跳转到主要内容

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.

让用户为当前会话或下一次请求选择需要启用的技能、插件和中间件。
ChatKit 可以把 Xpert 的可选运行时能力展示在 composer 中，让用户决定什么时候加载某个技能、插件中间件或子智能体，而不是每一次请求都默认启用全部能力。 这样可以减少默认上下文、表达更明确的用户意图，也能更好地控制成本较高或影响较大的能力。

​
核心概念

​
技能

技能是通过 Xpert Skills Middleware 暴露出来的可复用能力包。一个技能可以提供领域指令、prompt workflow、工具或任务专用行为。 技能可以分为：
  • 默认技能：assistant 加载后默认勾选
  • 可选技能：用户选择后才会加载
当 ChatKit 发送明确的运行时 allow-list 时，本次请求会以用户选中的 skill IDs 为准，而不是继续使用 middleware 的默认技能集合。

​
插件和中间件

插件是可选的工作流 middleware 节点。在产品文案中也可以称为插件中间件。ChatKit 使用 middleware node key 来识别插件，因此即使多个节点来自同一个 provider，也可以分别控制。 必须执行的能力应该配置为 required 或 system middleware，并对终端用户隐藏。它会始终跟随后端工作流执行，不出现在 ChatKit 选择器中。

​
Composer 体验

当 assistant 暴露运行时能力后，ChatKit 会在 composer 的 + 菜单中显示能力面板：
  • 技能
  • 插件
  • 子智能体，如果当前 assistant 提供
用户可以在这些面板中启用或关闭能力。当前会话的选择会在用户回到 thread 时恢复。 用户也可以输入 / 打开 slash palette 并直接搜索能力。选择技能、插件或子智能体后，composer 中会插入一个不可拆分的 token。这个 token 只影响下一次发送，请求发出后会自动清除。

​
请求行为

ChatKit 会把用户选择的能力作为运行时 allow-list 发送： 
await chatkit.sendUserMessage({
  text: '审查 build pipeline，并检查部署风险。',
  runtimeCapabilities: {
    mode: 'allowlist',
    skills: {
      workspaceId: 'workspace_123',
      ids: ['skill_code_review'],
    },
    plugins: {
      nodeKeys: ['Middleware_sandbox'],
    },
  },
});
这个 allow-list 会同时写入提交的 input 和 state.human，后端工作流可以从任意位置读取同一份选择。 空 allow-list 也是有意义的：它表示本次请求不加载任何用户可选技能和插件，但仍然保留 required/system middleware。

​
产品建议

当某项能力需要用户有意识地选择时，适合把它暴露为运行时能力。常见例子包括：
  • 代码审查或仓库分析技能
  • 文档搜索和检索插件
  • 浏览器、沙箱或文件系统 middleware
  • 工单、CRM 或工作流集成
  • 用于 review、research、planning 或 QA 的专用子智能体
建议使用简短名称、清晰描述，并尽量提供图标。始终必须执行的能力应放入 system middleware，而不是让用户手动选择。 如果运行时能力接口不可用，ChatKit 会隐藏选择器，并继续使用兼容的 assistant 默认行为。