[Документация Yandex Cloud](../../../../index.md) > [Yandex Serverless Integrations](../../../index.md) > [Пошаговые инструкции](../../index.md) > Workflows > [Конструктор шагов рабочего процесса](index.md) > Интеграционные шаги > Модели AI Studio

# Взаимодействие с моделями AI Studio

{% list tabs %}

- Консоль управления {#console}

  1. В процессе [создания](../workflow/create-constructor.md) нового рабочего процесса или [изменения](../workflow/update.md) существующего в консоли управления в блоке **Создание рабочего процесса** / **Изменение рабочего процесса** выберите `Конструктор`. 
  1. Из секции **AI Studio** в левой части экрана перетащите элемент ![foundation-models-icon](../../../../_assets/foundation-models-icon.svg) **Модели AI Studio** в нужное место рабочего процесса в окне конструктора.

      Перетаскивать шаги можно в обозначенные пунктирной линией блоки на графической схеме рабочего процесса, такие как **Добавить шаг** и т.п.
  1. В окне со схемой рабочего процесса нажмите на добавленный блок **Модели AI Studio**, чтобы выбрать его.
  1. В правой части окна на вкладке **Настройки**:
      1. В поле **Имя шага** задайте имя шага рабочего процесса.      
      1. Выберите [AI-модель](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/generation/index):

          {% cut "`Генерация текста`" %}
        
          1. Выберите:

              * `Базовая модель`, чтобы использовать модель из выпадающего списка, и в поле **Идентификатор каталога** выберите [каталог](../../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет вызываться модель.
              * `Дообученная модель`, чтобы использовать дообученную модель, и в поле **Идентификатор модели** укажите идентификатор ([URI](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/tuning/index#requests)) дообученной модели.

          1. В поле **Температура** задайте вариативность ответа модели: чем выше значение температуры, тем более непредсказуемым будет результат выполнения запроса. Диапазон возможных значений — от `0` до `1`.
          1. В поле **Количество токенов** задайте ограничение на максимально допустимое количество [токенов](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/generation/tokens) в ответе модели.
          1. В блоке **Контекст** выберите:

              * `Сообщения`, чтобы задать контекст запроса к модели в виде последовательности отдельных сообщений в формате `<Роль_отправителя_сообщения>`:`<Текст_сообщения>`, используя кнопку ![plus](../../../../_assets/console-icons/plus.svg).
              * `JSON-строка`, чтобы задать [контекст](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/index#prompt) запроса к модели в формате [JSON](https://ru.wikipedia.org/wiki/JSON)-строки.

          1. (Опционально) В блоке **Режим рассуждений** выберите статус [режима рассуждений](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/generation/chain-of-thought):
              * `Не задан` — не указано.
              * `Выключен` — режим рассуждений выключен. 
              * `Включён` — режим рассуждений включен.
          1. (Опционально) В блоке **Структурированный вывод** выберите [формат ответа](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/generation/structured-output):

              * `Нет` — модель возвращает ответ, отформатированный с помощью разметки Markdown.
              * `JSON-объект` — модель возвращает ответ в виде JSON-объекта.
              * `JSON-схема` — модель возвращает ответ в виде JSON-схемы, заданной в поле **JSON-схема**.

          {% endcut %}

          {% cut "`Работа с изображениями`" %}

          1. Выберите модель из выпадающего списка и в поле **Идентификатор каталога** выберите [каталог](../../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет вызываться модель.
          1. В поле **Температура** задайте вариативность ответа модели: чем выше значение температуры, тем более непредсказуемым будет результат выполнения запроса. Диапазон возможных значений — от `0` до `1`.
          1. В поле **Количество токенов** задайте ограничение на максимально допустимое количество [токенов](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/generation/tokens) в ответе модели.
          1. В блоке **Контекст** выберите:

              * `Сообщения`, чтобы задать контекст запроса к модели в виде последовательности отдельных сообщений в формате `<Роль_отправителя_сообщения>`:`<Текст_сообщения>`, используя кнопку ![plus](../../../../_assets/console-icons/plus.svg) **Добавить сообщение**.

                  Вы можете добавить изображение в сообщение. Для этого нажмите ![plus](../../../../_assets/console-icons/plus.svg) **Добавить изображение** и выберите:
                  * `Base64`, чтобы добавить изображение в формате [Base64](https://ru.wikipedia.org/wiki/Base64).
                  * `Источник изображения`, чтобы указать публичный URL, по которому будет доступно изображение, или имя объекта с изображением в [бакете](../../../../storage/concepts/bucket.md) Object Storage (например, `prefix/subprefix/image.png`).

              * `JSON-строка`, чтобы задать [контекст](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/index#prompt) запроса к модели в формате [JSON](https://ru.wikipedia.org/wiki/JSON)-строки.

          {% endcut %}

          {% cut "`Дообученная классификация`" %}

          1. В поле **Идентификатор модели** введите идентификатор дообученной модели. Подробнее в разделе [Модели классификаторов на базе YandexGPT](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/classifier/models).
          1. В поле **Текст** введите текстовое содержимое сообщения.

          {% endcut %}

          {% cut "`Классификация по промту`" %}

          1. Выберите модель и [каталог](../../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором она будет вызываться.
          1. В поле **Задание** введите текстовое описание задания для классификатора.
          1. В поле **Текст** введите текстовое содержимое сообщения.
          1. В блоке **Классы** выберите:
              * `Список`, чтобы ввести классы, используя кнопку ![plus](../../../../_assets/console-icons/plus.svg).
              * `JSON` и в блоке **JSON-объект** введите классы в формате [JSON](https://ru.wikipedia.org/wiki/JSON).

          1. (Опционально) В блоке **Примеры запросов** выберите: 
              * `Список`, чтобы ввести примеры запросов, используя кнопку ![plus](../../../../_assets/console-icons/plus.svg).
              * `JSON` и в блоке **JSON-объект** введите примеры запросов в формате JSON.
        
          {% endcut %}

      1. (Опционально) Отключите логирование запросов. Подробнее в [документации AI Studio](https://aistudio.yandex.ru/docs/ru/ai-studio/operations/disable-logging).
      1. (Опционально) В поле **Таймаут, мс** задайте максимальное время выполнения текущего шага.
      1. (Опционально) Чтобы задать для шага собственную политику повторных попыток, разверните блок **Политика повторных попыток** и нажмите кнопку ![plus](../../../../_assets/console-icons/plus.svg) **Политика повторных попыток**. В появившейся форме:
         
         1. (Опционально) В поле **Начальная задержка, мс** задайте начальное значение задержки между повторными попытками выполнения шага.
         1. (Опционально) В поле **Скорость изменения задержки** задайте коэффициент, на который будет умножаться время задержки перед каждой повторной попыткой выполнения шага.
         1. (Опционально) В поле **Максимальная задержка, мс** задайте значение максимальной задержки между повторными попытками выполнения шага.
         1. В поле **Ошибки** выберите ошибки, для которых будут (или, наоборот, не будут) сделаны повторные попытки выполнения шага.
         
             Подробная информация о возможных ошибках приведена в разделе [Возможные коды ошибок](../../../concepts/workflows/execution.md#errors).
         1. (Опционально) В поле **Количество повторных попыток** задайте максимальное количество повторных попыток выполнения шага.
         1. В поле **Режим выбора ошибок** выберите:
         
             * `INCLUDE` — чтобы делать для шага повторные попытки выполнения при возникновении ошибок, указанных в поле **Ошибки**.
             * `EXCLUDE` — чтобы делать для шага повторные попытки выполнения при возникновении любых ошибок, за исключением ошибок, указанных в поле **Ошибки**.
         
         Если вы хотите удалить политику повторных попыток, ранее созданную для шага, в строке **Политика повторных попыток** нажмите ![ellipsis](../../../../_assets/console-icons/ellipsis.svg) и выберите **Удалить**.
         
         Если для шага не настроена собственная политика повторных попыток, к нему будет применяться политика повторных попыток, [заданная для всего рабочего процесса](setup-restart-policy.md).
  1. (Опционально) Перейдите на вкладку **Вход** и задайте [jq-шаблон](../../../concepts/workflows/templating.md) для фильтрации [состояния рабочего процесса](../../../concepts/workflows/workflow.md#state), которое передается в шаг.
  1. (Опционально) Перейдите на вкладку **Выход** и задайте [jq-шаблон](../../../concepts/workflows/templating.md) для фильтрации выходных данных шага, которые добавляются в [состояние рабочего процесса](../../../concepts/workflows/workflow.md#state).
  1. (Опционально) [Добавьте](setup-catch-rule.md) для создаваемого шага [правило перехода по ошибкам](../../../concepts/workflows/yawl/index.md#catchrule), которые могут возникать во время выполнения этого шага.

{% endlist %}

## Полезные ссылки {#see-also}

* [Спецификация YaWL](../../../concepts/workflows/yawl/integration/foundationmodelscall.md)
* [Создать рабочий процесс с помощью конструктора](../workflow/create-constructor.md)
* [Изменить рабочий процесс](../workflow/update.md)