Dify 添加获取古诗词插件（今日诗词 API）实战教程

在使用 Dify Agent / Workflow 构建智能应用时，经常会遇到一个需求：

👉 让大模型随机获取一首古诗词，用于展示、学习、生成内容或互动问答。

本文将以 今日诗词 API 为例，手把手教你在 Dify 中添加一个「获取古诗词」插件（OpenAPI 方式）。

一、插件效果预览

插件调用后，返回数据示例：

json 复制代码

{
  "author": "苏轼",
  "category": "古诗文-山水-长江",
  "content": "大江东去，浪淘尽，千古风流人物。",
  "origin": "念奴娇·赤壁怀古"
}

在 Dify 中你可以让模型：

每次对话随机展示一首诗
写文章时自动引用古诗词
生成"每日一诗"应用
教学 / 国学 / 国风类应用

二、选择 API：今日诗词

我们使用的是 今日诗词 API：

官网：今日诗词（jinrishici.com）
支持随机返回古诗词
无需复杂参数
非常适合作为 Dify 插件示例

API 基础地址：

复制代码

https://v1.jinrishici.com

三、OpenAPI 配置说明（核心）

Dify 插件使用 OpenAPI 3.x 规范，下面是完整可用的配置。

1️⃣ OpenAPI 完整示例

yaml 复制代码

components:
    examples:
        all:
            value:
                ReqExample: {}
                RespExample:
                    author: 苏轼
                    category: 古诗文-山水-长江
                    content: 大江东去，浪淘尽，千古风流人物。
                    origin: 念奴娇·赤壁怀古
info:
    description: gushi
    title: gushi
    version: v1
openapi: 3.0.1
paths:
    /all.json:
        post:
            operationId: all
            requestBody:
                content: {}
            responses:
                "200":
                    content:
                        application/json:
                            schema:
                                properties:
                                    author:
                                        description: 古诗词的作者名称，字符串格式
                                        type: string
                                    category:
                                        description: 古诗词的分类名称，如"唐诗"、"宋词"等，用于筛选类别
                                        type: string
                                    content:
                                        description: 所有古诗词的文本内容，字符串格式
                                        type: string
                                    origin:
                                        description: 古诗词的出处或来源，字符串格式
                                        type: string
                                type: object
                    description: new desc
                default:
                    description: ""
            summary: 获取所有古诗词
servers:
    - url: https://v1.jinrishici.com

四、在 Dify 中添加插件

步骤 1：进入插件管理

打开 Dify 控制台
进入 **工具（Tools）/ 自定义 **
选择 创建自定义工具

步骤 2：粘贴 OpenAPI 配置

将上面的 YAML 配置完整粘贴到 Dify 的 OpenAPI 编辑器中：

确认 servers.url 正确
确认 operationId 唯一（这里是 all）

保存插件。

三、如何在 Agent 中调用古诗词插件

示例 Prompt（推荐）

text 复制代码

请调用工具获取一首随机古诗词，
并用以下格式输出：

【诗名】origin
【作者】author
【内容】content
【分类】category

示例输出

复制代码

【诗名】念奴娇·赤壁怀古
【作者】苏轼
【内容】大江东去，浪淘尽，千古风流人物。
【分类】古诗文-山水-长江

进入工作室 →Agent →创建空白应用

名称自定填内容如下图所示