新闻详情

新闻详情

首页 / 资讯中心 / 详情

AI Agent Skill Day 3:Tool Use技能:工具使用能力的封装与集成

发布时间:2026/11/19 1:40:16来源:尧图网络
AI Agent Skill Day 3:Tool Use技能:工具使用能力的封装与集成
1. 为什么你的 Agent 总是“只会聊天不会干活”很多人第一次搭 AI Agent都会遇到同一个尴尬模型能跟你聊得头头是道但一旦让它“查一下明天上海天气”“把 100 美元换成人民币”它就开始编。不是它笨而是它手里没有工具。大模型的知识停在训练截止那一刻实时数据、私有接口、数据库、计算器它一个都碰不到。Tool Use工具使用要解决的就是这件事。你可以把它理解成给模型配了一双手模型负责“想”工具负责“做”。Function Calling 是这套机制里的“调用约定”LangChain 是帮你把约定封装成可复用对象的“装配线”而 MCP 协议则是让工具能跨平台共享的“通用插座”。三者叠起来Agent 才真正从聊天框走进业务流。这篇是 AI Agent Skill 系列 Day 3聚焦 Tool Use 的落地。我会带你走完一条完整链路定义工具描述、写参数 Schema、封装调用回环、接上模型、跑一次端到端验证最后把常见报错一个个拆掉。适合已经写过简单 LangChain Demo、但工具一多就乱、调用一回就崩的开发者。读完你手里会有一套可复制的工具注册骨架而不是又一篇“概念科普”。2. 前置准备把模型接入层先搭稳工具调用对模型的要求比普通对话高它必须支持 Function Calling / Tool Use 协议否则你传过去的 tools 参数会被直接忽略。所以第一步不是写工具而是先把模型接入层跑通。我习惯用 TaoToken 做统一接入层原因是它同时兼容 OpenAI 风格的 function calling 和 Claude 的 tool_use 格式切换模型时不用重写工具定义。你只需要在控制台拿到 API Key然后把 base_url 指过去即可。整个流程不涉及任何网络环境改造就是标准的 HTTPS 调用。具体操作路径是这样的先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号进入控制台后创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。拿到 Key 之后接口基址用 https://taotoken.net/api 注意这个地址不带任何查询参数直接作为 OpenAI SDK 的 base_url 使用。如果你只是想先验证模型能不能正确识别工具描述可以打开模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 手动贴一段工具 Schema 试试。但真正要跑回环还是得写代码。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各语言 SDK 的 base_url 配置示例照着改一行就行。注意API Key 只显示一次创建后立刻复制到 .env 文件不要硬编码进源码更不要提交到 Git。3. 可复制配置工具描述、参数 Schema 与调用回环这一节是全文的核心。我会先给出一套最小可运行的工具封装骨架再解释每个字段为什么这么写。你直接复制就能跑改掉业务逻辑即可复用。3.1 环境依赖与目录结构先装依赖Python 3.9 以上pip install langchain-core langchain-openai requests python-dotenv jsonschema目录建议这样分工具多了也不会乱agent_tool_demo/ ├── .env ├── tools/ │ ├── __init__.py │ ├── base.py │ ├── weather.py │ └── currency.py └── run_agent.py.env 里放两样东西OPENAI_API_KEY你的TaoTokenKey OPENAI_BASE_URLhttps://taotoken.net/api3.2 工具抽象基类统一输入输出工具一多最怕的就是每个工具返回格式不一样模型看不懂。所以先定一个基类强制所有工具走同一套run()入口内部做校验和异常兜底。# tools/base.py from abc import ABC, abstractmethod from typing import Any, Dict import jsonschema class BaseTool(ABC): name: str description: str parameters: Dict[str, Any] {} abstractmethod def _run(self, **kwargs) - Dict[str, Any]: 真正的业务逻辑子类实现 raise NotImplementedError def run(self, input_data: Dict[str, Any]) - Dict[str, Any]: 统一入口先校验参数再执行异常不抛出 try: jsonschema.validate(instanceinput_data, schemaself.parameters) except jsonschema.ValidationError as e: return {success: False, error: f参数校验失败: {e.message}} try: data self._run(**input_data) return {success: True, data: data} except Exception as e: return {success: False, error: str(e)} def to_openai_schema(self) - Dict[str, Any]: 转成 OpenAI function calling 需要的格式 return { type: function, function: { name: self.name, description: self.description, parameters: self.parameters, }, }这里有个关键点parameters本身就是一份 JSON Schema直接拿来做输入校验一份定义两处用既喂给模型又校验自己避免“模型传了错参数、工具直接崩”的连锁反应。3.3 两个真实工具天气与汇率工具描述写得好不好直接决定模型选不选得对。描述里要写清楚“做什么、什么时候用、参数什么含义”别只写一句“查询天气”。# tools/weather.py import os import requests from .base import BaseTool class WeatherTool(BaseTool): name get_weather description 查询指定城市的当前天气。当用户询问某地天气、气温、是否下雨时使用。 parameters { type: object, properties: { city: { type: string, description: 城市名称例如 北京、上海、Tokyo, } }, required: [city], } def _run(self, city: str): # 示例用公开接口生产请替换为你的数据源 url fhttps://wttr.in/{city}?formatj1 resp requests.get(url, timeout8) resp.raise_for_status() current resp.json()[current_condition][0] return { city: city, temp_c: current[temp_C], desc: current[weatherDesc][0][value], humidity: current[humidity], }# tools/currency.py import requests from .base import BaseTool class CurrencyTool(BaseTool): name convert_currency description 把一种货币金额换算成另一种货币。用户提到汇率、换算、多少钱时使用。 parameters { type: object, properties: { amount: {type: number, description: 金额例如 100}, from_currency: {type: string, description: 源货币代码如 USD}, to_currency: {type: string, description: 目标货币代码如 CNY}, }, required: [amount, from_currency, to_currency], } def _run(self, amount: float, from_currency: str, to_currency: str): url fhttps://open.er-api.com/v6/latest/{from_currency.upper()} resp requests.get(url, timeout8) resp.raise_for_status() rates resp.json().get(rates, {}) if to_currency.upper() not in rates: raise ValueError(f不支持的货币: {to_currency}) converted amount * rates[to_currency.upper()] return { amount: amount, from: from_currency.upper(), to: to_currency.upper(), result: round(converted, 2), }3.4 调用回环模型决策 → 执行 → 回填这是 Tool Use 最容易写错的地方。回环的本质是模型返回 tool_calls你执行工具把结果作为 ToolMessage 塞回消息列表再调一次模型让它总结。少任何一步模型都拿不到工具结果。# run_agent.py import os from dotenv import load_dotenv from langchain_openai import ChatOpenAI from langchain_core.messages import HumanMessage, ToolMessage from tools.weather import WeatherTool from tools.currency import CurrencyTool load_dotenv() TOOLS [WeatherTool(), CurrencyTool()] TOOL_MAP {t.name: t for t in TOOLS} def build_llm(): return ChatOpenAI( modelgpt-4o-mini, temperature0, api_keyos.getenv(OPENAI_API_KEY), base_urlos.getenv(OPENAI_BASE_URL, https://taotoken.net/api), ) def run_agent(query: str, max_rounds: int 3) - str: llm build_llm() llm_with_tools llm.bind_tools([t.to_openai_schema() for t in TOOLS]) messages [HumanMessage(contentquery)] for _ in range(max_rounds): ai_msg llm_with_tools.invoke(messages) messages.append(ai_msg) if not ai_msg.tool_calls: return ai_msg.content for call in ai_msg.tool_calls: tool TOOL_MAP.get(call[name]) if tool is None: result {success: False, error: f未知工具 {call[name]}} else: result tool.run(call[args]) messages.append( ToolMessage(contentstr(result), tool_call_idcall[id]) ) return 达到最大回环次数未能完成。 if __name__ __main__: print(run_agent(上海现在天气怎么样)) print(run_agent(100美元等于多少人民币))注意max_rounds这个护栏。没有它模型偶尔会陷入“调工具→不满意→再调”的死循环加上次数上限能兜住。4. 验证请求跑一次端到端调用配置写完必须验证。分两步先确认模型能识别工具再确认回环能跑通。第一步单独测工具本身不经过模型python -c from tools.weather import WeatherTool; print(WeatherTool().run({city: 上海}))正常输出应该是{success: True, data: {city: 上海, temp_c: ..., ...}}。如果这里是 False问题在工具内部跟模型无关。第二步跑完整回环python run_agent.py预期看到两段输出。第一段类似“上海当前气温 22°C多云湿度 65%”第二段类似“100 美元约等于 720 元人民币”。如果你在日志里打印 messages会看到清晰的四段结构HumanMessage → AIMessage(带 tool_calls) → ToolMessage → AIMessage(最终回答)。实测下来一次工具调用的耗时主要在网络请求天气和汇率接口各在 300–800ms 之间模型决策本身很快。如果超过 3 秒还没返回先查工具接口的 timeout再查模型侧的网络。提示想快速验证模型对工具描述的理解可以到模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 手动贴 Schema 问它“什么情况下你会调用这个工具”能提前发现描述歧义。5. 本篇常见错排查工具调用报错大多集中在下面几类我按出现频率排了序。第一类模型根本不调工具。现象是直接返回一段文字没有 tool_calls。原因通常是工具描述太模糊或者bind_tools传的格式不对。检查to_openai_schema()返回的type是不是functionparameters是不是合法 JSON Schema。描述里补上“当用户……时使用”这类触发条件命中率会明显上升。第二类参数校验失败。报错参数校验失败: city is a required property。这是模型传了空参数或字段名拼错。解决办法是在 description 里给参数加示例比如“城市名称例如 北京”模型对示例的敏感度高于纯类型说明。第三类ToolMessage 的 tool_call_id 对不上。报错类似tool_call_id not found。这是回环里最常见的坑一次返回多个 tool_calls 时必须为每个 call 生成一条对应的 ToolMessageid 一一对应不能合并成一条。第四类工具内部异常没被兜住。如果_run里直接抛异常且没被run()捕获整个 Agent 会中断。基类里的 try/except 就是干这个的确保任何工具失败都返回结构化错误让模型有机会换工具或告知用户。第五类base_url 配错导致 404。如果你用的是 TaoToken 接入确认 base_url 是https://taotoken.net/api不要多加/v1或斜杠。SDK 会自己拼路径多写反而 404。接入细节可对照接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。第六类MCP 集成时的工具命名冲突。当你通过 MCP 协议挂载外部工具服务器时不同 server 可能暴露同名工具。建议在注册层加命名空间前缀比如weather.get_weather避免路由时选错。6. 从单机工具到 MCP 集成以及下一步单机跑通之后你迟早会遇到“工具散落在各个项目里、每个 Agent 都要重新注册一遍”的问题。MCP 协议就是冲这个来的它把工具的描述和执行拆成 client 和 server 两端工具提供方按协议暴露能力Agent 侧只负责发现和调用。落到代码上你现在的BaseTool骨架几乎不用改只需要在注册层多一个“从 MCP server 拉取工具列表并转成 schema”的适配器to_openai_schema()那一步复用即可。如果你打算把工具调用能力长期用在编码或 Agent 工作流里建议直接上 Coding Plan省去每次手动配 Key 和额度的麻烦入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Claude Code 相关的工具调用配置可以参考 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 里面有针对 tool_use 格式的适配说明。最后留一个我踩过的坑工具描述不是写完就完事它是要迭代的。上线后把每次“模型选错工具”的 case 记下来回头改 description比调 temperature 有用得多。工具注册表保持精简低频工具定期下线模型的选择准确率会跟着涨。
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/18 21:21:17

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/18 14:20:46

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/18 20:01:42

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/18 11:04:06

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/18 15:55:22

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/18 21:21:16

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉