Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Импорт приложения Dify — чат-ассистент в установке Dify

Чат-приложение Dify, экспортированное в DSL Dify, импортированное командой aggrega import в сущности Aggregate, Release и Manifest, которые собирают установку Dify из стандартной библиотеки, содержащую это приложение, для Kubernetes в том виде, в каком они написаны.

Импорт приложения Dify пошагово разбирает этот процесс: команду, файлы, которые она записывает, сборку и запуск того, что она собирает. В этой папке хранится каждый этап этого руководства:

папкачто содержит
source/приложение support-assistant.yml; файл .aggrega-config.yaml, который делает папку рабочим пространством; и import-answers.yaml — ответы на то, чего не может содержать ни одно приложение: имена Kubernetes Secrets, в которых хранятся секрет приложения установки и пароль владельца, и адрес электронной почты учётной записи владельца
draft/файлы, которые записала команда aggrega import support-assistant.yml --target helm, без изменений, и то, что она вывела: stdout.txt — стандартный вывод, import.txt — стандартный поток ошибок

source/support-assistant.yml написан для этого примера в той форме, в которой Dify экспортирует приложение в версии DSL 0.7.0.

В клоне репозитория документации check.sh повторно запускает импорт, сравнивает то, что он записывает и выводит, с draft/, сравнивает блоки, которые цитирует руководство, с этими файлами, а также валидирует и собирает то, что записал импорт. Для этого каталог стандартной библиотеки (где его взять) должен быть извлечён рядом с этим репозиторием или его директория должна быть указана в AGGREGA_CATALOG_DIRS.

Создание примера

Импорт этого примера можно запустить командами ниже или поручить его запуск своему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example import-dify

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd import-dify

Сборка

Импорт создаёт черновики файлов Aggrega рядом с проектом, в source/, берёт из import-answers.yaml то, чего не может содержать ни одно приложение, и загружает то, что нужно для сборки. Он сопоставляет проект с каталогом стандартной библиотеки, который реестр по умолчанию рабочего пространства публикует в виде подписанного снимка: первый импорт загружает его, проверяет, сохраняет в кэше содержимого рабочего пространства и указывает его по дайджесту в записи, которую создаёт рядом с черновиками. Рабочее пространство, которое указывает собственные папки каталога — в AGGREGA_CATALOG_DIRS или в workspace.catalog_dirs, — вместо этого импортирует относительно них:

Terminal window
cd source
aggrega import support-assistant.yml --target helm
aggrega validate --release release.yaml
aggrega build --release release.yaml

Создание Secrets, которые читают манифесты сборки, и их запуск описаны в пошаговом руководстве, ссылка на которое приведена выше.

С ИИ-ассистентом

ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.

Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочей области ещё нет папки `import-dify`, вызовите один раз инструмент `scaffold`, задав для `example` значение `import-dify` и не указывая `dir`: он запишет пример в новую папку `import-dify`, папка `source` которой содержит то, что импортирует этот пример. Затем вызовите инструмент `import`, задав `workspace_root` значение `import-dify/source`, `source` — `support-assistant.yml`, а `target` — `helm`: он читает нужные ему ответы из `import-answers.yaml` рядом с `support-assistant.yml`, записывает свои черновики в `import-dify/source` и загружает то, что им нужно. Затем вызовите инструмент `validate`, задав `workspace_root` значение `import-dify/source`, а `release` — `release.yaml`, и инструмент `build`, задав `workspace_root` значение `import-dify/source`, `release` — `release.yaml`, а `write` — true. Скажите мне, какие файлы записала сборка; они находятся в `import-dify/source/dist/`.

Тестирование

После импорта с --target compose и запуска так, как показывает раздел руководства В Docker Compose, установка отвечает на этой машине: API по адресу http://127.0.0.1:5001, а консоль — по адресу http://127.0.0.1:3001/signin. Приложение отвечает на сообщение, отправленное с его собственным ключом, который руководство создаёт после входа, установки поставщика OpenAI из маркетплейса плагинов Dify, доступ к которому установке даёт marketplace_enabled черновой сущности Release, и настройки ключа поставщика:

Terminal window
curl -sS http://127.0.0.1:5001/v1/chat-messages \
-H 'Authorization: Bearer <app key>' -H 'Content-Type: application/json' \
-d '{"inputs": {}, "query": "In one short sentence: what does a support plan cover?", "response_mode": "blocking", "user": "test-it"}'

Ключ поставщика в этом запуске был заглушкой, которую Dify при настройке отклонил сообщением OpenAI Incorrect API key provided, поэтому сообщение получило:

{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}

После сборки, как описано выше, для Kubernetes и применения так, как его применяет раздел руководства Запуск, API отвечает на те же запросы по тому же адресу, как только локальный порт перенаправлен на его Service; запуск получил там те же ответы:

Terminal window
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001