agent-platform-skill-registry

Этот навык Google предназначен для работы с Skill Registry в Gemini Enterprise Agent Platform. Он описывает не абстрактный каталог файлов, а набор операций вокруг реестра навыков: поиск доступных записей, получение конкретного навыка, просмотр истории ревизий, загрузка нового навыка, обновление существующего и его окончательное удаление. Отдельная часть workflow отвечает за мониторинг длительных операций и проверку их завершения. В комплект также входит сценарий первоначального создания локального каркаса навыка. Главное правило документа — до любой операции выполнить проверку окружения. Для этого предусмотрен scripts/validate_env.py; его нужно запустить до поиска, регистрации, изменения или удаления записи. Такая последовательность отделяет проблему локальной подготовки от ошибки самого реестра. Успешная проверка не означает, что последующая операция гарантированно завершится: она лишь подтверждает обязательный предварительный этап, после которого можно переходить к выбранному действию. Для работы требуются библиотеки google-auth и requests, а также настроенные Google Cloud credentials. В инструкции явно назван интерактивный вариант аутентификации через gcloud auth application-default login. Проект и регион передаются через GCP_PROJECT_ID и GCP_LOCATION; второй параметр должен содержать регион, например us-central1. Эти значения относятся к окружению Google Cloud, поэтому их нужно подставлять из конкретного проекта и не зашивать в исходный код или команды общего назначения. Если credentials, проект или регион не определены, навык не заменяет их догадкой. Самый короткий сценарий — поиск навыков через scripts/skill_registry_ops.py search с запросом и ограничением top-k. Для более точной работы предусмотрены отдельные документы query-skills.md, manage-skills.md, monitor-operations.md и generate-skill.md. Их назначение различается: поиск и чтение не требуют того же порядка действий, что публикация или удаление. Перед изменением состояния следует выбрать соответствующий reference-файл и проверить параметры конкретной операции, а для долгого запроса — дождаться подтверждённого результата через механизм мониторинга. Реестр полезен, когда агенту нужно обнаруживать повторно используемые возможности, публиковать новую функциональность или поддерживать ревизии уже зарегистрированного навыка. Generate Skill помогает начать с локальной структуры, но созданный каркас сам по себе не становится качественным или опубликованным навыком. Upload и update требуют проверки содержимого, идентификатора проекта, региона и полномочий. Delete в описании назван постоянным удалением, поэтому его нельзя рассматривать как обычное временное скрытие. Ограничения нужно учитывать отдельно. Навык не доказывает, что у текущего principal есть IAM-права, что регион доступен, что реестр отвечает или что загружаемый навык прошёл внутренний review. Он также не выполняет за пользователя проверку бизнес-логики, секретов, внешних зависимостей или безопасности исполняемых скриптов. Результат операции нужно подтверждать ответом сервиса и, если действие асинхронное, финальным статусом длительной операции. Для discovery достаточно чтения; для lifecycle-изменений нужны явные входные данные и отдельный контроль необратимых действий.