智能体开发服务平台（AgentWorks）术语表
本页逐项解释智能体、能力、会话、渠道和 API 中的常用术语。需要了解它们如何配合使用，参见 智能体、插件和实例的关系。
智能体与能力
智能体模板
智能体模板保存可复用的智能体设计，包括模型、提示词、能力关联和运行配置。一个智能体模板可以用于创建多个智能体实例。
修改智能体模板不会自动更新已有智能体实例。需要让实例使用新配置时，请手动更新实例并重新验证运行结果。
任务标题中的“智能体”有时泛指要构建的对象；涉及选择、编辑或更新具体资源时，文档使用“智能体模板”指代这个可复用设计。更多内容请见 智能体、插件和实例的关系。
智能体实例
智能体实例是根据智能体模板创建的运行对象，可以通过网页版对话、调用 API、飞书或 QQ 使用。
每个智能体实例都引用一个智能体模板，但可以具有自己的运行参数、能力资源、访问凭证、状态和会话。部分渠道配置界面使用“应用实例”指代同一个对象。
智能体实例不等同于一次会话或一次调用任务。更多内容请见 从智能体到智能体实例。
主智能体
主智能体是在委托关系中接收原始请求、判断是否委托并组织最终回答的智能体实例。
“主智能体”表示实例在当前委托关系中的角色，不是另一种资源类型。
更多内容请见 理解主智能体和子代理的关系。
子代理
子代理是通过主智能体模板关联、以受委托角色执行专业任务的已有智能体实例。
添加子代理关联不会创建新实例；主智能体根据当前任务决定是否委托，子代理使用自己的模型、提示词和能力完成任务。
更多内容请见 了解子代理和动态委托。
插件配置
插件配置记录智能体模板与能力对象之间的关联，用于让智能体检索知识、调用工具、保存记忆、执行命令或委托子代理。
插件配置不是独立的运行资源。根据能力类型，它可以引用能力模板、已有能力实例、平台工具包、用户工具契约或已有智能体实例。
保存插件配置后，还需要创建或更新智能体实例，并通过实际任务和 Trace 确认能力已经生效。更多内容请见 为智能体添加能力。
能力模板
能力模板保存可重复使用的能力配置，并可以决定创建智能体实例时允许填写哪些参数。
智能体模板通过插件配置选择能力模板后，平台会在创建智能体实例时按照该模板准备或绑定运行所需的能力资源。能力模板适合统一基线、复用配置或按需准备资源的场景。
创建第一个智能体并不要求预先创建能力模板。更多内容请见 模板和实例如何影响资源。
能力实例
能力实例是智能体运行时实际使用的能力资源或连接，例如 MCP 连接、知识库组、记忆库、技能组或沙箱。
在插件配置中选择已有能力实例，会让智能体模板直接关联该资源。由同一智能体模板创建的多个智能体实例可能共享它；选择已有实例不会自动复制资源或隔离其中的数据、凭证和权限。
需要按统一配置为新智能体实例准备资源时，请改用能力模板。更多内容请见 模板和实例如何影响资源。
知识库组
知识库组把一个或多个知识库集合（Collection）及默认检索参数提供给智能体，用于检索已经完成入库的资料。
知识库组引用集合，不复制其中的资料；不同知识库组仍可引用同一个集合。
更多内容请见 配置知识库组模板和实例。
知识库集合（Collection）
知识库集合（Collection）保存资料入库后实际用于检索的向量数据。
文件、飞书文档、网页 URL 或 Sitemap 中的资料导入集合后，可以通过知识库组提供给智能体检索。
更多内容请见 创建集合并导入知识。
记忆库
记忆库保存可以在后续交互中检索的事实、偏好和上下文，让智能体在另一段会话中继续使用这些信息。
新建会话不会创建、清空或隔离记忆库；多个智能体实例连接同一个记忆库时，会使用同一份记忆。
更多内容请见 添加并验证记忆库。
MCP
MCP（Model Context Protocol，模型上下文协议）是一种连接智能体与外部工具、数据的协议。在 智能体开发服务平台（AgentWorks） 中，MCP 能力用于连接平台外运行的 MCP Server，让智能体发现并调用其中的工具。
MCP 实例保存实际使用的服务地址、超时、TLS 和请求头配置；工具由远程 MCP Server 执行。
更多内容请见 使用 MCP 实例连接外部工具。
Skill
Skill 是包含 SKILL.md 和相关文件的版本化工作说明包，为智能体提供完成任务的方法和资源。
智能体通过技能组按需加载 Skill；Skill 本身不是可直接执行的工具，调用服务、运行命令或执行脚本还需要相应的工具或沙箱。
更多内容请见 创建和维护可复用的 Skill。
技能组
技能组把一个或多个 Skill 组合起来，供智能体按当前任务选择和加载。
智能体模板可以关联已有技能组实例，也可以通过技能组模板为每个智能体实例生成独立技能组；加入技能组不表示每次请求都会激活其中全部 Skill。
更多内容请见 使用技能组为智能体提供一组 Skill。
沙箱
在智能体开发服务平台（AgentWorks）中，沙箱是与智能体实例关联的隔离运行环境，可向智能体提供命令、文件和代码执行工具。使用微应用还需要兼容环境与配套界面入口，不能仅凭选择沙箱就获得业务界面。
选择沙箱模板时，创建智能体实例会为该实例创建沙箱资源；选择现有沙箱实例时，会复用同一个资源。新建会话不会自动创建沙箱。选择方法参见 配置沙箱模板和实例。
平台工具包
平台工具包是 智能体开发服务平台（AgentWorks） 内置工具的选择入口，所选工具由 AgentWorks 执行，不需要另外部署 MCP Server 或由调用方执行并回传结果。
平台工具包与沙箱是独立配置，添加平台工具包不会创建或关联沙箱。
更多内容请见 使用平台工具包。
用户工具包
用户工具包让智能体调用业务应用提供的工具，由智能体模板保存工具定义，业务应用实现并执行对应操作。
智能体开发服务平台（AgentWorks） 通过中断返回工具名称和参数，你自己的应用校验请求、在自己的环境中执行工具并回传结果，智能体再继续处理任务。
更多内容请见 使用用户工具包让智能体调用你自己的业务能力。
会话与运行
API 会话
通过 API 调用时，平台按渠道身份和会话信息组织多轮对话。服务端返回的 context_key 对应事件中的 sid；每次输入的 msg_id 对应事件中的 mid。
会话和一次运行是不同对象。运行完成或取消不表示历史已删除，开始新会话也不会自动创建或清空记忆库和沙箱。
调用方应保存用户、业务会话和服务端标识的对应关系。更多内容请见 管理会话、运行和中断。
单次运行（调用任务）
单次运行（调用任务）是智能体实例处理一次输入的执行过程，同一段会话可以包含多次运行。
中断后回传响应是让尚未完成的任务继续处理，不表示新建会话；本轮结束不会自动结束整个会话、记忆库或沙箱。
更多内容请见 管理会话、运行和中断。
中断
中断表示智能体在运行过程中需要外部决定或工具结果才能继续，例如等待审批，或等待你自己的应用执行用户工具。
调用方提交决定或结果后，还要根据后续运行事件判断本轮是否结束；提交成功不等于任务完成。
更多内容请见 响应中断。
渠道与 API
渠道账号
渠道账号把飞书、QQ 或 WebSocket 等外部入口连接到 智能体开发服务平台（AgentWorks），并保存该入口所需的渠道配置和凭证。
渠道账号可以绑定一个已有智能体实例，让渠道用户共享该实例；也可以绑定智能体模板，让不同渠道用户通过 /init 按需创建专属智能体实例。
渠道账号不等同于渠道用户、用户绑定或渠道会话。更多内容请见 通过渠道提供智能体。
模板绑定
模板绑定是渠道账号关联智能体模板、为不同渠道用户按需创建专属智能体实例的绑定方式。
用户首次完成 /init 时，平台创建实例并保存用户绑定；实例分开不等于关联的数据、记忆和权限自动隔离。
更多内容请见 为每位用户按需开通实例。
实例绑定
实例绑定是渠道账号将消息发送到一个已有智能体实例的绑定方式，不会按渠道用户动态创建实例。
同一账号可以供一位或多位用户使用；不同渠道会话可以分开对话，但仍可能共用实例配置及其关联资源。
更多内容请见 使用已有智能体实例。
用户绑定
用户绑定记录一个渠道用户与一个专属智能体实例之间的对应关系。它只在渠道账号使用模板绑定、并为用户按需创建实例时产生。
后续消息根据用户绑定进入已经创建的智能体实例。删除用户绑定不会删除原智能体实例；用户重新执行 /init 后，平台可以创建实例并建立新的绑定。
用户绑定不等同于渠道会话，也不会单独证明记忆、业务数据或外部账号已经按用户隔离。更多内容请见 管理渠道账号与用户绑定。
智能体接入 Token
智能体开发服务平台（AgentWorks）的智能体调用 HTTP 请求与 WebSocket 握手使用 WebSocket Token。它绑定渠道账号，渠道账号再绑定智能体模板或实例。
Token 由调用方服务端保管，不能代替控制台登录身份，也不同于大语言模型的文本计量 Token。
创建步骤请见 为客户端创建 Token；更换或撤销凭证请见 分批轮换 WebSocket Token。
智能体调用接口（Bridge API）
Bridge API 是 智能体开发服务平台（AgentWorks） 提供给业务应用调用智能体的一组接口，包括 HTTP API 和 WebSocket API。应用通过 HTTP 发送消息、查询历史和回传工具结果，通过 WebSocket 订阅并接收智能体回复和运行事件。
平台技术文档也将这条接入通道称为 Bridge Channel。它不是额外的通信协议，也不包含控制台内部的资源管理接口。
接入方式和调用流程参见 API 接入概览。