在智能体中使用技能

Documentation Index

Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt

Use this file to discover all available pages before exploring further.

智能体通过 Skills Middleware 使用技能。该中间件会让模型知道有哪些技能可用，把选中的技能文件同步到运行时沙箱，并提供读取完整技能指令的能力。

​

创建智能体时启用技能

创建空白智能体时，向导可以展示当前工作区中已安装的技能。 启用流程：

1. 打开空白智能体创建向导。
2. 选择目标工作区。
3. 进入技能步骤。
4. 勾选该智能体需要使用的技能。
5. 完成创建。

当选择了技能后，Xpert 会自动把 Skills Middleware 接入主智能体流程。

​

配置 Skills Middleware

在 Agent Studio 中，Skills Middleware 支持配置：

• 默认技能：当调用方没有传入明确的运行时选择时，默认加载这些技能。
• 系统提示：可选的自定义提示，会追加到默认技能提示之前。
• 自动发现技能：允许智能体在运行时搜索索引仓库，并安装相关技能。

Skills Middleware 建议配合 File 工具集使用，因为智能体需要读取 SKILL.md 和相关资源文件。

​

运行时技能选择

ChatKit 可以在输入框中展示运行时技能，让用户为某次会话或下一条消息选择需要加载的技能。 运行时相关状态包括：

• selectedSkillIds：本次运行明确选择的技能 ID。
• disabledSkillIds：本次运行禁用的技能 ID。
• selectedSkillWorkspaceId：技能所在工作区。

当运行时传入明确的 allow-list 时，本次运行会使用用户选择的技能列表，而不是继续使用中间件默认技能。空列表也有意义：表示本次运行不加载用户可选技能，但必需的系统中间件仍会保留。

​

智能体如何使用技能

技能采用渐进披露模式。

1. Skills Middleware 将可用技能的简要信息加入系统上下文。
2. 智能体判断当前任务是否匹配某个技能。
3. 智能体使用 read_skill_file 读取相关 SKILL.md。
4. 智能体按照完整指令执行，并按需读取辅助文件。

这样既能保持默认上下文简洁，又能在任务需要时加载详细流程。

​

自动发现技能

启用自动发现后，如果已安装技能不足以完成用户任务，智能体可以搜索已索引的技能仓库。 运行时可以：

• 根据查询搜索技能仓库索引
• 将少量最相关技能安装到当前工作区
• 把新安装技能同步到沙箱
• 读取对应 SKILL.md 后继续执行

自动发现默认关闭，以避免改变已有智能体行为。

​

技能命令

技能可以通过 metadata 暴露 ChatKit slash command。这些命令可以和工作区 Prompt Workflow、宿主命令一起出现在命令面板中。智能体命令配置可以为特定智能体启用、禁用或调整技能命令优先级。