☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用trae过程中发现ai无法调用外部工具（如git、curl、python脚本、腾讯地图skill等），则可能是由于tool calling机制未正确启用或工具注册路径异常。以下是解决此问题的步骤：
一、验证并启用Tool Calling核心开关
Trae默认关闭Tool Calling功能以保障本地环境安全，需手动激活才能允许AI识别用户意图并调度对应工具。该开关控制整个工具链的执行权限，是后续所有集成的前提。
1、启动Trae后，在左下角状态栏点击齿轮图标，进入「设置」界面。
2、在搜索框中输入tool calling，定位到「AI 工具调用」选项。
3、将开关切换为开启状态，并勾选「允许执行本地命令」与「启用第三方Skill调用」两项子选项。
4、重启Trae主进程使配置生效——注意：仅重启编辑器窗口无效，必须完全退出后再双击图标重进。
二、注册自定义CLI工具（以git和python为例）
Trae通过解析trae.tools.json文件识别可用CLI工具，每个工具需明确定义命令路径、参数格式及响应解析规则。注册后，AI可在生成代码时自动插入git add .或调用python -m http.server等指令。
1、在项目根目录新建文件trae.tools.json，内容如下：
2、填入标准Git工具定义：
{ "git": { "path": "git", "description": "版本控制操作", "args": ["status", "add", "commit", "push"] } }
3、追加Python工具定义（支持模块调用）：
{ "python": { "path": "python3", "description": "执行Python脚本或内置模块", "args": ["-m", "http.server", "-c"] } }
4、保存文件后，在Trae侧边栏打开「Tool Explorer」面板，确认git与python已显示为绿色就绪状态——若显示灰色“未检测”，请检查系统PATH中是否包含对应可执行文件。
三、集成腾讯地图Skill（官方封装工具）
Trae Skill体系将第三方服务抽象为标准化接口，腾讯地图Skill已预置HTTP请求封装、密钥自动注入、DOM自动挂载逻辑，无需手动引入SDK。集成后，AI可直接响应“在页面上添加一个带标记的地图”类自然语言指令。
1、访问腾讯位置服务控制台（lbs.qq.com），创建应用并获取key（需完成实名认证）。
2、在Trae中按下Ctrl+Shift+P（Windows）或Cmd+Shift+P（Mac），输入「Trae: Register Skill」并回车。
3、在弹出输入框中粘贴腾讯地图key，选择服务类型为「Web前端」。
4、Trae自动生成.trae/skills/tencent-map.json配置文件，并在右下角提示「Skill注册成功」——此时无需编写任何HTML或JavaScript，AI即可生成完整可运行地图页面。
四、调试Tool Calling失败场景
当AI返回“暂不支持该操作”或命令执行无响应时，通常源于上下文隔离、权限限制或工具描述歧义。Trae提供三层诊断入口，需按顺序排查。
1、在对话框中输入/debug toolcall，触发实时工具调用日志输出。
2、观察控制台中[TOOL] Attempting to call: xxx日志行，确认AI是否识别出目标工具名称。
3、若日志显示Not found in registry，返回第二步检查trae.tools.json拼写与路径是否匹配。
4、若日志显示Permission denied，进入设置→「安全策略」→临时启用「高危命令执行」并勾选当前项目路径——该选项仅限开发环境使用，生产部署前必须关闭。
五、构建自定义Python工具函数
对于CLI未覆盖的业务逻辑（如读取CSV生成图表），可通过Python脚本注册为Trae可调用工具。Trae会将脚本视为原子能力，支持传参、捕获stdout并结构化返回结果。
1、在项目tools/子目录下新建csv_to_chart.py，首行添加#!/usr/bin/env python3。
2、脚本需接收标准输入参数（如sys.argv[1]为文件路径），并以JSON格式打印结果到stdout。
3、在trae.tools.json中新增条目：
{ "csv_to_chart": { "path": "./tools/csv_to_chart.py", "description": "根据CSV数据生成可视化图表", "args": ["--input", "--output"] } }
4、在Trae对话中输入“用tools/data.csv生成柱状图并保存为chart.png”，AI将自动组装并执行完整命令链——脚本输出必须为合法JSON，否则Tool Calling将中断并报错。
