要将对话机器人升级为具备自主性的dify agent,需创建应用时选择“agent(智能助手)”类型,正确配置模型与api密钥,编写定义角色、技能和工作流程的提示词,启用并测试工具调用,最后发布验证自主执行效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让AI不再只是被动回答问题,而是能主动拆解目标、调用工具、分步执行复杂任务,比如“查完天气再推荐餐厅”“根据会议录音生成带行动项的纪要”,这就需要把基础对话机器人升级为具备自主性的Dify Agent。
创建Agent应用并选择正确类型
登录Dify工作台后,点击右上角【创建应用】→选择【创建空白应用】→在类型选项中【必须选中“Agent(智能助手)”】,不能选“聊天机器人”或“工作流”。选错会导致后续无法启用工具调用、任务规划等核心能力。
输入应用名称(如“天气美食小助手”)和简短描述,点击创建。名称会参与Agent的角色认知,建议体现功能特征。
配置模型与API密钥
进入应用设置页,点击左侧菜单【设置】→【模型供应商】。
方法一:使用Dify Cloud默认模型(适合快速验证)→直接启用gpt-3.5-turbo或claude-haiku,无需额外配置。
方法二:接入自有模型→点击【添加模型供应商】→选择对应平台(如OpenAI、Anthropic、月之暗面等)→粘贴API密钥→填写Base URL(若使用国内模型需确认是否需改写端点)→保存。
【密钥一旦保存无法在界面上查看原文,请提前备份】
编写提示词:定义Agent的“宪法”
回到应用编排页,定位到【提示词】编辑区。这里不是写问答模板,而是声明角色、职责、思考逻辑和输出约束。
第一步:用#角色开头,明确身份。例如:#角色 你是一位本地生活规划师,能主动判断用户需求阶段并分步响应。
第二步:用#技能列出可执行动作,如“调用天气API”“调用大众点评搜索接口”“识别用户是否提供地理位置”。不要写“你会翻译”,要写“你能通过调用工具获取实时天气数据”。
第三步:用#工作流程说明决策链路。例如:1. 若用户未提供城市,先询问;2. 获取城市后立即调用天气工具;3. 根据温度与天气状况筛选适宜餐厅类型;4. 调用本地生活API返回三家候选并附推荐理由。
这一步决定Agent是否“有脑子”,空泛描述(如“请专业、友好地回答”)会导致它拒绝调用工具或胡乱编造结果。
启用并配置工具调用能力
在编排页找到【工具】模块,点击【添加工具】。
选择【HTTP API】→填写工具名称(如“高德天气查询”)→输入API地址(如https://restapi.amap.com/v3/weather/weatherInfo?city={city}&key=xxx)→在参数映射中将{city}关联到用户输入的“城市”字段。
勾选【启用此工具】→点击【测试连接】确认返回200状态码。测试失败时检查key是否过期、URL是否含非法空格、参数占位符是否与提示词中要求的变量名一致。
一个Agent可同时启用多个工具,但首次上线建议只配1个,验证通路后再叠加。
发布并验证自主执行效果
点击右上角【发布】按钮→确认发布。
发布后进入【对话测试】面板→输入原始指令:“帮我查下杭州现在天气,然后推荐一家西湖边的咖啡馆。”
观察日志流:若看到“调用高德天气查询→收到温度28℃、晴→调用大众点评搜索→返回3家咖啡馆→整合输出”,说明Agent已实现闭环自主执行。











