模型供应商
最后更新：2026-10-10
pi-ai 把各家大模型的差异收敛成统一的接口：流式输出、工具调用、供应商工厂都一视同仁。换模型通常只改配置，不用改业务代码。这种「模型无关」的设计，让 Pi 的核心循环在面对快速变化的模型市场时始终稳定，也让你能在成本、合规与能力之间自由权衡。
已支持的供应商
| 供应商 | 说明 |
|---|---|
| OpenAI | GPT 系列，流式 + 工具调用。 |
| Anthropic | Claude 系列。 |
| Gemini 等官方 API。 | |
| Amazon Bedrock | 托管的多模型接入。 |
| Google Vertex | GCP 上的企业级接入。 |
| GitHub Copilot | 编码场景的模型通道。 |
| opencode 等 | 生态中持续扩充的供应商工厂。 |
统一接口的意义
核心循环只依赖 pi-ai 的抽象，不关心背后是谁在推理。带来的好处：
- 可替换：成本、合规或能力变化时可以一键切换供应商。
- 可测试：教学版用
MockModel在无 API key 情况下跑通整个循环，便于离线开发与 CI。 - 可组合：不同步骤可以接不同模型（例如规划用强模型、执行用快模型）。
这些抽象内置于 pi-agent-core 与 pi-ai 之中，是总体架构「核心循环稳定、外设可变」原则在模型层的直接体现。
配置方式
具体凭证与端点配置请以上游仓库为准（通常在环境变量或 .pi/ 配置中填写对应供应商的 key）。实践建议：
- 本地开发先用
MockModel或免费额度验证流程。 - 真实模型接入后，通过
./test.sh跑真实模型烟测确认链路。 - 凭证不要进仓库，使用环境变量 / 密钥管理。
在运行与调试中，你可以看到沙箱与密钥隔离的相关实践，确保凭证不随代理执行的命令外泄。
相关阅读
常见问题（FAQ）
Pi 支持哪些模型供应商？
通过 pi-ai 统一接入 OpenAI、Anthropic、Google、Amazon Bedrock、Google Vertex、GitHub Copilot 等，生态中还持续扩充如 opencode 等供应商工厂。最新列表以上游 pi-ai 包为准。
怎么切换模型供应商？
核心循环只依赖 pi-ai 的抽象，换供应商差异被收敛在 pi-ai 内部。切换通常只改配置（或在代码中换一个供应商工厂），业务与核心循环代码都不用动，详见核心包与总体架构。
没有 API key 能测试吗？
能。pi-ai 提供 MockModel，在完全离线、无密钥的情况下即可跑通整个核心循环，非常适合学习、演示与 CI。真实模型接入后再用 test.sh 做烟测。
可以在不同步骤用不同模型吗？
可以。由于核心循环只依赖 pi-ai 抽象，你可以为不同步骤配置不同模型，例如规划用强模型、执行用快模型，组合空间由配置决定。
凭证应该怎么配置才安全？
凭证不要进仓库，使用环境变量或密钥管理，通常填在环境变量或 .pi/ 配置中对应供应商的 key。具体端点与变量名以上游仓库为准，配置完成后用 test.sh 验证链路。
