Skip to main content

智能体

为代码审查、方案规划等工作配置专用智能体,复用指令和工具设置。

代码审查、方案规划等工作往往有固定的要求。你可以将这些要求写入自定义智能体,为它配置模型、权限和可用扩展,下次处理同类工作时直接使用。 例如,创建一个代码审查智能体,要求它优先检查正确性和回归风险,并按“位置、影响、依据、修改建议”返回结果,就不必在每次审查时重复说明。

选择运行位置

创建前,先按使用场景选择运行位置:
运行位置适用场景可用配置
本地在当前设备处理任务,使用本机文件和工具。当前设备的模型、权限和扩展。
云端在项目和讨论中参与协作,需要相应账号权限。云端表单提供的模型、Skills 和 MCP。
在 创建智能体 → 执行位置 中选择本地或云端。创建后不能修改运行位置。管理已有智能体时,列表按当前设备、云端设备和其他设备分组。

配置智能体

在 设置 > 智能体 中创建和管理智能体,也可以从扩展管理进入。 单击 创建智能体,按需要选择创建方式:
  • 从空白创建:自行填写名称、说明和工作指令。
  • 从模板创建:先单击模板右侧的箭头查看 Skills 和工作指令,再单击模板进入配置页。模板会带入初始配置,仍可按自己的需求调整。
以下步骤用于配置本地智能体。选择云端运行位置时,按表单提供的模型、权限和能力配置:
  1. 填写或调整名称和说明,让使用者知道它适合处理什么工作。请在保存前确认名称,创建后暂不支持修改。
  2. 配置默认模型和权限。这些设置用于该智能体的新任务和协作执行;在某个任务中更换模型或权限,只影响该任务。本地智能体在当前设备上执行;云端智能体适用范围见上文。
  3. 在 指令内容 中写明职责、工作范围和输出要求。使用模板时,也应检查并调整带入的指令。
  4. 按需选择 Skills、已配置的 MCP 服务器和 Plugins。未选择的 Plugin 不会加载。
    模板中的 Skill 引用不代表已在本地安装;若显示“当前目录中不可用”,可取消引用,或通过 去能力市场搜索 查找所需能力。
  5. 如需单独控制工具,在 工具权限 中单击 编辑:允许列表中的工具可免审批执行,禁止列表会阻止对应工具,其他工具遵循默认权限。规则仅作用于当前智能体。
  6. 单击 保存智能体。保存成功后,智能体会出现在列表中,可继续编辑或在新任务中选用。
工作指令可以参考:
审查提供的代码变更,重点检查正确性和回归风险。
先阅读差异和相关测试,只报告有明确依据的问题。
每个问题包含代码位置、影响和修改建议。
本次只做审查,不修改文件;信息不足时说明还需要哪些材料。

为智能体选择模型

可为智能体单独选择可用模型。为插件智能体调整模型时,其插件提供的指令和其他配置仍由对应插件管理。子智能体使用自定义 API Key 模型时,需要执行设备上存在可用的配置与凭证;这不会自动把本机密钥同步到云端或其他设备。

创建云端智能体

需要在项目或讨论中使用时,可以将智能体保存在云端:
  1. 在 设置 → 智能体 中选择 创建智能体 → 从空白创建。
  2. 将 执行位置 改为 云端。从空白创建时默认选择本地,即使从云端设备列表进入,也需要在表单中确认。
  3. 填写名称、说明和指令,选择默认模型,并按需配置 Skills、MCP 和工具权限。请检查云端表单中的权限和协作范围;可选访问模式可能受企业策略限制。
  4. 点击 保存智能体,在 云端设备 列表中确认已保存且启用。
  5. 创建讨论时添加该智能体,再通过 @ 选择它并发送要求。等待执行完成,在讨论中查看回复;具体入口见用于项目和讨论。
云端智能体可按团队配置中提供的选项参与协作,参见智能体团队。云端资源和功能仍取决于账号权限及云端服务配置;企业审批策略也可能限制可选择的访问模式。

管理云端资源

在 设置 → 云端运行环境 中分别管理技能、连接器和记忆。选择类别后,通过 从本地同步 勾选需要的资源;同步前检查选择内容和云端授权状态。 本地 MCP 同步仅列出独立配置的用户级 HTTPS 连接器,不支持 stdio、插件提供、AppHub 托管,以及带静态请求头或查询参数的地址。

通过对话创建智能体

可以在本地任务中描述智能体的用途、工作范围和期望结果,请 Qoder 生成配置草稿。例如:“帮我创建一个检查代码回归风险的智能体,只做审查,不修改代码。”
  1. 查看对话中的智能体草稿,核对名称、说明和工作指令。
  2. 选择继续配置,进入配置表单。
  3. 检查模型、权限和扩展,按需调整后选择保存智能体。
  4. 保存成功后,在新任务的执行者菜单中选择该智能体。
生成草稿不等于创建完成;只有在配置表单中保存成功后,才能在新任务中选用该智能体。 对话创建功能仅适用于本地任务,不支持 Remote SSH 或 WSL 远端任务。

查看其他设备的智能体

连接设备后,在 其他设备 中查看该设备的智能体和在线状态。此目录只读;需要执行任务时,先确认目标设备和工作区授权。

使用智能体

要让智能体从头处理一项工作,在新任务中选择它;已经在与 Qoder 对话时,也可以直接把其中一部分工作交给它,并要求回传结果。

执行新任务

创建并保存本地智能体后,在新任务中选择它:
  1. 单击左侧导航中的 新的任务,打开新任务页。
  2. 单击页面上方的 Qoder 名称或旁边的下拉箭头,展开执行者选择菜单。
  3. 在 自定义智能体 分组中选择要使用的智能体。确认页面上的 Qoder 已变为所选智能体的名称,再输入任务要求并发送。
在新任务页展开 Qoder 菜单,选择自定义智能体
尚未创建智能体时,可从菜单底部的 前往自定义 进入设置创建;已有智能体也可从其编辑页顶部的 任务 直接发起新任务。

通过对话委派任务

正在和 Qoder 讨论方案,想请另一个智能体做专项审查时,可以直接在当前本地任务中委派,无需重新整理一遍任务背景。先在 设置 > 智能体 中确认目标智能体已启用且可用。 在输入框中写明智能体名称、需要处理的材料和输出要求。例如:
请把上面的接口改造方案交给代码审查智能体,检查兼容性风险并给出测试建议。
只分析,不修改文件。请跟进到完成,把结果带回当前对话;需要我确认时告诉我。
发送后,Qoder 会创建委派任务。要求跟进后,可以在当前对话中接收结果和待确认事项,也可以打开对应任务查看过程。收到结果后,检查它是否回答了你的问题;如果只有“任务已创建”,还需要等待执行完成。

用于项目和讨论

项目和讨论仅企业版(Teams、Enterprise)支持。个人版暂不支持。
使用本地智能体时,在智能体设置中开启 允许在 Issue 和讨论中使用,并保持当前设备在线。 在项目中处理 Issue
  1. 在项目中打开 Issue,单击 发起讨论,确认已带入 Issue 的标题、描述和关联信息。
  2. 通过 Agent 选择自己的智能体,单击 创建。
  3. 在讨论中按下述方式调用智能体;需要继续落实的工作,记录回关联 Issue。
在讨论中调用
  1. 创建讨论时,通过 Agent 选择智能体;已有讨论可通过 分享 > 添加 Agent / Agent Team 添加。
  2. 在输入框键入 @,切换到 Agent 标签,选择自己的智能体,输入要求并发送。
  3. 等待执行完成,在讨论中查看回复。使用本地智能体时,还可单击 查看执行对话 检查执行过程和状态。
只能通过 @ 调用自己拥有的智能体;其他成员添加的智能体不能由你调用。

调整配置

在 设置 > 智能体 列表中单击编辑按钮,调整说明、工作指令或执行配置后,单击 保存智能体。 暂时不使用时,可关闭列表中的启用开关,或在编辑页关闭 允许指派。这会中止未完成任务并停止接收新任务,历史记录仍保留。 云端智能体的配置支持修改名称,保存后核对列表中的名称和可用状态。本地智能体的名称规则仍按其配置页面处理。

管理已归档智能体

在归档列表中检查对象后,可以使用当前提供的恢复或删除操作。恢复云端智能体需要具备对应权限,恢复后检查是否已可用。永久删除前阅读影响提示;不要把删除当作归档。