Dify平台构建简单Agent全指南：零基础也能轻松上手.docxVIP

Dify平台构建简单Agent全指南：零基础也能轻松上手

Dify是一个开源的大语言模型应用开发平台，它融合了”Define（定义）+Modify（修改）“的理念，让即使没有编程基础的人也能轻松创建智能代理[2]。Dify通过可视化界面和模块化设计，将复杂的人工智能应用开发简化为”搭积木”式的操作，用户无需编写代码，只需通过拖拽节点、配置参数和添加工具，就能构建出能完成特定任务的AI助手。本指南将手把手带你从注册到发布，完成一个简单的Agent构建，全程只需基本的计算机操作能力，无需编程知识。

一、Dify平台基础概念与Agent功能

Dify平台的核心功能是让AI不仅能”说”，还能”做”，自主完成复杂任务。它提供了一套完整的基础设施，帮助用户从构思、开发到部署、监控AI应用的全过程[2]。在Dify中，Agent（智能体）是一种具备推理与自主工具调用能力的AI组件，它能够根据预设的策略和实时输入进行决策和行动，从而完成更复杂的任务。

Dify平台的主要特点包括：

可视化工作流编排：通过图形化界面连接LLM模型、工具节点、条件分支等模块，降低系统复杂度[18]。

模型无界兼容：支持一键接入OpenAI、DeepSeek、阿里通义千问等20+主流模型，快速切换推理引擎[22]。

丰富的工具生态系统：内置搜索、时间查询等工具，同时支持通过OpenAPI格式快速接入自定义工具。

可观测性与调试功能：提供执行日志、Token消耗、响应延迟等监控指标，帮助用户持续优化应用。

Dify的Agent与传统聊天助手的区别在于：聊天助手侧重于对话内容的流畅性，而Agent则强调主动规划任务、调用工具完成复杂目标的能力。例如，聊天助手可以回答”北京今天天气如何”，而Agent可以根据天气情况自动规划出行路线或调整室内温度。

二、注册与登录Dify平台

2.1注册账号

首先，访问Dify官网（https://dify.ai/zh），点击右上角的”SignUp”按钮。在注册页面填写您的邮箱地址，点击”发送验证邮件”，然后在邮箱中找到验证链接并点击确认。完成验证后，您将收到一个登录凭证，即可开始使用Dify平台。

2.2配置模型API密钥

Dify平台需要连接大语言模型才能运行Agent，因此需要配置模型API密钥。对于零基础用户，推荐使用国内模型（如阿里通义千问），注册流程更简单，API获取也更便捷。

配置通义千问API密钥步骤：

访问阿里云官网（/），注册并登录账号。

在控制台搜索”通义千问”，进入产品页面。

点击”创建APIKey”，生成一个密钥（格式类似：sk-xxxxxxxxxxxxxxxx）。

返回Dify平台，点击右上角个人头像，选择”设置”→“模型供应商”。

点击”添加模型供应商”，选择”通义千问”。

在配置界面填入APIKey和BaseURL（北京地域为：/compatible-mode/v1）。

点击”保存”，完成模型配置。

小提示：如果遇到APIKey配置错误（如提示”InvalidAPI-keyprovided”），请确保使用默认业务空间的APIKey，并检查地域端点设置是否正确[42]。

三、创建第一个Agent应用

3.1创建空白Agent应用

登录Dify平台后，点击左侧导航栏的”工作室”，然后点击右上角的”创建应用”按钮。在弹出的应用类型选择界面中，选择”Agent（智能助手）“，输入应用名称（如”天气查询助手”），添加简短描述（如”根据城市名称查询天气情况”），最后点击”创建”按钮[13]。

3.2编排提示词

提示词是Agent理解并执行任务的关键，需要清晰定义其角色、目标和行为规范。在Agent创建完成后，进入”编排”页面的”提示词”文本框，输入以下内容：

你是一位专业的天气查询助手，能够根据用户提供的城市名称，查询实时天气信息并给出建议。

你的工作流程是：

1.接收用户输入的城市名称

2.使用天气查询工具获取该城市实时天气

3.分析天气数据，判断是否需要特殊建议

4.生成包含温度、天气状况和建议的回复

限制：

-严格按照指定格式输出

-不要编造信息，仅基于工具提供的数据

-如果城市名称不明确，可以向用户提问获取更多信息

小提示：提示词的编写是Agent成功的关键。对于零基础用户，可以从简单明确的指令开始，逐步添加更复杂的逻辑。

3.3添加工具

Agent强大的原因之一在于它能够调用工具，如天气查询API、搜索工具等，扩展其能力边界[22]。以天气查询助手为例，需要添加一个天气查询工具。

添加天气查询工具步骤：

在Agent编排页面，点击”工具”区域右侧的”添加”按钮。

在搜索框中输入”天气查询”，找到相关工具并