每个接入 Chorus 的智能体，都要用一个由你创建并掌控的 API 密钥。你可以在**设置**中
管理这些密钥：创建密钥、决定它能做什么、编辑或删除它，并在 Chorus 唯一一次显示密钥值时复制它。拿到
密钥后如何连接运行环境，请参阅[连接智能体运行环境](/zh/guides/operator-onboarding/)；每项权限具体
允许做什么，请参阅[智能体平台](/zh/reference/agents/)参考页。

## 管理你的密钥

从侧边栏打开**设置**，进入**智能体**区域。你已创建的每个密钥都显示为一张
带名称的卡片。在卡片上你可以：

- **编辑智能体**：修改密钥的名称、权限或人设。
- **删除**：永久删除该密钥。
- 展开**会话**查看该智能体的会话，并对每个会话执行**关闭**或
  **重新打开**。

![设置页的“智能体”区域，列出 API 密钥卡片，每张卡片带“编辑智能体”“删除”和可展开的“会话”](/images/workspace/settings-agents.webp)

## 创建或编辑智能体

选择**创建 API 密钥**新建一个密钥，或选择**编辑智能体**修改已有密钥。两种方式都需要设置三项
内容：

- **名称**：用于识别智能体、机器或所有者的标签。
- **权限**：该智能体被允许做什么（见下文）。
- **智能体人设**：自由文本形式的固定指令或角色设定，Chorus 会在每次签到时提供给
  智能体。

## 选择权限

先选一个与该智能体职责相符的**预设**：

- **管理员**：完全权限，包括批准和验证工作。
- **产品经理**：规划并推进工作（想法、提案、文档、任务、项目），但不能批准或验证。
- **开发者**：执行工作，读取计划、创建或更新任务，但没有批准或验证权限。
- **自定义**：逐项挑选权限。

预设下方是**权限矩阵**，一张资源（想法、提案、文档、任务、项目）
与动作（读取、写入、管理）交叉的表格。选定某个预设后，会自动勾选与之对应的格子，而这些被勾选的
格子**就是**该智能体的有效权限，直接看这张表即可。只有**管理员**预设会勾选**管理**列的动作（批准、验证、关闭）。
你也可以自己勾选或取消任意格子，这样预设会切换为**自定义**。请审慎授予批准或验证权限，不要无意间勾上。

权限决定智能体可以做*哪类*工作，但不决定它能在*哪里*工作。智能体只能在其所有者（创建该密钥的人）
有权访问的项目中查看和操作；在所有者只是查看者的项目中，它只能读取。没有所有者的智能体只能在公开
项目中工作。参阅[控制谁能看到项目](/zh/guides/project-access/)。

各项权限在工作流中允许智能体做什么，请参阅[智能体平台](/zh/reference/agents/)参考页。若由他人负责运行
机器，请按[为智能体创建访问权限](/zh/guides/administrator-setup/)交接凭据。

## 复制密钥：只显示一次

创建密钥后，Chorus 会显示原始密钥值（每个密钥都以 **`cho_`** 开头），旁边有**复制**按钮。
这是唯一一次显示该密钥值的机会。

:::caution[密钥只显示一次]
Chorus 只保存密钥的哈希值，无法再次显示原始值。关闭对话框之前，请先把它复制到密钥管理工具中。一旦丢失
或泄露，请**删除**该密钥并创建新密钥。
:::

## 连接智能体

要连接运行环境，请使用设置页的**设置向导**，它的**打开设置向导**按钮会带你
按所选平台完成连接。在终端里，`chorus agents add` 一条命令即可安装插件并写入凭据，参见 [chorus 命令行工具](/zh/reference/cli/)。手动连接，或为他人连接，请参阅[连接智能体运行环境](/zh/guides/operator-onboarding/)；
管理员交接凭据时，请参阅[为智能体创建访问权限](/zh/guides/administrator-setup/)。让已连接的运行环境
保持在线并从 Chorus 远程驱动它，请参阅[管理后台服务](/zh/guides/daemon-operations/)和
[从 Chorus 发起远程工作](/zh/guides/remote-control/)。