SuperAPI AI 工具集

tool-design

设计与创作

查看项目

更新于 10-16 01:31

技能介绍

用途:该技能面向智能体系统的工具接口层,单元是一单个工具或一份工具目录。它把每个工具视为确定性系统与非确定性智能体之间的契约:智能体只能依据描述推断意图并生成调用,因此描述必须消除歧义。项目形态、流水线架构、任务匹配与成本属于项目开发范畴;是否引入子智能体属于多智能体模式;轨迹层面的输出减重属于上下文优化,均不在本技能范围。

主要能力:围绕整合原则设计工具——若人类工程师都无法确定某场景该用哪个工具,智能体同样无法做到;应减少工具数量,使每个工具只有一个明确用途。工具描述被视为提示工程,需回答做什么、何时使用、返回什么。支持命名空间与组织(如 db_、web_)、参数默认值选择、响应格式优化(简洁与详细)、错误信息设计(说明问题并提供修正指引)、统一 schema(动词-名词命名、参数命名一致),以及 MCP 全限定命名格式 ServerName:tool_name。还涉及架构精简:以单一命令执行工具配合 Unix 工具(grep、cat、find、ls)的文件系统智能体模式替代定制工具,并讨论何时整合、何时不宜整合。

使用方式与适用场景:在撰写新工具描述、schema 或响应格式,排查智能体选错工具或生成畸形调用,合并重叠工具目录,设计可自纠错的错误信息,统一命名,评估第三方工具是否值得加入时启用。可用“工具测试智能体”模式把观察到的失败反馈给智能体以改进描述。

限制:不得在项目是否使用 LLM、流水线阶段、子智能体拆分、轨迹级输出压缩等相邻工作启用本技能。资料未提供具体价格、版本或平台支持信息。