摘要:本文是 Dify 学习系列的第二篇,聚焦于如何为 Dify 接入大语言模型。你将学习两种方式:一是通过 Ollama 部署本地大模型(以 qwen2.5 为例),实现完全离线的 AI 能力;二是通过 API 接入云端大模型(以 DeepSeek 为例),快速获得高性能模型支持。全程配有详细截图,涵盖模型下载、Dify 配置、常见问题处理,最后带你创建第一个可对话的聊天助手。

1. 本地大模型的接入

1.1 安装 Ollama(大模型管理工具)

Ollama 是一个开源的本地大模型运行框架,用于本地部署、管理和运行各类开源 LLM 大模型。

下载地址:https://ollama.com/download

在这里插入图片描述

1.2 下载模型

打开 Ollama,选择一个大模型下载。建议先选择一个小型模型,因为大模型动辄十几 GB,对电脑配置要求较高。例如选择 qwen2.5 即可。

在这里插入图片描述

找到模型后,如果没有下载,输入对话即可触发下载。下载完成后,出现以下界面即表示成功。

在这里插入图片描述

1.3 在 Dify 中配置 Ollama

Dify Marketplace 中搜索 Ollama 模型供应商进行安装。
在这里插入图片描述

如果下载失败,请勿频繁点击,避免被锁。可参考下一步的处理方法。

1.4 下载失败处理办法

进入 Dify 文件夹中的 docker 目录,打开 docker-compose.yaml 文件。

在这里插入图片描述

通过搜索找到 # plugin daemon 所在位置。
在这里插入图片描述

将以下配置替换原有内容:

plugin_daemon:
    image: langgenius/dify-plugin-daemon:0.5.4-local
    restart: always
    networks:
      - default
    environment:
      SERVER_PORT: 5003
      SERVER_KEY: lsk-123456
      DIFY_INNER_API_URL:  http://api:5001 
      DIFY_INNER_API_KEY: lsk-123456
      DB_USERNAME: postgres
      DB_PASSWORD: difyai123456
      DB_HOST: db_postgres
      DB_PORT: 5432
      DB_DATABASE: dify
      REDIS_HOST: redis
      REDIS_PORT: 6379
      REDIS_PASSWORD: difyai123456
      STORAGE_TYPE: local
      STORAGE_LOCAL_PATH: /app/storage
      PLUGIN_PYTHON_ENV_INIT_TIMEOUT: 600
      PLUGIN_MAX_EXECUTION_TIMEOUT: 2400
      PIP_MIRROR_URL:  https://pypi.tuna.tsinghua.edu.cn/simple 
      UV_NO_REFLINK: 1
      PLUGIN_REMOTE_INSTALLING_HOST:  http://plugin_daemon:5003 
      PLUGIN_REMOTE_INSTALLING_PORT: 5003
      PLUGIN_WORKING_PATH: /app/storage/cwd
    ports:
      - "5003:5003"
    volumes:
      - ./storage:/app/storage
    depends_on:
      - api
      - db_postgres
      - redis

接着打开 .env 文件。
在末尾添加以下配置:

PLUGIN_DAEMON_URL= http://plugin_daemon:5003 
PLUGIN_DAEMON_KEY=lsk-123456
PLUGIN_DAEMON_ENABLED=true

在这里插入图片描述

再次到 Dify 市场下载 Ollama。可能仍会出现下载超时的问题,但无需理会,通常等待几次即可成功(例如本人尝试四次后成功)。

1.5 Dify 中配置 Ollama

在这里插入图片描述

在添加模型的弹窗中填入三个信息:

  • 模型名称:填写在 Ollama 中下载的模型名称(如 qwen2.5)
  • 基础 URL
    • 同一机器 Docker 部署:http://host.docker.internal:11434
    • 不同机器部署:http://192.168.x.x(自己的 IP):11434

在这里插入图片描述

1.6 测试本地模型

回到开发页面,创建空白应用。
在这里插入图片描述

选择聊天助手,输入应用名称,直接创建。

在这里插入图片描述

在预览页面可以看到系统自动选择了刚配置的本地大模型。

在这里插入图片描述

能够正常对话即表示配置成功。

在这里插入图片描述

2. 云端大模型的接入

2.1 安装 OpenAI-API-compatible

打开 Dify 市场,找到 OpenAI-API-compatible,下载安装。
在这里插入图片描述

如果下载失败,参照前文“下载失败处理办法”进行配置。如果之前已配置过,则无需重复配置。下载时可能仍会报错,但无需理会(本人下载耗时十多分钟最终成功)。

2.2 创建 DeepSeek 账号

进入 DeepSeek 的 API 开放平台。

在这里插入图片描述

建议充值少量金额(如 1-2 元)用于学习测试。

在这里插入图片描述

2.3 创建 API Key

创建 API Key 时务必复制保存,因为 API Key 仅在创建时可查看。

在这里插入图片描述

2.4 在 Dify 中配置 DeepSeek

在这里插入图片描述

填入刚创建的 API Key,其他配置参考下图填写。

在这里插入图片描述

2.5 测试云端大模型

与本地大模型测试方式相同:在工作室页面创建空白应用,选择聊天助手模式。
在这里插入图片描述

选择刚刚配置好的 DeepSeek 模型。

在这里插入图片描述

首次对话可能会报错,再问一次即可恢复正常。

小结

下一篇将进入 提示词工程 的学习,深入讲解提示词的四要素、系统提示词与用户提示词的区别、如何借助大模型优化提示词,并通过“文案润色助手”案例演示优秀提示词的设计方法。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐