Are you an LLM? You can read better optimized documentation at /agent-teams-ai/docs/zh/reference/providers-runtimes.md for this page in Markdown format
提供方与运行时
Agent Teams 将编排与模型访问分离开来。应用负责管理团队、任务、消息、启动状态和审查 UI;所选的运行时/提供方路径则执行实际的模型工作。
应用提供什么
Agent Teams 提供:
- 团队与任务编排
- 看板 UI
- 队友消息传递
- 任务日志
- 审查 UI
- 本地项目集成
- 运行时检测与能力检查
- 本地日志与诊断
运行时提供什么
运行时提供:
- 模型执行
- 提供方身份验证
- 工具执行行为
- 特定于模型的速率限制与能力
- 特定于运行时的转录与投递凭证
受支持的运行时路径
| 运行时路径 | 提供方/模型路径 | 最佳适用场景 | 备注 |
|---|---|---|---|
| Claude Code | Anthropic / Claude 模型 | Claude Code 用户以及由 Anthropic 支持的工作流 | Claude 团队默认的本地优先路径。需要本地具备运行时及账户访问权限。 |
| Codex | Codex / 由 OpenAI 支持的模型 | Codex 原生工作流 | 在可用时使用 Codex 运行时集成以及 Codex 认证/账户状态。部分诊断与 Claude 转录不同。 |
| OpenCode | OpenCode 托管的模型路由 | 多提供方团队以及广泛的模型覆盖 | OpenCode 可以路由到许多模型提供方。Agent Teams 将 OpenCode 通道视为特定于运行时的凭证,并在通道身份不明确时避免臆测。 |
Gemini 作为一条受支持的提供方路径提供,支持 Google ADC(gcloud auth)、Gemini CLI OAuth 以及 API 密钥身份验证。当运行时报告其可用时,它会在团队创建和运行时设置 UI 中与其他提供方一同出现。
提供方 ID
应用目前在团队/运行时配置中识别以下提供方 ID:
| 提供方 ID | 显示意图 |
|---|---|
anthropic | Anthropic / Claude Code 路径 |
codex | Codex 路径 |
gemini | Gemini 提供方路径(Google ADC、Gemini CLI 或 API 密钥) |
opencode | OpenCode 路径,包括 OpenCode 托管的提供方路由 |
不要将此表解读为对每台机器上每个模型的每个提供方都已认证、已安装或可用的保证。对于某次具体启动而言,运行时状态和能力检查才是事实来源。
模型 ID
模型 ID 会被传递给所选的运行时。Agent Teams 不会将某个提供方的模型目录改写为统一的命名方案。
示例:
| 提供方路径 | 示例模型 ID | 备注 |
|---|---|---|
| Claude Code | opus、sonnet 或完整的 Claude 模型 ID | 可用性取决于 Claude Code 与账户访问权限 |
| Codex | gpt-5.4、gpt-5.3-codex | 可用性来自 Codex 账户/运行时状态 |
| OpenCode | openrouter/moonshotai/kimi-k2.6 | 前缀必须与某个 OpenCode 提供方配置相匹配 |
如果某个模型名称被拒绝,请先直接在运行时/提供方中进行验证。更改团队简报并不能让一个不可用的模型启动。
多提供方策略
Agent Teams 让编排具备提供方感知能力,但并不被提供方所拥有:
- 团队、任务、收件箱、评论、审查状态和启动诊断都保留在本地的 Agent Teams 存储中
- 每位成员都可以通过团队启动元数据携带提供方/模型设置
- 模型可用性、身份验证、速率限制和工具行为仍由运行时/提供方负责
- 当你希望让一个团队使用多条提供方/模型通道时,OpenCode 是覆盖面最广的路由路径
关于面向贡献者的边界以及规范的实现指南,请参阅贡献者架构。
推荐模式:
| 模式 | 何时有帮助 | 风险 |
|---|---|---|
| 所有成员使用同一个提供方 | 首次启动、敏感仓库、最简单的调试 | 共享的速率限制可能让整个团队停摆 |
| 强 lead + 更廉价的 builder | 在降低实现成本的同时保持规划/审查的可靠性 | builder 的产出可能需要更严格的审查 |
| 分别使用 builder 和 reviewer 模型 | 捕捉特定于模型的盲点 | 需要更多设置,并需检查更多归属信息 |
提供方成本
Agent Teams 免费且开源。你可以从内置的免费模型开始,无需身份验证——无需注册、API 密钥或信用卡。付费或基于账户的提供方使用由你所选择的运行时/提供方管理:订阅额度、API 密钥、账户认证、速率限制和提供方政策都仍然外置于应用之外。
能力检查
在设置过程中,应用可能会执行访问与能力检查。这有助于在团队启动于预配中途失败之前,检测出缺失的运行时认证。
能力检查可能会报告:某个提供方存在但未认证、模型列表不可用、缺少某条运行时路径,或某项特定的扩展能力不受支持。请将这些结果视为设置诊断,而非任务失败。
典型的设置修复:
| 检查结果 | 应采取的措施 |
|---|---|
| 缺少运行时 | 安装 CLI 或修复 PATH |
| 提供方未认证 | 运行提供方登录流程或添加所需的 API 密钥 |
| 模型不可用 | 选择该运行时模型列表中可见的模型 |
| 能力不受支持 | 为该队友改用另一条运行时路径 |
应预期的限制
- 受支持运行时并不意味着 Claude Code、Codex 和 OpenCode 之间具有同等的功能对等性。
- 日志和转录的覆盖范围因运行时而异。
- 在应用能够安全归属运行时日志之前,OpenCode 通道需要稳定的通道/会话凭证。
- 提供方的模型名称与可用性可能在应用之外发生变化。
- 团队提示词无法修复缺失的认证、缺失的 PATH 条目、提供方中断或耗尽的速率限制。
