AI-агенты

AI-агент — это многошаговый ассистент. Он читает разговор, планирует, вызывает инструменты (ваши AI-инструменты, MCP-инструменты и поиск по базе знаний), анализирует результаты и снова обращается к модели, пока не получит ответ. Узел Создать AI-ответ в чате делает один вызов модели и отвечает; узел AI-агент может продолжать работу через несколько вызовов моделей и инструментов в заданных вами пределах, прежде чем ответит.

Используйте агента, когда для запроса нужно несколько шагов, например «найти заказ клиента, проверить статус доставки и предложить новую дату». Для прямого ответа на основе инструкций и базы знаний AI-узел проще и дешевле.

Составные части

Часть	Что это	Где настраивается
AI Harness	Движок, который выполняет цикл агента: собственный движок MonoChat, SDK агентов или размещённый сервис агентов.	Настройки › Автоматизация › AI-оболочки
Модели	AI-модели, с помощью которых агент «думает»: основная модель, необязательная резервная и необязательная быстрая модель. Размещённые оболочки используют модели своего провайдера.	Узел AI-агент
Инструменты	AI-области, функции AI-инструментов и MCP-инструменты.	Узел AI-агент
Бюджет выполнения	Ограничения на вызовы модели, вызовы инструментов, токены, длительность и повторные попытки для каждого запуска.	Узел AI-агент
Запуск	Одно выполнение агента. Каждый запуск записывается в Запуски AI-агента.	Создаётся узлом или через API

AI-оболочки

В разделе Настройки › Автоматизация › AI-оболочки перечислены оболочки, на которых могут работать ваши агенты: те, которые MonoChat предлагает каждому рабочему пространству, и те, которые вы добавляете со своими учётными данными.

Оболочка	Где работает	Какие модели использует	Кто добавляет
MonoChat Native	Внутри MonoChat	Ваши AI-модели	MonoChat
OpenAI Agents SDK	Внутри MonoChat	Ваши AI-модели	MonoChat
Claude Agent SDK	На агентном исполнителе MonoChat	Ваши AI-модели	MonoChat
pi	На агентном исполнителе MonoChat	Ваши AI-модели	MonoChat
OpenAI Agents API	В облаке OpenAI	Разрешённые модели оболочки	Вы, со своим API-ключом OpenAI (MonoChat тоже может предложить такой)
Claude Managed Agents	В облаке Anthropic	Разрешённые модели оболочки	Вы, со своим API-ключом Anthropic (MonoChat тоже может предложить такой)
Custom Endpoint	На вашем собственном сервере	Ваши AI-модели (необязательно)	Вы, с вашей конечной точкой и секретом

Оболочки, работающие на MonoChat, предоставляет MonoChat; ваше рабочее пространство может добавлять только оболочки, принимающие его собственные учётные данные. Для Claude Agent SDK и pi нужен агентный исполнитель MonoChat: если он не настроен, запуск на них завершается ошибкой «Эта AI-оболочка недоступна на этом сервере.»

Какой бы ни была оболочка, контроль остаётся за MonoChat: каждый вызов модели оболочкой, использующей ваши AI-модели, проходит через MonoChat (поэтому действуют тарификация и бюджет), каждый вызов инструмента выполняет ваши функции, MCP-инструменты и AI-области в вашем рабочем пространстве, а бюджет соблюдается в любой оболочке.

Добавление оболочки

Перейдите в Настройки › Автоматизация › AI-оболочки и нажмите + (Создать).
Введите Название и при желании Описание.
Выберите Harness. У каждого варианта указано, где он работает.
В разделе Учётные данные введите то, что нужно оболочке:
- OpenAI Agents API, Claude Managed Agents: API-ключ.
- Custom Endpoint: Конечная точка и API-ключ.
Для размещённой оболочки заполните Разрешённые модели: введите названия моделей провайдера (например, ID модели OpenAI или Anthropic). Кнопка Добавить модель позволяет добавить до 10 моделей. Агенты на этой оболочке могут выбирать только из этого списка.
Нажмите Сохранить.

При редактировании оболочки тип Harness изменить нельзя, а поле ключа называется Ключ API (оставьте пустым, чтобы сохранить текущий ключ).

Claude Managed Agents

При первом использовании оболочки этого типа MonoChat создаёт в аккаунте Anthropic одного агента и одно окружение и затем использует их повторно.

Custom Endpoint

Оболочка Custom Endpoint отправляет запуски на ваш собственный сервис, например на самостоятельно размещённого агента. Для каждого запуска MonoChat отправляет POST на <Endpoint>/runs с заголовком Authorization: Bearer <API Key>. В теле запроса передаются ID запуска, инструкции, входные данные, сообщения разговора, бюджет, псевдонимы моделей (agent-main, agent-fallback, agent-fast) и три URL с токеном для этого запуска:

шлюз моделей (совместимый с OpenAI …/v1 и совместимые с Anthropic базовые URL), который вызывает AI-модели узла и следит за бюджетом,
MCP-сервер, который предоставляет инструменты запуска,
URL событий, на который ваш сервис сообщает результат (completed с result или failed с error).

Токен запуска перестаёт действовать, когда запуск завершается.

Узел AI-агент

Добавьте агента в сценарий с помощью узла AI-агент среди гибридных узлов в конструкторе сценариев. О том, как добавлять и соединять узлы, см. Сценарии.

Поля

Раздел	Поле	Описание
	Название	Название узла, отображаемое на холсте.
	AI Harness	Обязательное поле. Оболочка, которая запускает агента.
	Инструкции	Системные инструкции агента: его роль, тон, правила и то, что ему можно и нельзя делать.
	Задача (добавляется к инструкциям агента; можно использовать теги)	Что этот узел просит сделать агента. Добавляется после инструкций и может использовать те же теги, что и промпт AI-узла, например чтобы подставить данные клиента.
Модели	Основная модель	Модель, которую использует агент. Обязательна для любой оболочки, кроме Custom Endpoint.
	Резервная модель (после мягкого лимита)	Модель, на которую агент переключается, достигнув мягкого лимита вызовов модели; обычно более дешёвая или быстрая модель.
	Быстрая модель (лёгкие фоновые задачи)	Модель, которую оболочка может использовать для лёгких фоновых вызовов.
	Модель (одна из разрешённых моделей harness)	Отображается вместо трёх полей выше для размещённой оболочки.
Сессия агента	Диалог	Продолжить существующую сессию агента (по умолчанию) или Начать новую сессию агента. См. Сессии агента.
	Ключ задачи (отдельные сессии агента для каждой задачи)	Необязательно. Хранит отдельную сессию агента для каждого ключа в одном разговоре, например `booking` и `support`.
	Лимит истории сообщений	Сколько сообщений разговора получает агент.
	AI-модели преобразования речи в текст	Модель с функцией Транскрипция. Голосовые сообщения в разговоре попадают к агенту в виде текста.
Настройки инструментов	AI-области	Базы знаний, по которым может искать агент. Они предлагаются агенту как инструмент поиска по базе знаний.
	AI-инструмент	Функции типа AI-инструмент, которые может вызывать агент.
	Настроить инструменты контента MCP-клиента AI	Открывает панель, где вы добавляете MCP-инструменты. См. MCP-клиенты.
Сообщения	Пересылать промежуточные сообщения клиенту	По умолчанию выключено. Всё, что агент пишет в процессе работы (например, «Сейчас проверю ваш заказ»), при включении отправляется клиенту; при выключении оно добавляется в разговор как заметка (whisper), которую видит только ваша команда.
	Отправить ответ	По умолчанию включено. Отправляет клиенту окончательный ответ агента. Отключите, чтобы использовать ответ только внутри сценария.
Бюджет выполнения	Макс. вызовов модели	По умолчанию 4.
	Мягкий лимит: вызовы модели	Необязательно. После такого количества вызовов модели агент переключается на резервную модель. Должен быть меньше Макс. вызовов модели и требует резервной модели.
	Макс. вызовов инструментов	По умолчанию 6. При значении `0` запуск завершается с итогом Бюджет превышен сразу, как только агент пытается вызвать инструмент.
	Макс. всего токенов	По умолчанию 20000. Входные и выходные токены всех вызовов модели в запуске.
	Макс. длительность (секунды)	По умолчанию 30.
	Макс. повторных попыток	По умолчанию 2. Сколько раз повторяется неудачный вызов модели.

подсказка

Записывайте постоянные правила в Инструкции, а конкретную задачу этого шага — в Задача. Тогда несколько узлов AI-агент в сценарии могут использовать одни и те же инструкции и отличаться только задачей.

предупреждение

Размещённые оболочки не поддерживают мягкий лимит, потому что не могут переключиться на резервную модель. Для них оставляйте Мягкий лимит: вызовы модели пустым.

Что происходит, когда сценарий доходит до узла

MonoChat проверяет ваш баланс и настройки узла и запускает выполнение. Запуск получает статус В очереди, затем Выполняется. Экземпляр сценария ждёт на узле.
Агент получает инструкции и задачу, а если сценарий относится к разговору, то и сообщения разговора в пределах Лимит истории сообщений, причём голосовые сообщения расшифровываются.
Агент вызывает модели и инструменты, пока не получит ответ или не достигнет лимита. Текст, который он пишет между вызовами инструментов, обрабатывается как промежуточное сообщение.
Когда запуск заканчивается:
- если он Завершено и включено Отправить ответ, ответ отправляется клиенту. Длинные ответы разбиваются на несколько сообщений, если превышают лимит канала (4096 символов в WhatsApp);
- если он закончился иначе, в разговор для вашей команды добавляется заметка (whisper) «Запуск ИИ-агента завершён: статус. ошибка».
Сценарий продолжается по выходу, соответствующему итогу запуска.

Запуски одной и той же сессии агента обрабатываются по одному, по порядку.

Выходы

Выход	Когда
Завершено	Агент завершил работу ответом.
Бюджет превышен	Запуск исчерпал Макс. вызовов модели, Макс. вызовов инструментов или Макс. всего токенов.
Время ожидания истекло	Запуск достиг Макс. длительность (секунды).
Ненависть, Jailbreak, Самоповреждение, Сексуальный контент, Насилие	Фильтр контента провайдера модели остановил запуск по этой категории. Это те же выходы, что и у AI-узла.
При ошибке	Запуск завершился ошибкой по любой другой причине или был отменён. Остановка фильтром контента тоже направляется сюда в узлах, сохранённых до появления этих выходов; откройте и сохраните такой узел, чтобы они появились.

Подключите как минимум Завершено и При ошибке. Распространённый приём — направлять Бюджет превышен, Время ожидания истекло и При ошибке в узел Назначить диалог, чтобы разговор взял на себя сотрудник.

Сессии агента

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

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

Оплата

Вызовы AI-моделей, предоставляемых MonoChat, оплачиваются с вашего баланса как обычно. Вызовы ваших собственных моделей оплачивает ваш провайдер.
Оболочка, предоставляемая MonoChat, может взимать собственную плату за запуск, за минуту и за вызов инструмента, а для размещённой оболочки — за токены, о которых сообщает её провайдер. Они отображаются в разделе Транзакции в категориях Запуск AI-агента, Длительность работы AI-агента, Вызов инструмента AI-агента и категориях AI-токенов.
За оболочку, которую вы добавили со своими учётными данными, MonoChat плату не взимает; счёт выставляет её провайдер.
Запуск не начинается, если на балансе недостаточно средств.

Событие «Запуск AI-агента завершён»

Запуск AI-агента завершён — это узел события. Он срабатывает, когда завершается запуск, связанный с клиентом, независимо от того, был ли он начат сценарием или через API с разговором. Как и другие узлы событий, он имеет необязательные настройки Условие и Время истекло. Используйте его, чтобы запускать отдельный сценарий после запусков агентов, например чтобы записывать результаты или уведомлять команду.

Запуск агента из кода

Пользовательские функции и API-клиенты могут запускать агентов с помощью следующих методов (право Запуск / Просмотр / Отмена запусков ИИ-агентов в автоматизации):

Метод	Что делает
`business.tenants.automation.ai.aiAgentRuns.create`	Запускает выполнение. Возвращает `aiAgentRunId` и `aiAgentSessionId`.
`business.tenants.automation.ai.aiAgentRuns.show`	Возвращает запуск (`_id`) с его статусом, использованием, шагами и результатом.
`business.tenants.automation.ai.aiAgentRuns.cancel`	Отменяет запуск в очереди или выполняющийся запуск (`_id`).

create принимает aiHarnessClientId, input (задачу), а также необязательные sessionId (чтобы работать в разговоре), aiAgentSessionId, taskKey и isNewSession, и options с теми же настройками, что и у узла: instructions, aiModelClientId, fallbackAiModelClientId, fastAiModelClientId, harnessModel, toolCustomFunctionIds, aiScopeIds, aiMcpClientDatas, messageHistoryLimit, speechToTextAiModelClientId, forwardIntermediateMessages, willSendAnswer и обязательный budget. При работе через API forwardIntermediateMessages и willSendAnswer по умолчанию равны false.

const { aiAgentRunId } = await sdk.method({ name: 'business.tenants.automation.ai.aiAgentRuns.create' }).callAsync({
  payload: {
    aiHarnessClientId: 'HARNESS_ID',
    input: 'Summarise the open orders of this customer.',
    sessionId: 'SESSION_ID',
    options: {
      instructions: 'You are the order assistant of our store.',
      aiModelClientId: 'MODEL_ID',
      toolCustomFunctionIds: ['FUNCTION_ID'],
      budget: { maxLlmCalls: 4, maxToolCalls: 6, maxTotalTokens: 20000, maxDurationSeconds: 30, maxRetries: 2 },
    },
  },
})

Запуск асинхронный: прочитайте его позже через show или реагируйте на него с помощью события Запуск AI-агента завершён. Без sessionId каждый вызов начинает новую сессию агента, если только вы не передадите aiAgentSessionId, возвращённый предыдущим вызовом; тогда агент увидит ранее завершённые запуски этой сессии агента как свою историю. О вызове методов из функции см. Method.

Права доступа

Право	Что разрешает
Просмотр / Создание / Обновление / Удаление сред выполнения ИИ в автоматизации	Управление AI-оболочки
Просмотр запусков ИИ-агентов в автоматизации	Просмотр Запуски AI-агента
Запуск ИИ-агентов в автоматизации	Вызов `aiAgentRuns.create`
Отмена запусков ИИ-агентов в автоматизации	Вызов `aiAgentRuns.cancel`

См. Роли.

Запуски AI-агента: посмотрите, что сделал каждый запуск
AI-модели
MCP-клиенты
AI-области
Сценарии

Составные части​

AI-оболочки​

Добавление оболочки​

Custom Endpoint​

Узел AI-агент​

Поля​

Что происходит, когда сценарий доходит до узла​

Выходы​

Сессии агента​

Оплата​

Событие «Запуск AI-агента завершён»​

Запуск агента из кода​

Права доступа​

Связанные разделы​