С помощью этого руководства вы запустите AI-агента Ouroboros в Container Apps, подключите сервис Foundation Models и интегрируете его с агентом.
Вы будете использовать следующие сервисы:
Маркетплейс — витрина готовых сервисов для развертывания в облаке.
Container Apps — сервис для запуска контейнерных приложений в облаке. Не требует знания Kubernetes и создания виртуальных машин.
Ouroboros one click — AI-агент, способный самостоятельно писать код и улучшать архитектуру.
Foundation Models — сервис для доступа к API популярных фундаментальных моделей машинного обучения с открытым исходным кодом.
Object Storage — объектное S3-хранилище с бесплатным хранением файлов объемом до 15 ГБ.
Шаги:
Перед началом работы
Если вы уже зарегистрированы, войдите под своей учетной записью.
1. Создайте сервисный аккаунт
На верхней панели слева нажмите
и перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.
В правом верхнем углу нажмите Создать аккаунт.
Задайте для сервисного аккаунта название и описание.
Нажмите Продолжить.
Назначьте роль на проект «Администратор проекта».
Роль определяет права доступа сервисного аккаунта.
Нажмите Создать.
2. Сгенерируйте API-ключ
На верхней панели слева нажмите
и перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.Нажмите на название сервисного аккаунта, который будете использовать для отправки запроса к модели.
В разделе Учетные данные доступа нажмите Создать API-ключ.
Введите название и описание API-ключа, которое поможет в будущем идентифицировать его среди других ключей.
Заполните параметры API-ключа:
Сервисы — Foundation Models.
Время действия — срок действия API-ключа и часовой пояс. Вы можете установить значение от одного дня до одного года с текущей даты. Если параметр не задан, срок действия ключа устанавливается на максимальное значение — один год. Из соображений безопасности рекомендуется выставлять средние значения, например 90 дней.
Интервал работы ключа — один или несколько интервалов времени, в которые можно использовать API-ключ.
Нажмите Создать.
Сохраните Key Secret. После закрытия окна получить его будет нельзя.
Созданный API-ключ появится в списке ключей в статусе «Активен». Подробнее о работе с API-ключом.
3. Создайте бакет в сервисе Object Storage
В сервисе Object Storage создайте новый бакет со следующими параметрами:
Название — <your_name>-ouroboros, например name-ouroboros.
Доменное имя — <your_name>-ouroboros, например name-ouroboros.
Класс хранения по умолчанию — Стандартный.
Максимальный размер — отключите или укажите на свое усмотрение.
Убедитесь, что в личном кабинете на странице сервиса Object Storage:
в списке бакетов отображается созданный вами бакет;
класс хранения — Стандартный.
4. Запустите приложение из Маркетплейса
В строке поиска введите Ouroboros one click и нажмите на карточку в результатах выдачи.
В карточке сервиса нажмите кнопку Запустить контейнер.
В результате появится форма создания Container Service и первой ревизии.
ПримечаниеВ конфигурации установлены базовые параметры для работы образа. При необходимости вы можете их изменить. Минимальная конфигурация для работы «Ouroboros one click» — 0.2 vCPU - 512 MB.
Образ из Маркетплейса содержит следующие переменные:
Ключ — OUROBOROS_REPO_DIR, Значение — /opt/ouroboros.
Ключ — OUROBOROS_DATA_DIR, Значение — /mnt/ouroboros-data.
(Опционально) В разделе Монтирование постоянного тома в поле Бакет из Object Storage выберите бакет сервиса Object Storage, который вы создали на шаге 1.
В главный контейнер приложения будет автоматически смонтирован том со следующими параметрами:
Тип — Постоянный.
Название — автоматически сгенерированное название вида volume....
Бакет из Object Storage — бакет сервиса Object Storage, который вы создали на шаге 1.
Путь (path) — /mnt.
Параметры тома не отображаются в мастере создания контейнера.
В разделе Главный контейнер перейдите на вкладку Переменные и в поле Значение для переменной OPENROUTER_API_KEY укажите значение Key Secret, полученное на шаге 2.
В нижней части формы нажмите Создать.
Контейнер перейдет в статус «Создается», дождитесь перехода в статус «Выполняется».
Когда контейнер перейдет в статус «Выполняется», скопируйте Публичный URL.
В строке браузера укажите скопированное значение.
В результате откроется веб-интерфейс Ouroboros.
ПодсказкаАгент может не отвечать на ваши сообщения в чате — это ожидаемый результат на этом шаге. В следующих шагах вы подключите модели и агент начнет работать.
5. Настройте интеграцию агента с Foundation Models
В веб-интерфейсе Ouroboros перейдите в раздел Settings.
На вкладке AI Providers раскройте раздел Cloud.ru Foundation Models.
Проверьте, что значение в поле API Key совпадает со значением Key Secret, полученным на шаге 2.
В блоке AI Models укажите нужные модели из списка доступных.
Внизу страницы нажмите Save Settings.
6. Проверьте работу агента
В веб-интерфейсе Ouroboros перейдите в раздел Chat.
Отправьте сообщение, например: Расскажи, чем ты отличаешься от других AI-агентов.
AI-агент Ouroboros готов к работе.
Результат
Вы запустили Ouroboros в Container Apps и интегрировали его с сервисом Foundation Models. В результате получили готового к работе AI-агента, который отвечает в веб-интерфейсе и выполняет задачи. Ваши данные синхронизируются с постоянным томом Object Storage. Данные сохраняются, когда запросы к приложению не поступают.