Добавление версии агента

Обновлено 23 марта 2026

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

1. Заполнение информации для пользователей.
2. Описание агентов и добавление параметров.
3. Добавление примеров и вызовов.
4. Загрузка кода агента.
5. Добавление переменных окружения.

Для добавления версии агента необходимо последовательно пройти все этапы.

Шаг 1. Заполните информацию для пользователей

Создайте два типа описания агента: краткое и подробное. С их помощью пользователи поймут, какие задачи можно решить с помощью агента. Краткое описание будет отображено на карточке агента. Подробное описание откроется в новом окне при нажатии на карточку. При необходимости улучшите подробное описание с помощью нейросети. Для этого после заполнения поля нажмите кнопку Улучшить с ГигаЧатом. После заполнения полей нажмите Продолжить.

Шаг 2. Опишите агентов и добавьте параметры

На этом шаге необходимо описать агента для ГигаЧат и выбрать входные параметры для вызова агента.

В поле Опишите назначение агента для ГигаЧата опишите логику, поведение или настройки агента в этой версии так, чтобы ГигаЧат смог понять, какие запросы пользователя он может отправлять именно этому агенту.

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

1. В поле Входные параметры для вызова раскройте список Выберите тип и выберите необходимый параметр.
2. Отметьте, обязательный ли это параметр, с помощью ползунка справа.
3. Заполните поля ID и Описание параметра для ГигаЧат. Если вы выбрали тип параметра file, то заполните поле Поддерживаемые типы файлов. Инструкция по заполнению — ниже.
4. Нажмите кнопку Сохранить параметр. Параметр будет сохранен и отображен с заполненными данными.
5. Чтобы добавить следующий параметр, нажмите кнопку Добавить новый параметр над полем Входные параметры для вызова агента.
6. После добавления всех параметров нажмите кнопку Продолжить.

Для параметра file дополнительно укажите поддерживаемые типы файлов:

1. В поле Поддерживаемые типы файлов нажмите кнопку Добавить.
2. В открывшемся окне заполните поле MIME-тип данных (стандарт, указывающий формат файла). Для этого раскройте список и выберите тип.
3. Затем выберите значение типа данных. Для этого раскройте список и отметьте в чек-боксах значения.
4. Нажмите кнопку Добавить. После этого вы вернетесь на страницу добавления параметров.
5. Нажмите кнопку Сохранить параметр. Параметр будет сохранен и отображен с заполненными данными.
6. Чтобы добавить следующий параметр, нажмите кнопку Добавить новый параметр над окном Входные параметры для вызова агента.
7. После добавления всех параметров нажмите кнопку Продолжить.

Чтобы удалить или редактировать параметр:

1. Нажмите на три точки в правом верхнем углу в поле Входные параметры для вызова агента.
2. Выберите Удалить или Редактировать.
3. Подтвердите выбор, нажав Удалить в открывшемся окне.

Шаг 3. Укажите примеры и вызовы

1. Заполните поле Запрос пользователя. Добавьте все релевантные примеры запросов.
2. В поле Параметр выберите один из тех параметров, которые были указаны в шаге 2. Если был заполнен только один параметр, то он будет предвыбран в поле и других вариантов не будет.
3. Заполните поле Значение параметра. Если вы выбрали тип параметра file, то описывать значение параметра не нужно.
4. Нажмите Сохранить.
5. Чтобы добавить следующий пример, нажмите кнопку Добавить пример вызова. Если в шаге 2 был выбран только один параметр, то добавить пример вызова нельзя. Появится окно Невозможно создать новый пример вызова, из которого можно вернуться к добавлению параметров. Для этого нажмите кнопку К параметрам.

Примеры параметров

Параметр	Тип	Описание	Пример значения
topic	string	Тема или предмет запроса пользователя	анализ продаж
city	string	Город или локация для поиска услуг или путешествий	Санкт-Петербург
date	string	Дата события, поездки или бронирования	2026-05-15
dataset	file	Файл с данными для анализа	sales_report.xlsx
mood	string	Настроение пользователя для подбора книг или рекомендаций	вдохновение
profession	string	Профессия или карьерное направление	продуктовый аналитик
task_description	string	Описание задачи, которую должен выполнить агент	найти отзывы о сервисе
duration	number	Продолжительность события или поездки (в днях/часах)	5
format	string	Формат результата (таблица, график, mind map и т. п.)	график
difficulty_level	string	Уровень сложности консультации или рекомендаций	базовый

Примеры запросов

№	Запрос пользователя	Параметр	Значение параметра
1	Построй mind map по теме [управление проектами]	topic	управление проектами
2	Проанализируй данные продаж из файла и построй график	dataset	sales_report.xlsx
3	Найди книги для настроения [мотивация]	mood	мотивация
4	Помоги спланировать поездку в [город] на [3 дня]	city	Казань
5	Подбери книги для изучения профессии [data analyst]	profession	data analyst
6	Найди и собери информацию по задаче: [сравнение CRM систем]	task_description	сравнение CRM систем
7	Помоги записаться на услугу в [город] на [дата]	city	Москва
8	Проанализируй таблицу и сделай выводы в формате [график]	format	график
9	Подскажи, как справиться с ситуацией: [стресс на работе]	topic	стресс на работе
10	Составь план развития для профессии [product manager]	profession	product manager

Шаг 4. Загрузите код агента

Перед загрузкой кода агента изучите требования к версиям библиотек и зависимостям.

Библиотека	Версия
python	3.11 или 3.12
langchain	>=1.0.0
langgraph	>=1.0.0
langchain_gigachat	>=0.3.0
arize-phoenix	Запрещено
langfuse	Запрещено
prometheus-client	Запрещено

Зависимости, необходимые для работы агента, должны быть заданы в файле requirements.txt в корне проекта агента.

При выполнении HTTP-запросов к сторонним сервисам используйте модули requests или httpx и передавайте заголовок User-Agent: ari-agent. Без заголовка User-Agent прокси не пропустит HTTP-запрос.

Чтобы загрузить код версии агента:

1. Перенесите файл в формате ZIP в поле Код версии агента. Максимальный размер файла — 10 Мб.
   • Архив должен содержать корректную структуру агента:
     • в конфигурации должен быть ровно один граф;
     • имя графа — main;
     • len(graphs) == 1;
     • ключ graphs["main"] обязателен.

Если структура архива не соответствует требованиям, агент не запустится в среде исполнения и будет отклонен модератором.

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

   Платформа определяет:

   • среду исполнения;
   • поддерживаемые зависимости;
   • технические ограничения.

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

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

Шаг 5. Задайте переменные окружения

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

К таким параметрам относятся, например:

• API-ключи внешних сервисов;
• токены доступа;
• client_id/client_secret;
• URL внешних API;
• флаги конфигурации.

Значения переменных:

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

Для добавления переменной:

1. Заполните поле Ключ.
2. Заполните поле Значение. Если переменная помечена как Секретная, ее значение:
   • хранится в зашифрованном виде;
   • не отображается в интерфейсе после сохранения;
   • недоступно другим пользователям и разработчикам;
   • не передается в логи и мониторинг в открытом виде.

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

3. Нажмите Сохранить. Переменная будет сохранена и отображена с заполненными данными.

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

Чтобы добавить следующую переменную, нажмите кнопку Добавить переменную над полем Переменные окружения.

4. Нажмите кнопку Добавить версию. Появится окно об успешном добавлении версии вашего агента. При нажатии на кнопку На страницу агента вы перейдете к списку версий вашего агента.

До успешного прохождения модерации версия будет в статусе Черновик. После отправки на модерацию статус изменится на Модерация. И при успешном прохождении — на Опубликована.

Если версия агента взаимодействует с внешними системами, то их необходимо указать в обращении в контакт-центр. Без этого доступы к ним будут закрыты. Для отправки обращения перейдите в раздел Профиль > Помощь > Поддержка и для каждого внешнего ресурса укажите:

• домен;
• назначение (зачем ресурс используется агентом).

Отправьте обращение по электронной почте, указанной на карточке.

Шаг 6. Добавление следующей версии агента

Чтобы добавить новую версию агента:

1. Перейдите в раздел Мои агенты в левом меню.
2. На карточке с версиями агента нажмите кнопку Новая версия.
3. Пройдите шаги с 1 по 5.

После успешного добавления версии агента переходите к проверке работы агента на стенде.