BejelentkezésBemutató kérése

2.14. fejezet

AI-szolgáltatók és modellek

Hogyan választ ki egy modellt a mesterséges intelligencia (AI) Provider Router a szervezet saját kulcskészletéből, és hogyan érik el a szkriptek és AI-eszközök a Nexust kívülről.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

16 perc olvasási idő

A Harrow Port Authority két telepítést üzemeltet. A fizikailag leválasztott (air-gapped) üzemeltetési hálózatán lévő telepítésnek (2.10. fejezet, Fizikailag leválasztott telepítés) egyáltalán nincs hosztolt szolgáltatója. A hálózatra kapcsolt vállalati telepítésen, amelyet ez a fejezet követ nyomon, a legtöbb kérdésre a kikötő saját szervertermében lévő két grafikus feldolgozóegység (GPU) csomóponton futó modell válaszol. Egy, a Harrow által fizetett Google Gemini-kulcs veszi át a túlcsorduló forgalmat, amikor a helyi modell leterhelt, Aoife Brennan pedig az EU-ra korlátozta a szervezet mesterséges intelligencia (AI) forgalmát. A Harrow-nál senki sem konfigurált modellt szolgáltatáson vagy bővítményen belül. Egyetlen komponensnek adták meg, hogy mi van a Harrow birtokában, és ez a komponens dönt minden egyes hívásról.

Ez a fejezet ezt a komponenst, az AI Provider Routert tárgyalja – amelyet az 1. rész és a konzol AI-kapcsolóközpontnak nevez –, valamint a kulcskészletet, amelyből merít. Végül bemutatja, hogyan érik el a szkriptek és az AI-eszközök a Nexust kívülről: a szkriptekhez való kulcsokat, a REST (representational state transfer) alkalmazásprogramozási felületet (API) és a Model Context Protocolt (MCP).

Az AI Provider Router

Az útválasztó az átjárón, a nexus-gateway-en belül fut. Ez az egyetlen szolgáltatás, amely tárolja egy szervezet modell-hitelesítő adatait, és ez hozza meg a végső döntést arról, hogy melyik szolgáltató és melyik modell válaszol az egyes kérésekre. A Nexus minden más része tőle kérdez. Egy munkafolyamat-lépés megadja, mit szeretne, az útválasztó pedig dönt.

Csak néhány szolgáltatás kérdezhet, és mindegyik listát a chart rögzíti:

Mit kérnek Ki kérhet
Szövegkiegészítés (/internal/ai/chat és annak adatfolyama) nexus-orchestrator, nexus-workflows, nexus-skills-engine
Eszközhívások és az egyéb belső AI-útvonalak nexus-orchestrator, nexus-workflows
Beágyazások és újrarendezés nexus-graphrag, nexus-skills-engine, nexus-workflows

Minden belső útvonal két dolgot ellenőriz egymás után: a hívó belső szolgáltatáskulcsát, valamint a hívó azonosságát a fenti lista alapján. A kulcs nélküli kérést a rendszer MISSING_SERVICE_KEY (401) hibával utasítja el, a hibás kulcsot INVALID_SERVICE_KEY (403) hibával, azt a kérést, amely nem adja meg, ki a hívó, MISSING_CALLER_IDENTITY (403) hibával, a listán kívüli hívót pedig UNAUTHORIZED_CALLER (403) hibával. Ezek egyikét sem próbálja újra, mivel egyik sem átmeneti hiba.

Az alkalmazások és a bővítmények soha nem szerepelnek ezen a listán. A bővítmény az általa regisztrált képességeken (skill) deklarálja az igényeit, és az UNO-n, a munkafolyamat-motoron keresztül küldi el azokat. Ezután az orkesztrátor kérdezi meg az útválasztót a bővítmény nevében. Ezért van az, hogy egy kiszivárgott bővítménytitok eljárhat ugyan az adott bővítményként, de nem költheti el senki modellkeretét.

Bal oldalon: három egymás alatti doboz, „Asszisztens”, „Munkafolyamat-lépés”, „Képesség”, mindegyikből egy-egy nyíl mutat az „UNO diszpécser (nexus-orchestrator)” dobozba. Egy „kívánságok: előnyben részesített szolgáltató, előnyben részesített modell, képességprofil” feliratú nyíl jobbra, egy nagy „AI Provider Router (nexus-gateway)” dobozba mutat. Az útválasztó dobozán belül három kis doboz egymás mellett: „Szerepkör”, „Szervezeti készlet”, „Útválasztási házirend”. Az útválasztóból három nyíl mutat jobbra: „Helyi modell (ai.localProvider.baseUrl)”, „A hosztolt szolgáltatói kulcs”, „B hosztolt szolgáltatói kulcs”. Az útválasztó alatt egy külön doboz: „nexus-auth: a szervezet kulcskészlete (titkosítva)”, amelyből egy szaggatott, „kulcsok, hívásonként feloldva” feliratú nyíl mutat felfelé az útválasztóba.
Hogyan jut el egy kérés a modellhez.

A szervezet kulcskészlete

A modellkulcsok a szervezethez tartoznak. Minden szervezet a saját szolgáltatói fiókját hozza és a saját számláját fizeti, a kulcs pedig a szervezet kulcskészletében található, titkosítva a nexus-auth-ban. Nincs közös platformkulcs a szervezetek mögött, így egyetlen szervezet sem költi el soha egy másik keretét. Ennek a szabálynak az ára egyértelmű: az a szervezet, amelynek nincs kulcs a készletében, nem kap AI-válaszokat. Az asszisztens MODEL_NOT_CONNECTED (503) üzenetet jelenít meg, és megmondja, ki csatlakoztathat egyet.

A készlethez négy szolgáltató esetében adható hozzá kulcs:

Szolgáltatóazonosító Megjelenített név
anthropic_api_key Anthropic
gemini Google Gemini
openrouter OpenRouter
scaleway Scaleway

Saját modellszerver

Egy szervezet bármilyen általa üzemeltetett szervert is használhat, amely az OpenAI-kompatibilis API-t beszéli, mint például a Harrow GPU-csomópontjain futó modell. A telepítő a values fájlban nevezi meg:

# harrow-values.yaml (Helm values): the AI part
ai:
  localProvider:
    baseUrl: "https://models.harrow.example/v1"
  installationHosts:
    - models.harrow.example
    - 10.40.20.0/24
networkPolicy:
  externalEgressCIDRs:
    - 10.40.20.0/24

Az ai.localProvider.baseUrl az átjáró OpenAI-kompatibilis adapterét az Ön szerverére irányítja. Egy telepítésen a készlet scaleway helye éri el ezt a szervert, így az scaleway számára hozzáadott kulcs az a kulcs, amelyet a saját szervere vár.

Az ai.installationHosts felsorolja azokat a hosztneveket, amelyek a telepítésen belül találhatók, a kiadás saját szolgáltatási tartományán és a három nyilvános hoszton kívül. Minden bejegyzés egy hosztnév, egy .suffix, egy IP-cím vagy egy IPv4 Classless Inter-Domain Routing (CIDR) tartomány. Az útválasztó a lista segítségével különbözteti meg a telephelyen belül maradó hívást attól, amelyik elhagyja azt; erről számol be a Modell csatlakoztatása saját hardveren oldalon található „Semmi sem hagyja el ezt a telephelyet” ellenőrzés.

A hálózati házirend ugyanolyan fontos, mint az útválasztó. A névtér alapértelmezés szerint minden kimenő forgalmat tilt, így az átjáró csak akkor érhet el egy névtéren kívüli modellszervert, ha annak tartománya szerepel az networkPolicy.externalEgressCIDRs listában. Ugyanez vonatkozik a hosztolt szolgáltatókra is: ha a Harrow azt szeretné, hogy a Gemini-kulcsa válaszoljon, a szolgáltató címtartományait is fel kell ott sorolni, különben a hívás soha nem hagyja el a fürtöt. A 2.16. fejezet, Biztonság és hálózatkezelés, részletesen ismerteti a házirendet.

Modell csatlakoztatása saját hardveren
Modell csatlakoztatása saját hardveren
Modell csatlakoztatása saját hardveren. Az oldal felsorolja a szerver által jelentett modelleket, az egyes modellek által betöltött szerepkört, és megerősíti, hogy semmi sem hagyja el a telephelyet.

Kulcsok hozzáadása és visszavonása

A szervezet tulajdonosai és adminisztrátorai kezelik a kulcskészletet. Más nem láthatja és nem módosíthatja a kulcsokat, a tőlük érkező kéréseket pedig a rendszer AUTHORITY_EXCEEDED hibával utasítja el.

A konzolon

Enterprise kiadáson a készlet az AI-kapcsolóközpontban, a motorok alatt található. Community kiadáson ugyanezeket a kulcsokat a Beállítások, AI-modellek oldalon tárolja a rendszer. Ez az oldal az alapvető útválasztó, ahol kulcsokat és helyi modellcímet adhat hozzá, valamint kiválaszthatja, hogy melyik modell melyik feladatot lássa el. Mindkettő megjeleníti az egyes kulcsoknál, hogy ki és mikor állította be őket („Beállította: Aoife, szept. 3.”), valamint legfeljebb az utolsó négy karakterük maszkolt emlékeztetőjét, például ••••7f2q. Maga a kulcs a hozzáadása után soha többé nem jelenik meg.

Az AI-kapcsolóközpont
Az AI-kapcsolóközpont
Az AI-kapcsolóközpont felsorolja az egyes szolgáltatókat azzal együtt, hogy ki állította be a kulcsukat, és milyen feladatokat látnak el. Az egyik kulcs hibák után pihen, egy másikat kikapcsoltak, az oldal pedig jelzi, hová kerülhetnek az adatok.
AI-modellek
AI-modellek
Az alapvető útválasztó Community kiadáson: egy szervezeti kulcs, egy helyi modell a szervezet saját gépén, valamint az, hogy melyik modell melyik feladatot látja el.

A BFF API-n keresztül

A konzol előtér-kiszolgáló háttérrendszere (backend for frontend, BFF) három útvonalat szolgál ki a készlethez. Hívja meg őket egy személy saját hozzáférési tokenjével: a szervezet a tokenből származik, soha nem a kérésből.

GET  /api/v1/ai-providers
POST /api/v1/ai-providers/keys
POST /api/v1/ai-providers/keys/<key-id>/withdraw

A GET visszaadja a készletben lévő szolgáltatókat, azt, hogy melyik tud válaszolni, minden kulcsot az emlékeztetője alapján, valamint azokat a szolgáltatókat, amelyekhez kulcs adható hozzá. Kulcs hozzáadásához egy JSON-törzsre van szükség, két kötelező és egy opcionális mezővel:

{ "provider": "gemini", "api_key": "<the provider's key>", "label": "Overflow, EU" }

A kulcs egyszer utazik. A nexus-auth titkosítja, és értesíti az útválasztót, a válasz pedig már csak az emlékeztetőt tartalmazza. A válasz 201, az új kulcs azonosítójával és sorával: „Hozzáadva. A ••••7f2q Google Gemini-kulcs bekerült a szervezet AI-készletébe, és az AI Provider Router mostantól irányíthat rá forgalmat.” A címke legfeljebb 100 karakter lehet, a kulcs pedig egyetlen, szóközök nélküli, legfeljebb 4096 karakteres karakterlánc. A törzsben szereplő bármely más mezőt, illetve a szervezetet vagy személyt megnevező mezőket a rendszer elutasítja.

A visszavonás üres törzset vár. Az útválasztó azonnal leállítja a forgalom irányítását a kulcsra, a nexus-auth pedig megőrzi azt visszavontként feltüntetve, így az előzményei megmaradnak. A készletből soha semmi nem törlődik.

Elutasítás HTTP Mikor
VALIDATION_FAILED 400 Nem {provider, api_key, label?} formátumú törzs, ismeretlen szolgáltató, vagy egy személy saját előfizetése szervezeti kulcsként felkínálva
AUTHORITY_EXCEEDED 403 A hívó nem tulajdonosa vagy adminisztrátora a szervezetnek
RECORD_NOT_FOUND 404 Nincs ilyen azonosítójú kulcs a szervezet készletében
TRANSITION_NOT_PERMITTED 409 A kulcsot már visszavonták
TENANT_NOT_A_PARAMETER 403 A törzs vagy a lekérdezés megnevezett egy szervezetet

Kulcsállapotok

A készletben lévő minden kulcs hat állapot egyikében van. Csak a használatban lévő kulcs válaszol a csevegésekre.

Állapot Mit jelent
in_use A kulcs válaszol, a lejárati dátumáig, ha van neki.
resting Az útválasztó hibák után pihenteti egy meghatározott ideig. A kérések addig a következő kulcshoz mennek.
exhausted Kimerítette a keretét a szolgáltatónál.
invalid A szolgáltató már nem fogadja el.
expired A lejárati dátumán lejárt.
withdrawn Egy adminisztrátor visszavonta. Előzményként továbbra is szerepel a listán.

A hibázó kulcs 60 másodpercig pihen. Egymás után 5 hiba esetén az útválasztó kikapcsolja, a részesedését átadja a többi kulcsnak, és rögzíti a PROVIDER_KEY_SWITCHED_OFF értesítést. Senkit sem utasít el a rendszer, amíg egy másik kulcs tud válaszolni.

Amikor egy szolgáltatónak nincs használatban lévő kulcsa, a készlet megmondja az okát („Nincs használatban lévő kulcs: 1 visszavonva, 1 lejárt”). Amikor a készletben egyetlen szolgáltatónak sincs használatban lévő kulcsa, a csevegést a rendszer NO_PROVIDER_FOR_ROLE (422) hibával utasítja el, megadva a megoldást: egy tulajdonos vagy adminisztrátor adjon hozzá egy szervezeti kulcsot. Ez egy konfigurációs állapot, és addig marad a képernyőn, amíg valaki ki nem javítja.

Szerepkörök, irányelvek és preferenciák

Az útválasztó szerepkörökben gondolkodik. Minden kérés öt szerepkör egyikére irányul: default, fast, reasoning, code vagy long_context. Minden modell egy szintbe is tartozik – frontier, standard vagy fast –, és a magasabb szint élvez elsőbbséget, ha a szerepkör ezt megengedi. A szervezet dönti el, hogy melyik szolgáltató szolgálja ki az egyes szerepköröket (szerepkör-hozzárendelések), és milyen sorrendben történjen a tartalékra váltás, ha egy szolgáltató hibázik (útválasztási házirend-létra). Az adminisztrátorok mindkettőt az AI-kapcsolóközpontban állítják be. A nexus-auth a /auth/org/<organisation-id>/settings/ai-provider/role-assignments és /auth/org/<organisation-id>/settings/ai-provider/routing-policy végpontokon is kiszolgálja őket egy ai_provider:manage jogosultsággal rendelkező adminisztrátori kulcs számára.

A hívók megadhatják, mit szeretnének. Egy képességsor tartalmazhat előnyben részesített szolgáltatót és előnyben részesített modellt, valamint egy képességprofilt. Az útválasztó mindegyiket másként kezeli:

  • Az előnyben részesített szolgáltatót csak akkor veszi figyelembe, ha a szervezetnél engedélyezve van az adott szolgáltató, és van hozzá kulcs. Ellenkező esetben az útválasztó helyettesít.
  • Az előnyben részesített modellt akkor veszi figyelembe, ha az szerepel az adott szolgáltató katalógusában, és megfelel a profilnak.
  • A képességprofil egy szűrő, amely soha nem választ ki. Kérhet minimális kontextusablakot, eszközhasználatot, képfelismerést (vision), beágyazásokat, hosszú kontextust vagy adatrezidenciát. Bármi, ami ezen nem megy át, nem jogosult.

Az útválasztó rögzített sorrendben választ. Ha tudja, teljesíti a kívánságot, majd megpróbál egy másik modellt ugyanattól a szolgáltatótól, ezután a szerepkör-hozzárendelést, végül bármely más olyan, kulccsal rendelkező szolgáltatót, amelynek a katalógusa megfelel. Ha megadtak profilt, és egyetlen katalógus sem felel meg neki, a kérést MODEL_CAPABILITY_UNAVAILABLE (422) hibával utasítja el. Ha semmi sincs hozzárendelve és semmi sem felel meg, a hiba NO_PROVIDER_FOR_ROLE (422). Nincs végső, alapértelmezett modell. Az a szerepkör, amelyet nem konfigurált, hangos hibával áll le, és az útválasztó a saját szavaival mondja meg, mit kell beállítani.

Az adatrezidencia az egyetlen olyan megszorítás, amelyet nem lehet helyettesítéssel megkerülni. A eu_only beállítással rendelkező profilt vagy egy EU-s szolgáltató szolgálja ki, vagy a rendszer elutasítja. A Harrow az egész szervezetre beállítja ezt a zárolást, a kapcsolóközpont pedig kikapcsoltként ábrázolja a második hosztolt szolgáltatót, amely egy egyesült államokbeli régióban található.

Egy képesség rögzíthet egyetlen pontos modellt is, ha a képességnek a működéshez arra a modellre van szüksége. Az útválasztó még ilyenkor is a szervezet saját kulcsát használja hozzá, és ha nincs ilyen, semmi sem válaszol. Egy hívó soha nem veheti rá a Nexust olyan szolgáltató használatára, amelyet a szervezet nem konfigurált.

Miután a szolgáltatót kiválasztotta, az átállás (failover) már külön kérdés. Egy 429-es, egy 5xx-es vagy egy hálózati hiba lejjebb lépteti a kérést a létrán a következő szolgáltatóhoz. A 400-as, 401-es, 403-as vagy 404-es hiba azonnal megállítja a folyamatot, mivel a hitelesítő adatok és a kérésformátumok nem vihetők át a szolgáltatók között, és az újrapróbálkozás csak a kvótát égetné el, hogy ugyanabba a hibába fusson.

Ha látni szeretné, mit választana az útválasztó, mielőtt bárki kérdést tenne fel, olvassa ki a GET /api/ai/routing-policy/effective végpontot az átjárón egy személy saját tokenjével. Ez visszaadja a bejelentkezett szervezethez tartozó modellt, vagy – ha nincs ilyen – szövegesen az útválasztó elutasítását, és nem küld kérést semmilyen modellnek.

A router megfigyelése

Az egyes oldalak alján található adatsáv mutatja a használatban lévő modellt („Modell: helyi”). Enterprise kiadáson az AI-kapcsolóközpont, élő nézet valós időben rajzolja ki az útválasztó forgalmát: az asszisztenstől, a feladatoktól és az alkalmazásoktól érkező kéréseket, ahogy a szerepkörökön keresztül a szolgáltatókhoz és kulcsokhoz áramlanak; a 60 másodperces pihenőidejét töltő kulcsot szürkével, a kikapcsolt kulcsot pirossal, a helyi modell leterheltsége miatti hosztolt szolgáltatóra történő átállást pedig külön jelölve. Az áramlás mellett grafikonon mutatja a szolgáltatónkénti terhelést, a másodpercenkénti kéréseket és a várakozási időt. Tomás az útválasztási házirend bármely módosítása után az első héten nyitva tartja ezt a nézetet, mert egy hibás szerepkör-hozzárendelés perceken belül megjelenik ott olyan forgalomként, amelyet senki sem oda szánt.

Community kiadáson az AI-modellek oldalon található egy Minden modell tesztelése gomb, amely ellenőrzi az összes konfigurált modellt, és megjelöli, hogy válaszol-e. Ez a leggyorsabb módja annak, hogy bebizonyítsa, egy új kulcs működik, mielőtt bárki hagyatkozna rá.

Az AI-kapcsolóközpont, élőben
Az AI-kapcsolóközpont, élőben
Az útválasztó élőben. A forgalom az asszisztenstől és a feladatoktól a szerepkörökön keresztül egy helyi modellhez és a hosztolt kulcsokhoz áramlik; az egyik kulcs pihen, a másik ki van kapcsolva, az arany pontok pedig a tartalékra váltást mutatják, amíg a helyi modell leterhelt.

Beágyazások (embeddings)

A keresés és a tudásgráf vektorokká alakítja a szöveget. Alapértelmezés szerint a telepítés ezt egy olyan beágyazási modellel végzi, amely a fürtön belül, a processzoron fut, így semmilyen szöveg nem hagyja el a telephelyet a beágyazáshoz, és a szervezetnek nincs szüksége kulcsra ehhez. Hosztolt szolgáltató használata a beágyazásokhoz a szervezet saját döntése; ebben az esetben a folyamat ugyanazon a készleten és ugyanazokon a szabályokon megy keresztül.

Csak három szolgáltatás kérhet az útválasztótól beágyazást vagy újrarendezést: a nexus-graphrag, a nexus-skills-engine és a nexus-workflows. A GraphRAG annak a szervezetnek a nevében és beállításaival végzi a beágyazást, amelyhez a tartalom tartozik, és nem rendelkezik saját szolgáltatói kulccsal. Amikor egy szervezet megváltoztatja a beágyazási modelljét, a nexus-workflows futtatja le az újrabeágyazási feladatot az adott szervezet tárolóira.

A személyes hitelesítő adatok személyesek maradnak

Egyes hitelesítő adatok egyetlen személyhez tartoznak. A gyakori eset egy Claude Max-előfizetés, amelybe az adott személy a saját fiókján keresztül jelentkezett be. Az ilyen hitelesítő adat soha nem szervezeti kulcs: a készlet VALIDATION_FAILED hibával elutasítja, soha nem szerepel a szervezet kulcstáblázatában, és egyetlen másik személy képernyőjén sem jelenik meg.

A modellkulcsok máshová sem kerülhetnek soha. A Külső adatkulcsok oldal, amely a külső adatforrások kulcsait tárolja, AI_PROVIDER_KEYS_BELONG_TO_ORG_POOL (422) hibával elutasít mindent, ami AI-modellkulcsnak tűnik. Ha a fájlolvasó dokumentumban vagy konfigurációban olyan helyen talál modellkulcsokat, ahová azok nem valók, rögzíti a CREDENTIALS_IN_WRONG_PLACE eseményt, egy adminisztrátor pedig eltávolítja és lecseréli őket.

Szkriptek, REST és MCP

A Nexusnak három nyilvános hosztja van. A Harrow-nál ezek a console.harrow.example a konzolhoz, a api.harrow.example az átjáróhoz és a auth.harrow.example a bejelentkezéshez. A szkriptek és eszközök a másodikat és a harmadikat használják.

Kulcsok szkriptekhez

Egy szkript a Beállítások, Kulcsok szkriptekhez oldalon létrehozott kulccsal jelentkezik be. Minden kulcsnak van neve, hatóköre (például „Csak a drónos udvari számlálás indítása”), létrehozója és lejárati dátuma; a szervezet zárolhatja a kulcsok maximális élettartamát. A titok egyszer jelenik meg, a kulcs létrehozásakor. Másolja be a szkript titoktárolójába, mert a Nexus csak az utolsó négy karakterét őrzi meg. A kulcsokat visszavonják, soha nem törlik: a kulcs azonnal leáll, és minden általa indított hívással együtt a listán marad. A forgatás (rotáció) új titkot ad a kulcsnak, és egyszer megjeleníti azt.

Minden kulcsnak saját oldala van a napi hívásokkal, a szolgáltatásonkénti hívásokkal, valamint az időpontot, címet, szolgáltatást és eredményt tartalmazó tevékenységnaplóval. A kulcs hatókörén kívüli hívásokat a rendszer elutasítja, és megjeleníti a naplóban.

A nexus-auth ugyanezeket a kulcsokat szolgálja ki egy bejelentkezett személynek a https://auth.harrow.example/api-keys végponton: létrehozás és listázás, majd egy adott kulcs olvasása, módosítása, visszavonása vagy forgatása az azonosítója alapján.

Egy kulcs szkriptekhez
Egy kulcs szkriptekhez
Egy kulcs szkriptekhez. Az oldal mutatja a kulcs hatókörét, létrehozóját, lejárati dátumát, a napi és szolgáltatásonkénti hívásokat, valamint minden hívás eredményét; a titok vége …7QK2, és soha többé nem jelenik meg.

REST az átjárón keresztül

Küldje a REST-hívásokat a https://api.harrow.example címre Authorization: Bearer <token-or-key> fejléccel. Minden kulcsnak egy szervezethez kell tartoznia. A szervezet nélküli kulcsot TOKEN_ORG_MISSING (403) hibával utasítja el minden olyan szolgáltatás, amely a nexus-auth-on keresztül ellenőrzi a kulcsokat.

Ha egy hívó túl gyakran kérdez, a válasz 429 és RATE_LIMITED, egy Retry-After fejléc, a törzsben pedig a korlát és az időablak. Várjon annyi másodpercet, amennyit a válasz megad. Enterprise kiadáson az adminisztrátorok kulcsonként, alkalmazásonként és egységenként állíthatnak be korlátokat a Beállítások, Forgalmi korlátok oldalon (lásd a 2.16. fejezetet, Biztonság és hálózatkezelés).

MCP AI-eszközökhöz

A Model Context Protocolt beszélő AI-eszközök a https://api.harrow.example/mcp címhez csatlakoznak. Az OAuth 2.1 szerveren keresztül jelentkeznek be (az OAuth a delegált engedélyezés nyílt szabványa) a https://auth.harrow.example címen, amely támogatja a kliens regisztrációját magán az eszközön keresztül, így egy olyan eszköz, mint a Claude Code vagy a Cursor, regisztrálja magát, és megnyitja a személy böngészőjét a bejelentkezéshez. A kapcsolat ezután az adott személy nevében jár el, annak jogosultságaival, és semmi többel. A bejelentkezett személy a https://auth.harrow.example/api/v1/mcp/cli-config címről tölthet le kész konfigurációt egy parancssori eszközhöz.

A modellt igénylő eszközhívások minden máshoz hasonlóan az útválasztón mennek keresztül, a személy szervezete alatt.