Asystenci ds. dochodzeń w przedsiębiorstwach potrzebują EA, LangGraph, MCP i RAG.

Architektura przedsiębiorstwa dla asystenta do dochodzeń wieloźródłowych — dział administracyjny, logi Grafany i podsumowania transakcji

Dochodzeniowcy rzadko pracują w jednym systemie przechowywania danych. Praktyczny asystent musi zsynchronizować zgłoszenia z działu administracyjnego, logi Grafany oraz podsumowania transakcji w jednej osi czasu. To problem architektury przedsiębiorstwa: granice, zarządzanie i stopniowe wdrażanie — a nie weekendowy chatbot.

Dlaczego to jest problem architektury przedsiębiorstwa, a nie projekt „chatbotu”

Interfejsy chatowe ukrywają trudne aspekty: które źródło jest autorytatywne pod względem kwoty, kto może uzyskać dostęp do danych osobowych, w jaki sposób wywołania narzędzi przechodzą przez różne strefy sieciowe oraz jak odpowiedzi powołują się na dowody. Zapisy decyzji architektonicznych oraz fazy w stylu TOGAF sprawiają, że te pytania pozostają jasne, zanim liczba zapytań wzrośnie.

ADM w jednym zdaniu

Metoda rozwoju architektury uporządkowuje kwestie wizji, biznesu, danych, technologii, możliwości, migracji, zarządzania oraz zmian — dzięki temu proces realizacji nie pomija zgody i kontroli.

Faza wstępna — zasady przed żądaniami

Należy wcześnie uzgodnić zasady: minimalne uprawnienia, wymaganie podania źródła lub odmowa, narzędzia muszą się sprawdzić, podczas gdy RAG dostarcza wyjaśnienia, a decyzje o nieodwracalnych działaniach muszą być zatwierdzane przez człowieka. Bez tych zasad każdy nowy element systemu tworzy swój własny model zaufania.

Faza A — Wizja architektury: opis problemów w języku biznesowym

Analitycy tracą godziny, przeglądając różne portale, aby odpowiedzieć na pytanie „co się stało z tą płatnością?”. Sukces w tym zakresie polega na spójnej narracji z linkami do identyfikatorów zamówień, linii z dziennika oraz wpisów w księgach rachunkowych — a nie na ogólnikowym tekście wygenerowanym przez model językowy.

Faza B — Architektura biznesowa: co oznacza dochodzenie

Zmapuj role (analityk, specjalista ds. oszustw, audytor), wyzwalacze (odwołanie płatności, alert o anomalii) oraz wyniki (zamknięcie, eskalacja, żądanie dodatkowych danych). Każdy wynik implikuje inne uprawnienia do narzędzi.

Faza C — Architektura danych: trzy prawdy, jedna chronologia

Działania w tle, możliwości obserwacji oraz transakcje przedstawiają po części prawdę. Znormalizuj identyfikatory, strefy czasowe oraz klucze entytetów, aby połączenia były dokładne. Przechowuj informacje o pochodzeniu każdego pobranego fragmentu danych.

Faza D — Architektura technologiczna: LangGraph, MCP, role RAG

LangGraph koordynuje procesy śledcze wymagające przechowywania stanu. MCP umożliwia dostęp do zarządzanych narzędzi w oddzielonych systemach. RAG podsumowuje i wyjaśnia informacje; nie wymyśla w tajemnicy żadnych sald.

User question →
classify intent + extract entities (player_id, time window, txn id)
→ plan tools (which sources, in what order)
→ execute tools (parallel where independent)
→ reconcile (timeline merge, conflict detection)
→ answer (cited) OR escalate

Dlaczego LangGraph? (Decyzja ARB)

Dziale śledcze: czasami najpierw pobiera się logi, czasami księgę rachunkową, a czasami trzeba czekać na osobę. Wykresy z punktami kontrolnymi są lepsze od liniowych łańcuchów, gdy pauzy i odtwarzanie są normą.

MCP — jeden protokół, wiele granic przedsiębiorstw

Każdy serwer MCP znajduje się na granicy zaufania i ma własną mechanizm autoryzacji. Agent odkrywa narzędzia bez konieczności włączania każdego SDK. Zasady sieciowe pozostają przypisane do serwerów, a nie do tekstu poleceń.

RAG — wyjaśnia; narzędzia potwierdzają

Embeddingi pozwalają na uzyskanie kontekstu narracyjnego; sprawdzanie równowagi oraz zapytania do logów odbywają się za pośrednictwem narzędzi, które łączą się z systemami rejestrowymi. Mieszanie tych dwóch elementów bez oznaczeń powoduje fałszywe poczucie pewności.

Faza E — możliwości i rozwiązania

Buduj własne narzędzia do orkiestracji; kupuj lub używaj ponownie połączeń tam, gdzie dostawcy już obejmują swoimi rozwiązaniami systemy podstawowe; unikaj przepisywania Grafany lub księgi rachunkowej.

Faza F — migracja: pilotaż bez ryzyka dla banku

Zacznij od jednego typu dochodzenia, jednej jednostki biznesowej oraz odpowiedzi sprawdzanych przez ludzi. Rozszerz źródła dopiero wtedy, gdy wskaźniki „cite-or-refuse” się ustabilizują.

Faza G — Zarządzanie wdrożeniem

ARB kontroluje decyzje: jakie narzędzia są dozwolone, gdzie przechowywane są tajemnice oraz jak zachowywane są ślady.

ADR-008:
Player investigation assistant
LangGraph orchestration, MCP tools, RAG for context onlyStatus:
Accepted Date: 03/01/2026
Deciders: Architecture Board, Support Ops, Fraud, Payments, SRE, Data Platform, Risk
Context: Support, fraud ops, and back office investigate player issues by manually querying transaction summaries, Grafana/Loki logs, and back-office APIs. Answers are slow, inconsistent, and hard to audit. A generic "chat with your data" approach risks hallucinated financial facts and unbounded database access.
Decision Build an internal player investigation assistant: LangGraph- stateful orchestration (classify → plan → execute tools → reconcile → answer or escalate). Chosen over linear chains and one-shot prompts because investigations branch (payment vs gameplay vs bonus), require explicit state for audit, and need deterministic edges (e.g. FAILED txn → always pull payment-service logs) that ARB can diagram and version in Phase H MCP servers - one bounded tool surface per system of
record: `transaction_summary` - read-only parameterized queries on summary views `grafana_loki` - time-bounded LogQL with service allowlist `back_office` - scoped REST for account flags and context RAG - embed docs only (schema, enums, runbooks, ADR snippets); never live txn rows or log streams Citations required - factual claims must reference tool output ids Fail closed on ambiguous `player_id` or conflicting tool resultsConsequences Positive: Faster investigations; consistent citations; reusable MCP servers for future automations; clear security boundary (tools vs retrieval). Negative: LangGraph flow maintenance; MCP server ownership per domain team; golden-question regression suite required on model changes. Obligations: No free-form SQL from the model; quarterly access review; version MCP schemas when summary views change; shadow mode before full rollout.Alternatives considered | Alternative | Why rejected | |-------------|--------------| | Single prompt with DB + Grafana credentials | Ungovernable; audit nightmare | | RAG over exported txn/log snapshots | Stale truth; PII surface area | | Buy vendor "AI ops" suite only | Poor fit to gaming txn + custom back office; lock-in | | Dashboards only | Solves visibility, not synthesis and audit trail | | Autonomous agent with write tools | Unacceptable risk on wallet/account paths for v1 |

Faza H — Zarządzanie zmianami

Modele ulegają zmianom; polityka dochodzeń nie powinna. Używaj wskazówek dotyczących wersji oraz narzędzi takich jak API; ponownie szkol ludzi, gdy zmieni się zachowanie odmowy.

To, czego się nauczyliśmy („i”, a nie „vs”)

LangGraph i MCP i RAG współpracują: przy organizacji, dostępie i wyjaśnianiu. Traktowanie ich jako konkurentów marnuje architekturę.

Kiedy nie warto tego budować

Jeśli pojedyncze wyszukiwanie w CRM już odpowiada na 95% zapytań, agent wieloźródłowy jest zbędny. Buduj go wtedy, gdy głównym ograniczeniem jest łączenie informacji z różnych systemów w jedną chronologię.

Zakończenie

Pomocnicy w badaniach korporacyjnych odnoszą sukces, gdy architektura określa fakty, narzędzia oraz czynniki ludzkie — wtedy LangGraph jedynie realizuje ten projekt.

Szczegółowe uwagi dotyczące etapu C

Badacze tracą zaufanie, gdy daty czasowe różnią się o godziny z powodu tego, że jeden system używa czasu UTC, a drugi lokalnego. Należy ustandaryzować czas na UTC w widoku chronologii pomocnika i przedstawiać oryginalne strefy czasowe jako metadane. Rozwiązywanie problemów z identyfikacją entytetów (id konta, adres e-mail, id urządzenia) powinno należeć do architektury danych, a nie do zdań instrukcyjnych opartych na domysłach. Lepiej używać deterministycznych zapytań do bazy danych głównej za pomocą narzędzi MCP niż nieprecyzyjnych metod RAG.

Szczegółowe uwagi dotyczące płaszczyzny sterowania etapu D

Stan LangGraph powinien zawierać identyfikator dochodzenia, identyfikator podmiotu, zgodną listę narzędzi oraz notatki z hipotezami. Opisy narzędzi MCP muszą określać klasę efektu ubocznego (czytanie lub zapisywanie). Zbiory RAG są dzielone według poziomu wrażliwości. ARB powinien odrzucać projekty, które pozwalają modelowi tworzyć zapytania SQL do produkcyjnych magazynów; tylko weryfikowane narzędzia mogą mieć dostęp do tych systemów.

Metryki pilotażowe, które są istotne

• Mediana czasu do pierwszego przytoczonego dowodu
• Procent odpowiedzi zawierających co najmniej dwa niezależne typy źródeł
• Wskaźnik interwencji człowieka przy wywoływaniu narzędzi
• Wskaźnik odrzuceń z powodu niewystarczających dowodów
• Zablokowane próby dostępu między użytkownikami

Metryki pozorne, takie jak „liczba wysłanych wiadomości”, nie potwierdzają wartości badawczej.

Antypaternale

Budowanie megaindeksu wszystkiego bez pól ACL; pozwalanie modelom językowym na wybór surowych sterowników bazy danych; pomijanie fazy H, przez co prompty zmieniają się co tydzień bez żadnej weryfikacji; traktowanie Grafany jako opcjonalnego narzędzia do kolorowania zamiast pierwszorzędnego kanału informacji o błędach w trakcie działania systemu.

Przykład narracyjny

Analista pyta, dlaczego wypłata została odwołana. System otwiera narzędzie do przeglądania przypadków (back office), pobiera powiązane identyfikatory transakcji, przeszukuje logi z okresu dokonania rozliczenia i dopiero wtedy tworzy streszczenie z odniesieniami. Jeśli logi są brakujące, asystent odmawia udzielenia pewnej odpowiedzi i prosi o szerszy zakres czasowy — zamiast wymyślać nieprawdziwą narrację dotyczącą procesora.

Zdjęcia architektury bezpieczeństwa

Umieść serwery MCP w tych samych strefach bezpieczeństwa co systemy, które obsługują. Orchestrator w strefie DMZ powinien widzieć jedynie punkty końcowe narzędzi, a nie łańcuchy połączeń do bazy danych. Krótkotrwałe tokeny przy każdym dochodzeniu są lepsze od długotrwałych kluczy usługowych udostępnianych pomiędzy agentami. Rejestruj wywołania narzędzi w niezmiennej dziennicy audytowej oddzielonej od śladów modeli, aby zespół ds. zgodności mógł sprawdzić, kto pobrał dane z konkretnej pozycji, bez konieczności pobierania pełnych zapytań.

Związek z istniejącymi rozwiązaniami ITSM

Nie zastępuj od razu narzędzia do zarządzania przypadkami. Zapisuj wyniki działania asystenta jako komentarze do przypadku wraz z odniesieniami. Analitycy pozostają odpowiedzialni; graf przyspiesza proces kompletowania informacji. Pilotaże fazy F, które próbują automatycznie zamykać przypadki, zazwyczaj napotykają problemy związane z zaufaniem – komentarze w trybie cieniowym budują to zaufanie dzięki dowodom.

Umiejętności versus surowe narzędzia (opcjonalna warstwa)

Gdy katalogi narzędzi się rozrastają, umiejętności analityczne mogą pakować sekwencje działań (pobranie przypadku → pobraanie transakcji → zapytanie do logów → streszczenie), podczas gdy MCP pozostaje warstwą funkcjonalną. Odzwierciedla to szerszy kierunek rozwoju branży, bez konieczności wprowadzania nowego standardu, dopóki projekt pilotażowy nie udowodni swojej wartości.

Streszczenie dla kierownictwa ARB

Proszę o finansowanie w oparciu o skrócenie czasu obsługi i poprawę możliwości audytowania, a nie o „posiadanie agenta”. Pokaż demonstrację procesu przed i po wdrożeniu z wykorzystaniem trzech źródeł danych. Zobowiązuj się do odrzucania stawek i testów ACL jako warunków wypuszczenia produktu. W takim ujęciu LangGraph i MCP są jedynie szczegółami implementacji zatwierdzonej architektury – a nie projektem naukowym działającym równolegle z nią.

Umowy danych dla trzech prawd

Opublikuj prosty schemat dla CaseEvent, LogAnchor i LedgerPosting, który jest wspólny dla narzędzi MCP oraz indeksatorów. Harmonogramy dochodzeń deserializują te obiekty, a nie tekst wolny. Gdy źródło nie może dostarczyć pola, oznacz je wyraźnie jako null, aby syntezator nie mógł samodzielnie je uzupełnić. Umowy ewoluują tą samą ścieżką ARB co usługi – nie tylko poprzez edycje promptów.

Zdokumentuj założenia dotyczące przepływu sterowania obok kodu, aby przyszłe edycje nie mogły w tajemnicy usunąć żadnego krawędzi lub filtru. Wolij afirmacje podlegające weryfikacji maszynowej od wiedzy uzusowej, która jest dzielona jedynie w tematach czatowych. Ćwicz scenariusze awarii za każdym razem, gdy zmieniają się zasady topologii lub tożsamości.