Agent Tasks

设置智能体任务

为一个项目开启智能体任务、选择编码 CLI、把您自己的账户连上去,并用技能教会智能体您的团队规范。

开启功能

智能体任务按项目启用,而不是按账户。打开项目,进入 设置,再进入 智能体 标签页,勾选 启用智能体任务。这会在该项目的每个预发布和开发实例内部启动一个轮询进程,随时准备接手工作。

您需要项目设置权限才能看到并修改这个标签页。如果打不开它,请联系管理您工作区的人。

选择 CLI

智能体 CLI 下,选择由哪个编码 CLI 在这个项目上制定和执行任务:

  • Claude Code
  • Gemini CLI
  • Codex CLI

每个 CLI 用自己的凭据登录,并且 运行在您自己在该提供方的账户上。CICDoo 不转售模型访问权;智能体使用您提供的订阅或密钥,运行会计入您在那边的配额。

您之后可以更换 CLI。已经保存的凭据会保留它的掩码,所以切走再切回来不会再次要求填写密钥。

连接您的账户

怎么连接取决于 CLI,而这个区别决定了由谁付费。

Claude Code

在您自己的机器上运行 claude setup-token(这需要一个 Claude 订阅),把令牌粘贴到 Claude Code 令牌。这是 Claude Code 在这里提供的唯一模式。

Gemini CLI 与 Codex CLI

两者都可以用两种方式运行,在 智能体如何登录 下选择:

  • 用您自己的订阅。 在您自己的机器上登录该 CLI,然后把它缓存的登录文件的全部内容粘贴进来:Gemini 是 ~/.gemini/oauth_creds.json,Codex 是 ~/.codex/auth.json。智能体在运行过程中会刷新它,并把刷新后的副本送回来,所以您应该不用再做第二次。
  • API 密钥,按 token 计费。 在 Google AI Studio 或 OpenAI 平台控制台中创建一个密钥并粘贴进来。运行由提供方计费到这个密钥上。

付费的 Gemini Code Assist 授权还需要它的 Google Cloud 项目 id。使用个人 Google 账户时留空即可。

粘贴凭据之前请先读这段

凭据保存在平台上,并会发送到您的实例容器,好让智能体完成认证。任何拥有这些容器 shell 或 IDE 访问权限的人都能读到它。

登录文件比 API 密钥更重。它是您的账户会话,而不是权限受限的凭据:它无法单独吊销,而且如果有人在容器内手动运行该 CLI,用的就是它。各提供方也把这些套餐定位为交互式使用,OpenAI 就建议自动化流程使用 API 密钥,所以在让智能体使用个人订阅之前,请先确认您的套餐条款。

如果这对您的场景是个问题,就在提供方支持的地方使用 API 密钥模式:密钥可以限定权限,也可以单独吊销。

可选设置

  • 模型。 您所选 CLI 的模型别名或完整模型名称。留空则使用它的默认值。
  • 自动执行计划。 这个项目上的新任务会跳过审阅步骤:成功的计划会被自动批准,然后在没有人先读一遍的情况下实施并推送。被智能体报告为受阻的计划仍会等您,生产实例上的每份计划也一样。您可以按任务修改这一项,而设置它需要计划批准权限。

技能:教会它您的规范

同一个标签页上的 技能 部分,用来记录智能体应当遵循的团队规范:您怎么命名、怎么写视图、怎么测试。

上传一个 Markdown 文件,或者一个内含 SKILL.md 的技能文件夹 .zip。创建任务时您可以挑选它使用哪些技能,技能也可以标记为始终启用,这样每个任务都会带上它。技能存放在您项目自己的存储桶中,并会为用到它们的任务安装到容器里。

这是改善结果最便宜的办法。一个了解您模块布局和测试规范的智能体,产出的计划需要您纠正的次数会少得多。

下一步

关于智能体任务是什么,以及围绕生产环境的那些规则,见 什么是智能体任务。要创建并查看您的第一个任务,见 运行任务并查看结果

如果遇到问题,请从工单页面或聊天窗口提交支持工单。

仍未解决?在应用中提交工单,或与工程师沟通