跳到主要内容

从零构建AI机器人：Dify集成实战

本指南将介绍如何基于融云 IM 平台集成 AI 机器人，并接入 Dify 平台大模型服务

Dify 是一款开源的大语言模型(LLM) 应用开发平台。它融合了后端即服务（Backend as Service）和 LLMOps 的理念，使开发者可以快速搭建生产级的生成式 AI 应用。

1. 工作流程​

图示

  1. App Server

    • 管理机器人，处理 Webhook 回调，接收机器人消息。

  2. 用户终端

    • 发送用户消息，接收机器人响应。

  3. IM Server

    • 消息转发：根据回调类型（如 dify_chat, dify_completion）转发至 Dify 对应接口，支持流式/非流式模式。

    • 响应处理与会话管理：

      • 流式：实时推送 Dify 增量内容。
      • 非流式：整合完整文本后发送。
      • 会话上下文：存储首次交互的 conversation_id（24 小时有效），后续对话携带此 ID 确保多轮上下文。

  4. Dify

    • 接收消息，推理生成响应，返回流式数据或完整文本。

2. 快速开始​

本部分将帮助你快速完成部署与接入配置，开始使用融云机器人提供的智能对话体验。

2.1 准备工作​

在开始集成机器人之前，请确保以下准备工作已完成：

  • 已在 融云开发者控制台 创建应用，并获取有效的 App Key 和 App Secret。
  • 已完成 Dify 的部署（支持自部署或使用云平台服务）。

2.2 机器人回调方式​

用于将机器人集成到不同平台或系统中，当前支持以下回调方式：

类型描述
webhook通过 Webhook 实现自定义回调，适用于灵活对接外部系统。
dify_chat接入 Dify 平台的"聊天助手"模式，用于构建多轮对话机器人。
dify_completion接入 Dify 平台的"文本生成"模式，用于生成式内容应用场景。
dify_chatflow接入 Dify 平台的"Chatflow"模式，用于流程化对话构建。

2.3 接入步骤​

  1. 创建 Dify 应用：在 Dify 中创建应用，并获取对应的 API 密钥（API Key）。
  2. 创建真实用户：在系统中创建一个用于与机器人交互的真实用户账号。
  3. 配置机器人与回调地址：创建机器人，并配置消息回调地址。当用户向机器人发送消息时，消息将回调至您的系统或 Dify 平台。
  4. 验证接入效果：使用第二步创建的用户账号向机器人发送一条单聊消息，确认用户终端是否能收到来自 Dify 的对话响应。
  5. 验证连续对话效果：使用同一用户持续向同一机器人发送消息，验证对话上下文是否正确延续。融云将自动维持与 Dify 的上下文会话，实现连续对话体验。

⚠️ 注意：调用融云服务需进行身份认证，认证信息需通过工具脚本生成，具体使用方法见下文。

步骤 1：创建 Dify 应用​

消息助手采用 dify_chatflow 模式接入大模型服务，该模式支持记忆的复杂多轮对话工作流

图示

你可以查看 dify-chatflow-dsl.yml 来了解完整的 DSL 配置示例。

步骤 2：创建真实用户​

bash
curl -X POST "https://api.rong-api.com/user/getToken.json" \
  -H "App-Key: 填写您的App-Key" \
  -H "Nonce: 填写您的 Nonce" \
  -H "Timestamp: 填写您的 Timestamp" \
  -H "Signature: 填写您的Signature" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "userId=LoDld8izA"

步骤 3：配置机器人与回调地址​

与 Dify 集成，可根据实际业务场景选择消息响应模式：

  • 流式模式：适用于大模型生成内容较长或需逐步生成的场景，系统将以流消息（Streaming）方式将响应内容实时发送至用户终端，提升响应速度与用户交互体验。
  • 非流式模式：适用于需要完整响应后再展示的场景，系统将在接收到完整内容后一次性发送给用户。

开发者可按需配置响应模式，灵活适配不同交互体验需求。

bash
curl -X POST "https://api.rong-api.com/v3/bot/create.json" \
  -H "App-Key: 填写您的App-Key" \
  -H "Nonce: 填写您的 Nonce" \
  -H "Timestamp: 填写您的 Timestamp" \
  -H "Signature: 填写您的Signature" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "bot-test004",
    "name": "消息助手",
    "type": "Message AI",
    "profileUrl": "https://cdn.jsdelivr.net/gh/microsoft/fluentui-emoji/assets/Robot/3D/robot_3d.png",
    "integrations": [
        {
            "type": "webhook",
            "callbackUrl": "https://yourserver.com/callback",
            "objectNames":["RC:TxtMsg"],
            "events":["message:private"]
        },
        {
            "type": "dify_chatflow",
            "callbackUrl": "https://api.dify.ai/v1",
            "stream": true,
            "auth": {
                "apiKey": "填写您的 api-key"
            }
        }
    ],
    "metadata": {
        "version": 1
    }
}'

步骤 4：验证接入效果​

使用第二步创建的用户账号向机器人发送一条单聊消息，确认用户终端是否能收到来自 Dify 的对话响应。

bash
curl -X POST "https://api.rong-api.com/message/private/publish.json" \
  -H "App-Key: 填写您的App-Key" \
  -H "Nonce: 填写您的 Nonce" \
  -H "Timestamp: 填写您的 Timestamp" \
  -H "Signature: 填写您的Signature" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "fromUserId=BesqX1FTg33" \
  --data-urlencode "toUserId=bot-001" \
  --data-urlencode "objectName=RC:TxtMsg" \
  --data-urlencode 'content={"content":"能给我几个 AI 应用场景的点子吗？","extra":""}'

以下是演示效果，截图来自融云 Sealtalk APP Demo

��图示 图示

步骤 5：验证连续对话效果​

使用同一用户持续向同一机器人发送消息，验证对话上下文是否正确延续。融云将自动维持与 Dify 的上下文会话，实现连续对话体验。

图示

Dify 日志显示共记录了 4 条消息，验证了多轮对话过程中上下文得以正确延续，说明聊天会话在同一上下文中持续进行。

图示

3. 使用场景​

3.1 消息助手：触发智能对话、任务执行、内容生成等功能​

  • 用户向 AI 提问知识类问题，机器人通过知识库或大模型进行回答；
  • 发起内容生成请求，如"帮我写一封道歉邮件"；
  • 发起内容翻译请求，如"将内容翻译为英文"；
  • 发起指令请求，将消息分类同步到业务系统，如"创建工单"；
  • FAQ 问答：解析用户意图并自动回复；

3.2 陪聊助手：打造具备情感陪伴与个性化交互能力的智能聊天机器人​

  • 提供持续自然的闲聊体验，满足用户日常交流需求；
  • 模拟具有性格特征的角色（如朋友、心理咨询师、虚拟偶像等），提升互动趣味性与沉浸感；
  • 根据用户的情绪变化进行适当回应，实现基础的情绪识别与关怀；
  • 可与用户设定的虚拟人物设定结合，构建个性化陪伴场景（如"我的 AI 恋人"、"职场导师"）；

4. 使用建议​

4.1 支持设置创建人元数据​

在创建机器人时，支持为创建人设置自定义元数据（metadata）。该元数据会在消息回调时一并透传至 Dify，可用于提示词变量替换、上下文定制或流程编排，提升机器人响应的个性化与灵活性。

4.2 为不同场景配置独立机器人与 Dify 应用​

建议根据具体业务场景（如知识问答、翻译、工具使用、陪聊等）创建不同类型的机器人，并为每个机器人配置独立的 Dify 应用与专属提示词，以实现更精准的能力定位与更优质的用户体验。

5. 工具脚本​

5.1 生成融云 HTTP 请求签名​

python
import hashlib
import time
import random


def generate_rongcloud_signature(app_secret, nonce=None, timestamp=None):
    """
    生成融云 HTTP 请求签名

    参数:
        app_secret: 融云应用的App Secret
        nonce: 随机字符串(可选)，如果不提供将自动生成
        timestamp: 时间戳(可选)，如果不提供将使用当前时间

    返回:
        包含nonce, timestamp和signature的字典
    """
    if nonce is None:
        # 生成随机字符串(由数字和字母组成的6位字符串)
        nonce = ''.join(random.choices('0123456789abcdefghijklmnopqrstuvwxyz', k=6))

    if timestamp is None:
        # 获取当前时间戳(秒)
        timestamp = str(int(time.time()))

    # 计算签名
    signature_str = app_secret + nonce + timestamp
    signature = hashlib.sha1(signature_str.encode('utf-8')).hexdigest()

    return {
        'nonce': nonce,
        'timestamp': timestamp,
        'signature': signature
    }


if __name__ == '__main__':
    # 替换为你自己的App Secret
    app_secret = 'YOUR_APP_SECRET'

    # 生成签名
    signature_data = generate_rongcloud_signature(app_secret)

    print("生成的融云签名信息:")
    print(f"Nonce: {signature_data['nonce']}")
    print(f"Timestamp: {signature_data['timestamp']}")
    print(f"Signature: {signature_data['signature']}")

6. 结语​

通过本指南，您已完成融云机器人与 Dify 大模型服务的基本集成。这一方案有效降低了 AI 应用的开发门槛，为您的产品提供了强大的智能对话能力。

如在开发中遇到任何问题，欢迎通过创建工单或联系我们的技术支持团队。

最后于 更新