SuperAPI AI 工具集

tool-specification

编程与开发

查看项目

更新于 10-16 09:57

技能介绍

用途:为 AI agent 设计工具集与调用规范,包括定义工具接口、权限控制、发现与分组、并行调度和子代理委托架构;不用于纯对话场景、API 后端实现或用工具设计替代安全规则。

主要能力:一是定义格式选择,可选 JSON Schema、XML(如 xai:function_call)、TypeScript 类型;二是三层权限门控,将操作分为 Prohibited(自动拒绝)、Explicit Permission(需用户确认)、Regular(自动执行);三是发现与分组,工具少于 10 个可全量列举,10 至 25 个按命名空间分组,超过 25 个实现延迟加载;四是并行执行与子代理委托,识别可并行调用并设计委托协议;五是生命周期管理,覆盖发现、参数构造、权限检查、执行、结果解析与错误恢复。

使用方式:先按场景选格式并编写含名称、描述、参数与返回值的接口定义;再对每个操作做三层权限分类并经安全评审;随后按数量设计分组或延迟加载,目标是在两轮对话内找到并调用正确工具;再识别可并行调用并定义子代理任务描述、结果返回与错误处理;最后为各阶段定义失败降级策略与最大重试次数。

适用场景:设计 AI agent 工具集、定义 function calling schema、工具过多导致调用出错、部分操作需用户确认、需要子代理并行处理复杂任务。

限制:与安全约束类技能互补但不重叠,权限门控管操作层面、内容层面约束不在本技能范围;工具少于 5 个且无风险时无需复杂设计。常见失败包括描述歧义、权限层级过度简化、忽略发现成本、子代理信息孤岛和缺少错误恢复。具体收费与更多落地细节暂未提供。