配置字段参考
本页汇总智能体开发服务平台（AgentWorks）控制台公开的主要配置。具体可选资源还取决于账号权限、管理员资源分配和外部服务。
智能体模板配置
智能体模板字段按基本信息、模型、文件系统、Todo、用户提问、联网搜索、时间、压缩、容错、工具权限、渠道和插件配置分组。
| 分组 | 字段 | 说明 |
|---|---|---|
| 基本信息 | 模板名称、描述 | 可复用智能体模板的标识 |
| 模型配置 | 模型凭证、模型 | 必填 |
| 模型配置 | 温度 | 输出随机性 |
| 模型配置 | 思考模式 | 默认、开启或关闭；默认不强制覆盖模型行为，具体支持取决于模型 |
| 模型配置 | 存在惩罚、频率惩罚 | 调整内容引入和重复倾向 |
| 模型配置 | 最大生成长度、最大上下文长度 | 当前模型只读上限 |
| 模型配置 | 系统提示词 | 基础指令，可按表单标记为实例可配置 |
| 文件系统 | 启用文件系统、工具选择、写前必须读 | 使用 Skill 时必须开启并保留 read_file；只需读取时建议选择仅只读。清空表示使用默认工具集，完全停用须关闭开关 |
| 待办列表 | 启用待办列表 | 默认关闭；开启后，模型可以列出并更新当前任务的步骤。开始新会话后仍要保留进度，或需要系统自动继续执行后续步骤时，使用工单或工作流系统 |
| 用户提问 | 启用用户提问 | 让智能体通过文本、单选或多选问题收集缺失信息 |
| 联网搜索 | 启用联网搜索、Tavily API Key、搜索最大结果数 | 需要可用 Tavily 凭证；最大结果数为 1 到 20；避免向外部搜索服务提交敏感内容 |
| 时间 | 注入当前时间 | 按任务需要显式检查开关状态，不代替业务时区或调度规则 |
| 压缩配置 | 启用压缩 | 使用主模型自动摘要长会话，并提供手动压缩工具 |
| 容错配置 | 任务级容错、步骤级容错、模型降级切换、实例单独配置 | 设置任务或单次调用的超时、重试和备用模型 |
| 工具权限 | 拒绝规则、允许规则、默认行为、生成审批描述 | 智能体级调用决策：拒绝规则优先，其次允许规则，最后使用默认行为 |
| 渠道配置 | 飞书、QQ 参数 | 可选择模板绑定或实例绑定 |
| 插件配置 | 模板、实例、工具包、子代理 | 智能体模板可用能力 |
插件配置
插件配置 保存智能体模板与能力对象之间的关联。在沙箱、MCP、知识库组、记忆库或技能组管理页面创建能力资源后，还需要在智能体模板的 插件配置 中选择相应资源并建立关联。
| 插件类型 | 选择方式 | 保存后的含义 |
|---|---|---|
| 沙箱、MCP、知识库组（插件类型显示为“知识库 RAG”）、记忆、技能组 | 模板或实例 | 使用模板准备资源，或者连接现有资源 |
| 平台工具包 | 选择工具包 | 关联平台提供并负责执行的现成工具包 |
| 用户工具包 | 填写工具定义 JSON，并决定是否 创建实例时可配置 | 保存工具名称、描述和输入输出 schema；由调用智能体的业务系统执行工具并返回中断结果 |
| 子代理 | 选择智能体实例 | 把已有智能体实例作为子代理关联 |
保存智能体模板后，在 智能体模板详情页打开 插件，可以核对插件类型、名称和资源 ID。该列表表示关联已经保存；能力是否在运行中被实际选择和使用，还需要通过智能体实例测试、Trace 或对应运行记录确认。
控制台中的 工具权限 统一控制可审批工具的自动拒绝、自动批准和人工审批。同一组模板规则先检查拒绝规则，再检查允许规则，最后使用默认行为。已有规则而默认行为未指定时，未命中调用进入人工审批；只有规则和默认行为都为空，并且未开启 生成审批描述 时，才不启用 HITL。单独开启生成审批描述也会启用 HITL。渠道用户规则只会补充自动批准，拒绝或未命中仍交给人工处理。工具名称来自可调用名称，参数名来自输入 schema 顶层 properties，匹配正则由用户根据审批策略编写。只有同时填写参数名和匹配正则时，规则才会按参数值缩小范围。参见找到工具名称和参数名和配置工具审批流程。
压缩配置只保留启用开关。更新已有模板后，通过固定长会话检查事实保留和工具连续性，并将配置应用到目标实例。参见配置模型、提示词与上下文压缩。
容错配置
容错设置分别约束整次任务和单次模型或工具调用。下表列出新建模板的默认值和可设置范围；操作方法参见配置超时、自动重试和备用模型。
| 配置项 | 新建模板默认值 | 范围或生效条件 |
|---|---|---|
| 启用容错配置 | 开启 | 总开关开启时，任务级或步骤级至少开启一项 |
| 任务级容错 | 关闭 | 开启后设置任务总超时；最长 168 小时，时长须为正整数 |
| 任务自动重试 | 关闭 | 开启后次数为 1 到 10，间隔为 1 到 10 秒；表单初始值为 3 次、3 秒 |
| 步骤级容错 | 开启，选择模型调用和工具调用 | 至少选择一种步骤类型；两种类型独立设置 |
| 单次步骤超时 | 模型、工具均为 1 小时 | 正整数，最长 72 小时 |
| 步骤自动重试 | 模型、工具均开启，最多 3 次、间隔 3 秒 | 每种类型次数为 1 到 10，间隔为 1 到 10 秒 |
| 模型降级切换 | 关闭 | 模型调用自动重试开启后可用；至少选择一个备用模型 |
| 开放给 Agent 实例单独配置 | 关闭 | 开启后在实例编辑页调整整份容错设置；总开关由模板决定 |
备用模型共用当前智能体的模型凭证。租户启用非空备用池时，只能从池内选择；未限制时可自行配置。修改模板后，需要编辑并保存已有实例，再验证超时、重试和实际使用的模型。
注意
工具重试可能重复业务操作
超时或失败时，工具对应的业务操作可能已经完成。下单、发消息、扣款或修改数据等调用启用自动重试前，确认业务接口可以对重复请求去重；无法安全重复执行时，关闭对应自动重试。
智能体实例配置
智能体实例选择来源模板，并填写模板允许在创建实例时配置的参数。
- 智能体模板：实例来源智能体模板。
- 实例名称：用于识别运行对象；实例作为子代理时，也帮助主智能体区分不同职责。
- 描述：可选用途说明；实例作为子代理时，建议说明适合处理的任务、所需输入、返回结果和不适用范围。
- 模型参数：仅显示智能体模板开放的值。
- 渠道参数：仅显示智能体模板开放的值。
- 插件参数：仅显示能力模板开放的值。
- 容错配置：默认采用模板值；模板开放单独配置后，可从模板详情的创建实例页直接调整，也可在实例编辑页调整。实例列表的新建入口先采用模板值。保存前检查整份设置，实例不能单独修改模板的容错总开关。参见调整实例容错设置。
智能体实例详情提供 基本信息、容错配置、Trace、渠道 和 后台任务。侧边栏的 网页版对话 在新标签页打开；发送消息前需要在对话页选择目标实例。该入口仅在环境已配置对话地址时显示。
实例关联为子代理后，AgentWorks 会把实例名称和描述提供给主智能体，但不会自动把该实例的完整系统提示词、模型、插件或权限作为能力说明。参见让主智能体看懂每个子代理适合做什么。
MCP 配置
模板和实例支持：
- 名称和描述。
- Server URL。
- Streamable HTTP。
- 模板的 超时时间:，以及实例的 超时（秒）；实例中
0表示使用平台默认值。 - 跳过 TLS 校验。
- Headers。
警告
生产环境应保持 TLS 校验开启。仅在隔离测试环境排查自签名证书时临时跳过，并在配置受信任证书后重新开启。跳过校验可能导致连接凭证和传输数据被截获。
模板还可以把 URL 路径参数和 Headers 标记为 可配置，供智能体实例填写。生成字段名称、智能体模板参数映射和渠道 /init 的填写方法参见使用 MCP 模板为智能体实例按需生成连接。
知识库组配置
知识库集合保存已入库内容，知识库组模板和实例决定检索时使用的集合与默认参数。
知识库集合
可以配置以下字段：
- 名称
- 说明
- 向量维度
- chunk_overlap
- distance
知识库组模板
可以配置以下字段：
- 名称 *
- 描述
- 默认检索条数（top_k）
- 默认知识库集合 *
知识库组实例
可以配置以下字段：
- 名称
- 说明
- 模板
- 默认检索条数（top_k）
- 知识库集合 *
知识库组模板至少选择一个已注册集合，top_k 范围为 1 到 100。
记忆配置
一个智能体模板最多关联一项记忆插件，可连接已有记忆库，或选择环境中可用的记忆模板。交互模式 提供两种选择：
AUTO_EXTRACT_AND_TOOL：新添加记忆插件时的默认选择。平台从对话中自动提取并保存记忆，智能体按需调用工具检索。TOOL：智能体通过工具保存和检索记忆，便于逐次检查保存操作。
两种模式都需要由智能体调用工具取回记忆。配置后，使用一条测试事实验证保存、新会话检索、纠正和删除过程。
手动新增条目中的 infer 只控制这次新增是否先提取记忆，不改变模板交互模式。
多个实例连接同一记忆资源不会自动建立个人数据隔离。控制台没有用于切换用户隔离范围的 User ID 选择器；保存个人资料前，先确认可信身份映射和资源边界。参见添加并验证记忆和管理记忆条目。
Skill 和技能组配置
Skill 提供 SKILL.md、相关文件和版本。版本可以标记为 latest 或 stable。
智能体读取 Skill 说明和资源需要 read_file。在智能体模板中关联技能组后，还须开启文件系统并保留这个工具；只需读取时建议选择 仅只读。操作方法参见将技能组添加到智能体模板。
技能组模板和实例可以选择多个 Skill 及版本。该版本选择用于沙箱文件准备，不能据此认定智能体通过 Skill 能力读取的说明和资源也固定在同一版本。读取说明和资源时，运行时根据 stable 和 latest 标记解析版本；修改版本选择或标记后，应分别核对读取内容和挂载文件。参见验证 Skill 版本。
技能组确定智能体可用的 Skill。处理请求时，智能体先根据名称和描述选择相关 Skill，再读取运行时解析出的说明和按相对路径引用的资源。资源读取只返回内容。同一个智能体模板同时关联技能组和沙箱时，还会按技能组版本配置准备文件并只读挂载到沙箱的 /skills 目录。直接关联已有沙箱实例时，挂载仍写到那个共享沙箱的同一个 /skills。挂载不会执行脚本、安装依赖或注册工具。
沙箱用户配置
沙箱模板和实例使用相同的核心配置类别，并根据管理员开放的资源进行选择。
- 名称和 描述：用于标识模板或实例。
- 沙箱模板启动类型：选择 Docker 容器或 Virtual Machine 隔离环境。
- 资源规格：选择管理员开放的规格。
- 环境配置：选择管理员开放的环境。
- 环境变量：可以在模板中标记为 可配置。
- 存储挂载：可选挂载阿里云 OSS 或火山引擎 TOS 等 S3 兼容对象存储；一个沙箱表单中的挂载点共用同一凭证，最多 10 个，默认只读。
沙箱工具的拒绝、自动批准和人工审批在智能体模板的 工具权限 中配置。
沙箱管理员配置
重要
仅限 AgentWorks 平台配置后台
本节列出的沙箱规格、沙箱环境和租户分配字段在独立的平台配置后台中查看或修改。日常创建智能体的 AgentWorks 控制台只提供管理员已经分配给当前租户的规格和环境选项。
沙箱规格管理 公开：
- 沙箱类型和 启动类型。
- Sandbox Class。
- CPU、内存和磁盘。
- 运行超时和空闲回收。
- 带宽限制、出站访问控制、禁止访问 RFC1918 内网段和 域名访问控制。
沙箱环境管理 公开 镜像地址、内部工作目录和外部工作目录。环境变量和启动参数显示为 暂不支持，不能编辑。
渠道账号配置
渠道账号名称在当前租户的同一渠道类型内不能重复。创建或重命名账号时，如果名称已经被同类型账号使用，需要改用其他名称。
飞书和 QQ：
- 绑定模式，以及 实例绑定（agent_id 指向应用实例） 或 模板绑定（agent_id 指向 Agent 模板，用户需 /init）。其中，“应用实例”就是智能体实例，即基于智能体模板创建的运行实例。
- 应用 ID（凭证）和应用密钥。
- 禁用单聊：勾选并保存后，拒绝所有单聊消息（包括
/init），名单内用户也不例外。 - 单聊允许的发送者 ID：未勾选禁用单聊时，留空允许所有发送者；填写后只允许 ID 与名单条目完全匹配的发送者。勾选禁用单聊不会清空名单，修改后需保存。
- 飞书的 禁用群聊：勾选并保存后，拒绝所有群聊消息（包括群内的
/init），名单内的群也不例外。 - 飞书的 群聊允许的群 ID：未勾选禁用群聊时，留空不限制群；填写后按 ID 完全匹配。普通群聊使用群 ID，带有话题 ID 的消息使用话题 ID。勾选禁用群聊不会清空名单，修改后需保存；此名单不限制单聊，也不按群内成员的发送者 ID 判断。
- 飞书的 展示工具调用详情。
- 飞书的 审批人员 ID：列出的人员可以审批其他人发起的任务。
- 飞书的 可自我审批人员 ID：列出的人员只能审批自己发起的任务。两份名单同时填写时，权限合并；两份都为空时，仅任务发起人可以操作。已填写名单但所有人员身份都无法解析时，卡片不提供可用操作入口，不会自动改为由发起人审批。参见设置飞书审批人员。
- 未命中的斜杠指令透传给 Agent：默认关闭；关闭时未知命令返回
/help，开启时作为 Agent 输入运行。 - QQ 只支持单聊，勾选禁用单聊并保存后，该账号将无法接收用户消息。
WebSocket：
- 绑定模式，以及 绑定 Agent 实例（默认） 或 绑定 Agent 模板。
- 在 绑定对象 中选择目标智能体模板或智能体实例。
- 创建渠道账号时可选择 同步创建 Token（可一次创建多个）。
- Token 名称和有效期；同一账号内同步创建的名称必须唯一。
- 后续 WebSocket Token 绑定渠道账号，不直接绑定智能体模板或智能体实例。
- 一个智能体实例或智能体模板只能绑定一个尚未删除的 WebSocket 渠道账号；停用账号不会释放绑定目标。
- 对账号选择 停用会关闭该账号的连接。随后刷新 WebSocket Token 列表，逐个核对绑定 Token 的状态，并单独停用仍显示为启用的 Token。恢复时，只启用或替换仍需使用的 Token，再对渠道账号选择 启用并让客户端重新连接。
创建渠道账号、为客户端签发 Token 并验证连接，参见通过 API 调用智能体；更换或停用已有 Token，参见分批轮换 WebSocket Token。
所有类型的渠道账号都需要先选择 停用，再选择 删除。
业务客户端调用配置
业务接入使用 WebSocket 渠道账号及账号专属 Token，通过 HTTP 提交消息或中断响应，通过 WebSocket 接收事件。先在渠道账号选择目标模板或实例，再为调用服务创建 Token。参见通过 API 调用智能体。
已有 Direct Invoke 集成需要迁移时，参见迁移旧版智能体接入。
凭证管理配置
凭证管理 提供模型凭证、对象存储凭证和 WebSocket Token。业务接入使用绑定 WebSocket 渠道账号的 Token。
| 页签 | 创建字段 | 列表中的绑定字段 | 生命周期操作 |
|---|---|---|---|
| 模型凭证 | 凭证名称、API Key、默认模型 | 不适用 | 编辑名称和默认模型、测试连通性、复制 API Key、删除；API Key 不可编辑 |
| 对象存储凭证 | 凭证名称、存储类型、区域、访问地址、AccessKey ID、Secret Access Key | 由沙箱存储挂载引用 | 编辑名称、区域和访问地址，或删除；存储类型和 AccessKey 不可原位替换，Secret Access Key 不展示 |
| WebSocket Token | Token 名称、绑定 WebSocket 渠道账号、有效期 | 绑定 WebSocket 渠道账号 | 启用、停用、重置、删除 |
名称的唯一范围如下：
- 模型凭证名称在当前租户内不能重复。
- 对象存储凭证用于同租户的沙箱存储挂载；轮换 AccessKey 或 Secret Access Key 时应创建替代凭证并迁移引用。
- WebSocket Token 名称在同一个渠道账号内不能重复。
Token 创建和重置响应只显示一次明文；列表随后只显示脱敏值。重置会使旧值立即失效。模型凭证的 API Key 可以通过 复制 API Key 再次取得，因此使用方应把控制台访问权限纳入密钥治理。
模型凭证 页签还提供 Failover 配置，用于设置租户可选的备用模型范围。参见为租户限定备用模型范围。