SuperAPI AI 工具集

tool-design

智能体与模型

查看项目

更新于 10-16 00:24

技能介绍

用途:为领域专用智能体设计与实现自定义工具,使智能体具备超出默认工具范围的专门能力。适合智能体需要额外能力、领域需要专门操作、构建聚焦高效的智能体,以及创建可复用工具库的场景。

前置条件:了解 @tool 装饰器语法,掌握 MCP 服务器创建,并清楚定义工具用途。

设计流程:一是定义工具用途,明确执行什么操作、需要什么输入、产生什么输出、智能体何时使用;二是设计接口,使用 @tool(name, description, params) 签名,名称用 snake_case、具描述性并按领域加前缀(如 db_query),描述需说明何时用、做什么及约束;三是定义参数,支持 str、int、float、bool 等类型,并区分必填(args["param"])与可选(args.get("param", 默认值));四是按模板实现逻辑,依次提取校验输入、执行操作、返回成功结果;五是加入错误处理,校验必填项、类型、取值范围与安全性,并统一使用 success_response 与 error_response 辅助函数;六是用 create_sdk_mcp_server 创建 MCP 服务器并注册工具;七是配置智能体,在 mcp_servers 中挂载服务器,用 allowed_tools 列出 mcp__域名__工具名,用 disallowed_tools 关闭不需要的默认工具。

工具类别涵盖数据处理(parse_json、transform_data、validate_schema)、领域操作(calculate_metric、lookup_reference、process_record)与集成(query_database、call_api、send_notification)。

限制与注意:自定义工具需使用 ClaudeSDKClient,而非 query();需完成命名、描述、参数类型、必填可选、输入校验、错误处理、安全检查与返回格式一致性等设计检查。版本 v1.0.0(2025-12-26)。具体收费与平台支持等未提供。