SuperAPI AI 工具集

anth-core-workflow-a

办公与效率

查看项目

更新于 10-15 22:42

技能介绍

用途:实现 Claude 的工具调用(函数调用)能力,让模型调用你定义的函数。Claude 返回带结构化 JSON 输入的 tool_use 内容块,你的代码执行函数并返回 tool_result 块,这是构建 AI 智能体的基础。

前提:完成 anth-install-auth 设置;理解 Messages API 请求/响应循环;准备好希望 Claude 调用的函数或 API。

主要步骤:一是定义工具,使用 anthropic 客户端创建 tools 列表,每个工具含 name、description 和基于 JSON Schema 的 input_schema;二是发送带工具的请求,调用 client.messages.create 并传入 model、max_tokens、tools 与 messages,响应 stop_reason 为 tool_use,内容块同时包含 text 与 tool_use;三是执行工具并回传结果,遍历 tool_use 块执行对应实现,构造 tool_result 时 tool_use_id 必须与 block.id 完全一致,再以 assistant 内容加 tool_result 用户消息继续对话;四是智能体循环,用 max_turns 限制轮次,当 stop_reason 为 end_turn 时返回最终文本,否则追加 assistant 内容与工具结果消息继续调用。

输出:带 JSON Schema 输入校验的工具定义、处理顺序调用的智能体循环、正确的 tool_use 与 tool_result 消息串联。

错误处理:工具 schema 无效时按 JSON Schema 规范校验;tool_use_id 不匹配时精确复制 block.id;Claude 忽略工具通常是 description 过于模糊,可增加清晰的“Use when...”描述;死循环可通过 max_turns 上限与 tool_choice auto 控制。

tool_choice 选项:默认 auto 由 Claude 决定;tool 可强制使用指定工具;any 强制至少调用一个工具。

限制:需先完成授权设置并具备可调用的函数或 API;示例模型与具体实现需按实际环境调整。