Dify调用第三方API获取实时天气数据教程

要在Dify中实现AI助手实时获取用户所在地天气，不能依赖内置插件或静态知识库，必须通过“自定义工具”接入第三方天气API。整个过程并不复杂，但有几个关键细节容易出错。下面逐一详细说明。

注册并获取天气API密钥

首先，访问 OpenWeatherMap 官网（openweathermap.org/api）注册一个免费账号。登录后，进入 API Keys 页面，点击 “Generate new key” 生成密钥。该密钥每次请求都会用到，【切勿直接硬编码到前端代码或公开工作流中】。

免费版每分钟可调用1000次，每天100万次，用于测试和小规模部署完全足够。如果只是做Demo或内部工具，免费额度即可满足需求。

在Dify中创建自定义工具

登录 Dify 控制台，进入「应用」，选择目标应用，点击左侧菜单「工具」，然后点击「+ 添加工具」，选择「自定义工具」。

接着填写工具基本信息：名称设为“实时天气查询”，描述写“根据城市名返回当前温度、天气状况、湿度与风速”。然后切换到「Schema」标签页，在编辑框中粘贴以下 JSON（注意先将 YOUR_API_KEY 替换为刚才生成的真实密钥，但先不要点保存）：

{"type":"object","properties":{"location":{"type":"string","description":"城市英文名称，如 beijing, shanghai, new york"},"units":{"type":"string","enum":["metric","imperial"],"default":"metric"}},"required":["location"]}

然后在「API URL」栏填写：https://api.openweathermap.org/data/2.5/weather?q={location}&appid=YOUR_API_KEY&units={units}。注意，URL中的 {location} 和 {units} 是占位符，Dify会自动从用户输入中提取对应字段，无需手动拼接。

配置请求与响应映射

切换到「Response Mapping」标签页。这里Dify需要设定如何将API返回的原始JSON转换为AI可读的文本。

第一步：在「Response Body」区域勾选「Use template」，并输入以下 Jinja2 模板：

当前 {location} 的天气：{data.main.temp}°C，{data.weather[0].description}，湿度 {data.main.humidity}%，风速 {data.wind.speed} m/s。

第二步：确认「Status Code」设为 200，并在「Error Handling」中勾选「Treat non-200 as error」。这样，如果城市名拼写错误或网络超时，AI会明确提示“查不到该城市天气”，而不是返回乱码。

第三步：点击「测试工具」，在弹出的对话框中输入 location=shanghai，然后点击运行。如果返回类似“当前 shanghai 的天气：24.3°C，scattered clouds…”的内容，说明映射成功。如果提示404或invalid api key，请检查密钥是否正确、URL中是否遗漏了 &appid= 部分。

将工具绑定到应用工作流

有两种方式可以将工具接入实际对话。

方法一：在「编排」页面拖入一个「工具调用」节点，搜索“实时天气查询”，勾选启用。确保该节点位于LLM节点之前，并在LLM提示词中明确说明：“如果用户询问天气，先调用实时天气查询工具”。

方法二：如果使用「聊天增强」模式，在「提示词优化」→「工具调用」中直接开启该工具，并设置触发关键词，例如“天气、气温、下雨、今天穿什么”等常见口语表达。

绑定完成后，发布应用。此时用户输入“北京现在多少度”，AI将自动调用OpenWeatherMap接口，解析返回的数据，并用中文组织成完整回答。整个过程无需编写任何后端代码，但理解每一步的映射逻辑至关重要。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：Dify调用第三方API获取实时天气数据教程要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题