配置字段参考

本页汇总智能体开发服务平台（AgentWorks）控制台公开的主要配置。具体可选值还取决于租户能力开关、管理员资源分配和外部服务。

智能体模板配置

智能体模板字段按基本信息、模型、文件系统、Todo、压缩、工具权限、渠道和插件配置分组。

分组	字段	说明
基本信息	模板名称、描述	可复用智能体模板的标识
模型配置	模型凭证、模型	必填
模型配置	温度	输出随机性
模型配置	启用思考	请求模型思考能力
模型配置	存在惩罚、频率惩罚	调整内容引入和重复倾向
模型配置	最大生成长度、最大上下文长度	当前模型只读上限
模型配置	系统提示词	基础指令，可按表单标记为实例可配置
文件系统	启用文件系统、只读模式	新建模板默认开启文件系统功能；旧模板缺少配置时按关闭处理。只读模式移除写入和编辑工具
待办列表	启用待办列表	默认关闭；开启后，模型可以列出并更新当前任务的步骤。开始新会话后仍要保留进度，或需要系统自动继续执行后续步骤时，使用工单或工作流系统
压缩配置	启用压缩、使用新版压缩	默认关闭；新版压缩是推荐和首选方式，使用主模型自动摘要并提供 compact_conversation
压缩配置	压缩模型、压缩模型最大长度、压缩阈值、保留阈值、压缩温度	关闭 使用新版压缩 时显示的旧版压缩字段；旧版已弃用，不推荐用于新配置
工具权限	拒绝规则、允许规则、默认行为、生成审批描述	智能体级调用决策：拒绝规则优先，其次允许规则，最后使用默认行为
渠道配置	飞书、QQ 参数	可选择模板绑定或实例绑定
插件配置	模板、实例、工具包、子代理	智能体模板可用能力

插件配置

插件配置 保存智能体模板与能力对象之间的关联。在沙箱、MCP、知识库组、记忆库或技能组管理页面创建能力资源后，还需要在智能体模板的 插件配置 中选择相应资源并建立关联。

插件类型	选择方式	保存后的含义
沙箱、MCP、知识库组（插件类型显示为“知识库 RAG”）、记忆、技能组	模板或实例	使用模板准备资源，或者连接现有资源
平台工具包	选择工具包	关联平台提供并负责执行的现成工具包
用户工具包	填写工具定义 JSON，并决定是否 创建实例时可配置	保存工具名称、描述和输入输出 schema；由 Invoke API 调用方执行工具并返回中断结果
子代理	选择智能体实例	把已有智能体实例作为子代理关联

添加沙箱插件后，可以选择 微应用，将该沙箱指定为 Playground 的自定义界面运行环境。每个智能体模板最多指定一个微应用沙箱。该选项不会创建、构建或部署微应用；目标沙箱必须使用已经准备好的兼容环境。参见使用沙箱提供微应用界面。

保存智能体模板后，在 智能体模板详情页打开 插件，可以核对插件类型、名称和资源 ID。该列表表示关联已经保存；能力是否在运行中被实际选择和使用，还需要通过智能体实例测试、Trace 或对应运行记录确认。

控制台中的 工具权限 统一控制可审批工具的自动拒绝、自动批准和人工审批。同一组模板规则先检查拒绝规则，再检查允许规则，最后使用默认行为。已有规则而默认行为未指定时，未命中调用进入人工审批；规则和默认行为都为空时，不启用 HITL。渠道用户规则只会补充自动批准，拒绝或未命中仍交给人工处理。工具名称来自可调用名称，参数名来自输入 schema 顶层 properties，匹配正则由用户根据审批策略编写。只有同时填写参数名和匹配正则时，规则才会按参数值缩小范围。参见找到工具名称和参数名和配置工具审批流程。

优先并推荐使用新版压缩。新版压缩使用主模型按上下文自动摘要，不需要单独配置压缩模型和阈值。旧版压缩（兼容模式）已弃用，不推荐用于新配置，仅用于现有配置迁移和排障；其压缩模型与主模型共用当前模型凭证，最大长度和阈值共同控制触发时机。启用或迁移压缩方式后，要通过固定长会话验证，并同步或更新已有实例；实例仍使用旧行为时再重启。配置和验证方法参见配置模型、提示词与上下文压缩。

智能体实例配置

智能体实例选择来源模板，并填写模板允许在创建实例时配置的参数。

• 智能体模板：实例来源智能体模板。
• 实例名称：用于识别运行对象；实例作为子代理时，也帮助主智能体区分不同职责。
• 描述：可选用途说明；实例作为子代理时，建议说明适合处理的任务、所需输入、返回结果和不适用范围。
• 模型参数：仅显示智能体模板开放的值。
• 渠道参数：仅显示智能体模板开放的值。
• 插件参数：仅显示能力模板开放的值。

智能体实例创建后可使用 基本信息、Playground、Trace、渠道、后台任务和 API 调用视图。

实例关联为子代理后，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。

记忆配置

记忆库管理 页面下拉框列出可管理的记忆库。每个选项显示记忆库名称和 mem-* 资源 ID；选择后，记忆条目的新增、检索、查看、编辑和删除都作用于该记忆库。

记忆库提供名称、描述和记忆条目管理。智能体模板的插件配置公开三种交互模式：

• TOOL：不会自动提取或自动提供记忆。智能体通过记忆工具保存和检索。首次验证建议选择该模式，通过 Trace 检查工具调用，并完成写入、新会话检索、纠错和删除。
• AUTO_EXTRACT_AND_INSERT：智能体回复后，AgentWorks 自动从本次交互中提取并写入记忆；在后续交互中，根据最新用户输入自动检索相关记忆，并临时加入本次模型请求。用于业务数据前，使用一条独立、完整的事实验证自动写入和新会话召回。业务要求逐条审阅、纠正或删除，但管理页面找不到对应条目时，请改用 TOOL。
• AUTO_EXTRACT_AND_TOOL：智能体回复后，AgentWorks 自动从本次交互中提取并写入记忆；智能体在需要时通过记忆工具检索。只有目标环境通过自动写入、新会话工具检索和正确回答的完整验收后再使用；未通过时改用 TOOL。

AUTO_EXTRACT_AND_INSERT 中的 INSERT 表示在智能体处理当前输入时，临时把匹配的记忆提供给模型。不表示向记忆库新增记录，也不会把检索结果变成会话中的一轮新对话；智能体处理后续输入时会重新检索。

模式名称不能代替运行验证。手动新增记忆时显示的 infer 只控制这次新增操作是否先从输入中提取记忆，不会改变智能体模板的交互模式。一次输入可能生成一条或多条记忆；保存后应检查每条内容。输入已经是一条完整事实时，可以取消选择 infer 并直接保存。

多个智能体实例连接同一个现有记忆库时，会使用同一份记忆数据。该记忆库不会根据渠道用户、API 调用方或 session_id 自动拆分；需要保存个人信息时，应为每个隔离范围使用独立记忆库，或由业务系统管理按用户区分的长期记忆。配置和验证方法参见添加并验证记忆库，条目操作参见搜索、纠正和删除记忆。

Skill 和技能组配置

Skill 提供 SKILL.md、相关文件和版本。版本可以标记为 latest 或 stable。

技能组模板和实例可以选择多个 Skill 及版本。控制台通常把 latest 和 stable 显示为具体版本旁的状态标记；选择类似 v3 (latest) 的选项仍然固定使用 v3。已有技能组直接显示不带版本号的 latest 时，才表示运行时动态解析当前 latest 版本。

技能组先把所选 Skill 的名称、描述和版本提供给智能体实例。处理请求时，智能体可以根据名称和描述选择相关 Skill，再读取所选版本的完整说明和按相对路径引用的资源。资源读取只返回内容。同一个智能体模板同时关联技能组和沙箱模板时，所选 Skill 文件还会只读挂载到沙箱的 /skills 目录；直接关联已有沙箱实例时不会增加这项自动挂载。挂载不会执行脚本、安装依赖或注册工具。

沙箱用户配置

沙箱模板和实例使用相同的核心配置类别，并根据管理员开放的资源进行选择。

• 名称和 描述：用于标识模板或实例。
• 沙箱模板启动类型：选择 Docker 容器或 Virtual Machine 隔离环境。
• 资源规格：选择管理员开放的规格。
• 环境配置：选择管理员开放的环境。
• 环境变量：可以在模板中标记为 可配置。
• 存储挂载：可选挂载阿里云 OSS 或火山引擎 TOS 等 S3 兼容对象存储；一个沙箱表单中的挂载点共用同一凭证，最多 10 个，默认只读。

沙箱不再提供单独的工具审批开关。沙箱工具的拒绝、自动批准和人工审批由智能体模板的 工具权限 处理。

沙箱管理员配置

重要

仅限 AgentWorks 管理控制台

本节列出的沙箱规格、沙箱环境和租户分配字段只能在独立的 AgentWorks 管理控制台 中查看或修改。AgentWorks 控制台只提供管理员已经分配给当前租户的规格和环境选项。

沙箱规格管理 公开：

• 沙箱类型和 启动类型。
• Sandbox Class。
• CPU、内存和磁盘。
• 运行超时和空闲回收。
• 带宽限制、出站访问控制、禁止访问 RFC1918 内网段和 域名访问控制。

沙箱环境管理 公开 镜像地址、内部工作目录和外部工作目录。环境变量和启动参数显示为 暂不支持，不能编辑。

渠道账号配置

渠道账号名称在当前租户的同一渠道类型内不能重复。创建或重命名账号时，如果名称已经被同类型账号使用，需要改用其他名称。

飞书和 QQ：

• 绑定模式，以及 实例绑定（agent_id 指向应用实例） 或 模板绑定（agent_id 指向 Agent 模板，用户需 /init）。其中，“应用实例”就是智能体实例，即基于智能体模板创建的运行实例。
• 应用 ID（凭证）和应用密钥。
• 禁用单聊；启用后优先于单聊允许名单。
• 单聊允许的发送者 ID。
• 飞书的 群聊允许的群 ID、禁用群聊和展示工具调用详情。
• 飞书的 审批人员 ID：留空时仅工具调用发起人可操作审批；填写后仅列出的人员可操作。
• 未命中的斜杠指令透传给 Agent：默认关闭；关闭时未知命令返回 /help，开启时作为 Agent 输入运行。
• QQ 只支持单聊，因此启用禁用单聊会阻止该账号接收其唯一支持的消息模式。

WebSocket：

• 绑定模式，以及 绑定 Agent 实例（默认） 或 绑定 Agent 模板。
• 在 绑定对象 中选择目标智能体模板或智能体实例。
• 创建渠道账号时可选择 同步创建 Token（可一次创建多个）。
• Token 名称和有效期；同一账号内同步创建的名称必须唯一。
• 后续 WebSocket Token 绑定渠道账号，不直接绑定智能体模板或智能体实例。
• 一个智能体实例或智能体模板只能绑定一个尚未删除的 WebSocket 渠道账号；停用账号不会释放绑定目标。
• 对账号选择 停用会关闭该账号的连接。随后刷新 WebSocket Token 列表，逐个核对绑定 Token 的状态，并单独停用仍显示为启用的 Token。恢复时，只启用或替换仍需使用的 Token，再对渠道账号选择 启用并让客户端重新连接。

实际创建渠道账号并验证连接时，参见通过 WebSocket 接入智能体；后续创建、拆分、轮换或停用 Token 时，参见管理 API 调用和 WebSocket Token。

所有类型的渠道账号都需要先选择 停用，再选择 删除。

API 调用配置

智能体实例提供：

• API 调用状态。
• 仅在页面显示的有效期内使用的 临时调试 Token。
• 正式 Token（Agent API Token）名称和可选过期时间。
• Token 启用、停用、重置和删除。
• API 概览、调试、Token 管理和接入文档视图。

在 API 调用状态 中关闭调用会停用该实例已有的所有 Agent API Token。重新开启调用不会自动启用这些 Token，需要在凭证管理中启用或替换后再测试。

普通控制台通过智能体实例的 API 调用 页面管理调用状态、Token 和调试请求。

凭证管理配置

凭证管理 提供四个页签：

页签	创建字段	列表中的绑定字段	生命周期操作
模型凭证	凭证名称、API Key、默认模型	不适用	编辑名称和默认模型、测试连通性、复制 API Key、删除；API Key 不可编辑
对象存储凭证	凭证名称、存储类型、区域、访问地址、AccessKey ID、Secret Access Key	由沙箱存储挂载引用	编辑名称、区域和访问地址，或删除；存储类型和 AccessKey 不可原位替换，Secret Access Key 不展示
Agent API Token	Token 名称、绑定 Agent 实例、有效期	绑定 Agent 实例	启用、停用、重置、删除
WebSocket Token	Token 名称、绑定 WebSocket 渠道账号、有效期	绑定 WebSocket 渠道账号	启用、停用、重置、删除

名称的唯一范围如下：

• 模型凭证名称在当前租户内不能重复。
• 对象存储凭证用于同租户的沙箱存储挂载；轮换 AccessKey 或 Secret Access Key 时应创建替代凭证并迁移引用。
• Agent API Token 名称在同一个智能体实例内不能重复。
• WebSocket Token 名称在同一个渠道账号内不能重复。

Token 创建和重置响应只显示一次明文；列表随后只显示脱敏值。重置会使旧值立即失效。模型凭证的 API Key 可以通过 复制 API Key 再次取得，因此使用方应把控制台访问权限纳入密钥治理。