Dify Agent 要真正“能办事”，必须启用并配置外部接口调用能力：先开启「Agent 调用」节点的「启用外部 Agent 协同」开关，再通过后台注册或 Direct HTTP 模式配置目标服务，接着用代码块提取参数并动态绑定至请求体，最后确保外部 Agent 按规范回传 task_id 和 status=success 的 Webhook 结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让 Dify Agent 真正“能办事”，必须让它能主动调用订单系统、CRM、天气服务等真实业务接口，而不是只在对话框里复述知识。这一步不是可选项，而是生产环境中 Agent 能力落地的刚性前提。
确认 Agent 调用能力已启用
进入 Dify 工作流编辑器 → 打开目标应用 → 在左侧节点栏找到「Agent 调用」节点并拖入画布。该节点默认处于禁用状态，需手动开启。
点击节点 → 右侧配置面板中勾选「启用外部 Agent 协同」→ 此时下方「Agent ID」字段才变为可编辑状态。不勾选此开关，后续所有配置均无效，请求永远不会发出。
注册并配置外部 Agent 元信息
方法一：通过 Dify 后台统一注册（推荐团队协作场景）
访问 【Settings → Agents → Register New Agent】 → 填写名称（如 order-checker）、描述（查订单发货状态）、支持的工具集（仅勾选“GET /api/v1/orders/{id}/status”）、回调地址（https://your-agent-domain.com/webhook/dify）。
注册成功后，系统自动生成唯一 Agent ID（形如 agt_8xk2m9q），该 ID 必须与工作流中「Agent 调用」节点填写的 ID 完全一致，否则 Dify 无法路由请求。
方法二：跳过后台注册，直接在工作流中硬编码配置（仅限快速验证）
在「Agent 调用」节点配置面板中，选择「Direct HTTP」模式 → 手动填写目标 API 的完整 URL（如 https://order-api.internal/v1/status）→ 设置请求方法为 GET → 在 Headers 中添加 Authorization: Bearer {{env.ORDER_API_KEY}}。
注意：此方式绕过 Dify 的 Agent 生命周期管理，无法享受幂等校验、状态回传、可观测性埋点等企业级能力，【禁止用于生产环境】。
构建带上下文的动态请求体
第一步：提取用户输入中的关键参数
在「Agent 调用」节点前接入一个「代码块」节点，用 Python 提取订单号：import re; order_id = re.search(r'订单号[:：]?\s*(\w+)', inputs.get('query', '')) and re.search(r'订单号[:：]?\s*(\w+)', inputs.get('query', '')).group(1) or 'not_found'。
第二步：绑定变量到请求体
在「Agent 调用」节点的 Request Body 中填写 JSON：
{ "order_id": "{{code.order_id}}", "user_id": "{{sys.user_id}}" }。
这里的 {{code.order_id}} 会自动替换为上一步代码块输出的值，{{sys.user_id}} 则来自 Dify 用户会话上下文。
第三步：设置超时与重试策略
展开「Advanced Settings」→ 将 Timeout（秒）设为 8 → Retry Times 设为 2 → Failure Fallback 选择「Return error message to user」。网络抖动时，Dify 会自动重试两次再失败，避免因单次超时导致整个工作流中断。
验证 Webhook 回传结果格式
外部 Agent 收到请求并执行完毕后，必须向 Dify 指定端点发起 POST 回调：
POST /v1/webhooks/agent-callback
Header: X-DIFY-AGENT-ID: agt_8xk2m9q
Body: { "task_id": "task_xyz789", "status": "success", "outputs": { "status": "shipped", "tracking_no": "SF123456789CN" } }
【task_id 必须与 Dify 发起请求时携带的完全一致】，否则 Dify 无法匹配任务状态，后续节点将收不到 outputs 数据。
若 status 字段填错（如写成 "succeed" 或 "ok"），Dify 会静默丢弃该响应，工作流卡在 running 状态，且无错误日志提示——这是最常踩的坑。
