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

Импорт декларативного агента Microsoft Agent Framework — агент и сервер MCP

Декларативный агент Microsoft Agent Framework — один агент на модели OpenAI, ищущий документацию через сервер MCP, — преобразованный командой aggrega import в черновики файлов Aggrega, причём образ приложения указан один раз в файле ответов, и собранный для Docker Compose.

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

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

Декларативный агент написан для этого примера. Код приложения, который его загружает, в пример не входит: импорт никогда его не читает, а образ, в котором работает приложение, указывает Release.

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

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

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

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

Terminal window
aggrega scaffold --example import-agent-framework

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

Terminal window
cd import-agent-framework

Сборка

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

Terminal window
cd source
aggrega import support-agent.yaml --target compose
aggrega build --release release.yaml

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

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

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

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

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

Когда стек запущен так, как его запускает пошаговое руководство, один запрос достигает агента. Маршрут ниже принадлежит собственной программе руководства — небольшому HTTP-серверу на порту 8000; ваша собственная программа определяет свой. Сущность Release публикует агента на 127.0.0.1:8000, поэтому запрос отправляется с вашей машины:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'
{"error": "the agent failed: ChatClientException: (\"<class 'agent_framework_openai._chat_client.OpenAIChatClient'> service failed to complete the prompt: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the same error repeated as the exception it wraps]"}

Ключ этого запуска был заполнителем, поэтому ответом является отказ OpenAI принять его. В Kubernetes перенаправьте локальный порт на Deployment, у которого нет Service, и отправьте ему тот же запрос из другого терминала:

Terminal window
kubectl port-forward deploy/supportagent 8000:8000
Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'

Ответ тот же.