Создание базового агента в Yandex AI Studio и обращение к нему через Python-скрипт

Данный мануал предполагает, что у вас уже зарегистрированная учетка на Яндекс Облаке, так же на нем заведен сервисный аккаунт и получен API ключ. Если нет, то сначала воспользуйтесь инструкцией для получения ключа: https://yandex.cloud/ru/docs/iam/operations/authentication/manage-api-keys#create-api-key

Переходим в раздел «AI Studio» в консоли Yandex Cloud (https://console.yandex.cloud): Все Сервисы -> AI Studio.

Яндекс Ai Studio

Далее выбираем: Агенты -> Создать агента.

Создание агента

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

  1. Имя агента — укажите произвольное наименование, отражающее суть работы агента;
  2. Модель — выбирайте исходя из нужд, если не уверены с выбором, то после создания можно протестировать агента в панели справа для сравнения разных моделей;
  3. Инструкция — пожалуй, самый важный аспект создания агента, здесь необходимо дать инструктаж для агента с свободной форме, которым он будет оперировать при генерации ответа. Моменты, указанные в инструкции, прямо влияют на выдаваемый ответ, поэтому необходимо максимально ответственно подходить к ее написанию — можно как базой воспользоваться заготовками, которые специалисты Яндекса предоставили в интерфейсе, в том числе подсмотреть некоторые речевые обороты, которые продуктивно влияют на генерацию;
  4. И также здесь есть возможность подключить некоторые инструменты по работе со внешними данными, которые помогут расширить возможности агента (поиск в интернете, подключение пользовательской базы данных и другое). В примере подключим инструмент WebSearch, который позволяет агенту осуществлять поиск информации в открытом интернете (о чем соответственно добавим указание в инструкции).
Настройка агента Yandex Ai Studio

Остальные моменты можете оставить по-умолчанию, либо «поиграться» настройками, для получения инференса в реальном времени можно воспользоваться блоком тестирования агента, расположенным справа от блока создания.

В завершении создания агента нажмите кнопку «Сохранить» и далее выберите опцию «Посмотреть код» в окне агента.

Просмотр кода Агента Yandex AI Studio

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

Код обращения к агенту Yandex Ai Studio

В нем нужно указать свой API ключ (инструкция по его получению в сервисе Yandex Cloud: https://yandex.cloud/ru/docs/iam/operations/authentication/manage-api-keys#create-api-key), и также здесь коллеги из Яндекса немного не доработали — пропущена инициализация переменной (обн. 16-04-2026, уже исправили), в итоге должен получиться код примерно вот такого вида:

import openai

client = openai.OpenAI(
    api_key="zyz321zyz321zyz321zyz321",
    base_url="https://rest-assistant.api.cloud.yandex.net/v1",
    project="abc123abc123"
)

response = client.responses.create(
    prompt={
        "id": "abc123abc123",
    },
    input="some message",
) 

print(response.output_text)

Где в «api_key» — указан ваш API Ключ Яндекс Облака, а «input» — ваш запрос. При отсутствии также нужно будет установить библиотеку «openai» (консольная команда: pip install openai), и далее скрипт после запуска на вашем сервере выведет ответ агента.