配置字段参考

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

智能体模板配置

智能体模板字段按基本信息、模型、压缩、审批处理、渠道和插件配置分组。

分组	字段	说明
基本信息	模板名称、描述	可复用智能体模板的标识
模型配置	模型凭证、模型	必填
模型配置	温度	输出随机性
模型配置	启用思考	请求模型思考能力
模型配置	存在惩罚、频率惩罚	调整内容引入和重复倾向
模型配置	最大生成长度、最大上下文长度	当前模型只读上限
模型配置	系统提示词	基础指令，可按表单标记为实例可配置
压缩配置	启用压缩、压缩模型	长会话上下文压缩
压缩配置	压缩模型最大长度、压缩阈值、保留阈值、压缩温度	压缩行为
工具权限	工具名称、参数名、匹配正则 (RE2 语法)	模板级审批处理规则，只处理已经进入审批流程的确认型工具调用
渠道配置	飞书、QQ 参数	可选择模板绑定或实例绑定
插件配置	模板、实例、工具包、子代理	智能体模板可用能力

插件配置

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

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

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

控制台中的 工具权限 是模板级审批处理规则，不是让工具调用进入审批流程的开关。同一组模板规则先检查拒绝规则，再检查允许规则；对于已经建立用户绑定的渠道调用，模板未匹配时再检查用户绑定中的补充规则，仍未匹配时进入人工审批。工具名称来自可调用名称，参数名来自输入 schema 顶层 properties，匹配正则由用户根据审批策略编写。只有同时填写参数名和匹配正则时，规则才会按参数值缩小范围。参见找到工具名称和参数名和配置工具审批流程。

压缩模型与主模型共用当前模型凭证。压缩模型最大长度 与 压缩阈值 共同控制触发时机；最大长度应不高于主模型和压缩模型中较小的可用上下文，并为系统提示词、工具、记忆检索、多模态输入和模型输出保留余量。建议从默认值开始，通过固定的长会话测试逐项调整。配置和验证方法参见配置模型、提示词与上下文压缩。

智能体实例配置

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

• 智能体模板：实例来源智能体模板。
• 实例名称：运行对象名称。
• 描述：可选用途说明。
• 模型参数：仅显示智能体模板开放的值。
• 渠道参数：仅显示智能体模板开放的值。
• 插件参数：仅显示能力模板开放的值。

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

MCP 配置

模板和实例支持：

• 名称和描述。
• Server URL。
• Streamable HTTP。
• 模板的 超时时间:，以及实例的 超时（秒）；实例中 0 表示使用平台默认值。
• 跳过 TLS 校验。
• Headers。

警告

生产环境应保持 TLS 校验开启。仅在隔离测试环境排查自签名证书时临时跳过，并在配置受信任证书后重新开启。跳过校验可能导致连接凭证和传输数据被截获。

模板还可以把 URL 路径参数和 Headers 标记为 可配置，供智能体实例填写。

知识库组配置

知识库集合保存已入库内容，知识库组模板和实例决定检索时使用的集合与默认参数。

知识库集合

可以配置以下字段：

• 名称
• 说明
• 向量维度
• chunk_overlap
• distance

知识库组模板

可以配置以下字段：

• 名称 *
• 描述
• 默认检索条数（top_k）
• 默认知识库集合 *

知识库组实例

可以配置以下字段：

• 名称
• 说明
• 模板
• 默认检索条数（top_k）
• 知识库集合 *

知识库组模板至少选择一个已注册集合，top_k 范围为 1 到 100。

记忆配置

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

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

交互模式	目标运行方式
TOOL	通过记忆工具保存和检索
AUTO_EXTRACT_AND_INSERT	自动提取，并在后续交互中自动提供相关记忆
AUTO_EXTRACT_AND_TOOL	自动提取，通过记忆工具检索

首次验证建议选择 TOOL，通过 Trace 检查记忆工具调用，并完成写入、新会话检索、纠错和删除。自动方式还需要在预发布智能体实例中验证自动写入和检索结果。模式名称不能代替运行验证。

手动新增记忆时显示的 infer 只控制这次新增操作是否先从输入中提取记忆，不会改变智能体模板的交互模式。输入已经是一条完整事实时，可以取消选择 infer 并直接保存。多个智能体实例连接同一个现有记忆库时，会使用同一份记忆数据；需要保存用户私有信息时，应使用独立记忆库。验证方法参见使用和管理记忆库。

Skill 和技能组配置

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

技能组模板和实例可以选择多个 Skill 及版本。选择 latest 会动态跟随最新版本；选择具体版本号会固定使用该版本。

技能组把所选 Skill 的名称、描述和版本提供给智能体实例。运行时可以激活匹配的 Skill，并按相对路径读取该版本的相关资源。资源读取只返回内容；即使智能体模板同时关联技能组和沙箱，也不会自动把 Skill 文件放入沙箱、执行脚本、安装依赖或注册工具。

沙箱用户配置

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

• 名称和 描述：用于标识模板或实例。
• 沙箱模板启动类型：选择 Docker 容器或 Virtual Machine 隔离环境。
• 资源规格：选择管理员开放的规格。
• 环境配置：选择管理员开放的环境。
• 环境变量：可以在模板中标记为 可配置。
• 工具审批配置：决定沙箱工具调用是否进入审批流程。关闭后，模板规则和用户规则不参与审批处理。

沙箱管理员配置

警告

仅限 AgentWorks 管理控制台

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

沙箱规格管理 公开：

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

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

渠道账号配置

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

飞书和 QQ：

• 绑定模式，以及 实例绑定（agent_id 指向应用实例） 或 模板绑定（agent_id 指向 Agent 模板，用户需 /init）。其中，“应用实例”就是智能体实例，即基于智能体模板创建的运行实例。
• 应用 ID（凭证）和应用密钥。
• 禁用单聊；启用后优先于单聊允许名单。
• 单聊允许的发送者 ID。
• 飞书的 群聊允许的群 ID、禁用群聊和展示工具调用详情。
• QQ 只支持单聊，因此启用禁用单聊会阻止该账号接收其唯一支持的消息模式。

WebSocket：

• 绑定模式，以及 绑定 Agent 实例（默认） 或 绑定 Agent 模板。
• 在 绑定对象 中选择目标智能体模板或智能体实例。
• 创建渠道账号时可选择 同步创建 Token（可一次创建多个）。
• Token 名称和有效期；同一账号内同步创建的名称必须唯一。
• 后续 WebSocket Token 绑定渠道账号，不直接绑定智能体模板或智能体实例。
• 一个智能体实例或智能体模板只能绑定一个尚未删除的 WebSocket 渠道账号；停用账号不会释放绑定目标。
• 对账号选择 停用会停用其所有 WebSocket Token；重新选择 启用不会自动启用这些 Token。

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

API 调用配置

智能体实例提供：

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

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

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

凭证管理配置

凭证管理 提供三个页签：

页签	创建字段	列表中的绑定字段	生命周期操作
模型凭证	凭证名称、API Key、默认模型	不适用	编辑名称和默认模型、测试连通性、复制 API Key、删除；API Key 不可编辑
Agent API Token	Token 名称、绑定 Agent 实例、有效期	绑定 Agent 实例	启用、停用、重置、删除
WebSocket Token	Token 名称、绑定 WebSocket 渠道账号、有效期	绑定 WebSocket 渠道账号	启用、停用、重置、删除

名称的唯一范围如下：

• 模型凭证名称在当前租户内不能重复。
• Agent API Token 名称在同一个智能体实例内不能重复。
• WebSocket Token 名称在同一个渠道账号内不能重复。

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