Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Імпорт проєкту CrewAI — команда з двох агентів

Оголошення агентів і завдань проєкту CrewAI у класичній структурі — два агенти на одній моделі OpenAI, по одному завданню на кожного, — перетворені командою aggrega import на чернетки файлів Aggrega, з образом, у якому працює програма crew, указаним один раз у файлі відповідей, і зібрані для Docker Compose.

Імпорт проєкту CrewAI покроково описує цей процес: команду, що вона запитує, файли, які вона записує, і навіщо в них кожен рядок, збірку та роботу crew. У цій теці зберігається кожен етап цього покрокового опису:

тека або файлщо містить
source/оголошення проєкту src/support_brief/config/agents.yaml і tasks.yaml, файл .aggrega-config.yaml, який робить теку робочим простором, і src/support_brief/import-answers.yaml — значення, яких не містить жодне оголошення: образ кожного агента та ім’я Kubernetes Secret, з якого збірка для Kubernetes читає ключ OpenAI
draft/файли, які записала команда aggrega import src/support_brief --target compose, без змін, включно з release.lock, і те, що вона вивела: stdout.txt — стандартний вивід, import.txt — стандартний потік помилок

Оголошення написано для цього прикладу. Програма команди до прикладу не входить: імпорт ніколи її не читає, а образ, у якому вона працює, задає Release.

У клоні репозиторію документації check.sh знову запускає імпорт, порівнює те, що він записує й виводить, із draft/, порівнює блоки, які цитує покроковий опис, із цими файлами, а також перевіряє та збирає те, що записав імпорт. Для цього каталог стандартної бібліотеки (де його взяти) має бути розгорнутий поруч із цим репозиторієм або його директорію має бути вказано в AGGREGA_CATALOG_DIRS.

Створення прикладу

Імпорт цього прикладу можна запустити командами нижче або доручити його запуск своєму ШІ-асистентові.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example import-crewai

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd import-crewai

Збирання

Імпорт створює чернетки файлів Aggrega поруч із проєктом, у source/. Він зіставляє проєкт із каталогом стандартної бібліотеки, який типовий реєстр робочого простору публікує як підписаний знімок: перший імпорт завантажує його, перевіряє, зберігає в кеші вмісту робочого простору й називає за його дайджестом у записі, який створює поруч із чернетками. Робочий простір, що вказує власні теки каталогу — в AGGREGA_CATALOG_DIRS або в workspace.catalog_dirs, — натомість імпортує відносно них. Імпорт читає образи з src/support_brief/import-answers.yaml, а потім завантажує те, від чого залежить чернетка сутності Release, тож збірка може відбутися одразу:

Terminal window
cd source
aggrega import src/support_brief --target compose
aggrega build --release release.yaml

Образ, який називає приклад, заміняє той, що ви збираєте зі свого проєкту; його збирання та запуск стеку описано в покроковому описі за посиланням вище.

З ШІ-асистентом

ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.

Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочої області ще не містить теки `import-crewai`, викличте один раз інструмент `scaffold`, задавши для `example` значення `import-crewai` і не вказуючи `dir`: він запише приклад у нову теку `import-crewai`, тека `source` якої містить те, що імпортує цей приклад. Потім викличте інструмент `import`, задавши `workspace_root` значення `import-crewai/source`, `source` — `src/support_brief`, а `target` — `compose`: він читає потрібні йому відповіді з `import-answers.yaml` у теці `src/support_brief`, записує свої чернетки в `import-crewai/source` і завантажує те, що їм потрібно. Потім викличте інструмент `validate`, задавши `workspace_root` значення `import-crewai/source`, а `release` — `release.yaml`, та інструмент `build`, задавши `workspace_root` значення `import-crewai/source`, `release` — `release.yaml`, а `write` — true. Скажіть мені, які файли записала збірка; вони розташовані в `import-crewai/source/dist/`.

Тестування

Коли стек працює так, як його запускає посібник, один запит досягає crew. Наведений нижче маршрут належить власній програмі посібника, невеликому HTTP-серверу на порту 8000; ваша власна програма визначає свій. Сутність Release публікує дослідника на 127.0.0.1:8000, а автора — на 127.0.0.1:8001, тож запит іде до дослідника з вашої машини:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'
{
"error": "the crew failed: AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the error's type and code]"
}

Ключ цього запуску був заповнювачем, тому відповіддю є відмова OpenAI щодо нього. У Kubernetes перенаправте локальний порт на Deployment, який не має Service, і надішліть йому той самий запит з іншого термінала:

Terminal window
kubectl port-forward deploy/researcher 8000:8000
Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'

Відповідь та сама.