Nervora: Ekzekutim i kontrolluar i tool-eve për agjentë Enterprise-AI

Konteksti

Nervora është arkitektura referencë flamurtare e Inovativit për ekzekutimin e sigurt të tool-eve të Enterprise-AI. Ajo demonstron se si agjentët AI mund të ndërveprojnë me sistemet e biznesit përmes një MCP-gateway-i të kontrolluar — në vend të një qasjeje API të drejtpërdrejtë e të pakontrolluar. Sistemi përfshin autentikim OIDC, Tool-Level-RBAC, redaktim PII, trajtim dry-run për veprime të ndjeshme shkruese, ekzekutim asinkron job-esh, idempotencë, audit-log të strukturuar dhe tracing OpenTelemetry.

Problemi

Shumica e piloteve Enterprise-AI dështojnë gjatë kalimit nga ndërfaqet e chat-it te sistemet reale të biznesit. E vështira nuk është gjenerimi i tekstit, por t'u japësh agjentëve një qasje të sigurt, të auditueshme dhe të kontrolluar nga policy te tool-et, të dhënat, workflow-et dhe sistemet legacy. Ndërmarrjet duhet të dinë kush thirri çfarë, cili rol e lejoi, cilat të dhëna u ekspozuan, nëse veprimi ishte lexues apo shkatërrues dhe nëse gabimet mund të riprovohen pa ekzekutim të dyfishtë aksidental.

Çfarë u ndërtua / modernizua

Nervora funksionon si një shtresë ekzekutimi e kontrolluar midis agjentëve AI dhe sistemeve enterprise. Në vend që t'u lejojë agjentëve qasje të drejtpërdrejtë te sistemet backend, të gjitha tool-call-et kalojnë përmes një MCP-gateway-i të vetëdijshëm ndaj policy-ve. Gateway-i e validon identitetin, kontrollon autorizimet Tool-Level, redakton të dhënat e ndjeshme, protokollon çdo vendim, drejton detyrat me kohëgjatësi të madhe përmes një rruge worker-i asinkron dhe bllokon veprimet shkatërruese, përveç nëse janë miratuar shprehimisht ose ekzekutohen në modalitet dry-run.

Rrjedha e sigurisë

• Autentikim i gatshëm për OIDC / Azure Entra ID për çdo thirrës
• Matricë RBAC Tool-Level e zbatuar te gateway-i
• Tool-e të ndjeshme HR të disponueshme vetëm për rolet HR / Admin
• Agjentët Sales të përjashtuar nga të dhënat HR
• Fushat PII të redaktuara para rezultatit të dukshëm për modelin
• Përditësimet shkatërruese CRM të çaktivizuara si parazgjedhje
• Ndryshimet CRM krijohen si propozime dry-run me miratim njerëzor
• Thirrjet e refuzuara protokollohen, nuk injorohen në heshtje

Kontrollet e tool-calling

• Tool-Registry me policy-metadata eksplicite — pa tool-e të fshehura
• Tool-policy-t klasifikojnë operacionet lexuese, shkruese, shkatërruese, sinkrone, asinkrone dhe të ndjeshme ndaj PII
• Idempotency-Keys për riprovime të sigurta të veprimeve të jashtme
• Ekzekutim ekskluzivisht asinkron për job-et me kohëgjatësi të madhe
• Propozime dry-run para se të ekzekutohet një veprim shkrues shkatërrues
• Dizajn me dead-letter-queue dhe retry për job-et e dështuara

Observability

• Regjistra audit-i të strukturuar për çdo tool-call
• Trace-ID të përbashkëta përgjatë gateway-it, worker-it dhe regjistrave të audit-it
• Span-e OpenTelemetry për auth, RBAC, redaktim, queueing, ekzekutim worker-i dhe audit-writes
• Gjendje gabimi të qarta për veprimet e refuzuara, dry-run, të vendosura në radhë, të ekzekutuara dhe të dështuara

Integrim me Databricks & workflow-e të dhënash

• Abstraksion konektori për workflow Databricks / SQL-warehouse
• Rrugë ekzekutimi asinkrone përmes një abstraksioni Azure Service Bus
• Shërbim worker-i për workflow-e me kohëgjatësi të madhe
• Gjurmim i statusit të job-it në vend të bllokimit sinkron
• Riparaqitja idempotente kthen Job-ID-në fillestare

Pikat kryesore të workflow-it

• MCP-gateway i bazuar në FastAPI me ndërfaqe tool-i të tipizuar
• Tool-Registry me policy-metadata eksplicite
• Shtresë autentikimi e gatshme për OIDC / Azure Entra ID
• Matricë RBAC Tool-Level
• Audit-trail PostgreSQL
• Kufi redaktimi PII
• Rrugë ekzekutimi asinkrone përmes një abstraksioni Azure Service Bus
• Abstraksion konektori për workflow Databricks / SQL-warehouse
• Idempotency-Keys, dead-letter-queue dhe dizajn retry
• Tracing OpenTelemetry përgjatë gjithë rrugës së thirrjes

Siguri, auditueshmëri & governance

• Agjentët nuk mund të anashkalojnë autorizimet e tool-eve
• Tool-et e ndjeshme HR janë të disponueshme vetëm për rolet HR / Admin
• Fushat PII redaktohen para rezultatit të dukshëm për modelin
• Ekzekutimi shkatërrues CRM është i çaktivizuar si parazgjedhje dhe i siguruar pas miratimit dry-run
• Thirrjet e refuzuara protokollohen, nuk injorohen në heshtje
• Tool-policy-t klasifikojnë operacionet lexuese, shkruese, shkatërruese, sinkrone, asinkrone dhe të ndjeshme ndaj PII

Vlera për biznesin

• Demonstron kontrollet e qeverisjes dhe audit-it që nevojiten para se agjentët të prekin sisteme të ndjeshme
• Tregon veprimet shkatërruese pas miratimit dry-run në vend të ekzekutimit të drejtpërdrejtë
• Dëshmon ekzekutim asinkron, idempotent, ashtu që riprovimet nuk i dyfishojnë kurrë veprimet e biznesit
• Ofron një model konkret, të verifikueshëm, për ta sjellë IA-në enterprise nga piloti te ekzekutimi i kontrolluar

Teknologjitë

Rolet relevante