agents-build

Этот навык AWS предназначен для расширения уже существующего проекта Amazon Bedrock AgentCore. Он маршрутизирует задачи добавления межсессионной памяти, вызова агента из web-, mobile- или backend-приложения, настройки VPC для приватных ресурсов, построения multi-agent-схем с orchestrator и specialist, миграции Bedrock Agent, подключения Browser tool и Code Interpreter, добавления AgentCore Payments и удаления ресурсов. Навык принимает как короткую capability, так и описание результата: например, сохранить предпочтения пользователя, вызвать агента из React-приложения, подключиться к RDS через приватную сеть, запустить pandas в sandbox или разобрать teardown. Граница применимости принципиальна. Подключение внешних API, Lambda, OpenAPI, MCP-серверов, credential и policy относится к «agents-connect»; создание нового проекта — к «agents-get-started»; обычное развертывание — к «agents-deploy»; исправление ошибок и отказавших инструментов — к «agents-debug». Сам build-навык добавляет возможности в работающий проект и не должен подменять эти workflows. Для email, Gateway или другой интеграции сначала нужно определить, не является ли запрос connect/debug-задачей. До выбора workflow проверяется версия CLI: «agentcore --version» должна быть не ниже 0.9.0. Затем читается «agentcore/agentcore.json», чтобы понять framework, ресурсы и конфигурацию агента. Если файла нет, нужно проверить родительские каталоги максимум на три уровня; при найденном проекте уточняется рабочая директория. Если проекта рядом нет, сначала выясняется требуемая capability и предлагается создать проект или вернуться в правильный каталог. После маршрутизации загружается конкретная reference-инструкция: memory, integrate, vpc, multi-agent, request-headers, migrate, browser, code-interpreter, payments или teardown. Для изменения модели используется «app/<AgentName>/model/load.py», где меняется параметр «model_id» в «BedrockModel()». Cross-region prefixes «us.», «eu.», «apac.» и «global.» определяют региональный режим, но доступность профиля нужно проверить для конкретной модели. После смены модели проверяются Model access в Bedrock и destination regions, а при использовании agents-harden обновляется IAM policy; затем проект проверяется через «agentcore dev», а опубликованная версия обновляется через deployment workflow. Файл «agentcore.json» для самой смены model_id не требуется. Отдельный pre-flight касается имён. Для agent, memory, gateway, gateway-target, credential, evaluator, online-eval, policy, policy-engine, payment-manager и payment-connector разрешено не более 48 символов, только буквы, цифры и «_», имя начинается с буквы. Hyphen, точка и пробел недопустимы; имя нужно проверить до построения CLI-команды, потому что ошибка иначе возникает поздно после интерактивных шагов. Для «agentcore create --name» действует более строгий предел 23 символа и запрет подчёркивания. Workflow удобен как карта решений: сначала подтверждается существующий AgentCore-контекст и версия CLI, затем выбирается узкая capability и соответствующая reference, а опасные имена и неверные границы отсекаются до команды. Не следует использовать build для нового проекта, внешнего Gateway, deployment или debug; teardown требует собственного осторожного сценария.