Перейти до вмісту
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