Задача
Компаниям с прайсом, доставкой и повторяющимися вопросами нужен консультант, который помогает клиенту найти условия и перейти к заказу. Если ответа в документах нет, важно передать вопрос менеджеру вместе с контекстом.
Сделал демонстрационный проект на базе вымышленной пекарни «Колосок». Один движок обслуживает виджет сайта и Telegram-бота. Это открытый проект с работающим сервисом, а не история внедрения у реального клиента.
Решение
Клиент спрашивает об условиях, получает ответ и раскрывает использованный фрагмент прайса или FAQ. Вопросы с недостаточным совпадением с базой отклоняются до вызова модели. В остальных случаях GigaChat получает найденные фрагменты и инструкцию отвечать по ним или отказаться. Если модель недоступна, сервис показывает подходящий фрагмент без генерации.
Когда нужна помощь человека, консультант собирает имя, телефон и суть обращения. В рабочем режиме заявка сначала сохраняется в PostgreSQL, затем отправляется менеджеру в Telegram вместе с диалогом. В публичном демо показывается только предпросмотр с вымышленными контактами. Вопросы и найденные фрагменты передаются провайдеру модели; контакты из анкеты в её контекст не включаются.
Решённые задачи
- Собрал единую базу из прайса, правил доставки и FAQ для виджета и Telegram-бота
- Подключил GigaChat и показ источников, чтобы клиент мог проверить цену и условия
- Добавил отказ при недостатке информации и переход к анкете менеджера
- Сделал загрузку TXT, Markdown и PDF для вопросов по собственному документу
- Отделил контакты анкеты от истории, передаваемой модели
- Добавил квоту вопросов, очередь модели и ответ из базы при недоступности провайдера
- Подготовил режим без отправки заявок, демоконтакты и удаление сессии с файлом при сбросе
Результат
Работает полный путь от вопроса по документам до заявки с контекстом. Виджет подключается к сайту одной строкой, Telegram-бот использует ту же базу и правила ответа. На сайте доступны живой виджет, загрузка документа и браузерный предпросмотр Telegram-сценария без отправки сообщений.
На небольшом приёмочном наборе поиск ставит правильный фрагмент первым для 16 из 16 вопросов. Без модели 12 из них получают ответ, четыре перефраза требуют модели; семь вопросов вне базы получают «не знаю». Это проверка заданного набора, а не обещание точности ИИ на любых вопросах.
Комментарий разработчика
Что было трудно
Главная сложность — различать наличие похожего текста и наличие ответа. Слова о цене встречаются в разных разделах, а вопрос о погоде может пересекаться с прайсом по отдельным словам. Поэтому разделил поиск кандидатов и проверку ответа моделью, добавил источники и отдельную причину отказа.
Ещё одна задача — не терять работоспособность при сбоях и параллельных вопросах. Квота резервируется атомарно, бюджет проверяется перед вызовом модели, а сетевой сбой возвращает сервис к поиску по базе. Контакты анкеты не попадают в последующие запросы к модели.
Что далось легко
Общая логика для двух каналов хорошо легла на отдельный Python-движок. Виджет и Telegram-бот передают ему вопрос, а получают одинаковые ответы, источники и шаги анкеты. Изменение прайса не требует двух независимых реализаций.
Базу удобно поддерживать обычными Markdown-файлами. Условия доставки, цены и FAQ разделены на понятные разделы, которые можно открыть под ответом и сверить с исходным документом.
Технологии
PythonFastAPIPostgreSQLGigaChataiogramDocker