Облачная платформаEvolution

Создать AI-агента

Эта статья полезна?

AI-агент — интеллектуальная система, способная самостоятельно воспринимать окружающую среду через MCP-серверы, анализировать результат их выполнения и предпринимать целенаправленные действия для решения поставленных задач.

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

Примечание

Убедитесь, что у вас подключены сервисы ML Inference и Foundation Models. Без этого не получится создавать агентов и агентные системы.

Для создания AI-агента:

  1. Авторизуйтесь в личном кабинете.

  2. На верхней панели слева нажмите Кнопка с изображением девяти точек и перейдите в AI Factory → AI Agents → AI-агенты.

  3. Нажмите Создать агента.

  4. Выберите способ создания агента:

    • Простой агент — не требует написания кода, создается на основе Docker-образа по умолчанию, вам необходимо задать минимальные настройки.

    • Агент из Docker-образа — потребует загрузки вашего Docker-образ в Artifact Registry. Самый кастомизируемый вариант.

    В зависимости от вашего выбора дальнейшие действия будут немного отличаться.


    1. Введите Название и при необходимости добавьте описание.

    2. В блоке Модель и конфигурация:

      1. Выберите источник модели:


        Выберите одну из моделей.

      2. Выберите конфигурацию агента — количество ресурсов, выделяемых каждому экземпляру агента.

    3. В блоке Инструкция для агента:

      1. Добавьте MCP-сервер.

        Доступны MCP-серверы в статусе «Запущен» или «Ожидает запроса», а также серверы из каталога.

        Вы можете добавить больше одного MCP-сервера.

      2. (Опционально) Настройте инструменты для сервера.

        Вы можете включать и выключать их. Для этого нажмите на название инструмента в карточке сервера.

      3. (Опционально) Если вы хотите реализовать хореографию агентов, добавьте созданных ранее AI-агентов.

      4. Введите Системный промпт. Чтобы сгенерировать или улучшить промпт, нажмите Режим AI-генерации.

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

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

  6. (Опционально) Настройте Генерацию ответа. Доступны два способа генерации:


    1. Выберите Температуру.

      Чем выше температура, тем более креативные ответы будет давать модель.

    2. Задайте Максимум токенов в ответе.

      Чем больше токенов, тем объемнее ответ будет давать модель.

    3. (Опционально) Настройте Размышления агента. Если опция активирована:

      1. Выберите Уровень детализации размышлений — чем он выше, тем более подробно агент описывает свои рассуждения.

      2. Задайте Бюджет токенов на размышления — общий лимит на шаги в рамках размышлений.

        Примечание

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

  7. (Опционально) Настройте Надежность и контекст:

    1. Задайте Максимум вызовов на задачу.

      Опция защищает от зацикливания при обращении агента к LLM-модели или MCP-серверу.

    2. Настройте Повтор при ошибке. Если опция активирована, выберите Максимум попыток обращений.

      Опция позволяет агенту направить повторное обращение к LLM-модели или MCP-серверу в случае ошибки.

    3. Настройте Сжатие истории диалога. Если опция активирована:

      1. Выберите Интервал сжатия сообщений — количество сообщений, которое агент объединит в краткое резюме для сохранения контекста.

      2. Выберите Размер перекрытия — количество сообщений из предыдущего резюме, которые попадут в следующее.

    4. Настройте Размышления агента. Если опция активирована:

      1. Выберите Время жизни кеша — длительность хранения промежуточных результатов (например, ответы инструментов). После истечения срока данные запрашиваются заново.

      2. Выберите Частоту обновления — насколько часто агент проверяет актуальность данных.

      3. Активируйте опцию Сохранять вложения, чтобы агент мог при необходимости использовать файлы в последующих ответах.

        Если опция не активирована, то агент использует вложения только при ответе в текущем запросе без возможности обратиться к ним повторно.

        Примечание

        Функция доступна только при активации опции Артефакты в блоке настроек Память агента.

  8. (Опционально) Настройте Память агента:

    1. Настройте параметр Долгосрочная память для сохранения ключевых данных между сессиями.

      Если опция активирована, из списка выберите подходящую модель эмбеддинга.

    2. Активируйте опцию Краткосрочная память для сохранения и использования контекста текущей сессии.

    3. Настройте Артефакты, чтобы агент сохранял в Object Storage вложения пользователя, а также файлы, которые агент создает во время сессий.

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

      • Если опция не активирована, файлы удалятся при перезапуске агента.

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

  10. Задайте настройки масштабирования. Доступны два режима масштабирования:


    В этом режиме агент постоянно запущен и готов к обработке запросов.

    1. В поле Минимум задайте количество постоянно запущенных экземпляров для обработки запросов агентом.

    2. В поле Максимум задайте максимальное количество экземпляров, способных одновременно поддерживать нагрузку. По мере роста нагрузки дополнительные экземпляры запускаются автоматически в количестве, необходимом для ее обработки.

    1. Выберите тип масштабирования и укажите допустимое количество запросов в секунду:

      • Concurrency — параллельные запросы на экземпляр, автомасштабирование начинается при достижении заданного лимита на количество одновременных запросов на экземпляр.

      • RPS — запросы в секунду на экземпляр, автомасштабирование начинается при достижении заданного лимита на количество запросов в секунду на экземпляр.

  11. (Опционально) Активируйте опцию Аутентификация для аутентификации пользователя при вызове модели через публичный URL. Настройте аутентификацию в API:

    1. Тип аутентификации — выберите Access token (токен доступа) или API-key (API-ключ).

    2. Сервисный аккаунт — выберите, создайте вручную или автоматически сервисный аккаунт.

    При создании сервисного аккаунта для него необходимо создать ключ в соответствии с выбранным типом аутентификации.

  12. (Опционально) Активируйте опцию Логирование запросов для ведения журнала запросов к агенту. Укажите лог-группу или создайте новую.

  13. Нажмите Создать и дождитесь перехода агента в статус «Запущен» или «Ожидает запроса».

После перехода агента в статус «Запущен» вы можете протестировать агента на вкладке Чат.

Для просмотра примеров использования агентов на разных языках программирования нажмите Использовать.

Выбрать агента из каталога

  1. Авторизуйтесь в личном кабинете.

  2. На верхней панели слева нажмите Кнопка с изображением девяти точек и перейдите в AI Factory → AI Agents → Каталог → AI-агенты.

  3. Выберите агента и нажмите Запустить.

Что дальше

Создайте агентную систему для различных задач с использованием полученного агента.