Что ИИ-агент умеет делать в Cloud.ru
- Вызывает LLM через Foundation Models API. Скилл cloudru-foundation-models из набора Cloud.ru отправляет запросы готовым моделям.
- Разворачивает свои модели на GPU. Скилл cloudru-ml-inference из того же набора управляет ML-развертываниями. Скилл cloudru-vm создает и настраивает виртуальные машины.
- Отвечает по базе знаний. cloudru-managed-rag ведет базы знаний и семантический поиск, а MCP-сервер Evolution Managed RAG отдает агенту контекст из готовой базы одним инструментом request_to_rag.
- Подключает kubectl к Managed Kubernetes. cloudlogin получает токен по персональным ключам и перевыпускает его при истечении.
- Переносит проект с Lovable. Скилл переезда поднимает self-hosted Supabase на сервере Cloud.ru, настраивает домен, HTTPS через Caddy и платежи ЮKassa.
- Учит публиковать свой сервер. MCP-сервер курсов валют ЦБ показывает сборку образа и деплой в Container Apps.
Как получить ключ API Cloud.ru
API Cloud.ru принимает три вида учетных данных: ключ доступа сервисного аккаунта, персональный ключ доступа и API-ключ. Ключи доступа (keyId и secret) обменивают на токен через iam.api.cloud.ru. Такой токен живет 1 час. API-ключ передают напрямую в заголовке Authorization: Api-Key. Документация называет этот способ менее защищенным.
Скиллам Cloud.ru нужны переменные CP_CONSOLE_KEY_ID, CP_CONSOLE_SECRET, PROJECT_ID и отдельный ключ Foundation Models API. В агента набор добавляет npx skillfoxx add skills/cloud-ru-skills-dlya-ai-agentov.
Ключ для Foundation Models выпускают в четыре шага.
- В личном кабинете, в разделе «Пользователи» на вкладке «Сервисные аккаунты», создается аккаунт уровня проекта с нужной ролью.
- В учетных данных этого аккаунта выпускают API-ключ для сервиса Foundation Models со сроком от 1 дня до 1 года.
- Key Secret сохраняют сразу: после закрытия окна его не получить.
- Запросы идут на foundation-models.api.cloud.ru/v1. Эндпоинт принимает формат chat.completions из спецификации OpenAI.
Официальные инструменты и проекты сообщества
Сама Cloud.ru выпустила набор скиллов, cloudlogin, сервер Managed RAG и учебный сервер курсов валют. У набора скиллов широкий доступ: он создает и удаляет виртуальные машины и ML-развертывания с оплатой по факту. Минимальный доступ у сервера курсов, потому что он только читает публичные курсы. cloudlogin и сервер Managed RAG получили расширенный.
Из проектов сообщества широкий доступ у скилла переезда с Lovable, потому что он выполняет команды по ssh на боевом сервере. MCP-сервер Yougile сделан на хакатоне cloud.ru для связки с Evolution AI Agents и умеет только создать задачу и собрать сводку. Все инструменты работают без VPN. Под проект на другом облаке Foxx AI соберет свой набор инструментов.
Ограничения и безопасность
Агент с ключом проекта тратит деньги, ведь виртуальные машины и GPU оплачиваются по факту. Безопаснее выдать сервисному аккаунту роль только в тестовом проекте и ограничить срок ключа. В быстром старте Cloud.ru приводит в пример срок 90 дней.
Учебные серверы Managed RAG и курсов валют больше года без обновлений. Их удобно разбирать как образец, но собрать и развернуть их придется самому. Транспорт у MCP Managed RAG пока только SSE.
cloudlogin кеширует токен в $HOME/.cloudru/.token и ставится из архива вручную.