必须选择agent类型并配置支持function calling的模型，再添加搜索引擎、知识库或openapi工具，最后编写结构化系统提示词并启用高级推理模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中快速创建一个能自动调用搜索、知识库或API工具完成任务的智能Agent，必须跳过传统Chatbot模式，直接启用具备自主规划能力的Agent类型，并正确配置工具链与推理机制。
创建具备工具调用能力的Agent应用
登录Dify控制台（cloud.dify.ai 或私有部署地址）→ 点击「创建应用」→ 在应用类型中【必须选择“Agent”而非“Chatbot”或“Workflow”】。
输入应用名称，例如“售后问题诊断助手”，并填写简明描述；图标可暂不上传，不影响功能。
这一步不能选错——选成Chatbot会导致后续无法启用函数调用（Function Calling）和自主工具调度能力，所有工具将变成手动触发的静态按钮。
配置支撑Agent运行的核心模型
进入「模型设置」→ 在「模型供应商」中添加你已开通API权限的大模型服务（如OpenAI、DeepSeek-V3、Qwen2.5-72B等）→ 保存后返回模型设置页，为当前Agent指定推理模型。
【必须选用支持Function Calling的模型】，例如gpt-4-turbo、deepseek-chat、qwen2.5-72b-instruct。gpt-3.5-turbo虽支持，但复杂工具链下易出现跳过调用或乱序执行。
若使用国产模型，请确认其API文档明确标注支持OpenAI-style function calling，否则需切换至ReAct模式（稳定性下降约40%）。
添加并启用外部工具
方法一：接入内置搜索引擎
进入「工具」→ 点击「添加工具」→ 选择「Google Search」或「Bing Search」→ 开启「结果翻译」开关（否则中文用户将收到英文原始结果）→ 设置最大返回条数为5 → 保存。
方法二：连接企业知识库
先在「知识库」中上传PDF/Word/Markdown格式的FAQ、SOP或产品手册 → 创建完成后回到当前Agent的「工具」页 → 点击「添加工具」→ 选择「Knowledge Base」→ 勾选刚创建的知识库 → 启用「语义检索」和「高亮匹配段落」→ 保存。
方法三：集成自定义API（OpenAPI规范）
准备一份符合OpenAPI 3.0规范的YAML或JSON文件（含auth配置、endpoint、parameters）→ 在「工具」页点击「添加工具」→ 选择「OpenAPI」→ 粘贴文档URL或上传文件 → Dify会自动解析可用接口 → 勾选需要暴露给Agent的端点（如GET /v1/orders/{id}）→ 保存。
⚠️注意：自定义API若含Bearer Token认证，必须在OpenAPI文档的securitySchemes中明确定义，否则Dify无法生成合法请求头。
编写驱动Agent行为的系统提示词
第一步：进入「提示词」编辑区，清空默认内容，粘贴以下结构化指令模板：
你是一名专业的{业务领域}智能助手，具备自主分析、分步执行和工具调用能力。请严格遵守： 1. 先判断用户问题是否需查知识库或调用API，是则立即触发对应工具，不得自行编造答案 2. 工具返回结果后，必须整合信息再作答，禁止直接转发原始JSON或HTML片段 3. 若工具调用失败或无结果，明确告知用户“暂无法获取该信息”，不猜测、不延伸
第二步：在提示词末尾追加当前可用工具说明，格式为： 可用工具：[知识库-售后政策]、[搜索引擎]、[订单查询API]
第三步：勾选「启用高级推理模式」→ 选择「Function Calling」→ 保存。
测试工具调用是否生效
步骤一：点击右上角「Preview」打开预览面板
步骤二：输入测试语句：“我的订单#OD202606001物流到哪了？”
步骤三：观察响应过程——若看到Agent先输出类似“正在查询订单#OD202606001状态…”的中间态，随后返回物流信息，则工具调用链路已通。
步骤四：若响应直接为“我不知道”，或返回空JSON、报错提示“tool not found”，请返回「工具」页检查API密钥是否填错、知识库是否启用、OpenAPI文档是否含有效paths字段。
步骤五：在Preview面板中点击「Debug」标签页，查看完整执行轨迹，确认LLM是否真正生成了tool_calls字段及参数。
