#AI 接口技能使用指南

AI 接口技能用于将平台中已配置的目标接口导出为标准 Skill，再交由本地 Agent 执行。使用者无需反复关注请求地址、鉴权方式和返回结构，只需要完成导出并触发 Skill，Agent 就会按约定流程调用接口并整理结果。

#前置条件

• 已开通腾讯 QClaw 账号
• 已获取可用的 APIKey
• 已准备好 PIGX 服务地址
• 本地 Agent 已具备加载 Skill 的能力

#整体流程

flowchart LR
    A[PIGAI 平台选择目标接口] --> B[导出 Skill]
    B --> C[本地 Agent 加载并执行 Skill]
    C --> D[Agent 调用目标接口]
    D --> E[获取接口返回 JSON 结果]
    E --> F[Agent 输出最终 LLM 结果]

#调用原理

AI 接口技能的执行链路可以分为两个阶段：

• 平台侧封装：PIGAI 平台负责将已选中的目标接口能力导出为标准 Skill
• 本地侧执行：本地 Agent 负责加载 Skill，并在执行过程中调用目标接口获取结果

sequenceDiagram
    participant P as PIGAI 平台
    participant A as 本地 Agent
    participant I as 目标接口

    P->>A: 1. 选中接口后导出 Skill
    A->>A: 2. 加载并执行 Skill
    A->>I: 3. 调用目标接口
    I-->>A: 4. 返回接口结果
    A-->>A: 5. 整理并输出最终结果

#使用指南

这里以腾讯 QClaw 为例，访问地址：https://qclaw.qq.com/。

#第一步：开通 APIKey

进入个人中心，在 APIKEY 标签页中点击“创建 APIKey”，完成创建与管理。

AK 是当前登录用户的唯一凭据，代表当前用户身份。Agent 在执行接口技能时，会基于该凭据识别调用者，因此这一步必须优先完成。

建议将鉴权信息写入环境变量。该操作通常只需执行一次，后续 Agent 在调用接口技能时会自动读取这些变量完成鉴权。

export PIGX_APIKEY="xxxxx"
export PIGX_BASE_URL="http://172.37.0.33:38183"

#第二步：在平台中选择接口并导出 Skill

进入 PIGAI 平台对应的接口管理或技能导出页面，选中需要给 Agent 使用的目标接口，然后执行导出操作。

导出后的 Skill 通常会包含以下信息：

• 接口名称和用途说明
• 调用该接口所需的输入参数定义
• 请求地址、请求方式或调用约束
• 返回结果的解析和输出说明

#第三步：在本地 Agent 中执行 Skill

将导出的 Skill 加载到本地 Agent 环境后，Agent 会按照 SKILL.md 中的描述进入执行流程。对于使用者来说，这一步通常表现为调用某个 Skill，或者在对话中触发对应的技能能力。

可以直接将平台导出的 Skill 内容交给本地 Agent 创建并加载。

#第四步：调用执行并获取 LLM 结果

接口返回成功后，Agent 会根据 Skill 中的描述对结果进行整理，并输出最终内容。最终结果既可以是直接的接口返回信息，也可以是在接口结果基础上的总结、重组或进一步加工结果。