ConfigureAgent¶

更新当前用户可以管理的 AI 代理的指令或设置。只提供需要更改的字段；其余字段保持当前值。先用 ListAgents 读取代理：指令是整体替换的，因此要编辑它们，请将编辑应用到当前文本并传递完整结果。更改仅适用于之后打开的会话；正在运行的会话保留其开始时的指令。如需设置显示名称、handle、描述或图片，请使用 ConfigureBot；对于普通 webhook 机器人，请使用 ManageBotChannelAccess。

参数¶

参数	类型	必填	描述
`botId`	string	是	代理的 bot id：来自 ListAgents 的 `bot.botId`。
`instructions`	string	否	用 markdown 编写的完整新指令。完全替换当前指令；省略则保留当前指令。
`harness`	`"in-memory"` \| `"cursor"` \| `"macrod"`	否	要将代理迁移到的运行时。`macrod` 还需要 harnessId；其他运行时则不能有 harnessId。当前模型可能不存在于新运行时中，因此通常应同时传入 defaultModel。省略则保持当前运行时。
`harnessId`	string	否	已注册的自托管 harness 的 Id；当 harness 为 `macrod` 时必需，否则禁止提供。
`defaultModel`	string	否	代理的新会话应使用的模型 id，采用运行时的命名方式（例如 `claude-sonnet-4-5`）。有效 id 取决于运行时。省略则保持当前模型。
`channelScope`	`"all"` \| `"selected"`	否	`all` 使代理在其所有者可使用的每个频道中都可被提及；`selected` 将其限制到 channelIds。省略以保持当前范围；或者省略它并仅传入 channelIds，以切换到 `selected`。
`channelIds`	string[]	否	代理被限制到的完整频道 id 列表；用户必须是每个频道的成员。在 `selected` 范围内必需，在 `all` 范围内禁止。
`mcpScope`	`"owner_connections"` \| `"selected"`	否	`owner_connections` 将会话交给运行会话的人所连接的任意应用；`selected` 则只交给 mcpServers。省略以保持当前范围；或者省略它并仅传入 mcpServers，以切换到 `selected`。
`mcpServers`	AgentMcpServerSummary[]	否	`selected` MCP 范围的完整已连接应用列表，每项包含其 Pipedream 应用 slug（例如 `linear`）和显示名称。Pipedream 未列为可连接应用的 slug 会被拒绝，并且不会保存任何内容。与 `owner_connections` 一起使用时禁止。
`autoAcceptPermissions`	boolean	否	`true` 允许会话在运行时允许的情况下自动批准工具权限请求，而无需询问；`false` 则每次都询问。省略则保持不变。
`isCoding`	boolean	否	`true` 表示编码代理，它在代码仓库中工作，并通过实时会话响应提及；`false` 表示聊天代理，它在线程中回复。省略则保持不变。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 macro3/macro