核心功能: 本技能提供结构化的工作流程和配置指引等能力。

能力扩展工具免费版

概述

能力扩展工具免费版为个人用户的 AI Agent 提供访问训练数据之外的结构化知识能力。通过配置访问令牌,Agent 可以向知识服务发送请求,获取最新的技术文档、API 规范、领域知识等结构化数据,从而突破训练数据的时效性限制. 免费版聚焦单次查询场景,配置简单,适合个人开发者扩展 Agent 的知识边界.

核心能力

1. 外部知识检索

Agent 向知识服务发送查询请求,获取结构化数据:

输入格式

用户提问 → Agent 识别知识缺口 → 发送查询请求 → 获取结构化数据 → 整合到回答中

处理: 解析外部知识检索的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回外部知识检索的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

2. 无状态架构

处理: 解析无状态架构的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回无状态架构的响应数据,包含状态码、结果和日志.

3. 加密传输

所有请求在传输过程中加密,确保数据安全:

Agent → [加密通道] → 知识服务 → [加密通道] → Agent

处理: 解析加密传输的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回加密传输的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

4. 令牌授权

通过环境变量配置访问令牌,授权 Agent 访问外部知识库:

# 配置访问令牌
export KNOWLEDGE_TOKEN="your-access-token"

处理: 解析令牌授权的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回令牌授权的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：代理提供训练数据、之外的外部知识检、索能力、扩展问题解决边界、面向个人用户的能、力扩展工具、能够访问训练数据、之外的结构化知识、核心能力、外部知识库查询与、结构化数据获取、单次查询、实时返回结果、上下文处理即丢弃、数据不存储不训练等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

使用场景

场景一: 查询最新技术文档

Agent 需要回答关于最新框架版本的问题,但训练数据中没有覆盖.

# 触发外部知识查询
请查询 React 19 的并发渲染特性,我的训练数据可能不包含最新版本信息

查询流程:

1. Agent 识别知识缺口: React 19 是训练截止后的版本
2. 发送查询请求: "React 19 concurrent rendering features"
3. 获取结构化数据: 特性列表、API 变更、迁移指南
4. 整合到回答中: 基于返回数据给出准确回答

场景二: 获取领域专业知识

处理特定领域问题时,获取专业领域知识辅助决策.

# 查询领域知识
请查询关于 OAuth 2.1 与 OAuth 2.0 的主要差异
我需要准确的标准规范信息

场景三: 扩展知识边界

当 Agent 回答"我不确定"时,主动查询外部知识补充.

# 补充知识
你刚才说不确定 WebSocket 心跳机制的最新优秀实践
请查询最新的 WebSocket 心跳实现规范

不适用场景

以下场景能力扩展工具免费版不适合处理：

• 需要100%确定性的关键决策
• 医疗诊断
• 法律判决

触发条件

需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于非本工具能力范围的需求.

快速开始

领先步: 获取访问令牌

注册知识服务账户,获取访问令牌.

第二步: 配置环境变量

# 在 shell 配置文件中添加
export KNOWLEDGE_TOKEN="your-access-token"
# ...
# 验证配置
echo $KNOWLEDGE_TOKEN

第三步: 在 Agent 中使用

# 直接在对话中触发
请使用外部知识查询: GraphQL 订阅与 WebSocket 的区别
# ...
# 或在任务中自动触发
请帮我实现 SSE 推送,如果训练数据不够新,请查询最新规范

第四步: 查看结果

Agent 会整合外部知识与自身能力,给出更准确的回答:

查询完成: 已获取 GraphQL 订阅相关规范
# ...
回答:
GraphQL 订阅基于 WebSocket 协议,与普通 WebSocket 的区别在于:
1. 使用 GraphQL 查询语言定义数据结构
2. 服务端按订阅条件推送更新
3. [来源: 外部知识查询]

场景四: 补充过时信息

当发现自身知识可能过时时,主动查询补充.

# 发现知识可能过时
你之前提到的 Docker 部署方式可能已经过时
请查询最新的 Docker 容器部署优秀实践
# ...
# 查询后更新回答
查询完成: 已获取最新 Docker 部署规范
# ...
更新回答:
最新推荐的 Docker 部署方式:
1. 使用多阶段构建减小镜像体积
2. 使用 .dockerignore 排除不必要文件
3. 使用非 root 用户运行容器
4. [来源: 外部知识查询, 获取时间: 2026-07]

示例

基础配置

# 必需配置
export KNOWLEDGE_TOKEN="your-access-token"
# ...
# 可选配置
export KNOWLEDGE_ENDPOINT="https://knowledge-service.example.com/api"
export KNOWLEDGE_TIMEOUT="30"
export KNOWLEDGE_MAX_RESULTS="5"

配置项说明

优秀实践

1. 识别知识缺口

Agent 应主动识别自身知识边界,在以下情况触发外部查询:

2. 查询后验证

获取外部知识后,Agent 应:

1. 标注信息来源: [来源: 外部知识查询]
2. 与已有知识交叉验证
3. 明确哪些是查到的、哪些是推断的
4. 对不确定的部分保持透明

3. 高效查询

# 好的查询(具体明确)
请查询: Python 3.12 类型系统的新特性,特别是类型参数语法
# ...
# 不好的查询(过于宽泛)
请查询: Python 相关信息

常见问题

已知限制

免费版有每日查询次数限制,适合个人日常使用。高频查询场景请使用 PRO 版.

Q2: 查询的数据会被存储吗?

不会。采用无状态架构,上下文处理完成后立即丢弃,不存储也不用于训练.

Q3: 网络不通时怎么办?

网络不可用时,Agent 会回退到使用自身训练数据回答,并注明可能不是最新信息.

Q4: 令牌过期了怎么办?

重新登录知识服务获取新令牌,更新环境变量即可.

Q5: 支持哪些类型的知识查询?

支持技术文档、API 规范、领域知识、标准规范等结构化知识查询.

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

• Agent 平台: 支持读取 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统: Windows / macOS / Linux
• 网络: 需要访问知识服务端点

依赖详情

API Key 配置

# 必需: 知识服务访问令牌
export KNOWLEDGE_TOKEN="your-access-token"
# ...
# 可选: 自定义服务端点

可用性分类

• 分类: MD+EXEC+API(Markdown 指令 + 命令行执行 + 外部 API 调用)
• 说明: 通过自然语言指令驱动 Agent 查询外部知识服务
• 离线可用: 否,查询需要网络连接知识服务

错误处理

输出格式

{
  "success": true,
  "data": {
    "result": "能力扩展工具免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "cheat code"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}