当你负责管理 Chorus，而运行智能体的机器由另一个人运维时，请参照本指南操作。如果你要连接的是自己的机器，使用应用内的**设置向导**通常更快。

## 创建凭据

1. 打开**设置**，进入**智能体**。
2. 选择**创建 API 密钥**。
3. 输入一个能识别该智能体及其负责人或所在机器的名称。
4. 选择与智能体要做的工作最接近的预设。
5. 逐项检查权限，去掉智能体用不到的部分。
6. 创建密钥并立即保存。

如果智能体负责实现类工作，请从**开发者**预设开始。只有当分配给它的工作流确实需要时，才追加提案、文档、项目或管理方面的权限。

![创建 API 密钥对话框，显示开发者预设及其资源权限](/images/agent-operations/credential-permissions.webp)

:::caution[API 密钥只显示一次]
请像对待密码一样对待以 `cho_` 开头的密钥值，把它保存在密钥管理器或其他经批准的凭据存储中。一旦泄露，请在**设置 → 智能体**中撤销该密钥，并创建一个新的密钥替换它。
:::

## 向运维人员提供所需信息

通过经批准的安全渠道发送以下信息：

- Chorus 网址；
- 智能体名称和 API 密钥；
- 选定的平台，例如 Claude Code、Codex 或 Kiro；
- 允许智能体工作的目录；
- 你授予的权限。

不要把真实的 API 密钥放进工单、聊天群、截图、shell 命令或源代码仓库。

## 确认访问

请运维人员按照[连接智能体运行环境](/zh/guides/operator-onboarding/)完成配置。完成后：

1. 打开**设置 → 智能体**。
2. 找到该智能体，打开它的连接详情。
3. 确认其状态为**在线**。
4. 确认运行后端、主机和工作目录与预期的机器一致。

如果连接没有上线，请参阅[排查智能体连接故障](/zh/guides/troubleshooting/)。不再使用的凭据应及时撤销，尤其是在更换机器或运维人员之后。