Dify 集成

Dify 是企业级 LLM 应用开发平台。通过集成梓享搜索，可以快速搭建具备实时检索能力的 AI 应用：

智能客服系统：自动搜索产品信息和行业资讯回答用户问题
内容创作助手：搜索相关资料辅助文章/报告生成
企业知识助手：结合内部知识库和外部搜索的工作流
市场分析工具：自动收集竞品和行业动态数据

应用场景示例

场景 1：智能客服工作流

创建一个能够自动搜索信息回答客户问题的 Chatbot：

工作流设计：

用户提问 → 意图识别 → [需要实时信息?]
   ├─ 是 → 梓享搜索 → 整理答案 → 回复用户
   └─ 否 → 直接 LLM 回答 → 回复用户

Prompt 配置：

你是一个专业的客服助手。

当用户询问以下内容时，使用梓享AI搜索获取最新信息：
- 产品价格、促销活动
- 行业资讯、竞品对比
- 政策法规、最新规定
- 技术支持、故障解决

搜索后，用通俗易懂的语言回答用户，并注明信息来源和时效性。

场景 2：内容创作辅助系统

构建一个能够自动搜索资料、生成文章的工作流：

工作流设计：

主题输入 → 关键词提取 → 多次搜索收集资料
   → 资料汇总分析 → 生成文章大纲
   → 补充细节搜索 → 生成完整文章
   → 事实核查搜索 → 最终输出

节点配置：

关键词提取：LLM 节点，提取核心关键词
主题搜索：梓享搜索工具，query = " 最新资讯"
背景搜索：梓享搜索工具，query = " 行业分析"
数据搜索：梓享搜索工具，query = " 数据报告"
内容生成：LLM 节点，基于搜索结果生成文章
事实核查：梓享搜索工具，验证关键数据

配置步骤

1. 创建 API 工具

在 Dify 工作台中：

进入「工具」设置
创建「自定义 API 工具」
填写以下配置

基础配置

工具信息

工具名称：梓享AI搜索
工具描述：搜索互联网实时信息
图标：可选择搜索相关图标

API 配置

url: https://search.aiserver.cloud/v1/api
method: POST

请求头配置

Authorization: Bearer YOUR-API-KEY
Content-Type: application/json

请求体配置

{
  "engine": "{{engine}}",
  "query": "{{query}}",
  "max_results": 5
}

参数定义

输入参数

参数名	类型	必填	默认值	描述
`query`	string	是	-	搜索关键词或问题
`engine`	select	否	china	搜索引擎（china/global）

engine 选项配置：

{
  "options": [
    { "label": "中文搜索", "value": "china" },
    { "label": "全球搜索", "value": "global" }
  ]
}

输出映射

响应处理

{
  "results": "{{data.results}}",
  "engine": "{{engine}}",
  "balance": "{{balance}}"
}

结果展示配置

输出字段：

results[].title - 标题
results[].url - 链接
results[].content - 摘要

在工作流中使用

Chatflow 工作流

添加工具节点
- 选择「梓享 AI 搜索」工具
- 连接到 LLM 节点之前

配置输入

query: {{#1720700550143.text#}}  # 用户输入
engine: china                     # 固定值或变量

连接 LLM
- 将搜索结果传递给 LLM
- 在 System Prompt 中引导使用搜索结果

Workflow 工作流

nodes:
  - id: start
    type: start

  - id: search
    type: tool
    tool: zixiang_search
    inputs:
      query: "{{start.query}}"
      engine: "china"

  - id: llm
    type: llm
    model: gpt-4
    prompt: |
      根据以下搜索结果回答用户问题：
      {{search.results}}

      用户问题：{{start.query}}

Prompt 配置建议

System Prompt 示例

你是一个智能助手，能够通过搜索互联网获取实时信息。

当用户询问以下类型问题时，使用梓享AI搜索工具：
- 最新新闻、动态
- 实时数据、统计信息
- 当前事件、趋势
- 需要验证的事实信息

搜索后，基于搜索结果为用户提供准确答案，并在回答中注明信息来源。

Context 配置

context:
  - type: tool_output
    tool: zixiang_search
    format: |
      搜索结果：
      {% for result in search.results %}
      - 标题：{{ result.title }}
        内容：{{ result.content }}
        来源：{{ result.url }}
      {% endfor %}

高级功能

1. 条件搜索

根据用户问题类型自动选择引擎：

condition:
  if: "{{#1720700550143.language#}} == 'zh'"
  then:
    engine: china
  else:
    engine: global

2. 结果过滤

在工具输出后添加代码节点：

def filter_results(results):
    # 过滤掉不相关或低质量结果
    filtered = []
    for item in results:
        if len(item['content']) > 50:  # 内容长度过滤
            filtered.append(item)
    return filtered[:3]  # 只保留前3条

output = filter_results(tool_output['results'])

3. 多次搜索

串联多个搜索节点：

- search_china:
    engine: china
    query: "{{user_query}}"

- search_global:
    engine: global
    query: "{{user_query}}"

- merge:
    results: |
      中文结果：{{search_china.results}}
      全球结果：{{search_global.results}}

常见问题

Q: 如何处理搜索失败？

在工作流中添加错误处理分支：

- search:
    on_error:
      - fallback_message: "搜索服务暂时不可用，请稍后再试"

Q: 如何限制搜索频率？

在 Dify 中配置节流：

rate_limit:
  max_requests: 10
  per_minutes: 1

资源	链接
Dify 官方文档	https://docs.dify.ai/
API 完整文档	Web Search API