必须通过添加自定义工具接入外部系统能力；在工作流中右键添加“自定义工具”节点，填写名称、不可修改的英文id及功能描述，配置http请求参数（表单式或json schema），密钥须用secrets引用，测试通过后保存并接入流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在腾讯元器平台创建的混元智能体中接入外部系统能力，比如调用企业内部API、查询数据库或触发微信通知，必须通过添加自定义工具实现。这一步不可跳过，否则智能体只能依赖内置插件和知识库，无法对接真实业务系统。
在元器工作流中添加自定义工具节点
进入腾讯元器控制台 → 点击左侧「工作流」→ 选择已创建的智能体工作流 → 在画布空白处右键 → 选择「添加节点」→ 点击「工具」→ 选择「自定义工具」。
这一步操作后，画布上会出现一个未配置的工具节点，双击它进入编辑面板。
填写自定义工具基础信息
在弹出的表单中，依次填写以下三项：
名称：输入该工具的中文名，例如“CRM客户查询”或“钉钉审批提交”，这个名称会出现在工作流连线标签和调试日志里；
ID：必须为英文小写字母+数字组合，不含空格与特殊符号，例如 crm_search 或 dingtalk_approve，【ID一旦保存不可修改，后续所有工作流调用都依赖此ID】；
描述：一句话说明该工具用途，如“根据手机号返回客户等级与最近3次订单金额”，用于后续多工具场景下快速识别功能边界。
配置HTTP请求参数
方法1：使用表单式配置（推荐新手）
协议类型选 HTTP → 请求方式选 GET 或 POST → 在URL栏粘贴完整接口地址，例如 https://api.yourcompany.com/v1/customer?phone={phone}；
点击「添加参数」按钮，在「路径参数」区域填入 phone，值设为 {{input.phone}} —— 这表示从上游节点传入的变量；
如果需带认证头，勾选「添加请求头」→ 输入 Key 为 Authorization → Value 填 Bearer {{secrets.token}}，其中 secrets.token 是你在「密钥管理」中预先存入的凭证。
方法2：使用JSON Schema声明（适合复杂入参）
切换至「高级模式」→ 在「输入Schema」栏粘贴符合OpenAPI 3.0规范的JSON结构，例如：
{"type":"object","properties":{"order_id":{"type":"string"},"timeout_minutes":{"type":"integer","default":30}},"required":["order_id"]}
这样配置后，工作流运行时会自动校验传入字段是否合规，缺失 order_id 将直接中断执行并报错，避免无效请求打到后端。
注意：URL中不能包含硬编码的敏感信息，如 access_token=abc123，所有密钥必须通过 secrets 引用。
测试并启用工具
第一步：点击右上角「测试」按钮 → 在弹窗中手动输入模拟参数 → 点击「运行」；
第二步：观察返回结果是否为合法JSON且含预期字段，例如 {"status":"success","data":{"level":"VIP","orders":[...]}}；
第三步：若响应状态码非2xx，检查URL拼写、headers是否遗漏、secrets是否填错——【返回401错误时，90%是因为secrets.token值为空或过期】；
第四步：确认无误后关闭测试窗口 → 点击右上角「保存」→ 返回工作流画布，将该工具节点拖入流程线中，连接上游「大模型」或「用户输入」节点即可生效。
