Coze(扣子)与 Dify 使用指南


一、平台对比

维度 Coze(扣子) Dify
开发方 字节跳动 LangGenius
定位 AI 智能体(Bot)开发平台 开源 LLM 应用开发平台
部署方式 云端(SaaS) 自托管(Docker)或云服务
开源 部分开源(coze-studio) 完全开源(Apache 2.0)
核心能力 工作流编排、插件、知识库、多Agent RAG、Agent、工作流、API 编排
适用场景 快速搭建 AI Bot、发布到多渠道 企业级 AI 应用私有化部署
上手难度 低(零代码) 中(需要 Docker 基础)
费用 免费额度 + 按量付费 开源自部署免费

第一部分:Coze(扣子)

1.1 Coze 简介

Coze(中文名:扣子)是字节跳动推出的 AI 智能体开发与发布平台。用户无需编写代码,通过可视化界面即可创建具备知识库、插件、工作流等能力的 AI Bot,并一键发布到多个渠道。

官网地址:

1.2 注册与登录

  1. 访问 coze.cn,使用手机号或抖音账号注册登录。
  2. 登录后进入工作空间,这是管理所有 Bot 和资源的主界面。

1.3 创建智能体(Bot)

创建入口

点击左侧「工作室」→「创建智能体」,有三种模式可选:

模式 说明 适用场景
单 Agent 模式 一个智能体处理所有任务 简单问答、内容生成
多 Agent 模式 多个智能体分工协作 复杂业务流程
工作流模式 纯流程编排,无 Agent 固定步骤的自动化任务
AI 创建(快速)
  1. 选择「AI 创建」,用自然语言描述需求。
  2. 示例:“帮我创建一个给小学生修改作文的智能体”。
  3. AI 自动生成:人设描述、回复逻辑、推荐插件。
  4. 确认或调整后创建。
标准创建(推荐)
  1. 选择「标准创建」,填写:
    • 名称:给 Bot 起名(如"客服小助手")
    • 描述:一句话说明功能(如"回答用户关于产品的常见问题")
  2. 进入编辑界面。

1.4 配置 Bot

人设与回复逻辑(Prompt)

在「人设与回复逻辑」区域编写系统提示词:

你是一个专业的客服助手,负责回答用户关于产品的常见问题。
回答要求:
1. 语气友好、专业
2. 回答简洁,不超过200字
3. 如果不确定答案,请说"我需要查询一下,请稍等"
4. 不要编造不存在的产品功能
技能配置

Bot 的能力通过「技能」模块添加:

1)插件(工具调用)

  • 内置插件:搜索、天气、新闻、图片生成、代码执行等。
  • 第三方插件:飞书、Notion、GitHub 等。
  • 自定义插件:通过 OpenAPI 接入自己的服务。

添加方式:点击「插件」→ 搜索或浏览 → 添加。

2)知识库(RAG)

  • 支持上传文档:PDF、Word、TXT、Excel 等。
  • 支持在线数据源:网页 URL、飞书文档、Notion 页面。
  • 支持数据库:MySQL、PostgreSQL 等。

配置步骤:

  1. 点击「知识库」→「添加知识库」。
  2. 上传文档或连接数据源。
  3. 设置分块策略和检索参数。
  4. 在 Bot 中引用该知识库。

3)工作流

  • 可视化拖拽编排复杂流程。
  • 支持条件分支、循环、并行、子流程。
  • 详见 1.5 节。

4)记忆

  • 短期记忆:自动保存对话上下文。
  • 长期记忆:跨会话记住用户偏好。
  • 可配置记忆窗口大小和保留策略。

1.5 工作流

创建工作流
  1. 进入工作空间 →「资源库」→ 右上角「+资源」→「工作流」。
  2. 填写名称和描述,确认创建。
  3. 进入可视化画布编辑界面。
界面布局
区域 功能
左侧面板 节点面板,搜索/分类添加节点
中间画布 拖拽节点、连线编排流程
右侧面板 节点配置、参数设置
顶部工具栏 调试、试运行、保存、发布
常用节点类型
节点 说明
开始节点 工作流入口,定义输入参数
LLM 节点 调用大模型进行文本生成/分类/抽取
条件分支 根据条件走不同路径(if-else)
循环 遍历列表执行操作
并行 多个分支同时执行
插件节点 调用插件(搜索、API 等)
知识库检索 从知识库中检索相关内容
代码节点 执行自定义 JavaScript/Python 代码
变量节点 定义和操作变量
结束节点 工作流出口,定义输出
工作流示例:智能客服
开始(用户输入)
  → 知识库检索(匹配相关问题)
  → 条件分支:
    - 匹配到 → LLM 生成回答 → 结束
    - 未匹配 → 插件:转人工客服 → 结束
调试与发布
  1. 点击右上角「试运行」,输入测试数据验证流程。
  2. 调试通过后点击「发布」。
  3. 发布后可在 Bot 中引用该工作流。

1.6 预览与发布

预览调试

在编辑页右侧「预览与调试」区域,通过对话框测试 Bot 是否符合预期。

发布 Bot
  1. 点击右上角「发布」按钮。
  2. 填写发布记录(可选)。
  3. 选择发布平台:
    • 扣子商店:发布到 Coze 智能体商店
    • 飞书:发布为飞书机器人
    • 微信公众号:接入公众号
    • 微信客服:接入微信客服
    • 网页:嵌入网页 Widget
    • API:通过 API 调用

1.7 多 Agent 模式

适用于复杂业务场景,多个 Agent 分工协作:

  1. 创建「多 Agent 模式」的智能体。
  2. 添加多个子 Agent,每个负责不同任务。
  3. 配置 Agent 之间的协作规则:
    • 路由 Agent:判断用户意图,分配给对应子 Agent。
    • 子 Agent:各司其职,处理特定任务。
  4. 支持串行、并行、条件路由等编排方式。

1.8 API 调用

Coze 支持通过 API 调用已发布的 Bot:

  1. 在 Bot 设置中获取 API 密钥。
  2. 调用示例:
import requests

url = "https://api.coze.cn/v3/chat"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "bot_id": "YOUR_BOT_ID",
    "user_id": "user_123",
    "stream": False,
    "auto_save_history": True,
    "additional_messages": [
        {
            "role": "user",
            "content": "你好,请问你们的产品有哪些功能?"
        }
    ]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

第二部分:Dify

2.1 Dify 简介

Dify 是一个开源的 LLM 应用开发平台,提供从 Prompt 编排、RAG 知识库、Agent 智能体到工作流编排的全套功能。支持私有化部署,数据完全自主可控。

2.2 系统要求

项目 最低要求 推荐配置
CPU >= 2 核 >= 4 核
内存 >= 4 GB >= 16 GB
磁盘 >= 20 GB >= 50 GB SSD
Docker >= 20.10.0 最新版
Docker Compose >= 1.29.0 >= 2.0
操作系统 macOS 10.14+ / Ubuntu 20.04+ / CentOS 8+ Ubuntu 22.04 LTS

macOS 用户:Docker Desktop 需至少分配 2 vCPU 和 8GB 内存。

2.3 安装部署(Docker Compose)

步骤一:安装 Docker
# Ubuntu / Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker

# 验证
docker -v
docker compose version
步骤二:克隆 Dify 仓库
git clone https://github.com/langgenius/dify.git
cd dify/docker
步骤三:配置环境变量
cp .env.example .env

首次部署建议保留默认值,关键配置项:

变量 说明 默认值
EXPOSE_PORT Web 访问端口 80
NGINX_PORT Nginx 端口 80
DB_USERNAME 数据库用户名 postgres
DB_PASSWORD 数据库密码 difyai123456
SECRET_KEY 加密密钥 随机生成
REDIS_PASSWORD Redis 密码 difyai123456
步骤四:启动服务
docker compose up -d

首次启动需要拉取镜像,约 5-15 分钟(取决于网络速度)。

步骤五:验证部署
# 查看容器状态
docker compose ps

# 查看日志
docker compose logs -f

# 所有容器应为 Running 状态
步骤六:初始化账号
  1. 打开浏览器访问 http://localhost(或服务器 IP)。
  2. 首次进入设置管理员账号和密码。
  3. 登录后进入 Dify 主界面。
常用运维命令
# 停止服务
docker compose down

# 重启服务
docker compose restart

# 更新到最新版
cd dify
git pull
cd docker
docker compose pull
docker compose up -d

# 查看日志
docker compose logs -f api
docker compose logs -f worker

2.4 接入大模型

Dify 支持多种模型提供商:

内置模型供应商
  • OpenAI(GPT-4o、GPT-4、GPT-3.5)
  • Anthropic(Claude 系列)
  • 百度文心
  • 阿里通义千问
  • 智谱 GLM
  • Moonshot(月之暗面)
  • Ollama(本地模型)
配置步骤
  1. 进入「设置」→「模型供应商」。
  2. 选择要配置的供应商。
  3. 填入 API Key 和其他参数。
  4. 点击「保存」。
  5. 在应用中选择已配置的模型。
接入本地模型(Ollama)
# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 拉取模型
ollama pull qwen2.5:7b

# 启动 Ollama 服务
ollama serve

在 Dify 中配置 Ollama:

  1. 模型供应商 → Ollama → 填入 Ollama 服务地址(如 http://host.docker.internal:11434)。
  2. 选择可用模型。

2.5 创建应用

Dify 提供四种应用类型:

类型 说明 适用场景
聊天助手 对话式 AI 应用 客服、问答、闲聊
Agent 具备工具调用能力的智能体 自动化任务、数据分析
工作流 可视化流程编排 固定流程的自动化
Completion 单次文本生成 翻译、摘要、内容生成
创建聊天助手
  1. 点击「创建应用」→「聊天助手」。
  2. 填写名称和描述。
  3. 进入编排界面。

2.6 编排界面功能

Prompt 编排

在左侧编排区域编写系统提示词,支持变量插入:

你是一个 {{tone}} 风格的 {{role}}。
请根据以下知识库内容回答用户问题:
{{#context#}}
知识库(RAG)
  1. 点击「添加」→「知识库」。
  2. 上传文档(PDF、Word、TXT、CSV、MD 等)。
  3. Dify 自动进行文档解析、分块、向量化。
  4. 支持的向量数据库:Weaviate、Qdrant、Milvus、Chroma、PgVector 等。
  5. 配置检索策略:
    • 检索模式:语义检索 / 全文检索 / 混合检索
    • Top K:返回的文档片段数量
    • 相似度阈值:过滤低质量匹配
工具(Tools)

为 Agent 添加工具能力:

  • 内置工具:Google Search、Wikipedia、天气、计算器等。
  • 自定义 API 工具:通过 OpenAPI Schema 接入自己的 API。
  • 已发布的工具:从 Dify 工具市场安装。
变量

定义应用级别的变量,用户在对话前填写:

变量名 类型 说明
tone 文本 回答风格(专业/轻松)
role 文本 角色设定
language 下拉选项 输出语言

2.7 工作流编排

Dify 的工作流支持复杂的流程编排:

节点类型
节点 说明
开始 定义输入参数
LLM 调用大模型
知识检索 从知识库检索相关内容
条件分支 if-else 逻辑
迭代 循环处理列表数据
HTTP 请求 调用外部 API
代码执行 运行 Python / JavaScript
模板转换 数据格式转换
变量聚合 合并多个分支的输出
结束 定义输出
工作流示例:RAG 问答
开始(用户问题)
  → 知识检索(从知识库匹配相关文档)
  → LLM(基于检索结果生成回答)
  → 结束(输出回答)

2.8 发布与集成

Web 应用

发布后自动生成 Web 访问链接,可直接分享给用户使用。

API 访问
  1. 在应用设置中获取 API 密钥。
  2. Dify 提供 OpenAI 兼容的 API 接口。
from openai import OpenAI

client = OpenAI(
    base_url="http://localhost/v1",
    api_key="app-YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="qwen2.5-7b",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
嵌入网站

Dify 提供嵌入式的 iframe Widget,可嵌入到任何网页中:

<iframe
  src="http://localhost/chatbot/YOUR_APP_ID"
  style="width: 100%; height: 600px; border: none;"
></iframe>

2.9 常见问题

问题 解决方案
Docker 启动失败 检查 Docker 版本和内存分配
容器状态非 Running docker compose logs -f 查看日志
模型调用失败 检查 API Key 和网络连接
Ollama 连接不上 使用 host.docker.internal 而非 localhost
知识库上传失败 检查文件大小限制和格式支持
中文分块效果差 调整分块策略,使用中文分词模式

三、Coze vs Dify 选型建议

场景 推荐 原因
快速搭建 AI Bot,发布到飞书/微信 Coze 一键发布到多渠道,零代码
企业私有化部署,数据不出内网 Dify 开源自部署,数据自主可控
搭建内部知识库问答系统 Dify RAG 能力强,支持多种向量数据库
搭建多渠道客服机器人 Coze 渠道集成丰富
需要自定义 API 和复杂工作流 Dify 工作流更灵活,支持代码节点
团队协作开发 AI 应用 Dify 支持团队协作和版本管理
个人快速体验 AI Agent Coze 上手更快,内置插件丰富

Logo

这里是“一人公司”的成长家园。我们提供从产品曝光、技术变现到法律财税的全栈内容,并连接云服务、办公空间等稀缺资源,助你专注创造,无忧运营。

更多推荐