Памочнікі для розследавання ў прэдпрыемствах патрабуе EA, LangGraph, MCP і RAG.

Архітэктура падпрыемства для асістэнта для расследавання з калькольных джэраў — аддзены бэк-офіса, логі Grafana і падсумкі транзакцый

Раследавальнікі рэдка калі працуюць у адной сістэме зберагача дакументаў. Корыстны асістэнт павінен супакоўваць інформацыю з тыкетамі аддзена бэк-офіса, логамі Grafana і падсумкамі транзакцый у аднай часовой шкале. Гэта проблема архітэктуры падпрыемства: межы, кераванне і поэтапная рэалізацыя — а не проста чат-бот для вякенду.

Чаму гэта проблема архітэктуры падпрыемства, а не праект «чат-бота»

Інтэрфейсы чата маскуюць складныя аспекты: які джэнер кантролюе цячу, хто можа бачыць персональную інформацыю, як вызывы інструментоў пераводзяцца праз сеткавыя зоны і як адпаведзі цытуюць доказы. Запісы рашэнняў па архітэктуры і фазы у стыле TOGAF дапамагаюць чытка паказаць гэтыя пытанні ўсё раней, чым калькольныя запіты стануць занадта многімі.

ADM за аднае рэчы

Метод развітку архітэктуры выкладвае ў парадку візыю, бізнес, даныя, тэхналогіі, можлівасці, міграцыю, кераванне і змяны — такім чынам працэс рэалізацыі не ігнаруе згоду і контроль.

Прыяварочны этап — прынцыпы перад запітамі

Заранее даговорыцеся пра прынцыпы: мінімальныя правы, прабаваць чы рашыць негатывна, інструменты павінны быць пераканаючымі, а RAG — пояснюючым, а незворачлівыя дзеяння — падтверджаныя людзьмі. Без прынцыпаў кожны новы з’еднальнік стварае свой схема довер’я.

Этап А — Візыя архітэктуры: проблемы на мове бізнесу

Следчыя вітрачаюць гадзіны, перашукаючы інформацыю між разнымі порталамі, каб адпаведзець на запыт «Што сталося з гэтым платэжам?». Успех у візыі архітэктуры выглядае як ўніверсальная наратыва з поўязаннямі на ідэнтыфікаторы тыкаў, лініі журналу і запісы бухгалтэрскага обліку — а не як звычны эсэй, напісаны LLM.

Этап Б — Бізнес-архітэктура: што означае розследаванне

Апісанае ролі (аналіцыст, спецыяліст па борьбе з мошчаннем, аўдытар), трыгеры (вярненне грошаў, апавесць пра анамалію) і рэзультаты (закрыць, падняць на вышэйшы ранг, запрашаць большых дадзеных). Кожны рэзультат паўтарае разныя правы прыступу да інструментаў.

Фаза C — Архітэктура дадзеных: тры правды, адна часовая шкала

Функцыі, якія выканаюцца у закрытых структурах, можлівасці абзору і транзакцыі, кожна з яных паведамляе частку правды. Нормалізаваць ідэнтыфікаторы, часовыя зоны і ключы ентытаў, каб спаўненне запітоў было правдападобным. Зберагаць інформацыю пра паводзець кожнага атрыбута, які быў выявлены.

Фаза D — Архітэктура тэхналогій: LangGraph, MCP, ролі RAG

LangGraph керуе працэсамі расследавання з урахоўваннем стану дадзеных. MCP адкрывае доступ да кераваныях інструментаў у адсакроўаных сістэмах. RAG стварае кінуцыя выкладкі і ўсвятленья; яны не ствараюць балансы без падтрымкі дадзеных.

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

Чаму LangGraph? (Рашэнне ARB)

Адміністрацыя розследаванняў: інодзе спачатку запрашваюць логі, інодзе — бухгалтэрскія кнігі, а інодзе чакаюць на людзя. Графікі з пунктамі контролю лепшыя за лінейныя ланцюгі, калі паузы і перэгляд знову ёсць стандартамі.

MCP — адна пратака, многі корпаратыўныя межы

Кожны сервер MCP знаходзіцца на межы довер’я і мае савой атрыбут автэнтыкацыі. Агент выклікае інструменты без неабяжнае наяўнасці кожнага SDK. Палітыкі сеткі залішаюцца пры серверах, а не пры тэксце запіту.

RAG — пояснення; інструменты падтверджуюць

Эмбедынгі запоўняюць наратывны кантэкст; балансаванне пераказаў і запытов да логаў адбываецца праз інструменты, якія з’ўязваюцца з сістэмамі зберагання дадзэнняў. Сумешчанне гэтых двух методаў без абазавання стварае хыбнае довер’я.

Фаза E — Магчымасці і рашэнні

Ствараюць оркестрацыю самостойна; купуюць або перадаюць у паўторны выкарыстоўванне канектары там, дзе постачальнікі вялічаюць яшчэ основныя сістэмы; утрымваюцца ад перапісвання Grafana чы бухгалтэрскіх кніг.

Фаза F — Міграцыя: пілот без рызыка для банку

Пачніце з адного тыпу расследавання, адной бізнес-ячэйкі, пры чым адпаведныя адказы пераглядаюць людзі. Расшырайце каналы збору інфармацыі толькі пасля таго, як паказнікі «цітаваць/адражнаць» стабілізуюцца.

Фаза G — Управлінне рэалізацыяй

ARB фіксуе рашэнні: якія інструменты дазволены, дзе зберагаюцца секрэты, як захавляюцься следы.

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 |

Фаза H — Кантроль змян

Мадэлі меняюцца; політыка расследавання не павінна. Адпаведныя прапытанні пра версіі і інструменты на кшталт API; перапрыяўляйце персонал, калі зменяецца стаянне адражнення.

Што мы выявілі («і», а не «протыва»)

LangGraph і MCP і RAG саўместна працуюць: коардынаванне, доступ і адказы. Адносіць іх як супернікаў — значы марнаваць архітэктуру.

Калі не трэба ствараць гэта

Калі аднальны пошук у CRM вялікае 95% запытанняў, то агент з калькольніка істочнікаў — тэлькі формальнасць. Стварайце такое, калі прычынай спазу ёст трыбутаванне межасістэмных дадзенняў.

Заключныя заўважэнні

Памочнікі для расследаванняў у корпаратывах дасягаюць успеху, калі архітэктура вказвае правду, інструменты і людзей, якія беруць удзел — пасля чаго LangGraph проста выкананяе гэты праект.

Больш дакладныя заўважэнні пра адłąчэнне фазы C

Расследавальнікі трапляюцца ў сітуацыі, калі яны трапляюцца ў недоверы, калі часавыя меткі разніцяюцца на калькі гадзін, таму што адна сістэма выкарыстоўвае UTC, а іншая — местны час. Неабходна стандартызаваць відображэння часу ў памочніку на UTC, а первыя зоны часу паказваць як метаданы. Рашэнне па кантэксту (ідэнтыфікатор абліковання проты электроннай пашты проты ідэнтыфікатора прыстрою) апавяжана з архітэктурай дадзэнняў, а не з запітамі, якія толькі спадзяюцца. Крашчэ вікорыстоўваць дэтэрміністычныя способы пошуку галоўных дадзэнняў за дапамогою інструментаў MCP, чым неясныя методы RAG.

Больш дакладныя заўважэнні пра план керування фазы D

Стан LangGraph павінен мячыць ідэнтыфікатор расследавання, ідэнтыфікатор учасніка, дазволены набор засобаў і запіску з гіпатэзамі. Апісанні засобаў MCP павінны прызначыць клас пабочных эфектаў (чытанне проты напісання). Колекцыі RAG дзеляцца за ступенем чутлівасці. ARB павінен адхіляць дыяктуры, якія дазволяюць модэлю ствараць SQL-запыты да прыметных хранілішчаў; толькі адборныя засобы могу працаваць з гэтымі сістэмамі.

Метрыкі, якія маюць значэнне

• Серэдняе врэмя да першага цітаванага доказу
• Адсотак адказоў з прынеймна двума незалежнымі тыпамі джэрэл
• Штоць перакрыцэння з боку чалавека пад час выклікаў засобаў
• Штоць адхілення з-за недастатку доказоў
• Заблокаваныя спробы доступу ад іншых корыстаўцоў

Метрыкі-пустословы, такія як “выправленыя паведамленні”, не дазваляюць аднойчы пераканацца ў значэнні расследавання.

Анты-патэрыны

Стварэнне мега-індэксу ўсьго без полей ACL; дазвол лінгвістычным моцным мадэлям выбіраць первынных драйвераў базы дадзеных; праскакванне фазы H, таму запіты зміняюцца ўсё новыя кожны тыдзень без перагляду; выкорыстоўванне Grafana як неабавязковага колеру, а не як прыроднага каналу для фіксацыі проблем пад час працы.

Прыклад нарадзів

Аналітык спытаецца, чаму адбылася перакрыцце выплаты. Графік ачынае інструмент для аналізу звярзаных кейсаў (бэк-офіс), запошчае іды звярзаных транзакцый, шукае логі ў перыяд часу расчытку і толькі пасля гэтага стварае апূরненне з цітатамі. Калі логі відсутны, асістэнт не можа даты паведамлення і прасіць пра шырэйшы перыяд часу — замест таго, каб выдумаць нарадзів пра апрацоўшчык.

Карточкі архітэктуры безпекі

Размешчайце серверы MCP у тых сэнтыняцкіх зонах, якія належаць сістэмам, якія яны абараняюць. Оркестрайзер у DMZ павінен бачыць толькі канчыкі інструментаў, а не стрэлкі з’яносу да базы дадзеных. Короткавечныя токены для кожнага расследавання лепшыя, чым дзейнаўскія ключы службы, якія дзеляюцца между агентамі. Запісвайце вызывы інструментаў у незменным журнале аўдыту, які не залежыць ад трэсаў мадэляў, так каб спецыялісты з адпаведнасці моглі вырашыць, хто запрашаў канкрэтную інфармацыю, не завантажваючы всі запіты.

Связь з існуючым ITSM

Не заменяйце інструмент для обработкі кейса з самага пачатку. Запішвайце выходныя даны асістэнта як коментары да кейса з цітатамі. Аналітыкі застаюцца адпаведальнымі; граф разгарнуўце працэс. Пілотныя праекты фазы F, якія прагнуць автаматычна закрыць кейсы, зазвычай стаюць на месцы праз проблемы з доверам — коментары у рэжыме „цэнт” ствараюць гэта доверанне за дапамогою доказаў.

Навыкі проты простых інструментаў (неабавязковы слой)

Калектары інструментаў развіваюцца, і “навыкі” аналізу можаў бы пакаваць серыя крокаў (з’еўшчы даныя з кейса → запрашаючы транзакцыі → адпрашваючы логі → ствараючы падсумак), тады калі MCP застаецца шаром можлівасцей. Гэта адпавядае шырэйшай напрамоўці промыслу, не выклікаючы патрэбы ў новым стандарце, пакуль пілатны праект не парадуе свою цэннасць.

Короткі апূвядчык для ARB

Прасіце пра фінансаванне на адзначэнне скорасці часу апрацоўкі і павышэння можлівасцяў аўдыту, а не на “наяўнасць агента”. Пакажыце дэманстрацыю стварэння часовай лініі “до/пасля” з трыма джэрамі даных. Зобавяйцеся адмовляцца ад стаўак і тэстаў ACL як атрыбутаў выпуску. У такім падходзе LangGraph і MCP ёсць дэталямі рэалізацыі затверджанай архітэктуры — не науковым праектам па боку архітэктуры.

Контракты з дадзеннямі для трох праўд

Выпускайце маленькія схемы для CaseEvent, LogAnchor і LedgerPosting, якія вікорыстоўваюцься інструментамі MCP і індэксарамі. Часовыя шкалы розбору дэталей раздзеляюць гэтыя об’екты, а не прыводзяць іх у вастовы тэкст. Калі джэрэла не можуць запрацаваць пэўны поле, яго неабходна чыста пазначыць як null, каб сінтэзатор не могаў самастойна заполніць яго данымі. Контракты развіваюцца па той самы пат гэтавароўкі ARB, як і службы — а не толькі праз правкі запрошэнняў.

Документавайце прыпускі ўзгалдова прайму разам з кодам, каб будучыя правкі не моглі таямна адмаўліць які-небудзь рэгулярны элемент чы фільтра. Вядчыжайце тэзы, якія можна пераканаць за дапамогою машыны, працоўнае знанне, якое дзеляцца толькі ў чат-тэпах. Практыкуйце трэнінгі на развароты кожны раз, калі змянююцца правілы топологіі чы ідэнтычнасці.