Создание AI-агента на основе Ouroboros с Foundation Models

Перед началом работы

1. Разверните ресурсы в облаке

1. Сгенерируйте ключевую пару:

   1. На локальном устройстве откройте терминал и выполните команду.

      ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519
      
      

      Если система спросит, куда сохранить ключ — нажмите Enter, будет использован путь по умолчанию. Если система спросит о небходимости passphrase — можете задать парольную фразу, это повысит безопасность.

      В результате будут сгенерированы два файла:

      • ~/.ssh/id_ed25519 — приватная часть ключа, хранится на вашем устройстве.

      • ~/.ssh/id_ed25519.pub — публичная часть ключа, загружается в облако Cloud.ru.

   2. Проверьте, что файлы сгенерированы.

      ls -l ~/.ssh/id_ed25519 ~/.ssh/id_ed25519.pub
      
      

      В результате отобразится информация о файлах.

   3. Чтобы просмотреть публичный ключ, выполните команду.

      cat ~/.ssh/id_ed25519.pub
      
      

      В результате отобразится значение публичного ключа — скопируйте его, оно понадобится далее.

2. Загрузите публичный ключ, созданный на предыдущем шаге.

3. Создайте бесплатную виртуальную машину со следующими параметрами:

   • Название — ouroboros.

   • Образ — на вкладке Маркетплейс выберите образ Ouroboros E.

     В образе используется операционная система Ubuntu 24.04.

     Внимание

     Необходимо выбрать образ Ouroboros E. Образ Ouroboros для этого сценария не подойдет.

   • Публичный IP — оставьте Арендовать новый или выберите IP-адрес из списка арендованных.

   • Логин — оставьте значение по умолчанию или укажите новый.

   • Метод аутентификации — Публичный ключ и Пароль.

   • Пароль — задайте пароль пользователя.

   • Остальные параметры оставьте по умолчанию или выберите на свое усмотрение.

4. Убедитесь, что в личном кабинете на странице Инфраструктура → Виртуальные машины отображается виртуальная машина со статусом «Запущена» и назначенным публичным IP-адресом.

5. Уточните зону доступности, в которой была создана виртуальная машина.

6. Убедитесь, что в личном кабинете на странице Сеть → Группы безопасности есть группа с тегом «Default», которая расположена в той же зоне доступности, что виртуальная машина.

   Если группы нет, создайте группу безопасности с названием ouroboros в той же зоне доступности и добавьте в нее правила:

   • Трафик — Входящий.

   • Протокол — TCP.

   • Порт — 22.

   • Тип источника/адресата — IP-адрес.

   • Источник/Адресат — IP-адрес вашего устройства с маской 32, например 0.0.0.0/32.

7. Назначьте созданную группу безопасности виртуальной машине.

8. Проверьте создание ресурсов:

   1. Убедитесь, что в личном кабинете на странице Сети → Группы безопасности отображается группа безопасности ouroboros со статусом «Создана».

   2. Убедитесь, что в личном кабинете на странице Инфраструктура → Виртуальные машины отображается виртуальная машина ouroboros со статусом «Запущена» и ей назначен публичный IP-адрес.

   3. Скопируйте и сохраните публичный IP-адрес. Он понадобится далее.

2. Настройте доступ к веб-интерфейсу

1. Подключитесь к виртуальной машине ouroboros по SSH, выполнив команду на своем компьютере:

   ssh -i ~/.ssh/id_ed25519 ouroboros@public_ip
   
   

   Где:

   • ~/.ssh/id_ed25519 — путь до файла с приватной частью SSH-ключа.

   • ouroboros — имя пользователя виртуальной машины, созданной на шаге 1.

   • public_ip — публичный IP‑адрес вашей виртуальной машины.

   Если при подключении возникают ошибки, обратитесь к разделу Решение проблем.

2. Чтобы убедиться в работе образа, проверьте доступ к порту 8765:

   ss -ltnp | grep 8765
   
   

   В результате отобразится строка с указанным портом. Если порт не отображается, подождите несколько минут и повторите команду.

   Внимание

   Не закрывайте терминал до окончания работы с сервисом — это необходимо для работы веб-интерфейса.

3. Чтобы создать SSH-туннель, на своем компьютере выполните:

   ssh -i ~/.ssh/id_ed25519 -L 8765:127.0.0.1:8765 ouroboros@public_ip
   
   

   Где:

   • ~/.ssh/id_ed25519 — путь до файла с приватной частью SSH-ключа.

   • ouroboros — имя пользователя виртуальной машины, созданной на шаге 1.

   • public_ip — публичный IP‑адрес вашей виртуальной машины.

4. В браузере откройте ссылку на веб-интерфейс Ouroboros:

   http://127.0.0.1:8765
   
   

   Откроется веб-интерфейс Ouroboros:

   
   Подсказка

   Агент может не отвечать на ваши сообщения в чате — это ожидаемый результат на этом шаге. В следующих шагах вы подключите модели и агент начнет работать.

3. Создайте сервисный аккаунт

1. На верхней панели слева нажмите и перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.

   

2. В правом верхнем углу нажмите Создать аккаунт.

   

3. Задайте для сервисного аккаунта название и описание.

4. Нажмите Продолжить.

5. Назначьте роль на проект «Администратор проекта».

   Роль определяет права доступа сервисного аккаунта.

   

6. Нажмите Создать.

4. Сгенерируйте API-ключ

1. На верхней панели слева нажмите и перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.

2. Нажмите на название сервисного аккаунта, который будете использовать для отправки запроса к модели.

   

3. В разделе Учетные данные доступа нажмите Создать API-ключ.

   

4. Введите название и описание API-ключа, которое поможет в будущем идентифицировать его среди других ключей.

5. Заполните параметры API-ключа:

   • Сервисы — Foundation Models.

   • Время действия — срок действия API-ключа и часовой пояс. Вы можете установить значение от одного дня до одного года с текущей даты. Если параметр не задан, срок действия ключа устанавливается на максимальное значение — один год. Из соображений безопасности рекомендуется выставлять средние значения, например 90 дней.

   • Интервал работы ключа — один или несколько интервалов времени, в которые можно использовать API-ключ.

6. Нажмите Создать.

7. Сохраните Key Secret. После закрытия окна получить его будет нельзя.

   Созданный API-ключ появится в списке ключей в статусе «Активен». Подробнее о работе с API-ключом.

5. Настройте интеграцию агента с Foundation Models

6. Проверьте работу агента

1. В веб-интерфейсе Ouroboros перейдите в раздел Chat.

2. Отправьте сообщение, например: Расскажи, чем ты отличаешься от других AI-агентов.

   

Результат