SuperAPI AI 工具集

dynamic-api-integration

编程与开发

查看项目

更新于 10-16 02:36

技能介绍

用途:让智能体在运行时动态发现、解析并调用此前未使用过的外部 HTTP REST API,适配自 UTCP(通用工具调用协议)模式,以 Node.js / Claude Code 工具方式使用。属于认知/提示驱动型技能,无独立脚本,需在智能体上下文中调用。

主要能力:五阶段工作流——发现(抓取并解析 OpenAPI/Swagger 规范,或手工定义工具模板)、匹配(将用户意图语义映射到端点)、构造(拼装方法、路径、参数、请求头、请求体与鉴权)、执行(用 Bash curl 或 WebFetch 调用并捕获响应)、链式调用(任务未完成则再分析再调用,受 max_iterations 限制)。工具模板支持 name、description、base_url、method、content_type、auth(api_key/bearer/basic/none)、parameters、response_hint 等字段。

使用方式:优先抓取规范(如 /openapi.json、/swagger.json、/v3/api-docs、/.well-known/openapi.json);无规范时手工写工具模板。用 curl 获取原始 JSON 与状态码,需要 AI 摘要或处理 HTML 时用 WebFetch。鉴权示例:curl -H "X-Api-Key: $API_KEY"、-H "Authorization: Bearer $AUTH_TOKEN"、-u "$USERNAME:$PASSWORD"。

适用场景:调用陌生 REST API、从规范中发现端点、多步链式调用(搜索→取详情→过滤)、带鉴权与参数的请求构造。

限制:不适用于已封装为 MCP 工具、一次性硬编码调用、需 OAuth 2.0 授权码交互式重定向、以及 WebSocket 或纯流式协议。铁律:密钥只用环境变量或密钥管理器;先查规范再写集成;列表响应必须处理分页;对 429/503 等瞬时错误用指数退避重试;使用前校验响应结构。大响应需截断或抽取字段以控制上下文。具体收费、价格与平台支持暂未提供。