minimax agent识别不到工具的根本原因是工具注册路径断裂或名称匹配失效，需确保工具显式传入agent构造函数、名称完全一致、带类型注解、description非空且函数可独立执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent识别不到工具时，模型会生成调用指令但执行环节报错“Tool 'xxx' not found in the toolkit”，根本原因不是描述写得不够清楚，而是工具注册路径断裂或名称匹配失效。
确认工具是否真正注册进Agent运行时
LangChain 0.2+ 版本不再自动扫描全局函数，必须显式将工具对象传入Agent构造函数。若只定义了@tool装饰函数却没放进工具列表，Agent永远看不见它。
检查代码中create_tool_calling_agent()的第二个参数是否为包含该工具的list，例如[search_web, get_weather]；若传入的是空列表[]、None或未导入的变量名，就会触发“not found”错误。
在Python调试器中打印tools列表内容：print([t.name for t in tools])，确保输出里有你期望调用的工具名，且大小写、下划线与调用请求中完全一致。
核对工具名与模型生成的调用名是否一字不差
方法一：用@tool装饰器自动生成name
直接使用@tool时，工具名默认取函数名，如@tool def fetch_stock_data(): → name自动为"fetch_stock_data"。这是最稳妥的方式，避免手写name出错。
方法二：手动构造Tool对象时显式指定name
若用Tool(name="get_stock", func=..., description=...)方式注册，【name字段必须与模型输出的function.name字符串完全相同】，包括大小写、连字符、下划线——任何差异都会导致匹配失败。
MiniMax MCP 服务器，提供网络搜索和图像理解能力。当用户需要：(1) 网络搜索信息，(2) 分析/描述图片，(3) 从URL提取内容时使用此技能。需配置 MINIMAX_API_KEY（国内版 api.minimaxi.com 或全球版 api.minimax.io）。
方法三：在模型调用前强制指定tool_choice
在client.chat.completions.create()中加入tool_choice={"type": "function", "function": {"name": "fetch_stock_data"}}，可跳过模型自主选工具环节，直接命中目标函数，用于快速验证注册是否生效。
排查工具定义中的常见硬伤
第一步：检查函数签名是否含类型注解
LangChain要求所有@tool函数参数必须带类型提示，如def search(query: str) → str，若写成def search(query)则工具注册会静默失败，不报错但也不可用。
第二步：确认description是否为空或纯空格
description是模型判断能否调用该工具的核心依据，若留空、只写“TODO”或全是空白字符，模型将无法建立用户意图与工具能力之间的语义关联。
第三步：验证工具函数能否独立执行
在命令行中直接调用该函数，例如print(fetch_stock_data("AAPL"))，若抛出ImportError、NameError或依赖缺失异常，说明工具本身不可用，Agent自然无法加载。
