Dify полагается на ChatGPT-on-WeChat для доступа к экосистеме WeChat

Хань Фаньюань, "Dify Автор проекта с открытым исходным кодом "WeChat

1. Обзор

WeChat, как самая популярная программа для обмена мгновенными сообщениями, имеет огромный трафик.

Дружественное окно чата WeChat - это естественное приложение искусственного интеллекта LUI (языковой пользовательский интерфейс)/CUI(Команда Пользовательский интерфейс).

В WeChat есть не только личный WeChat, но и такие каналы общения, как публичный номер, корпоративный WeChat, корпоративное приложение WeChat, служба поддержки корпоративного WeChat и т. д. В WeChat сложилась хорошая экология.

Подключив приложение Dify к экосистеме WeChat, вы сможете создать мощную интеллектуальную службу поддержки клиентов, которая значительно сократит расходы на обслуживание клиентов, а также улучшит их впечатления. В этом руководстве мы расскажем вам, как использовать проект Dify on WeChat, потрогав руками и подключив приложение Dify к экосистеме WeChat.

2. Предоставить доступ к персональному microsoft ### 2.1. подготовка

2.1.1 Создание чат-ассистента

(1) Знакомство с Dify

Dify - отличная платформа для LLMOps (Large Language Modelling Operations). Для подробного ознакомления с Dify перейдите к официальной документации Welcome to Dify | Chinese | Dify.

(2) Войдите в официальную платформу приложения Dify

Прежде всего, войдите в официальную платформу приложения Dify, вы можете использовать логин Github или логин Google. Кроме того, вы можете обратиться к официальному руководству Dify Docker Compose Deployment | Chinese | Dify Private Deployment, Dify - это проект с открытым исходным кодом, который поддерживает частное развертывание.

(3) Создание приложения Dify Basic Orchestration Chat Assistant

После успешного входа в систему мы переходим на страницу Dify и выполняем следующие шаги для создания базового приложения чат-ассистента оркестровки

1. Нажмите на кнопку Студия в верхней части страницы
2. Создание пустого приложения
3. Тип приложения Выберите Чат-помощник
4. Chat Assistant Параметры построения графиков Базовые графики
5. Выберите значок приложения и введите его название, например Basic Orchestration Chat Assistant.
6. Нажмите, чтобы создать

После успешного создания мы будем перенаправлены на страницу, показанную выше, и продолжим настройку приложения

1. Выберите модель, например, gpt-3.5-turbo-0125
2. Настройка параметров модели
3. Заполните подсказки приложения

После завершения настройки мы можем протестировать ее в диалоговом окне справа, а после завершения теста сделайте следующее

1. почта
2. обновление
3. Доступ к API

(4) Генерирование базового ключа API Orchestration Chat Assistant

После нажатия кнопки "Access API" мы будем перенаправлены на указанную выше страницу управления API, на этой странице мы выполним следующие шаги, чтобы получить ключ API:

1. Нажмите на ключ API в правом верхнем углу
2. Нажмите кнопку Создать ключ
3. Копирование и сохранение ключа

После сохранения ключа вам также нужно проверить сервер API в правом верхнем углу, если приложение создано на официальном сайте Dify, адрес сервера API будет "https://api.dify.ai/v1", если это частное развертывание, пожалуйста, убедитесь, что адрес вашего собственного сервера API.

На этом подготовка к созданию чат-ассистента завершена, и в этом подразделе нам осталось сохранить только две вещи:Ключ APIвместе сАдрес сервера API

2.1.2. загрузить проект Dify on WeChat

(1) Информация о проекте Dify на WeChat

Dify в WeChatбыть ChatGPT в WeChat Ветвь Dify API, которая дополнительно реализует докинг к Dify API, поддержку Dify Chat Assistant, поддержку инструментов вызова агентов и баз знаний, а также поддержку рабочих процессов Dify, подробнее см. в GitHub-репозитории Dify on WeChat.

(2) Загрузите код и установите зависимости

1. Скачать код проекта

Копировать

gitclonehttps://github.com/hanfangyuan4396/dify-on-wechat
cddify-on-wechat/

1. Установка python

Проект Dify on WeChat написан на языке python.официальный сайт pythonСкачайте и установите python, рекомендуется установить python 3.8 или выше, я тестировал версию 3.11.6 в ubuntu, и она отлично работает.

1. Установите основные зависимости (обязательно):

Копировать

pip3install-rrequirements.txt# 国内可以在该命令末尾添加 "-i https://mirrors.aliyun.com/pypi/simple" 参数，使用阿里云镜像源安装依赖

1. Расширенные зависимости (необязательно, рекомендуется):

Копировать

pip3install-rrequirements-optional.txt# 国内可以在该命令末尾添加 "-i https://mirrors.aliyun.com/pypi/simple" 参数，使用阿里云镜像源安装依赖

(3) Заполните файл конфигурации

Мы создаем файл config.json в корневом каталоге проекта со следующим содержимым и создаем файл в каталогеПодраздел 2.1.1 (4) Наконец-то спасенКлюч APIвместе с Адрес сервера API Пожалуйста, поставьтеdify_api_baseсконфигурировать как Адрес сервера API .;dify_api_keyсконфигурировать какКлюч APIДругие конфигурации остались неизменными.

(PS: Возможно, многие из вас не до конца выполнили все шаги, описанные в моем руководстве.Тип чат-ассистентаприложения Dify, с особым вниманием кdify_app_typeметод настройки, если вы создадитеПомощник чатаПожалуйста, настройте приложение на чатбот ; созданиеАгентПожалуйста, настройте приложение на агент ; созданрабочий процессПожалуйста, настройте приложение на рабочий процесс )

Копировать

{
"dify_api_base":"https://api.dify.ai/v1",
"dify_api_key":"app-xxx",
"dify_app_type":"chatbot",
"channel_type":"wx",
"model":"dify",
"single_chat_prefix": [""],
"single_chat_reply_prefix":"",
"group_chat_prefix": ["@bot"],
"group_name_white_list": ["ALL_GROUP"]
}

2.2 Доступ к WeChat для базовой оркестровки чат-ассистентов

2.2.1 Тест быстрого запуска

(1) Выполните следующую команду в корневом каталоге проекта Dify on Wechat

Копировать

cddify-on-wechat
python3app.py# windows环境下该命令通常为 python app.py

(2) Сканировать код входа

Этот проект использует itchat для реализации персонального входа в wechat, существует риск блокировки, рекомендуется использоватьаутентификация по реальному именипрошлоеМиниатюрный номер WeChatДля проверки, после выполнения вышеуказанной команды, мы можем увидеть в консоли, чтобы распечатать QR-код, показанный выше, использовать WeChat для сканирования кода для входа в систему, после входа в систему, когда вы видите "itchat: Начало автоответчика." символов, говорит, что вход в систему успешно, мы можем проверить.

(3) Диалоговый тест

Мы видим, что ответы бота WeChat совпадают с ответами на тестовой странице Dify. На этом поздравляем вас с успешным подключением Dify к вашему персональному WeChat 🎉🎉🎉🎉🎉🎉!

(PS: Некоторые друзья здесь могут увидеть нормальный ответ на сообщение в журнале, но не получили сообщение в WeChat, пожалуйста. Не пишите сообщения в своем WeChat )

(4) Развертывание сервера

1. Развертывание исходного кода

Копировать

cddify-on-wechat
nohuppython3app.py&tail-fnohup.out# 在后台运行程序并通过日志输出二维码

1. развертывание docker compose

контейнерпеременная окруженияобязательноперезаписатьфайл config.json, пожалуйста, измените переменные окружения файла docker/docker-compose.yml в соответствии с вашей реальной конфигурацией, метод настройки такой же, как иПодраздел 2.1.1 (4) Конфигурация config.json соответствует конфигурации

Убедитесь, что вы правильно настроили его! DIFY_API_BASE , DIFY_API_KEYвместе сDIFY_APP_TYPEПеременные среды.

Копировать

version:'2.0'
services:
dify-on-wechat:
image:hanfangyuan/dify-on-wechat
container_name:dify-on-wechat
security_opt:
- seccomp:unconfined
environment:
DIFY_API_BASE:'https://api.dify.ai/v1'
DIFY_API_KEY:'app-xx'
DIFY_APP_TYPE:'chatbot'
MODEL:'dify'
SINGLE_CHAT_PREFIX:'[""]'
SINGLE_CHAT_REPLY_PREFIX:'""'
GROUP_CHAT_PREFIX:'["@bot"]'
GROUP_NAME_WHITE_LIST:'["ALL_GROUP"]'

Затем выполните следующую команду, чтобы запустить контейнер

Копировать

cddify-on-wechat/docker# 进入docker目录
dockercomposeup-d# 启动docker容器
dockerlogs-fdify-on-wechat# 查看二维码并登录

2.3 Подключение чат-ассистента оркестровки рабочих процессов к WeChat

После получения доступа к базовому приложению чат-ассистента Dify в WeChat мы увеличиваем сложность и пытаемся получить доступ к приложению чат-ассистента для оркестровки рабочих процессов в WeChat, чтобы реализовать интеллектуальную службу поддержки клиентов WeChat со знанием платформы Dify для ответа на вопросы, связанные с рабочим процессом Dify.

2.3.1 Создание базы знаний

(1) Загрузите файл базы знаний

Мы здесь.Хранилище документов docifyЗагрузите документацию по Dify Workflow Introduction.

(2) Импорт базы знаний в Dify

Перейдите на страницу База знаний, чтобы создать базу знаний

Выберите импорт существующего текста, загрузите только что скачанный файл introduce.md, нажмите кнопку "Далее"!

Выберите следующую конфигурацию

• Настройка сегментов: автоматическая сегментация и очистка
• Метод индексирования: высокое качество
• Параметры поиска: Векторный поиск

Наконец, нажмите кнопку "Сохранить и обработать".

Мы видим, что база знаний обрабатывается для встраивания, поэтому подождите несколько минут, чтобы встраивание прошло успешно.

2.3.2 Создание чат-ассистентов оркестровки рабочих процессов

Заходим в студию Dify и нажимаем кнопку Создать из шаблона приложения.

Мы используем шаблон типа "База знаний + чатбот", задаем значок и название приложения и нажимаем кнопку "Создать"!

Перейдя на страницу оркестровки рабочего процесса, сначала щелкните узел Knowledge Retrieval, а затем нажмите на крайний правый "+", чтобы добавить базу знаний. Мы выбрали ранее загруженную базу знаний introduce.md, которая представляет собой базовое введение в рабочий процесс Dify. Наконец, мы нажимаем кнопку Добавить, и настройка узла базы знаний завершена.

Далее выбираем узел LLM, щелкаем на Set Context и выбираем переменную result, в которой хранятся результаты поиска знаний.

После настройки узла LLM мы нажали на Preview для проверки и ввели вопрос: please introduce the dedify workflow. Вы можете видеть, что в итоге выводится правильное введение рабочего процесса Dify. После правильной проверки мы возвращаемся в режим редактирования.

Вернувшись в режим редактирования, поочередно нажмите "Опубликовать", "Обновить" и "Доступ к API".

2.3.3. Генерация API-ключа чат-ассистента оркестровки рабочих процессов

Перейдя на страницу управления API, мы обратимся к файлу2.1.1 Подраздел (4) Получение ключа API для приложения "База знаний + чатботвместе сАдрес сервера API

2.3.4 Доступ к WeChat

вместе с2.1.2 Подраздел (3) Аналогично, создаем файл config.json в корневом каталоге проекта со следующим содержимым, а также помещаем в него dedify_api_baseсконфигурировать какБаза знаний + чатботадрес API-сервера приложения, адрес dify_api_keyсконфигурировать какБаза знаний + чатботAPI-ключ для приложения, остальные конфигурации остаются без изменений

Копировать

{ 
"dify_api_base":"https://api.dify.ai/v1",
"dify_api_key":"app-xxx",
"dify_app_type":"chatbot",
"channel_type":"wx",
"model":"dify",
"single_chat_prefix": [""],
"single_chat_reply_prefix":"",
"group_chat_prefix": ["@bot"],
"group_name_white_list": ["ALL_GROUP"]
}

Мы следуем2.2.1 ПодразделЗапустите приложение и отсканируйте код для входа в систему, а затем отправьте сообщение боту WeChat, чтобы проверить его работу

Ответы бота WeChat совпадают с ответами на тестовой странице Dify. Поздравляем вас с тем, что вы сделали еще один шаг вперед и внедрили приложение для оркестровки рабочих процессов в свой личный WeChat, вы можете импортировать больше официальной документации Dify в свою базу знаний и позволить боту WeChat отвечать на большее количество вопросов, связанных с Dify, для вас.

2.4. Подключение агентов к WeChat

2.4.1 Создание агентских приложений

Перейдите на страницу Studio, нажмите кнопку Create Blank App, выберите Agent, задайте значок и название приложения и нажмите кнопку Create.

После успешного создания мы попадаем на страницу конфигурации приложения Agent, где выбираем модель диалога, а затем добавляем инструменты. Сначала мы добавим инструмент рисования DALL-E, для первого использования которого необходимо авторизоваться, в общем, мы зададим ключ API OpenAI и URL базы OpenAI для использования инструмента рисования DALL-E.

После успешной авторизации мы добавили инструмент для рисования DALL-E 3

Затем добавьте поисковую систему DuckDuckGo и математический инструмент для последующего тестирования.

Вводим вопрос "Поиск количества звезд открытого проекта Dify, каково это число, умноженное на 3,14", убеждаемся, что приложение может вызвать инструмент правильно, нажимаем на релиз, обновление, доступ к API в свою очередь!

2.4.2. Генерация ключей API агента

Мы продолжаем ссылаться на2.1.1 Подраздел (4) Получение интеллектуального помощникаприкладнойКлюч APIвместе сАдрес сервера API

2.4.3 Доступ к WeChat

Мы создадим файл config.json в корневом каталоге проекта со следующим содержимым, а также поместим в него файлdify_api_baseсконфигурировать какинтеллектуальный помощникАдрес сервера API приложения;dify_api_keyсконфигурировать какинтеллектуальный помощникAPI-ключ для приложения, отметив, что приложение являетсяинтеллектуальный помощникПриложения этого типа также необходимо поместитьdify_app_typeустановленный на агент Остальные конфигурации остались без изменений.

Копировать

{
"dify_api_base":"https://api.dify.ai/v1",
"dify_api_key":"app-xxx",
"dify_app_type":"agent",
"channel_type":"wx",
"model":"dify",
"single_chat_prefix": [""],
"single_chat_reply_prefix":"",
"group_chat_prefix": ["@bot"],
"group_name_white_list": ["ALL_GROUP"]
}

постоянная ссылка2.2.1 ПодразделЗапустите приложение и отсканируйте код для входа в систему, а затем отправьте сообщение боту WeChat, чтобы проверить его работу

Видно, что бот WeChat может нормально использовать инструменты поиска и рисования. Еще раз поздравляем вас с внедрением приложения Dify Agent в WeChat. Также поздравьте меня, я могу спать первым после написания этой статьи.

2.5 Подключение рабочих процессов к WeChat

2.5.1 Создание приложений рабочего процесса

Для начала вам нужно загрузить файл DSL, который я заранее создал.Нажмите здесь, чтобы скачать. После завершения загрузки перейдите на страницу студии, нажмите Импортировать DSL-файл, загрузите файл, который вы скачали заранее, и нажмите Создать.

После создания выполните описанные выше шаги для тестирования. Нажмите кнопку Run и введите hello, чтобы убедиться, что рабочий процесс выводит результаты должным образом.

Вы можете развить этот рабочий процесс, но дляТип рабочего процессаПриложение, которое имеет очень гибкое имя переменной ввода, для того, чтобы легче получить доступ к WeChat робота, Dify на WeChat проект вовлеченияТип рабочего процессаконкретное применениеВходная переменная имеет имя<strong>query</strong>(математика) родВыходная переменная имеет имя<strong>text</strong>.

После тестирования без проблем выполните описанные выше действия для публикации приложения, нажав в этом порядке кнопки Publish, Update и Access API.

2.5.2. Генерация ключей API рабочего процесса

Мы в равной степени относимся к2.1.1 Подраздел (4) Приобретение рабочих процессовприкладнойКлюч APIвместе с Адрес сервера API .

2.5.3 Доступ к WeChat

Мы создадим файл config.json в корневом каталоге проекта со следующим содержимым, а также поместим в него файлdify_api_baseсконфигурировать какрабочий процессАдрес сервера API приложения;dify_api_keyсконфигурировать какрабочий процессAPI-ключ для приложения, отметив, что приложение являетсярабочий процессПриложения этого типа также необходимо поместитьdify_app_typeустановленный на рабочий процесс Остальные конфигурации остались без изменений.

Копировать

{
"dify_api_base":"https://api.dify.ai/v1",
"dify_api_key":"app-xxx",
"dify_app_type":"workflow",
"channel_type":"wx",
"model":"dify",
"single_chat_prefix": [""],
"single_chat_reply_prefix":"",
"group_chat_prefix": ["@bot"],
"group_name_white_list": ["ALL_GROUP"]
}

см. ту же ссылку2.2.1 ПодразделЗапустите программу и отсканируйте код для входа в систему, а затем отправьте сообщение боту WeChat, чтобы проверить его.

Вы видите, что робот успешно подключается к api рабочего процесса и отвечает. На данный момент мы полностью освоили создание всех типов приложений Dify: базового чат-ассистента, чат-ассистента рабочего процесса, интеллектуального ассистента, рабочего процесса, а также научились публиковать вышеперечисленные приложения как API и получать доступ к WeChat.

Далее я опишу, как получить доступ к приложению для других каналов WeChat, таких как публичный номер, приложение WeChat предприятия, служба поддержки WeChat предприятия и так далее.

3. Укажите доступ к личному номеру WeChat предприятия (только для среды windows)

1. есть риск получить свой номер Пожалуйста, используйте Enterprise WeChatскрипкаиспытание (машины и т.д.)
2. При входе в старую версию Enterprise WeChat может появиться Enterprise WeChat слишком низкой версии, не может войти в ситуацию, ссылкавыпуск1525Пожалуйста, попробуйте перейти на другой микросигнал предприятия и повторите попытку.

3.1. Загрузите и установите Enterprise WeChat

Убедитесь, что у вас есть компьютер с операционной системой windows, а затем загрузите и установите на него определенную версию enterprise microsoft.Официальная ссылка для скачивания(математика) родАльтернативные ссылки для скачивания.

3.2 Создание приложения Dify

Мы были перед 2.1.1 , и 2.3.2 , и2.4.1вместе с2.5.1В этих подразделах описано создание 4 различных приложений Dify - Basic Chat Assistant, Workflow Chat Assistant, Intelligent Assistant и Workflow - и вы можете создать любое из них в соответствии с приведенными выше руководствами.

3.3. Загрузка и установка Dify на WeChat

земля 2.1.2(2) шаг, загрузить код и установить зависимости, чтобы впоследствии следовать за зависимостями ntwork, шаг Убедитесь, что у вас установлен python версии 3.8, 3.9 или 3.10. .

3.4. Установка зависимостей ntwork

Поскольку источник установки ntwork не очень стабилен, вы можете загрузить соответствующий whl-файл и использовать его для установки ntwork в автономном режиме.

Первое, что вам нужно сделать, это проверить версию python: введите python в командной строке, чтобы увидеть информацию о версии, а затем в строкеntwork-whlкаталог, чтобы найти соответствующий whl-файл, запустите программуpip install xx.whlУстановите зависимости ntwork, обратите внимание, что "xx.whl" заменяется на файл whl Фактический путь .

Например, моя информация о версии python выглядит следующим образом

"Python 3.8.5 (по умолчанию, 3 сентября 2020, 21:29:08) [MSC v.1916 64 bit (AMD64)]".

Вы можете видеть, что версия python 3.8.5 и является AMD64 Соответствующий whl-файл ntwork-0.1.3-cp38-cp38-win_amd64.whl Если вы хотите установить его, выполните следующую команду

Копировать

pipinstallyour-path/ntwork-0.1.3-cp38-cp38-win_amd64.whl

3.5 Заполнение файла конфигурации

Мы создаем файл config.json в корневом каталоге проекта Dify on WeChat, ниже приведен файл конфигурации с приложением Dify intelligent assistant в качестве примера, пожалуйста, правильно заполните информацию dedify_api_base, dedify_api_key, dedify_app_type приложения, которое вы только что создали, обратите внимание, что channel_type заполняется как channel_key и channel_type заполняется как channel_type. тип - это wework

Копировать

{ 
"dify_api_base":"https://api.dify.ai/v1",
"dify_api_key":"app-xxx",
"dify_app_type":"agent",
"channel_type":"wework",
"model":"dify",
"single_chat_prefix": [""],
"single_chat_reply_prefix":"",
"group_chat_prefix": ["@bot"],
"group_name_white_list": ["ALL_GROUP"]
}

3.6 Вход в WeChat

Не забудьте заранее отсканировать код на своем компьютере для входа в Enterprise WeChat.

3.7 Запуск персонального робота WeChat

Выполните следующую команду, чтобы запустить робота

Копировать

cddify-on-wechat
pythonapp.py

Мы видим, что терминал выводит следующее сообщение. Дождитесь завершения инициализации программы wework. И наконец, стартап оказался успешным.

Копировать

[INFO][2024-04-30 21:16:04][wework_channel.py:185] - 等待登录······
[INFO][2024-04-30 21:16:05][wework_channel.py:190] - 登录信息:>>>user_id:xxx>>>>>>>>name:
[INFO][2024-04-30 21:16:05][wework_channel.py:191] - 静默延迟60s，等待客户端刷新数据，请勿进行任何操作······
[INFO][2024-04-30 21:17:05][wework_channel.py:224] - wework程序初始化完成········

Теперь мы отправляем сообщение боту и видим, что доступ был успешным!

4. Dify Access Public

Будет обновлено~

5. Отключите доступ к корпоративному приложению WeChat

Будет обновлено~

6. Dify доступ к службе поддержки WeChat предприятия

Будет обновлено~

7. постскриптум

Я социальный работник животных, энергия действительно ограничена, может работать только ночью и выходные свободное время для поддержания Dify на WeChat проекта, полагаться на мое личное развитие проекта прогресс очень медленно, я надеюсь, что вы можете участвовать в этом проекте, больше PR, так что экология Dify стать лучше ~!