API 调用配置

让AI调用任何API —— 天气、股票、翻译随你接

API 集成外部服务进阶能力

这个 Skill 干嘛用的？

Web Search 让 AI 能搜网页，而 API Call 让 AI 能直接对话各种在线服务。

天气预报、股票行情、翻译接口、GitHub 仓库信息 —— 只要有 API 的服务，都可以让 AI 直接调用。不用你当中间人来回复制粘贴了。

配好之后你说一句「查下北京今天天气」，AI 就直接调天气 API 拿到结果告诉你。

没有 API 调用是什么体验

你问 AI「帮我查一下这个 GitHub 仓库的 star 数」，它说「我无法访问外部服务」。你想让 AI 帮你翻译一段话然后发到 Slack，它说「请你手动操作」。来回当传话筒 —— 问 AI 要结果，AI 让你去查，查完再告诉 AI，AI 再帮你整理。累不累？

模板一：REST API 通用配置

一个万金油模板，能对接大部分 REST API。改改 URL 和参数就能用。

REST API 通用配置 · Skill 模板 SKILL

## SKILL: REST API 通用调用

### 功能描述
通用的 HTTP API 调用能力，支持 GET/POST/PUT/DELETE 等标准方法。

### 支持的认证方式
- API Key（Header / Query Parameter）
- Bearer Token
- Basic Auth
- OAuth 2.0（需预先配置 token）

### 请求配置
- 自动设置 Content-Type
- 支持 JSON / Form-Data / Multipart 请求体
- 超时控制和重试机制
- 响应自动解析（JSON / XML / 纯文本）

### 安全规则
- API Key 从环境变量读取，不硬编码
- 请求日志脱敏（不记录 token 和密码）
- 限制请求频率（默认每分钟 30 次）

模板二：天气查询 API

最经典的 API 调用场景。问一句「明天北京冷不冷」，AI 直接给你答案。

天气查询 API · Skill 模板 SKILL

## SKILL: 天气查询

### 功能描述
调用天气 API 获取实时天气和未来预报。

### API 配置
- 服务商: OpenWeatherMap（免费额度够用）
- 端点: https://api.openweathermap.org/data/2.5/
- 认证: API Key via query parameter

### 触发条件
- 用户提到天气、气温、下雨、穿什么
- 用户规划出行或户外活动

### 输出格式
- 当前天气：温度、体感温度、天气状况、湿度、风速
- 未来预报：简要概括未来 3 天趋势
- 穿衣建议：根据温度给一句建议（非必须）

### 配置变量
- WEATHER_API_KEY: 你的 OpenWeatherMap API Key
- DEFAULT_CITY: 默认查询城市（用户没指定时使用）
- UNITS: metric（摄氏度）/ imperial（华氏度）

模板三：GitHub API 集成

开发者福利 —— 让 AI 帮你查仓库信息、看 issue、监控 PR，不用切出对话窗口。

GitHub API 集成 · Skill 模板 SKILL

## SKILL: GitHub API

### 功能描述
对接 GitHub REST API，获取仓库、Issue、PR 等信息。

### 支持的操作
- 仓库信息：star 数、fork 数、最近更新、语言分布
- Issue 管理：列出 open issues、搜索特定 issue
- PR 状态：查看 PR 列表、review 状态、CI 结果
- Release 追踪：最新版本、changelog 摘要

### 触发条件
- 用户提到 GitHub 仓库链接
- 用户问某个项目的状态、版本、issue

### 输出格式
- 仓库概况用表格展示核心指标
- Issue/PR 列表按优先级排序，显示标题和状态
- Release 信息附 changelog 摘要和下载链接

### 配置变量
- GITHUB_TOKEN: Personal Access Token（权限按需配置）
- DEFAULT_ORG: 默认组织名（可选）

skill_config 配置参考

API 调用的通用配置模板。重点看认证和安全相关的部分：

API 调用 skill_config

skill_config:
  name: "api-call"
  description: "外部 API 调用能力"
  version: "1.0"

  triggers:
    - pattern: "查天气|天气预报|气温"
      action: "call_weather_api"
    - pattern: "GitHub|仓库|repo|star"
      action: "call_github_api"
    - pattern: "调用API|请求接口"
      action: "call_custom_api"

  settings:
    timeout: 20                  # 请求超时（秒）
    retry: 3
    rate_limit: 30               # 每分钟最大请求数
    log_requests: true           # 记录请求日志
    redact_secrets: true         # 日志中脱敏处理

  auth:
    weather:
      type: "api_key"
      key: "${WEATHER_API_KEY}"  # 从环境变量读取
      location: "query"          # query / header
    github:
      type: "bearer"
      token: "${GITHUB_TOKEN}"

  permissions:
    - internet_access
    - env_read                   # 读取环境变量

  error_handling:
    on_401: "提示用户检查 API Key"
    on_429: "等待后重试，通知用户限流"
    on_timeout: "报告超时，建议稍后重试"

🔑 强烈建议用环境变量存 API Key，不要直接写在配置文件里。把 Key 写死在配置中，一不小心提交到 Git 就泄露了。用 ${VARIABLE_NAME} 语法引用环境变量，安全又方便。

API 调用配置

这个 Skill 干嘛用的？

模板一：REST API 通用配置

模板二：天气查询 API

模板三：GitHub API 集成

skill_config 配置参考

相关资源