agent-ecosystem/landing/product-docs/zh/reference/providers-runtimes.md
777genius 95e0f34d31 docs(product-docs): add zh, es, ja, fr, de doc translations
Localize the VitePress docs into Simplified Chinese, Spanish, Japanese,
French and German (18 pages each), mirroring the existing en/ru structure.

- generate the 5 new locales in config.ts from a single strings table
  (nav, sidebar, search, footer, docFooter, outline, editLink) with
  locale-prefixed links
- rework DocsCardGrid from the binary isRu check to a per-locale map so
  the home cards render translated copy and prefixed links for every locale
2026-05-31 17:50:54 +03:00

5.7 KiB
Raw Blame History

title description lang
提供方与运行时 Agent Teams 文档 受支持的运行时路径Claude Code、Codex、OpenCode、提供方 ID、模型命名、多提供方策略以及能力检查。 zh-Hans

提供方与运行时

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 ADCgcloud 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 opussonnet 或完整的 Claude 模型 ID 可用性取决于 Claude Code 与账户访问权限
Codex gpt-5.4gpt-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 条目、提供方中断或耗尽的速率限制。