С помощью этого руководства вы запустите AI-агента Ouroboros в Container Apps, подключите сервис Foundation Models и интегрируете его с агентом.
Вы будете использовать следующие сервисы:
Маркетплейс — витрина готовых сервисов для развертывания в облаке.
Container Apps — сервис для запуска контейнерных приложений в облаке. Не требует знания Kubernetes и создания виртуальных машин.
Ouroboros — AI-агент, способный самостоятельно писать код и улучшать архитектуру.
Foundation Models — сервис для доступа к API популярных фундаментальных моделей машинного обучения с открытым исходным кодом.
Шаги:
Перед началом работы
Если вы уже зарегистрированы, войдите под своей учетной записью.
1. Запустите приложение из Маркетплейса
Перейдите в сервис «Маркетплейс» <https://marketplace.cloud.ru/>.
В строке поиска введите Ouroboros one click и нажмите на карточку в результатах выдачи.
В карточке сервиса нажмите кнопку Запустить контейнер.
В результате появится форма создания Container Service и первой ревизии.
ПримечаниеВ конфигурации установлены базовые параметры для работы образа. При необходимости вы можете их изменить. Минимальная конфигурация для работы «Ouroboros one click» — 0.2 vCPU - 512 MB.
В нижней части формы нажмите Создать.
Контейнер перейдет в статус «Создается», дождитесь перехода в статус «Выполняется».
Когда контейнер перейдет в статус «Выполняется», скопируйте Публичный URL.
В строке браузера укажите скопированное значение.
В результате откроется веб-интерфейс Ouroboros.
ПодсказкаАгент может не отвечать на ваши сообщения в чате — это ожидаемый результат на этом шаге. В следующих шагах вы подключите модели и агент начнет работать.
2. Создайте сервисный аккаунт
На верхней панели слева нажмите
и перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.
В правом верхнем углу нажмите Создать аккаунт.
Задайте для сервисного аккаунта название и описание.
Нажмите Продолжить.
Назначьте роль на проект «Администратор проекта».
Роль определяет права доступа сервисного аккаунта.
Нажмите Создать.
3. Сгенерируйте API-ключ
На верхней панели слева нажмите
и перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.Нажмите на название сервисного аккаунта, который будете использовать для отправки запроса к модели.
В разделе Учетные данные доступа нажмите Создать API-ключ.
Введите название и описание API-ключа, которое поможет в будущем идентифицировать его среди других ключей.
Заполните параметры API-ключа:
Сервисы — Foundation Models.
Время действия — срок действия API-ключа и часовой пояс. Вы можете установить значение от одного дня до одного года с текущей даты. Если параметр не задан, срок действия ключа устанавливается на максимальное значение — один год. Из соображений безопасности рекомендуется выставлять средние значения, например 90 дней.
Интервал работы ключа — один или несколько интервалов времени, в которые можно использовать API-ключ.
Нажмите Создать.
Сохраните Key Secret. После закрытия окна получить его будет нельзя.
Созданный API-ключ появится в списке ключей в статусе «Активен». Подробнее о работе с API-ключом.
4. Настройте интеграцию агента с Foundation Models
В веб-интерфейсе Ouroboros перейдите в раздел Settings.
На вкладке AI Providers раскройте раздел Cloud.ru Foundation Models.
В поле API Key введите значение Key Secret, полученное на шаге 3.
Внизу страницы нажмите Save Settings.
В блоке AI Models укажите нужные модели из списка доступных.
Внизу страницы нажмите Save Settings.
5. Проверьте работу агента
В веб-интерфейсе Ouroboros перейдите в раздел Chat.
Отправьте сообщение, например: Расскажи, чем ты отличаешься от других AI-агентов.
AI-агент Ouroboros готов к работе.
Результат
Вы запустили Ouroboros в Container Apps и интегрировали его с сервисом Foundation Models. В результате получили готового к работе AI-агента, который отвечает в веб-интерфейсе и выполняет задачи.