Архитектура ИИ-агента простыми словами: из каких блоков он собирается

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

Канал

Первый блок — подключение к каналу: Telegram, Instagram, WhatsApp, сайт. Он принимает сообщение клиента и отправляет ответ обратно. Здесь же действуют правила платформы: окна ответа, форматы сообщений, ограничения на рассылки.

Оркестратор

Оркестратор — управляющая часть агента. Он получает сообщение, подтягивает историю разговора, нужные фрагменты базы знаний и инструкцию, передаёт всё модели, а затем выполняет действия, которые модель решила сделать. По сути, это «диспетчер», который связывает остальные блоки.

Языковая модель

Модель понимает запрос и решает, что ответить или какой инструмент вызвать. Её можно менять: архитектура не зависит от конкретной модели, если оркестратор написан правильно.

Память

• Короткая: история текущего разговора
• Длинная: сведения о клиенте из прошлых обращений, если это предусмотрено
• Рабочая: данные, собранные в текущей задаче, — имя, телефон, выбранная услуга

База знаний

Документы компании разбиваются на фрагменты и сохраняются в специальной базе, где поиск идёт по смыслу, а не только по словам. Когда клиент задаёт вопрос, оркестратор находит подходящие фрагменты и передаёт модели. От качества этого поиска зависит, найдёт ли агент правильный факт.

Инструменты

Инструменты — функции, которые агент может вызвать: проверить расписание, записать заявку, найти заказ. Каждый инструмент выполняет действие строго по заданным правилам, а модель лишь решает, когда его использовать и с какими параметрами.

Журнал и мониторинг

Журнал сохраняет каждый шаг: сообщение, найденные фрагменты, решения модели, вызовы инструментов, ответ. Мониторинг следит за ошибками и задержками. Без этих блоков агент — «чёрный ящик», в котором невозможно разобраться.

Как пользоваться этой схемой

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

Пример сбоя и его поиска

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