助手运行配置
运行配置用于保存技能或 MCP 连接执行任务时需要的参数和凭据。例如,天气服务需要 WEATHER_API_KEY,连接外部系统可能需要个人访问令牌。
配置项定义需要什么信息,配置值保存实际内容。实际值独立管理,敏感值加密保存,助手定义和发布内容不包含真实密钥。
配置声明与配置值
配置项来自技能或 MCP 连接,包含名称、用途、是否必填和使用时机。助手发布版本固定配置项声明和提供策略,实际值可以来自:
- 使用者为当前助手保存的配置;
- 使用者只为当前对话填写的配置;
- 维护者设置的助手共享默认值。
当前对话的自定义值优先于该使用者为助手保存的值。复制或导入助手时,只携带配置项声明和提供策略,真实值需要重新提供。
配置卡触发条件
配置项的使用时机决定填写入口。截图以“待办系统访问令牌”为例,演示值不对应真实账号。
对话前填写必需配置
选择助手后,需要在对话前填写的配置会显示在「开始前需要配置」中。
- 阅读配置项用途,确认要连接的服务。
- 填写所需值,或点击「选择已保存配置」复用兼容的配置。
- 选择「为此助手保存」或「仅当前对话」。配置策略限制保存范围时,「仅当前对话」不可选。
- 点击「保存配置」。必填项完成后即可开始对话。

任务中填写按需配置
只有执行到相关技能或连接时才需要的配置,会在任务执行期间显示「需要配置」卡片。卡片中的「本次用途」说明这次请求需要凭据的原因。
- 阅读配置项用途和使用范围,确认要连接的服务。
- 填写所需值,或选择已有的兼容配置。
- 选择「为此助手保存」或「仅当前对话」。
- 点击「保存并继续」,继续任务。必填项不提供时,可点击「不提供并停止」结束本次请求。

「为此助手保存」供本人使用该助手的其他兼容对话复用;「仅当前对话」只影响当前对话。为自己保存配置与维护者设置共享默认值分别管理。
选填配置可以点击「暂不提供」,只跳过本次请求;留空并点击「保存并继续」会在所选范围内记住不提供,之后不再询问。需要重新提供时,到运行配置中心填写值或清除跳过状态。必填配置不提供时,依赖该配置的任务无法继续。
运行配置中心
点击客户端左下角的用户信息,选择「运行配置」。按助手查找配置项,也可以搜索需要处理的配置。
配置中心按助手、技能或 MCP 连接、配置项展示默认绑定和对话覆盖。根据需要替换配置值、解除绑定,或清除“记住不提供”状态。敏感值不显示明文,更新时填写新的值。
一个配置项反复询问时,检查是否选择了「仅当前对话」、原配置是否被撤销,以及助手发布后的配置声明是否变化。配置状态加载失败时先重试;提交支持请求时记录助手名称、配置项名称和错误信息。

图中「待办系统访问令牌」已有个人配置,可通过「更新配置」替换;「项目标识」处于「记住不提供」状态,需要使用时点击「配置」重新填写。
配置提供策略
维护者决定配置由谁提供:
- 使用者必填:每位使用者提供自己的值,适合个人账号连接。
- 允许覆盖:维护者提供共享默认值,使用者可以用自己的值替换。
- 固定默认值:维护者提供统一默认值,使用者不能替换。
在「连接」页签的「鉴权方式」中,这三种策略分别显示为「使用时填写」「默认密钥(可覆盖)」「助手持有密钥」。选择后,在相应字段中填写配置项名称、注入方式和所需默认值。
个人助手的维护者可在保存后的助手编辑器中,通过「运行参数」管理相应策略和共享值;MCP 的鉴权配置通过「连接」管理。企业助手的配置维护需要相应的资源权限。
提供策略的变化需要发布后进入运行版本。轮换实际配置值无需重新发布;固定默认值失效时,应联系维护者补充或替换,任务无法自动改用使用者凭据。

图中选择「使用时填写」,将字段名设为 TASK_TOKEN,显示名称设为“待办系统访问令牌”。字段名用于连接配置,显示名称用于提示使用者填写。
凭据安全边界
- 真实密钥只填写在运行配置中,禁止写入工作方式、消息正文、技能源码或 MCP 固定请求头。
- 为此助手保存的个人配置供本人复用;授予同事助手使用权不会分发该值。
- 获得助手管理权或企业后台权限,不会获得读取成员配置值的权限。
撤销配置值后,依赖该值的新请求无法继续使用该凭据。排障时记录配置项和错误信息,提交材料中应去除真实密钥。