gemini managed agents api
Manages custom Agent resources on Gemini Enterprise Agent Platform. Use when the user wants to programmatically create, configure, list, update, or delete stateful, server-managed Agent resources (including mounting files, skills, and tools) before executing conversations.
Что делает навык
Навык обеспечивает программное управление пользовательскими ресурсами Agent на Gemini Enterprise Agent Platform через Control Plane API. Он позволяет создавать, настраивать, обновлять, просматривать список и удалять постоянные (stateful) контейнеры агентов с инструкциями, файлами и инструментами.
Когда применять
- Программное создание новых агентов с кастомными инструкциями и подключенными инструментами.
- Монтирование файлов, папок или реестров навыков (Skill Registry) из Google Cloud Storage в рабочее пространство агента.
- Настройка подключения к внешним серверам Model Context Protocol (MCP) для выполнения инструментов.
- Обновление конфигурации существующего агента (например, изменение системных инструкций) без пересоздания.
- Удаление неиспользуемых ресурсов агентов для освобождения контейнеров.
Как работает
- Настроить переменные окружения PROJECT_ID, LOCATION и получить ACCESS_TOKEN через gcloud auth print-access-token.
- Отправить POST-запрос на endpoint /agents с JSON-пейлоадом для создания агента (создание является Long-Running Operation).
- Получить объект операции из ответа и периодически опрашивать статус через GET-запрос к URL операции до завершения.
- Использовать GET-запрос для получения конфигурации конкретного агента или GET-запрос к списку /agents для просмотра всех агентов проекта.
- Отправить PATCH-запрос с параметром update_mask для изменения полей существующего агента.
- Отправить DELETE-запрос для удаления ресурса агента.
Примеры запросов агенту
Что понадобится
- Доступ к Google Cloud и установленный gcloud CLI для получения токена доступа.
- Переменные окружения PROJECT_ID и LOCATION (например, 'global').
- Активный Bearer-токен, полученный через Application Default Credentials (ADC).
Описание составлено по SKILL.md навыка, сверено 06.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.