Руководство разработчика агента

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

Если вы хотите добавить созданных вами ИИ-агентов на маркетплейс агентов ГигаЧат , изучите информацию ниже.

Как добавить ИИ-агента на маркетплейс агентов

Маркетплейс агентов — это виртуальная площадка в веб-версии ГигаЧата, на которую разработчики добавляют созданных ими агентов, а пользователи маркетплейса выбирают подходящего для своих целей агента. Агенты помогают пользователям ГигаЧата быстрее выполнять задачи, реагируя на запросы. 

Чтобы ваш агент появился на маркетплейсе необходимо последовательно пройти следующие шаги: 

1. Авторизацию и онбординг.
2. Добавление агента. 
3. Добавление версии агента. 
4. Проверку агента на стенде.
5. Модерацию.

Требования к коду агента

При разработке агента следуйте рекомендациям:

• для обмена сообщениям с моделью используйте библиотеку langchain-gigachat;
• используйте env GIGACHAT_BASE_URL для доступа к модели;
• для передачи дополнительных данных (виджеты и прочая информация необходимая для отображения в интерфейсе) вместе с сообщением из агента на фронтенд в стриме используется поле additional_kwargs класса BaseMessage;
• агент не должен интегрировать в себя зависимости метрик Prometheus, Azire Phoenix или LangFuse;
• для корректного отображения параметров запуска агента на фронте State и RunnableConfig схемы должны быть описаны с использованием модуля Pydantic и должны наследоваться от BaseModel;
• при написании кода следуйте руководству PEP8;
• для node графа, выполняющих сетевые запросы к LLM, базам данных или внешним API, обязательно используйте асинхронные функции;
• синхронные функции применяйте исключительно для быстрых локальных операций вроде парсинга JSON или форматирования текста;
• следите, чтобы код агента был понятным, содержал подробные комментарии и обеспечивал удобство сопровождения.