IdħolIbbukkja laqgħa informattiva

Kapitlu 2.14

Fornituri u mudelli tal-IA

Kif ir-Router tal-Fornituri tal-intelliġenza artifiċjali (IA) jagħżel mudell mill-ġabra ta' ċwievet tal-organizzazzjoni stess, u kif l-iskripts u l-għodod tal-IA jilħqu lil Nexus minn barra.

Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

16 minuti qari

Harrow Port Authority tħaddem żewġ installazzjonijiet. Dik li tinsab fuq in-netwerk tal-operazzjonijiet tagħha iżolat bl-air-gap (kapitlu 2.10, Installazzjoni iżolata bl-air-gap) m'għandha l-ebda fornitur ospitat. Fuq l-installazzjoni korporattiva konnessa, li dan il-kapitlu jsegwi, il-biċċa l-kbira tal-mistoqsijiet jitwieġbu minn mudell li jaħdem fuq żewġ nodi ta' unità tal-ipproċessar tal-grafika (GPU) fil-kamra tas-servers tal-port stess. Ċavetta ta' Google Gemini, imħallsa minn Harrow, tieħu t-traffiku żejjed meta l-mudell lokali jkun okkupat, u Aoife Brennan issakkret it-traffiku tal-intelliġenza artifiċjali (IA) tal-organizzazzjoni fl-UE. Ħadd f'Harrow ma kkonfigura mudell ġo servizz jew plugin. Qalu lil komponent wieħed x'għandha Harrow, u dak il-komponent jiddeċiedi kull sejħa.

Dan il-kapitlu jkopri dak il-komponent, ir-Router tal-Fornituri tal-IA (AI Provider Router), li Parti 1 u l-console jsejħulu l-iswitchboard tal-IA, u l-ġabra ta' ċwievet li juża. Jagħlaq bil-modi kif l-iskripts u l-għodod tal-IA jilħqu lil Nexus minn barra: ċwievet għall-iskripts, l-interfaċċja tal-ipprogrammar tal-applikazzjonijiet (API) tat-trasferiment tal-istat rappreżentattiv (REST) u l-Protokoll tal-Kuntest tal-Mudell (MCP).

Ir-Router tal-Fornituri tal-IA

Ir-router jaħdem ġol-gateway, nexus-gateway. Huwa l-uniku servizz li jżomm il-kredenzjali tal-mudelli ta' organizzazzjoni, u jieħu d-deċiżjoni finali dwar liema fornitur u liema mudell iwieġbu kull talba. Kull parti oħra ta' Nexus tistaqsi lilu. Pass tal-fluss tax-xogħol jgħid x'jixtieq, u r-router jiddeċiedi.

Ftit servizzi biss jistgħu jistaqsu, u kull lista hija stabbilita miċ-chart:

X'inhu mitlub Min jista' jistaqsi
Tlestija (/internal/ai/chat u l-istream tagħha) nexus-orchestrator, nexus-workflows, nexus-skills-engine
Sejħiet ta' għodod u r-rotot interni l-oħra tal-IA nexus-orchestrator, nexus-workflows
Embeddings u reranking nexus-graphrag, nexus-skills-engine, nexus-workflows

Kull rotta interna tiċċekkja żewġ affarijiet waħda wara l-oħra: iċ-ċavetta tas-servizz intern ta' min qed isejjaħ, u l-identità ta' min qed isejjaħ mal-lista ta' hawn fuq. Talba mingħajr iċ-ċavetta tiġi rrifjutata b'MISSING_SERVICE_KEY (401), ċavetta ħażina b'INVALID_SERVICE_KEY (403), talba li ma tgħidx min qed isejjaħ b'MISSING_CALLER_IDENTITY (403), u min isejjaħ barra mil-lista b'UNAUTHORIZED_CALLER (403). L-ebda waħda minn dawn ma terġa' tiġi ppruvata, għaliex l-ebda waħda minnhom mhi ħsara temporanja.

L-apps u l-plugins qatt ma jidhru fuq dik il-lista. Plugin jiddikjara x-xewqat tiegħu fuq il-ħiliet li jirreġistra u jibgħat permezz ta' UNO, il-magna tal-fluss tax-xogħol. L-orkestratur imbagħad jistaqsi lir-router f'isem il-plugin. Huwa għalhekk li sigriet wieħed ta' plugin li jinkixef jista' jaġixxi bħala dak il-plugin iżda ma jistax jonfoq il-baġit tal-mudelli ta' ħadd.

Xellug: tliet kaxxi fuq xulxin, "Assistent", "Pass tal-fluss tax-xogħol", "Ħila", kull waħda bi vleġġa ġo kaxxa " UNO dispatch (nexus-orchestrator)". Vleġġa bit-tikketta "xewqat: fornitur preferut, mudell preferut, profil ta' kapaċità" tmur lejn il-lemin ġo kaxxa kbira "Router tal-Fornituri tal-IA (nexus-gateway)". Ġol-kaxxa tar-router, tliet kaxxi żgħar f'ringiela: "Rwol", "Ġabra tal-organizzazzjoni", "Politika tar-routing". Mir-router, tliet vleġeġ imorru lejn il-lemin għal "Mudell lokali (ai.localProvider.baseUrl)", "Ċavetta A tal-fornitur ospitat", "Ċavetta B tal-fornitur ospitat". Taħt ir-router kaxxa separata "nexus-auth: il-ġabra taċ-ċwievet tal-organizzazzjoni (kriptata)" bi vleġġa b'linji maqtugħa 'l fuq ġor-router bit-tikketta "ċwievet, solvuti għal kull sejħa".
Kif talba tilħaq mudell.

Il-ġabra ta' ċwievet tal-organizzazzjoni

Iċ-ċwievet tal-mudelli jappartjenu lill-organizzazzjoni. Kull organizzazzjoni ġġib il-kont tal-fornitur tagħha stess u tħallas il-kont tagħha stess, u ċ-ċavetta tinżamm fil-ġabra tal-organizzazzjoni, kriptata f'nexus-auth. M'hemm l-ebda ċavetta tal-pjattaforma kondiviża wara organizzazzjoni, għalhekk l-ebda organizzazzjoni qatt ma tonfoq il-baġit ta' oħra. L-ispiża ta' dik ir-regola hija ċara: organizzazzjoni mingħajr ċavetta fil-ġabra tagħha ma tieħu l-ebda tweġiba tal-IA. L-assistent juri MODEL_NOT_CONNECTED (503) u jgħid min jista' jikkonnettja waħda.

Ċavetta tista' tiżdied mal-ġabra għal erba' fornituri:

Id tal-fornitur Muri bħala
anthropic_api_key Anthropic
gemini Google Gemini
openrouter OpenRouter
scaleway Scaleway

Server tal-mudelli tiegħek stess

Organizzazzjoni tista' wkoll tuża kwalunkwe server li tħaddem li jitkellem l-API kompatibbli ma' OpenAI, bħall-mudell fuq in-nodi tal-GPU ta' Harrow. L-installatur isemmih fil-fajl tal-valuri:

# 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

ai.localProvider.baseUrl jipponta l-adapter kompatibbli ma' OpenAI tal-gateway lejn is-server tiegħek. Fuq installazzjoni, l-islott scaleway tal-ġabra jilħaq dak is-server, għalhekk iċ-ċavetta li żżid għal scaleway hija ċ-ċavetta li jistenna s-server tiegħek stess.

ai.installationHosts jelenka ismijiet ta' hosts li jinsabu ġol-installazzjoni, minbarra d-dominju tas-servizz tar-rilaxx stess u t-tliet hosts pubbliċi. Kull entrata hija isem ta' host, .suffix, indirizz tal-IP jew medda ta' Classless Inter-Domain Routing (CIDR) tal-IPv4. Ir-router juża l-lista biex jagħraf sejħa li tibqa' fuq is-sit minn waħda li toħroġ minnu, li huwa dak li jirrapporta l-kontroll "Xejn ma joħroġ minn dan is-sit" fuq il-paġna Ikkonnettja mudell fuq il-ħardwer tiegħek stess.

Il-politika tan-netwerk hija importanti daqs ir-router. In-namespace jiċħad il-ħruġ kollu b'mod awtomatiku, għalhekk il-gateway jista' jilħaq server tal-mudelli barra min-namespace biss meta l-medda tiegħu tkun f'networkPolicy.externalEgressCIDRs. L-istess jgħodd għal fornitur ospitat: jekk Harrow trid li ċ-ċavetta Gemini tagħha twieġeb, il-meded tal-indirizzi tal-fornitur iridu jkunu elenkati hemmhekk ukoll, inkella s-sejħa qatt ma toħroġ mill-cluster. Kapitlu 2.16, Sigurtà u netwerking, ikopri l-politika kollha kemm hi.

Ikkonnettja mudell fuq il-ħardwer tiegħek stess
Ikkonnettja mudell fuq il-ħardwer tiegħek stess
Il-konnessjoni ta' mudell fuq il-ħardwer tiegħek stess. Il-paġna telenka l-mudelli li jirrapporta s-server, ir-rwol li għandu kull wieħed, u tikkonferma li xejn ma joħroġ mis-sit.

Żieda u irtirar ta' ċwievet

Is-sidien u l-amministraturi ta' organizzazzjoni jieħdu ħsieb il-ġabra tagħha. Kwalunkwe persuna oħra ma tistax tara ċ-ċwievet u ma tistax tibdilhom, u talba mingħandhom tiġi rrifjutata b'AUTHORITY_EXCEEDED.

Fil-console

Fuq Enterprise il-ġabra tinżamm fl-iswitchboard tal-IA, taħt il-magni. Fuq Community l-istess ċwievet jinżammu fuq Settings, Mudelli tal-IA. Dik il-paġna hija r-router bażiku, fejn iżżid iċ-ċwievet u indirizz ta' mudell lokali u tagħżel liema mudell jagħmel liema xogħol. It-tnejn juru kull ċavetta skont min issettjaha u meta ("Issettjata minn Aoife, 3 ta' Settembru") u bi ħjiel moħbi tal-aħħar erba' karattri tagħha l-aktar, bħal ••••7f2q. Iċ-ċavetta nnifisha qatt ma terġa' tintwera wara li żżidha.

Is-switchboard tal-IA
Is-switchboard tal-IA
L-iswitchboard tal-IA jelenka kull fornitur b'min issettja ċ-ċavetta tiegħu u liema xogħlijiet jagħmel. Ċavetta waħda qed tistrieħ wara xi fallimenti, oħra ġiet mitfija, u l-paġna tgħid fejn tista' tmur id-dejta.
Mudelli tal-IA
Mudelli tal-IA
Ir-router bażiku fuq Community: ċavetta tal-organizzazzjoni, mudell lokali fuq il-magna tal-organizzazzjoni stess, u liema mudell jagħmel liema xogħol.

Permezz tal-API tal-BFF

Il-backend għall-frontend (BFF) tal-console iservi tliet rotot għall-ġabra. Sejħilhom bit-token tal-aċċess tal-persuna stess: l-organizzazzjoni tiġi mit-token, qatt mit-talba.

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

GET iwieġeb bil-fornituri fil-ġabra, jekk kull wieħed jistax iwieġeb, kull ċavetta bil-ħjiel tagħha, u l-fornituri li għalihom tista' tiżdied ċavetta. Biex iżżid ċavetta hemm bżonn ta' korp JSON b'żewġ oqsma meħtieġa u wieħed fakultattiv:

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

Iċ-ċavetta tivvjaġġa darba. nexus-auth jikkriptaha u jgħid lir-router, u t-tweġiba ġġorr biss il-ħjiel. It-tweġiba hija 201 bl-id taċ-ċavetta l-ġdida u r-ringiela tagħha: "Miżjuda. Iċ-ċavetta ta' Google Gemini ••••7f2q tinsab fil-ġabra tal-IA tal-organizzazzjoni, u r-Router tal-Fornituri tal-IA jista' jibgħat lejha issa." Tikketta jkollha l-aktar 100 karattru, u ċavetta hija sekwenza waħda mingħajr spazji ta' mhux aktar minn 4,096 karattru. Kwalunkwe qasam ieħor fil-korp, jew qasam li jsemmi organizzazzjoni jew persuna, jiġi rrifjutat.

L-irtirar jieħu korp vojt. Ir-router jieqaf jibgħat lejn iċ-ċavetta mill-ewwel, u nexus-auth iżommha, elenkata bħala rtirata, sabiex l-istorja tagħha tibqa'. Xejn fil-ġabra ma jitħassar qatt.

Rifjut HTTP Meta
VALIDATION_FAILED 400 Korp li mhuwiex {provider, api_key, label?}, fornitur mhux magħruf, jew l-abbonament ta' persuna stess offrut bħala ċavetta tal-organizzazzjoni
AUTHORITY_EXCEEDED 403 Min qed isejjaħ mhuwiex sid jew amministratur tal-organizzazzjoni
RECORD_NOT_FOUND 404 L-ebda ċavetta b'dik l-id ma tinsab fil-ġabra tal-organizzazzjoni
TRANSITION_NOT_PERMITTED 409 Iċ-ċavetta hija diġà rtirata
TENANT_NOT_A_PARAMETER 403 Il-korp jew il-mistoqsija semmew organizzazzjoni

Stati taċ-ċwievet

Kull ċavetta fil-ġabra tinsab f'wieħed minn sitt stati. Ċavetta li qed tintuża biss twieġeb chat.

Stat Xi tfisser
in_use Iċ-ċavetta twieġeb, sad-data tal-iskadenza tagħha jekk ikollha waħda.
resting Ir-router serraħha wara xi fallimenti, sa ħin stabbilit. Sadanittant it-talbiet imorru għaċ-ċavetta li jmiss.
exhausted Użat il-limitu kollu tagħha għand il-fornitur.
invalid Il-fornitur ma għadux jaċċettaha.
expired Skadiet fid-data tal-iskadenza tagħha.
withdrawn Amministratur irtiraha. Tibqa' elenkata bħala storja.

Ċavetta li tfalli tistrieħ għal 60 sekonda. Wara 5 fallimenti wara xulxin ir-router jitfiha, iċaqlaq is-sehem tagħha għaċ-ċwievet l-oħra, u jirreġistra l-avviż PROVIDER_KEY_SWITCHED_OFF. Ħadd ma jiġi rrifjutat sakemm ċavetta oħra tkun tista' twieġeb.

Meta fornitur ma jkollu l-ebda ċavetta li qed tintuża, il-ġabra tgħid għaliex ("L-ebda ċavetta ma qed tintuża: 1 irtirata, 1 skaduta"). Meta l-ebda fornitur fil-ġabra ma jkollu ċavetta li qed tintuża, chat tiġi rrifjutata b'NO_PROVIDER_FOR_ROLE (422) u r-rimedju: sid jew amministratur iżid ċavetta tal-organizzazzjoni. Dak huwa stat ta' konfigurazzjoni, u jibqa' fuq l-iskrin sakemm xi ħadd jirranġah.

Rwoli, politika u xewqat

Ir-router jaħseb fi rwoli. Kull talba hija għal wieħed minn ħamsa: default, fast, reasoning, code jew long_context. Kull mudell jinsab ukoll f'livell (tier), frontier, standard jew fast, u livell ogħla huwa preferut meta r-rwol jippermettih. L-organizzazzjoni tiddeċiedi liema fornitur iservi kull rwol (l-assenjazzjonijiet tar-rwoli tagħha) u l-ordni li fiha taqa' fuq ieħor meta fornitur ifalli (is-sellum tal-politika tar-routing tagħha). L-amministraturi jissettjaw it-tnejn fl-iswitchboard tal-IA. nexus-auth iservihom ukoll f'/auth/org/<organisation-id>/settings/ai-provider/role-assignments u /auth/org/<organisation-id>/settings/ai-provider/routing-policy għal ċavetta ta' amministratur li jkollha ai_provider:manage.

Min isejjaħ jista' jgħid x'jixtieq. Ringiela ta' ħila tista' ġġorr fornitur preferut u mudell preferut, flimkien ma' profil ta' kapaċità. Ir-router jittratta kull wieħed b'mod differenti:

  • Fornitur preferut jiġi onorat biss meta l-organizzazzjoni jkollha dak il-fornitur attivat u jkollha ċavetta għalih. Inkella r-router jissostitwixxi.
  • Mudell preferut jiġi onorat meta jkun fil-katalgu ta' dak il-fornitur u jkun jaqbel mal-profil.
  • Profil ta' kapaċità huwa filtru li qatt ma jagħżel. Jista' jitlob tieqa minima ta' kuntest, użu ta' għodod, viżjoni, embeddings, kuntest twil jew residenza tad-dejta. Kwalunkwe ħaġa li tfalli fih ma tkunx eliġibbli.

Ir-router jagħżel f'ordni fissa. Jonora x-xewqa meta jista', imbagħad jipprova mudell ieħor tal-istess fornitur, imbagħad l-assenjazzjoni tar-rwol u kwalunkwe fornitur ieħor b'ċavetta li l-katalgu tiegħu jaqbel. Jekk ingħata profil u l-ebda katalgu ma jaqbel miegħu, it-talba tiġi rrifjutata b'MODEL_CAPABILITY_UNAVAILABLE (422). Jekk xejn ma jkun assenjat u xejn ma jaqbel, ikun NO_PROVIDER_FOR_ROLE (422). M'hemm l-ebda mudell awtomatiku tal-aħħar rikors. Rwol li ma kkonfigurajtx ifalli b'mod ċar, bi kliem ir-router stess jgħid x'għandek tissettja.

Ir-residenza tad-dejta hija l-unika restrizzjoni li ma tistax tiġi sostitwita. Profil b'eu_only jiġi servut minn fornitur tal-UE jew jiġi rrifjutat. Harrow tissettja dan is-serratura għall-organizzazzjoni kollha, u l-iswitchboard juri t-tieni fornitur ospitat, li jinsab f'reġjun tal-Istati Uniti, bħala mitfi.

Ħila tista' wkoll torbot mudell wieħed eżatt meta l-ħila jkollha bżonn dak il-mudell biex taħdem. Anke dakinhar ir-router juża ċ-ċavetta tal-organizzazzjoni stess għalih, u mingħajr waħda xejn ma jwieġeb. Min isejjaħ qatt ma jista' jġiegħel lil Nexus juża fornitur li l-organizzazzjoni ma kkonfiguratx.

Ladarba jintgħażel fornitur, il-failover huwa kwistjoni separata. 429, 5xx jew falliment tan-netwerk iċaqlaq it-talba 'l isfel fis-sellum għall-fornitur li jmiss. 400, 401, 403 jew 404 jieqaf mill-ewwel, għaliex il-kredenzjali u l-forom tat-talbiet ma jgħaddux minn fornitur għal ieħor u tentattiv ieħor jaħli l-kwota biex jasal għall-istess falliment.

Biex tara x'jagħżel ir-router qabel ma xi ħadd jistaqsi mistoqsija, aqra GET /api/ai/routing-policy/effective fuq il-gateway bit-token tal-persuna stess. Iwieġeb bil-mudell għall-organizzazzjoni li tkun idħlet, jew bir-rifjut tar-router fi kliem meta ma jkun hemm xejn, u ma jibgħat l-ebda talba lil mudell.

Osservazzjoni tar-router

L-istrixxa taċ-ċifri fin-naħa t'isfel ta' kull paġna turi l-mudell li qed jintuża ("Mudell: lokali"). Fuq Enterprise, L-iswitchboard tal-IA, b'mod dirett ipinġi t-traffiku tar-router hekk kif iseħħ: talbiet mill-assistent, xogħlijiet u apps li jgħaddu mir-rwoli għall-fornituri u ċ-ċwievet, ċavetta fil-mistrieħ tagħha ta' 60 sekonda mpinġija bil-griż, ċavetta mitfija mpinġija bl-aħmar, u rikors għall-fornitur ospitat meta l-mudell lokali jkun okkupat. Maġenb il-fluss juri t-tagħbija għal kull fornitur, it-talbiet kull sekonda u l-ħin ta' stennija. Tomás iżommu miftuħ matul l-ewwel ġimgħa wara kwalunkwe bidla fil-politika tar-routing, għaliex assenjazzjoni ħażina ta' rwol tidher hemmhekk fi ftit minuti bħala traffiku li jmur x'imkien li ħadd ma riedu jmur.

Fuq Community, il-paġna Mudelli tal-IA għandha buttuna Ittestja kull mudell li tiċċekkja kull mudell ikkonfigurat u timmarka jekk iwieġebx. Huwa l-aktar mod mgħaġġel biex tipprova li ċavetta ġdida taħdem qabel ma xi ħadd joqgħod fuqha.

L-iswitchboard tal-IA, b'mod dirett
L-iswitchboard tal-IA, b'mod dirett
Ir-router b'mod dirett. It-traffiku jgħaddi mill-assistent u x-xogħlijiet permezz tar-rwoli lejn mudell lokali u ċwievet ospitati; ċavetta waħda qed tistrieħ, waħda hija mitfija, u tikek tad-deheb juru rikors waqt li l-mudell lokali jkun okkupat.

Embeddings

It-tfittxija u l-graff tal-għarfien jibdlu t-test f'vetturi. B'mod awtomatiku l-installazzjoni tagħmel dan b'mudell ta' embedding li jaħdem ġol-cluster fuq il-proċessur, sabiex l-ebda test ma joħroġ mis-sit biex jiġi embedded u organizzazzjoni ma jkollha bżonn l-ebda ċavetta għalih. L-użu ta' fornitur ospitat għall-embeddings huwa għażla li tagħmel organizzazzjoni; imbagħad jgħaddi mill-istess ġabra u l-istess regoli.

Tliet servizzi biss jistgħu jitolbu lir-router għal embeddings jew reranking: nexus-graphrag, nexus-skills-engine u nexus-workflows. GraphRAG jagħmel l-embedding bħala l-organizzazzjoni li tagħha jkun il-kontenut, bis-settings ta' dik l-organizzazzjoni, u ma jżomm l-ebda ċavetta ta' fornitur tiegħu stess. Meta organizzazzjoni tibdel il-mudell ta' embedding tagħha, nexus-workflows iħaddem ix-xogħol ta' re-embedding għall-imħażen ta' dik l-organizzazzjoni.

Il-kredenzjali għal kull persuna jibqgħu personali

Xi kredenzjali jappartjenu lil persuna waħda. Abbonament ta' Claude Max, li tkun dħalt fih permezz tal-kont ta' dik il-persuna stess, huwa l-każ komuni. Kredenzjali bħal din qatt ma hija ċavetta tal-organizzazzjoni: il-ġabra tirrifjutaha b'VALIDATION_FAILED, qatt ma tiġi elenkata fit-tabella taċ-ċwievet tal-organizzazzjoni, u l-ebda skrin ta' persuna oħra ma juriha.

Iċ-ċwievet tal-mudelli wkoll qatt ma jmorru mkien ieħor. Il-paġna Ċwievet tad-dejta esterna, li żżomm iċ-ċwievet għal sorsi ta' dejta esterni, tirrifjuta kwalunkwe ħaġa li tidher bħala ċavetta ta' mudell tal-IA b'AI_PROVIDER_KEYS_BELONG_TO_ORG_POOL (422). Jekk il-qarrej tal-fajls isib ċwievet tal-mudelli ġo dokument jew konfigurazzjoni fejn ma jappartjenux, jirreġistra CREDENTIALS_IN_WRONG_PLACE u amministratur ineħħihom u jibdilhom.

Skripts, REST u MCP

Nexus għandu tliet hosts pubbliċi. F'Harrow huma console.harrow.example għall-console, api.harrow.example għall-gateway u auth.harrow.example għad-dħul (sign-in). L-iskripts u l-għodod jużaw it-tieni u t-tielet wieħed.

Ċwievet għall-iskripts

Skript jidħol b'ċavetta magħmula fuq Settings, Ċwievet għall-iskripts. Kull ċavetta għandha isem, ambitu (pereżempju, "Ibda l-għadd tat-tarzna bid-Drone biss"), il-persuna li għamlitha u data tat-tmiem; organizzazzjoni tista' tissakkar l-itwal ħajja li jista' jkollha ċavetta. Is-sigriet jintwera darba meta ssir iċ-ċavetta. Ikkopjah fil-maħżen tas-sigrieti tal-iskript, għaliex Nexus iżomm biss l-aħħar erba' karattri tiegħu. Ċavetta tiġi rtirata, qatt ma titneħħa: tieqaf mill-ewwel u tibqa' elenkata b'kull sejħa li għamlet. Ir-rotazzjoni tagħti liċ-ċavetta sigriet ġdid u turih darba.

Kull ċavetta għandha l-paġna tagħha stess bis-sejħiet kuljum, is-sejħiet skont is-servizz u reġistru tal-attività tal-ħin, l-indirizz, is-servizz u r-riżultat. Sejħa barra mill-ambitu taċ-ċavetta tiġi rrifjutata u tidher fir-reġistru.

nexus-auth iservi l-istess ċwievet lil persuna li tkun idħlet f'https://auth.harrow.example/api-keys: oħloq u elenka, imbagħad aqra, ibdel, irrevoka jew dawwar ċavetta waħda bl-id tagħha.

Ċavetta waħda għall-iskripts
Ċavetta waħda għall-iskripts
Ċavetta waħda għall-iskripts. Il-paġna turi l-ambitu taċ-ċavetta, min għamilha, id-data tat-tmiem tagħha, is-sejħiet skont il-jum u skont is-servizz, u r-riżultat ta' kull sejħa; is-sigriet jintemm b'…7QK2 u qatt ma jerġa' jintwera.

REST permezz tal-gateway

Ibgħat sejħiet REST lil https://api.harrow.example b'Authorization: Bearer <token-or-key>. Kull ċavetta trid tappartjeni lil organizzazzjoni. Ċavetta mingħajr waħda tiġi rrifjutata b'TOKEN_ORG_MISSING (403) minn kull servizz li jiċċekkja ċ-ċwievet permezz ta' nexus-auth.

Min isejjaħ u jitlob spiss wisq jitwieġeb 429 b'RATE_LIMITED, header Retry-After, u l-limitu u t-tieqa fil-korp. Stenna għan-numru ta' sekondi li jagħti. Fuq Enterprise, l-amministraturi jissettjaw il-limiti għal kull ċavetta, għal kull app u għal kull unità fuq Settings, Limiti tar-rata (ara kapitlu 2.16, Sigurtà u netwerking).

MCP għall-għodod tal-IA

L-għodod tal-IA li jitkellmu l-Protokoll tal-Kuntest tal-Mudell (Model Context Protocol) jikkonnettjaw ma' https://api.harrow.example/mcp. Huma jidħlu permezz tas-server OAuth 2.1 (OAuth huwa l-istandard miftuħ għall-awtorizzazzjoni delegata) f'https://auth.harrow.example, li jappoġġja r-reġistrazzjoni tal-klijent mill-għodda nnifisha, sabiex għodda bħal Claude Code jew Cursor tirreġistra lilha nnifisha u tiftaħ il-brawżer tal-persuna biex tidħol. Il-konnessjoni mbagħad taġixxi għal dik il-persuna waħda, bid-drittijiet ta' dik il-persuna u xejn aktar. Persuna li tkun idħlet tista' ġġib konfigurazzjoni lesta għal għodda tal-linja tal-kmand minn https://auth.harrow.example/api/v1/mcp/cli-config.

Sejħiet ta' għodod li jeħtieġu mudell jgħaddu mir-router bħal kull ħaġa oħra, taħt l-organizzazzjoni tal-persuna.