Содержание
- Когда подключается и кто его запускает
- Что умеет подагент
- Типы задач
- Как подагент ищет товары
- Как возвращается результат и общение с клиентом
- Настройка поведения через инструкции
Подагент для работы с каталогом — отдельный специализированный помощник, который занимается поиском товаров и услуг в подключённом каталоге и собирает из них список позиций для корзины или заказа. Основной агент не работает с каталогом: когда в разговоре нужно подобрать позиции, проверить наличие или подготовить корзину для оформления заказа, он передаёт задачу подагенту, получает результат и продолжает диалог.
Важная особенность: подагент не общается с клиентом напрямую. Это «тихий» исполнитель — он работает с каталогом и возвращает результат основному агенту, а уже основной агент решает, что и как сказать клиенту. Так за разговор всегда отвечает один агент, а подагент остаётся за кулисами.
Когда подключается и кто его запускает
Подагент работает только при включённом доступе к каталогу в настройках агента — там же выбирается, из какого магазина брать товары (см. «Настройки агента»). Пока каталог не включён, подагента нет и основной агент про товары ничего не знает.
Запускает подагента сам основной агент. Это часть его инструкций: когда нужно подобрать товары или собрать корзину, основной агент обращается к подагенту, а не ищет сам. Он формулирует задачу — что нужно сделать и с какими товарами — и передаёт её. С точки зрения клиента всё выглядит как единый диалог: переключения на подагента он не видит.
Что умеет подагент
Подагент знает структуру каталога (категории → товары → варианты-предложения) и умеет:
- искать товары по названию, категории, диапазону цен, бренду и характеристикам;
- разбирать структуру каталога — получать дерево категорий и список доступных характеристик с их значениями (например, какие бывают цвета и размеры и сколько товаров под каждый из них);
- доставать подробности по товару — полное описание, цены, свойства, изображения и ссылку на сайт (краткий результат поиска он сам дополняет деталями, прежде чем отдать основному агенту);
- проверять остатки — но только если задача прямо этого требует; по умолчанию наличие он игнорирует, потому что данные об остатках бывают неактуальными;
- поднимать историю клиента — прошлые заказы и данные из карточки, чтобы учесть их при подборе;
- собирать корзину из найденных позиций.
Доступ к информации о клиенте и списку его заказов есть и у основного агента — поэтому проверить данные клиента или статус заказа он может сам, не привлекая подагента. Подагент же пользуется этой историей в первую очередь для более точного подбора товаров.
При этом подагент работает строго по реальным данным каталога и не выдумывает товары, цены или характеристики: если чего-то нет, он так и сообщает основному агенту.
Типы задач
Основной агент обращается к подагенту при помощи постановки задачи одного из следующих типов.
Подобрать и описать товары. Подагент ищет в каталоге подходящие товары и возвращает основному агенту подробный текстовый отчёт — описания, сравнения, рекомендации, какие есть доступные варианты. Корзина при этом не создаётся: основной агент использует отчёт, чтобы показать товары клиенту и помочь с выбором.
Собрать корзину. Когда в шаге сценария есть переменная типа «Состав заказа», основной агент сам её не заполняет — корзину собирает подагент: находит позиции с нужным количеством и возвращает её основному агенту, а тот передаёт корзину в поле шага. Вместе с корзиной приходит краткая сводка её состава, чтобы агент при необходимости обсудил его с клиентом. Обещанные клиенту подарки, скидки или особые цены передаются подагенту вместе с задачей.
Помимо таких структурированных задач основной агент может передать запрос и в свободной форме — например, когда клиент просто рассматривает ассортимент или задаёт вопросы о товарах.
Как подагент ищет товары
Поиск устроен как последовательная, а не разовая операция. Подагент сначала разбирается в каталоге (категории, доступные характеристики и их значения), затем ищет с конкретными фильтрами и только потом догружает детали по отобранным позициям. При необходимости он повторяет круги: сужает или меняет фильтры, пробует другие категории, корректирует диапазон цен.
Ключевой приём — идти от широкого к узкому: сначала найти хоть что-то по одному признаку, а потом отсеивать лишнее дополнительными фильтрами. Это важно, потому что формулировки клиента почти никогда не совпадают с каталогом дословно: клиент говорит «красная футболка», а в каталоге — «T-shirt Basic Red». Если каталог ведётся на другом языке или со своими сокращениями и названиями, подагент сперва просматривает категории, чтобы понять реальные наименования, и только затем ищет по ним.
Отсюда прямая зависимость: качество подбора не может быть лучше самого каталога. Чем понятнее структура, полнее описания и характеристики товаров, тем точнее подагент находит нужное (об обратной ситуации — в разделе «Антипаттерны»).
Как возвращается результат и общение с клиентом
Закончив работу, подагент возвращает управление основному агенту и передаёт ему результат: собранную корзину, текстовый отчёт по поиску — или запрос на уточнение. Сам клиенту он, как уже говорилось, не пишет.
Из этого следует устройство уточнений. Если подагенту не хватает информации, чтобы выполнить задачу (например, клиент не назвал размер или непонятно, какой из вариантов он имеет в виду), подагент не спрашивает клиента сам — он возвращает основному агенту вопрос. Основной агент задаёт этот вопрос клиенту, получает ответ и передаёт его подагенту обратно, после чего тот продолжает работу.
Показывает товары клиенту тоже основной агент — обычно карточками с изображением, названием, ценой и ссылкой, а не простым текстом. Внутренние идентификаторы товаров при этом клиенту не показываются — они нужны только для работы системы.
Настройка поведения через инструкции
Поведение подагента настраивается двумя слотами промпта (см. «Инструкции»):
- «Работа с каталогом» — инструкции основному агенту: в каких ситуациях обращаться к каталогу, какие запросы передавать подагенту, что важно учитывать. Если основной агент не всегда вовремя замечает, что пора искать товар, дополнять стоит именно этот слот.
- «Каталог товаров» — инструкции самому подагенту: на какие поля и характеристики опираться при поиске, какие категории и признаки учитывать, особенности структуры каталога и нестандартных названий. Этот слот особенно полезен для каталогов со сложной структурой или непривычными наименованиями — он помогает подагенту искать точнее.
Через эти слоты подагента адаптируют под конкретный бизнес и устройство его каталога, не трогая встроенную логику поиска.