Необходимо создать готовый, протестированный workflow для n8n, который будет работать как первая линия поддержки SaaS-сервиса Venta-CRM.
Агент должен принимать обращения пользователей в Telegram, собирать полный запрос, обращаться к базе знаний на Google Drive и отвечать пользователю только тогда, когда в базе знаний есть точный ответ.
Если точного ответа нет, агент не должен выдумывать ответ. В таком случае он передает обращение в Telegram-группу менеджеров.
Канал коммуникации
Используем только:
Необходимо поддержать 2 сценария:
1. Клиент пишет боту в личные сообщения
2. Клиент пишет в Telegram-группу, где присутствует бот
Бот один. Но в будущем должна быть возможность масштабировать логику на других клиентов.
База знаний
База знаний находится в Google Drive.
Формат:
Google Docs
15-20 документов сейчас
в дальнейшем 50+ документов
каждый документ - отдельная инструкция или отдельный вопрос
язык документов - украинский
средний размер документа - 1-2 страницы
Примеры документов:
Как подключить телефонию
Как оптимизировать маршрут
Как добавить водителя
Как работает баланс клиента
Как настроить тарифы
Необходимо подготовить базу знаний к AI-поиску.
Желаемая логика:
Google Drive
↓
загрузка Google Docs
↓
разбиение текста на chunks
↓
OpenAI embeddings
↓
vectore store
↓
AI Agent ищет ответ в vector store
Индексация базы знаний
Нужен отдельный workflow для индексации базы знаний.
Варианты:
1. ручной запуск индексации
2. автоматическая переиндексация 1 раз в неделю
Агент не должен каждый раз читать все документы из Google Drive при каждом обращении пользователя. База должна быть предварительно проиндексирована.
AI-модель
Используем только OpenAI API.
Модель можно предложить исполнителю, но нужно выбрать оптимальный вариант по качеству и цене.
Ожидания:
короткие ответы
природный стиль живого менеджера
без лишних длинных объяснений
без выдумывания информации
Логика работы агента
Основной сценарий:
Пользователь пишет сообщение
↓
n8n получает сообщение через Telegram Bot API
↓
бот ждет 45 секунд
↓
если пользователь написал несколько сообщений, они объединяются в один запрос
↓
агент определяет суть обращения
↓
агент ищет ответ в базе знаний
↓
если точный ответ найден и confidence >= 80% - отвечает пользователю
↓
если ответа нет или confidence < 80% - передает обращение менеджерам
Обработка сообщений частями
Если пользователь пишет:
Добрый день
Подскажите, пожалуйста
Как добавить нового водителя?
Агент должен обработать это как один запрос:
Добрый день. Подскажите, пожалуйста, как добавить нового водителя?
Если пользователь написал только:
Бот не должен искать ответ в базе знаний. Он должен ответить:
Добрый день! Напишите, пожалуйста, ваше вопрос по Venta-CRM - я постараюсь помочь.
Условия ответа
Агент отвечает пользователю только если:
1. вопрос понятен
2. в базе знаний найдена точная ответ
3. confidence не ниже 80%
Агент не должен отвечать, если:
ответ найден лишь частично
ответ не подтвержден базой знаний
вопрос не полностью понятен
в базе нет точной инструкции
В таких случаях:
если вопрос неполный - задать уточняющее вопрос
если вопрос понятен, но ответа нет - передать менеджерам
Передача менеджерам
Если агент не нашел ответ, нужно отправить сообщение в одну общую Telegram-группу менеджеров.
Сообщение менеджерам должно содержать:
Новый запрос пользователя без точного ответа в базе знаний
Клиент:
{{client_name}}
Username / Telegram ID:
{{telegram_user}}
Источник:
личные сообщения боту / Telegram-группа
Полный запрос:
{{full_user_question}}
Контекст последних сообщений:
{{dialog_context}}
Причина передачи:
ответ не найден / confidence ниже 80%
Пользователю в этот момент нужно ответить:
Спасибо, вопрос получили. Передал его менеджеру, чтобы проверить информацию и предоставить точный ответ.
Ответ менеджера
Необходимо реализовать возможность, чтобы менеджер мог ответить клиенту из Telegram-группы менеджеров.
Также желательно добавить кнопки:
Взял в работу
Ответил
Добавить в базу знаний
Если реализация кнопок усложняет MVP, нужно вынести это отдельным блоком, но желательно заложить в архитектуру.
Добавление новых Q&A в базу знаний
Если менеджер ответил на вопрос, которого не было в базе знаний, нужно предусмотреть ручное добавление нового вопроса-ответа в базу знаний.
Желаемый вариант:
Google Sheets или отдельная Google Drive папка для новых Q&A
Менеджер вручную подтверждает, что ответ можно добавить в базу знаний.
Статистика
Необходимо сохранять статистику в Google Sheets.
Минимальные KPI:
дата обращения
Telegram ID пользователя
type источника: личные сообщения / группа
tема или короткая суть вопроса
ответил ли агент самостоятельно
было ли передано менеджеру
confidence
время ответа
статус: answered / escalated / clarification
популярные вопросы
Технические требования
Платформа:
n8n self-hosted
сервер Hetzner
последняя актуальная версия n8n
Telegram Bot API
OpenAI API
Google Drive
Google Sheets
API-ключи и credentials я не передаю исполнителю.
Необходимо сделать workflow так, чтобы я сам мог подключить свои credentials в n8n.
Что должно быть в результате
Исполнитель должен передать:
1. готовый n8n workflow в формате JSON
2. отдельный JSON workflow для индексации базы знаний
3. инструкцию по подключению credentials
4. инструкцию по настройке Telegram Bot API
5. инструкцию по подключению Google Drive папки базы знаний
6. инструкцию по подключению Google Sheets для статистики
7. короткое описание логики workflow
8. перечень мест, где нужно заменить переменные
Тестирование перед приемом
Важно: workflow должен быть протестирован исполнителем до передачи.
Ожидаю, что исполнитель:
1. поднимет workflow в своем n8n или тестовом окружении
2. протестирует на реальном Telegram-боте
3. протестирует на тестовой базе знаний Google Drive
4. покажет результат работы
5. после этого передаст JSON workflow
Я принимаю задачу только после того, как смогу сам протестировать workflow в своем n8n со своим Telegram Bot API, OpenAI API и Google Drive.
Критерии приемки
Workflow считается готовым, если:
1. бот принимает сообщения в Telegram
2. бот ждет 45 секунд и собирает сообщения частями
3. бот распознает простое приветствие
4. бот ищет ответ в базе знаний
5. бот отвечает только при confidence >= 80%
6. бот не выдумывает ответы
7. бот ставит уточняющее вопрос, если запрос неполный
8. бот передает вопросы менеджерам, если ответа нет
9. менеджеры получают полный контекст обращения
10. статистика записывается в Google Sheets
11. база знаний индексируется из Google Drive
12. есть готовый JSON workflow
13. есть понятная пошаговая инструкция для установки
Важно для исполнителя
Прошу откликаться только тем, кто имеет практический опыт с:
n8n
Telegram Bot API
OpenAI API
AI Agent / RAG
Google Drive API
Google Sheets
vector store / embeddings
В отклике прошу кратко указать:
1. делали ли подобные AI support agents
2. какой vector store рекомендуете для этой задачи
3. как планируете реализовать буфер 45 секунд
4. как будете определять confidence >= 80%
5. ориентировочный срок выполнения
6. примеры подобных workflow, если есть
Ожидаемый результат
Нужен не теоретический описание, а готовый рабочий workflow для n8n, который можно импортировать через JSON, подключить credentials по инструкции и использовать как AI-агента первой линии поддержки Venta-CRM.