Перейти к содержимому
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?"}'

Ответ тот же.