Potrzebne jest stworzenie gotowego, przetestowanego workflow dla n8n, który będzie działał jako pierwsza linia wsparcia dla usługi SaaS Venta-CRM.
Agent ma przyjmować zapytania użytkowników w Telegramie, zbierać pełne zapytanie, odwoływać się do bazy wiedzy na Google Drive i odpowiadać użytkownikowi tylko wtedy, gdy w bazie wiedzy znajduje się dokładna odpowiedź.
Jeśli dokładnej odpowiedzi nie ma, agent nie ma wymyślać odpowiedzi. W takim przypadku przekazuje zapytanie do grupy menedżerów w Telegramie.
Kanał komunikacji
Używamy tylko:
Potrzebne jest wsparcie 2 scenariuszy:
1. Klient pisze do bota w wiadomościach prywatnych
2. Klient pisze w grupie Telegram, w której jest bot
Bot jest jeden. Ale w przyszłości musi być możliwość skalowania logiki na innych klientów.
Baza wiedzy
Baza wiedzy znajduje się na Google Drive.
Format:
Google Docs
15-20 dokumentów teraz
w przyszłości 50+ dokumentów
dokument każdy - osobna instrukcja lub osobne pytanie
język dokumentów - ukraiński
średni rozmiar dokumentu - 1-2 strony
Przykłady dokumentów:
Jak podłączyć telefonię
Jak zoptymalizować trasę
Jak dodać kierowcę
Jak działa saldo klienta
Jak ustawić taryfy
Potrzebne jest przygotowanie bazy wiedzy do wyszukiwania AI.
Pożądana logika:
Google Drive
↓
ładowanie Google Docs
↓
rozbicie tekstu na chunks
↓
OpenAI embeddings
↓
vectory store
↓
AI Agent szuka odpowiedzi w vectory store
Indeksacja bazy wiedzy
Potrzebny jest oddzielny workflow do indeksacji bazy wiedzy.
Opcje:
1. ręczne uruchomienie indeksacji
2. automatyczna ponowna indeksacja 1 raz w tygodniu
Agent nie ma za każdym razem czytać wszystkich dokumentów z Google Drive przy każdym zapytaniu użytkownika. Baza musi być wcześniej zaindeksowana.
Model AI
Używamy tylko OpenAI API.
Model można zaproponować wykonawcy, ale trzeba wybrać optymalną opcję pod względem jakości i ceny.
Oczekiwania:
krótkie odpowiedzi
naturalny styl żywego menedżera
bez zbędnych długich wyjaśnień
bez wymyślania informacji
Logika pracy agenta
Główny scenariusz:
Użytkownik pisze wiadomość
↓
n8n otrzymuje wiadomość przez Telegram Bot API
↓
bot czeka 45 sekund
↓
jeśli użytkownik napisał kilka wiadomości, są one łączone w jedno zapytanie
↓
agent określa istotę zapytania
↓
agent szuka odpowiedzi w bazie wiedzy
↓
jeśli dokładna odpowiedź została znaleziona i confidence >= 80% - odpowiada użytkownikowi
↓
jeśli odpowiedzi nie ma lub confidence < 80% - przekazuje zapytanie menedżerom
Przetwarzanie wiadomości częściami
Jeśli użytkownik pisze:
Dzień dobry
Proszę powiedzieć
Jak dodać nowego kierowcę?
Agent ma przetworzyć to jako jedno zapytanie:
Dzień dobry. Proszę powiedzieć, jak dodać nowego kierowcę?
Jeśli użytkownik napisał tylko:
Bot nie ma szukać odpowiedzi w bazie wiedzy. Ma odpowiedzieć:
Dzień dobry! Proszę napisać swoje pytanie dotyczące Venta-CRM - postaram się pomóc.
Warunki odpowiedzi
Agent odpowiada użytkownikowi tylko jeśli:
1. pytanie jest zrozumiałe
2. w bazie wiedzy znaleziono dokładną odpowiedź
3. confidence nie niższa niż 80%
Agent nie ma odpowiadać, jeśli:
odpowiedź została znaleziona tylko częściowo
odpowiedź nie została potwierdzona przez bazę wiedzy
pytanie nie jest w pełni zrozumiałe
w bazie nie ma dokładnej instrukcji
W takich przypadkach:
jeśli pytanie jest niepełne - zadać pytanie uzupełniające
jeśli pytanie jest zrozumiałe, ale odpowiedzi nie ma - przekazać menedżerom
Przekazanie menedżerom
Jeśli agent nie znalazł odpowiedzi, należy wysłać wiadomość do jednej wspólnej grupy Telegram menedżerów.
Wiadomość do menedżerów ma zawierać:
Nowe zapytanie użytkownika bez dokładnej odpowiedzi w bazie wiedzy
Klient:
{{client_name}}
Nazwa użytkownika / Telegram ID:
{{telegram_user}}
Źródło:
wiadomości prywatne do bota / grupa Telegram
Pełne zapytanie:
{{full_user_question}}
Kontekst ostatnich wiadomości:
{{dialog_context}}
Powód przekazania:
odpowiedź nie została znaleziona / confidence poniżej 80%
Użytkownik w tym momencie musi otrzymać odpowiedź:
Dziękuję, pytanie zostało odebrane. Przekazałem je menedżerowi, aby sprawdzić informacje i podać dokładną odpowiedź.
Odpowiedź menedżera
Potrzebne jest zrealizowanie możliwości, aby menedżer mógł odpowiedzieć klientowi z grupy menedżerów w Telegramie.
Również pożądane jest dodanie przycisków:
Wziąłem do pracy
Odpowiedziałem
Dodać do bazy wiedzy
Jeśli realizacja przycisków utrudnia MVP, należy to wydzielić jako osobny blok, ale pożądane jest uwzględnienie w architekturze.
Dodawanie nowych Q&A do bazy wiedzy
Jeśli menedżer odpowiedział na pytanie, którego nie było w bazie wiedzy, należy przewidzieć ręczne dodanie nowego pytania-odpowiedzi do bazy wiedzy.
Pożądana opcja:
Google Sheets lub oddzielny folder Google Drive dla nowych Q&A
Menedżer ręcznie potwierdza, że odpowiedź może być dodana do bazy wiedzy.
Statystyka
Potrzebne jest przechowywanie statystyki w Google Sheets.
Minimalne KPI:
data zapytania
Telegram ID użytkownika
typ źródła: wiadomości prywatne / grupa
temat lub krótka istota pytania
czy agent odpowiedział samodzielnie
czy zostało przekazane menedżerowi
confidence
time odpowiedzi
status: answered / escalated / clarification
popularne pytania
Wymagania techniczne
Platforma:
n8n self-hosted
serwer Hetzner
najbardziej aktualna wersja n8n
Telegram Bot API
OpenAI API
Google Drive
Google Sheets
API-keys i credentials nie przekazuję wykonawcy.
Potrzebne jest zrobienie workflow tak, aby sam mógł podłączyć swoje credentials w n8n.
Co ma być w wyniku
Wykonawca ma przekazać:
1. gotowy workflow n8n w formacie JSON
2. oddzielny workflow JSON do indeksacji bazy wiedzy
3. instrukcję podłączenia credentials
4. instrukcję ustawienia Telegram Bot API
5. instrukcję podłączenia folderu Google Drive bazy wiedzy
6. instrukcję podłączenia Google Sheets do statystyki
7. krótki opis logiki workflow
8. wykaz miejsc, gdzie należy zamienić zmienne
Testowanie przed przyjęciem
Ważne: workflow musi być przetestowany przez wykonawcę przed przekazaniem.
Oczekuję, że wykonawca:
1. uruchomi workflow w swoim n8n lub środowisku testowym
2. przetestuje na rzeczywistym Telegram-bocie
3. przetestuje na testowej bazie wiedzy Google Drive
4. pokaże wynik pracy
5. po tym przekaże JSON workflow
Akceptuję zadanie tylko po tym, jak będę mógł sam przetestować workflow w swoim n8n z moim Telegram Bot API, OpenAI API i Google Drive.
Kryteria akceptacji
Workflow uznaje się za gotowy, jeśli:
1. bot przyjmuje wiadomości w Telegramie
2. bot czeka 45 sekund i zbiera wiadomości częściami
3. bot rozpoznaje proste powitanienie
4. bot szuka odpowiedzi w bazie wiedzy
5. bot odpowiada tylko przy confidence >= 80%
6. bot nie wymyśla odpowiedzi
7. bot zadaje pytanie uzupełniające, jeśli zapytanie jest niepełne
8. bot przekazuje pytanie menedżerom, jeśli odpowiedzi nie ma
9. menedżerowie otrzymują pełny kontekst zapytania
10. statystyka jest zapisywana w Google Sheets
11. baza wiedzy jest indeksowana z Google Drive
12. jest gotowy JSON workflow
13. jest zrozumiała instrukcja krok po kroku do instalacji
Ważne dla wykonawcy
Proszę o zgłaszanie się tylko tych, którzy mają praktyczne doświadczenie z:
n8n
Telegram Bot API
OpenAI API
AI Agent / RAG
Google Drive API
Google Sheets
vector store / embeddings
W zgłoszeniu proszę krótko wskazać:
1. czy robili podobne AI support agents
2. jaki vector store rekomendujecie do tego zadania
3. jak planujecie zrealizować bufor 45 sekund
4. jak będziecie określać confidence >= 80%
5. orientacyjny czas realizacji
6. przykłady podobnych workflow, jeśli są
Oczekiwany wynik
Potrzebny jest nie teoretyczny opis, a gotowy działający workflow dla n8n, który można zaimportować przez JSON, podłączyć credentials zgodnie z instrukcją i używać jako AI-agenta pierwszej linii wsparcia Venta-CRM.