1. Mety projektu
Opracować agenta AI do automatycznego określania analogów produktów i formowania cross-selli z integracją w BAS KUP przez moduł "System interakcji" (Dyskusja).
2. Cele biznesowe
- Zmniejszenie strat sprzedaży w przypadku braku towaru
- Zwiększenie średniego koszyka dzięki cross-sellom
- Standaryzacja rekomendacji dla menedżerów
- Zmniejszenie zależności od doświadczenia menedżera
3. Architektura rozwiązania
Usługa AI jest realizowana jako osobny mikroserwis z REST API. BAS KUP pełni rolę źródła danych i klienta API.
Komponenty:
1. BAS KUP (źródło produktów, zamówień, stanów magazynowych)
2. Usługa AI (logika analogów i cross-selli)
3. REST API (wymiana danych)
4. Moduł integracji BAS (rozszerzenie konfiguracji)
4. Podstawowa funkcjonalność
4.1 Określenie analogów:
- Exact (dokładny analog)
- Close (bliski analog)
- Alternative (alternatywne rozwiązanie)
4.2 Formowanie cross-selli:
- Must-have
- Recommended
- Upsell
- Bundle
5. Punkty uruchomienia AI
- Przy otwieraniu zamówienia
- Przy dodawaniu produktu do zamówienia
- Przy braku towaru w magazynie
- Przy naciśnięciu przycisku "AI-podpowiedź"
6. Format API
Endpoint: /analogs
Endpoint: /crosssell
Metoda: POST
Format wymiany: JSON
Przykład odpowiedzi:
analogs_exact[], analogs_close[], alternatives[]
crosssell_must[], crosssell_recommended[], upsell[]
manager_script, reason_short
7. Integracja z BAS KUP
Realizować przez rozszerzenie konfiguracji bez zmiany typowej bazy. BAS wykonuje zapytanie HTTP do usługi AI i publikuje odpowiedź w zakładce "Dyskusja" odpowiedniego dokumentu.
8. Ograniczenia AI
- Nie wymyślać cech
- Nie zmieniać cen ani stanów magazynowych
- Nie dawać gwarancji dostawy
- Używać tylko danych z BAS
9. Bezpieczeństwo
- Autoryzacja przez token API
- Logowanie zapytań
- Ograniczenie dostępu do danych wewnętrznych
10. Etapy realizacji
1. Audyt struktury produktów
2. Opracowanie usługi AI
3. Opracowanie rozszerzenia dla BAS
4. Testowanie
5. Uruchomienie
