Max AI Agent
Artykuły

Agent AI między CRM a zgłoszeniami: projekt mapowania, statusów i błędów

Proponowany warsztat integracyjny: karta pól, reguły zmiany statusów, obsługa niejednoznacznych zapisów i scenariusze odbioru.

Redakcja Max AIOpublikowano Zaktualizowano

Zacznij od jednej sprawy i pisemnych granic

Proponujemy rozpocząć projekt od jednego scenariusza: agent przygotowuje podsumowanie zgłoszenia i proponuje aktualizację powiązanej sprawy w CRM. Wszystkie nazwy pól, statusy i przykłady w tym artykule są naszym projektem warsztatowym. Nie opisują funkcji konkretnego dostawcy ani zachowania określonego API. Potraktuj je jako materiał do uzupełnienia podczas projektowania własnego połączenia.

Na pierwszym spotkaniu zapiszcie cel w jednym zdaniu: „Po zatwierdzeniu podsumowania zgłoszenia przypisz je do wskazanej sprawy klienta”. Następnie określcie, kto wybiera klienta, kto zatwierdza treść oraz kto rozstrzyga niezgodność statusów. Proponujemy osobno opisać uprawnienie do przygotowania propozycji, wykonania zapisu i zamknięcia sprawy. Nie przyznawajcie tych trzech ról automatycznie temu samemu etapowi procesu.

W proponowanej karcie zakresu uwzględnijcie również operacje wyłączone: tworzenie nowych klientów, łączenie kontaktów i usuwanie zgłoszeń. Przy każdej z nich wpiszcie osobę odpowiedzialną za ewentualne rozszerzenie zakresu. Jako materiał do przeglądu przygotujcie jeden kompletny przykład, od wejściowego zgłoszenia do oczekiwanego rekordu docelowego, zamiast samego opisu intencji.

Nasza karta mapowania danych

Proponujemy tabelę, w której każdy wiersz reprezentuje jedno pole docelowe. Umieśćcie w niej nazwę pola źródłowego, nazwę docelową, typ wartości, dopuszczalne wartości, regułę przekształcenia i zachowanie przy braku danych. Dodajcie właściciela decyzji oraz przykład zaakceptowanego wyniku. Każdą zmianę tej tabeli oznaczajcie własnym numerem wersji.

Dla ćwiczenia przyjmijcie pole ticket_ref, które przechowuje identyfikator zgłoszenia, oraz crm_case_ref, które wskazuje wybraną sprawę. W naszym proponowanym kontrakcie oba pola mają być tekstem. Niech agent przekazuje je w osobnych właściwościach, a nie w treści podsumowania. Osobno przewidźcie identyfikator powiązania i identyfikator pojedynczej operacji zapisu.

Dla opisów proponujemy dwa pola: summary_draft oraz summary_approved. Pierwsze przeznaczcie na propozycję agenta, drugie na treść dopuszczoną do wysłania. Określcie limit długości przyjęty w waszym projekcie i sposób postępowania po jego przekroczeniu. Zamiast dowolnego skracania zaproponujcie powrót do redakcji z widocznym komunikatem o wymaganej długości.

Wartości puste opiszcie jako odrębne decyzje. W naszym wariancie brak właściwości oznacza „nie zmieniaj”, pusty tekst wymaga sprawdzenia, a usunięcie istniejącej wartości wymaga osobnego polecenia. To proponowana konwencja integracji; potwierdźcie jej zgodność z wybranymi interfejsami przed wdrożeniem. Dla każdego wariantu przygotujcie osobny przykład wejścia i oczekiwanego wyniku.

Dla kategorii i priorytetów opracujcie zamknięty słownik projektu. Przykładowo przypiszcie roboczą kategorię „pytanie o fakturę” do uzgodnionego kodu docelowego. Jeśli agent poda kategorię spoza tabeli, w proponowanym procesie skierujcie ją do przeglądu. Nie dopisujcie nowej kategorii podczas pojedynczego wykonania bez odrębnej decyzji właściciela słownika.

Proponowany warsztat

Od pola do zaakceptowanego przykładu

  1. 1

    Wskaż pole

    Zapisz nazwę źródłową, docelową i właściciela decyzji.

  2. 2

    Ustal regułę

    Określ typ, słownik i przekształcenie.

  3. 3

    Opisz braki

    Rozróżnij pominięcie, pustą wartość i polecenie usunięcia.

  4. 4

    Zatwierdź przykład

    Dołącz wejście i oczekiwaną wartość docelową.

Nasza proponowana kolejność opracowania jednego wiersza mapowania. Cztery etapy: wybór pola, określenie reguły, opis braków i zatwierdzenie przykładu.

Nasza umowa o statusach i kierunkach zmian

Proponujemy potraktować status zgłoszenia i status sprawy jako dwa osobne pola. Niech tabela przejść określa, które zdarzenie upoważnia integrację do zaproponowania zmiany drugiego pola. W przykładzie warsztatowym wybierzcie statusy zgłoszenia „nowe”, „w obsłudze” i „rozwiązane”, a dla sprawy CRM „otwarta”, „oczekuje” i „zamknięta”.

Nie przypisujcie im znaczenia wyłącznie na podstawie podobieństwa nazw. W naszym projekcie „rozwiązane” uruchamia przygotowanie propozycji zamknięcia sprawy, natomiast sam zapis „zamknięta” wymaga zatwierdzenia opiekuna. Dla ponownego otwarcia zgłoszenia ustalcie oddzielną ścieżkę. Możecie wybrać ponowne otwarcie tej samej sprawy albo skierowanie decyzji do człowieka; zapiszcie jeden wariant jako obowiązującą konwencję projektu.

Dla każdego przejścia określcie źródło decyzji. Proponujemy, aby system zgłoszeń decydował o stanie obsługi, CRM o przypisaniu opiekuna, a agent o treści roboczego podsumowania. Jeżeli dwa zdarzenia żądają sprzecznych zmian, zatrzymajcie automatyczny zapis i przedstawcie obie propozycje osobie wskazanej w karcie zakresu.

Ustalcie także własną konwencję potwierdzeń. W naszym wariancie rozróżniamy „zaproponowano”, „zatwierdzono”, „wysłano” i „potwierdzono zapis”. Dopiero ostatni etap pokazujcie operatorowi jako zakończoną synchronizację. Przy odrzuconej propozycji pozostawcie powód odrzucenia oraz decyzję, czy przygotować nową wersję, czy zakończyć tę operację.

Konwencja projektu

Dwa pola, osobne decyzje

Zgłoszenie
Roboczy słownik
Nowe, w obsłudze, rozwiązane
Źródło decyzji
Uzgodniony proces obsługi
Przykład zamknięcia
Przygotuj propozycję dla CRM
Sprawa CRM
Roboczy słownik
Otwarta, oczekuje, zamknięta
Źródło decyzji
Uzgodniony proces opiekuna
Przykład zamknięcia
Zapisz po zatwierdzeniu opiekuna
Przykładowy podział odpowiedzialności do zatwierdzenia podczas warsztatu. Porównanie proponowanych zasad dla statusu zgłoszenia i statusu sprawy CRM.

Nasza kolejka błędów i niepewnych wyników

Proponujemy cztery robocze grupy obsługi: niepoprawne dane, brak dopasowania, odrzucony zapis i wynik nieustalony. Dla każdej grupy przypiszcie osobę odpowiedzialną, następny krok oraz warunek zakończenia. Są to etykiety naszego procesu, a nie klasyfikacja kodów odpowiedzi konkretnego systemu.

Przy niepoprawnych danych pokażcie pole, otrzymaną wartość i oczekiwaną regułę. Przy braku dopasowania przedstawcie dostępne kandydatury albo pole do ręcznego wskazania sprawy. Niech operator zatwierdzi wybór przed wysłaniem podsumowania. Przy odrzuconym zapisie zachowajcie treść odpowiedzi systemu i oznaczcie, czy kolejna próba wymaga poprawienia danych lub konfiguracji.

Dla wyniku nieustalonego proponujemy osobny etap sprawdzenia. Niech operator lub uzgodniona procedura odczyta rekord docelowy i porówna go z zamierzoną zmianą. W tym scenariuszu dopuszczajcie ponowienie dopiero po decyzji „zapis potwierdzony” albo „zapis niepotwierdzony, ponowienie zatwierdzone”. Wpiszcie również własny limit prób i osobę podejmującą decyzję po jego osiągnięciu.

W dzienniku operacji proponujemy przechowywać identyfikator operacji, powiązane rekordy, wersję mapowania, proponowaną zmianę, wynik kontroli, odpowiedź zapisu oraz następną czynność. Oddzielcie treść wygenerowaną od odpowiedzi systemu docelowego. W widoku operatora umieśćcie jednoznaczny przycisk odpowiedni do etapu: „popraw dane”, „wskaż sprawę”, „sprawdź zapis” albo „przekaż opiekunowi”.

Nasz odbiór integracji na przykładach

Google wskazuje, że odpowiedzi generatywnej AI mogą zawierać nieścisłości, i zaleca ręczne sprawdzanie treści przed publikacją. To wskazówka dotycząca treści internetowych; nie jest specyfikacją integracji CRM. Źródło. Naszą propozycją dla tego warsztatu jest analogiczny punkt kontroli podsumowania przed zatwierdzeniem zapisu.

Przygotujcie sześć przypadków odbiorowych: kompletne dane, brak identyfikatora sprawy, nieznana kategoria, sprzeczne statusy, odrzucony zapis oraz nieustalony wynik operacji. Dla każdego zapiszcie oczekiwane pola, dozwolone przejście, komunikat dla operatora i osobę odpowiedzialną. Podczas przeglądu oceniajcie zgodność z tymi oczekiwaniami, a nie sam fakt uruchomienia przepływu.

Google proponuje również pytanie oceniające treść: czy odbiorca nauczył się wystarczająco dużo, by osiągnąć swój cel. Źródło. W naszej proponowanej instrukcji operatora zastosujcie podobny sprawdzian: poproście uczestnika warsztatu o wskazanie następnego kroku w każdym z sześciu przypadków. Niech niejasne odpowiedzi staną się zadaniami redakcyjnymi dla zespołu.

Nasz plan przekazania do eksploatacji

Proponujemy trzy etapy przekazania: przegląd mapowania, wykonanie zatwierdzonych scenariuszy i ograniczony start wybranego zakresu. Przed każdym etapem wpiszcie osobę akceptującą oraz dokument będący podstawą decyzji. Ustalcie również warunek wstrzymania zapisów i sposób ręcznego dokończenia rozpoczętych spraw. Po każdej zmianie słownika lub reguły statusu wróćcie do odpowiednich przykładów odbiorowych.

Strona rejestracji Max AI przedstawia usługę jako „Operating system for AI agents”. Źródło. Nasza propozycja następnego kroku to przygotowanie powyższej karty integracji przed rozmową o zakresie wdrożenia. Dołączcie jeden przykład mapowania, jedno sporne przejście statusu i jeden nieustalony wynik zapisu. Na tej podstawie określcie oczekiwane zachowanie oraz pytania do dokumentacji wybranego CRM i systemu zgłoszeń.

Proponowane etapy

Trzy decyzje przed przekazaniem

  1. Przegląd mapowania

    Zatwierdź pola, słowniki i odpowiedzialność za statusy.

  2. Odbiór scenariuszy

    Porównaj wyniki sześciu przypadków z zapisanymi oczekiwaniami.

  3. Ograniczony start

    Wybierz zakres, warunek wstrzymania i sposób ręcznego dokończenia spraw.

Na każdym etapie wskaż osobę akceptującą i podstawę jej decyzji. Etapowy plan obejmujący przegląd mapowania, odbiór scenariuszy i ograniczony start.

Źródła

  1. Max AI - Operating system for AI agents — maxaiagent.app; dostęp 20 listopada 2026
  2. Google Search's Guidance on Generative AI Content on Your Website | Google Search Central | Documentation | Google for Developers — developers.google.com; opublikowano 1 października 2026
  3. Creating Helpful, Reliable, People-First Content | Google Search Central | Documentation | Google for Developers — developers.google.com; opublikowano 5 października 2026

Zacznij działać z własnym agentem

Agent zna kontekst tego artykułu i nadal realizuje checklistę przypisanego działu.

Załóż konto
Max AI Agent
Integracja agenta AI z CRM: dane, statusy i błędy