Leagan 1.0.0-alpha.1is déanaí
Caibidil 2.14
Soláthraithe agus múnlaí AI
Conas a roghnaíonn Ródairí Soláthraithe na hintleachta saorga (AI) múnla ó linn eochracha na heagraíochta féin, agus conas a bhaineann scripteanna agus uirlisí AI Nexus amach ón taobh amuigh.
d'aistrigh AI an leathanach seo ón mbunleagan Béarla. Má tá aon rud doiléir, is é an leathanach Béarla an tagairt. Léigh an leathanach seo i mBéarla

Ritheann Harrow Port Authority dhá shuiteáil. Níl aon soláthraí óstáilte ar chor ar bith ag an gceann ar a líonra oibríochtaí aerbhearnaithe (caibidil 2.10, Suiteáil aerbhearnaithe). Ar an tsuiteáil chorparáideach nasctha, a leanann an chaibidil seo, freagraítear formhór nagceisteanna ag samhail a ritheann ar dhá nód aonaid próiseála grafaicí (GPU) i seomra freastalaí an phoirt féin. Glacann eochair Google Gemini, a íocann Harrow aisti, an breis-sreabhadh nuair a bhíonn an tsamhail logánta gnóthach, agus tá Aoife Brennan tar éis trácht intleachta saorga (AI) na heagraíochta a ghlasáil don AE. Níor chumraigh aon duine ag Harrow samhail taobh istigh de sheirbhís ná de bhreiseán. D'inis siad do chomhpháirt amháin cad is leis an eagraíocht Harrow, agus déanann an chomhpháirt sin gach glao a chinneadh.
Clúdaíonn an chaibidil seo an chomhpháirt sin, an AI Provider Router, ar a dtugann Cuid 1 agus an consól an lascchlár AI, agus an linn eochracha as a dtarraingíonn sé. Críochnaíonn sí leis na bealaí a sroicheann scripteanna agus uirlisí AI Nexus ón taobh amuigh: eochracha do scripteanna, an comhéadan clárúcháin feidhmchlár (API) REST (representational state transfer) agus an Model Context Protocol (MCP).
An AI Provider Router
Ritheann an ródaire taobh istigh den gheata, nexus-gateway. Is é an t-aon seirbhís amháin a choinníonn dintiúir samhla eagraíochta, agus déanann sé an cinneadh deiridh faoi cén soláthraí agus cén tsamhail a fhreagraíonn gach iarratas. Fiafraíonn gach cuid eile de Nexus de. Deir céim sreafa oibre cad ba mhaith léi, agus socraíonn an ródaire.
Ní féidir ach le cúpla seirbhís fiafraí, agus tá gach liosta socraithe ag an gcairt:
| Cad a iarrtar | Cé a fhéadfaidh fiafraí |
|---|---|
Comhlánú (/internal/ai/chat agus a shruth) |
nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| Glaonna uirlisí agus na bealaí inmheánacha AI eile | nexus-orchestrator, nexus-workflows |
| Leabuithe agus athrangú | nexus-graphrag, nexus-skills-engine, nexus-workflows |
Seiceálann gach bealach inmheánach dhá rud i ndiaidh a chéile: eochair sheirbhíse inmheánach an ghlaoiteora, agus aitheantas an ghlaoiteora i gcoinne an liosta thuas. Diúltaítear d'iarratas gan an eochair le MISSING_SERVICE_KEY (401), d'eochair mhícheart le INVALID_SERVICE_KEY (403), d'iarratas nach ndeir cé atá ag glaoch le MISSING_CALLER_IDENTITY (403), agus do ghlaoiteoir lasmuigh den liosta le UNAUTHORIZED_CALLER (403). Ní dhéantar ath-iarracht ar aon cheann acu seo, toisc nach locht sealadach é aon cheann acu.
Ní bhíonn feidhmchláir ná breiseáin ar an liosta sin riamh. Fógraíonn breiseán a mhianta ar na scileanna a chláraíonn sé agus a sheolann sé trí UNO, an t-inneall sreafa oibre. Ansin fiafraíonn an ceolfhoirneoir den ródaire thar ceann an bhreiseáin. Sin é an fáth gur féidir le rún breiseáin amháin atá sceite gníomhú mar an breiseán sin ach nach féidir leis buiséad samhla aon duine a chaitheamh.
Linn eochracha na heagraíochta
Is leis an eagraíocht eochracha samhla. Tugann gach eagraíocht a cuntas soláthraí féin léi agus íocann sí a bille féin, agus maireann an eochair i linn na heagraíochta, criptithe in nexus-auth. Níl aon eochair ardáin roinnte taobh thiar d'eagraíocht, mar sin ní chaitear buiséad eagraíochta eile ag aon eagraíocht riamh. Tá costas na rialach sin soiléir: ní fhaigheann eagraíocht gan eochair ina linn aon fhreagraí AI. Taispeánann an cúntóir MODEL_NOT_CONNECTED (503) agus deir sé cé is féidir ceann a nascadh.
Is féidir eochair a chur leis an linn do cheithre sholáthraí:
| Aitheantas soláthraí | Taispeántar mar |
|---|---|
anthropic_api_key |
Anthropic |
gemini |
Google Gemini |
openrouter |
OpenRouter |
scaleway |
Scaleway |
Freastalaí samhla de do chuid féin
Is féidir le heagraíocht freisin aon fhreastalaí a ritheann sí a labhraíonn an API atá comhoiriúnach le OpenAI a úsáid, amhail an tsamhail ar nóid GPU Harrow. Ainmníonn an suiteálaí é sa chomhad luachanna:
# 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/24Díríonn ai.localProvider.baseUrl cuibheoir an gheata atá comhoiriúnach le OpenAI ar do fhreastalaí. Ar shuiteáil, sroicheann sliotán scaleway na linne an freastalaí sin, mar sin is í an eochair a chuireann tú le haghaidh scaleway an eochair a mbíonn do fhreastalaí féin ag súil léi.
Liostaíonn ai.installationHosts óstainmneacha atá taobh istigh den tsuiteáil, le cois fhearann seirbhíse an eisiúna féin agus na dtrí óstach poiblí. Is óstainm, .suffix, seoladh IP nó raon IPv4 Classless Inter-Domain Routing (CIDR) gach iontráil. Úsáideann an ródaire an liosta chun glao a fhanann ar an láthair a aithint ó cheann a fhágann é, agus is é sin a thuairiscíonn an tseiceáil "Ní fhágann aon rud an láthair seo" ar an leathanach Ceangail samhail ar do chrua-earraí féin.
Tá an polasaí líonra chomh tábhachtach leis an ródaire. Diúltaíonn an t-ainmspás do gach trácht amach de réir réamhshocraithe, mar sin ní féidir leis an ngeata freastalaí samhla lasmuigh den ainmspás a shroicheadh ach amháin nuair atá a raon in networkPolicy.externalEgressCIDRs. Baineann an rud céanna le soláthraí óstáilte: más mian le Harrow go bhfreagródh a eochair Gemini, caithfear raonta seoltaí an tsoláthraí a liostú ansin freisin, nó ní fhágann an glao an braisle riamh. Clúdaíonn Caibidil 2.16, Slándáil agus líonrú, an polasaí go hiomlán.
Eochracha a chur leis agus a tharraingt siar
Coinníonn úinéirí agus riarthóirí eagraíochta a linn. Ní féidir le haon duine eile na heochracha a fheiceáil ná iad a athrú, agus diúltaítear d'iarratas uathu le AUTHORITY_EXCEEDED.
Sa chonsól
Ar Enterprise coinnítear an linn sa lascchlár AI, faoi na hinnill. Ar Community coinnítear na heochracha céanna ar Socruithe, Samhlacha AI. Is é an leathanach sin an ródaire bunúsach, áit a gcuireann tú eochracha agus seoladh samhla logánta leis agus a roghnaíonn tú cén tsamhail a dhéanann cén post. Taispeánann an dá cheann gach eochair de réir cé a shocraigh í agus cathain ("Socraithe ag Aoife, 3 MF") agus le leid chumhdaithe dá ceithre charachtar dheireanacha ar a mhéad, amhail ••••7f2q. Ní thaispeántar an eochair féin arís riamh tar éis duit í a chur leis.
Tríd an API BFF
Freastalaíonn inneall cúil don inneall tosaigh (BFF) an chonsóil trí bhealach don linn. Glaoigh orthu le comhartha rochtana duine féin: tagann an eagraíocht ón gcomhartha, ní ón iarratas riamh.
GET /api/v1/ai-providers
POST /api/v1/ai-providers/keys
POST /api/v1/ai-providers/keys/<key-id>/withdraw
Freagraíonn GET na soláthraithe sa linn, cibé an féidir le gach ceann freagairt, gach eochair de réir a leide, agus na soláthraithe ar féidir eochair a chur leo. Glacann cur eochrach leis corp JSON le dhá réimse riachtanacha agus ceann amháin roghnach:
{ "provider": "gemini", "api_key": "<the provider's key>", "label": "Overflow, EU" }Taistealaíonn an eochair uair amháin. Criptíonn nexus-auth í agus insíonn sé don ródaire, agus ní iompraíonn an freagra ach an leid. Is é an freagra ná 201 le haitheantas na heochrach nua agus a ró: "Curtha leis. Tá an eochair Google Gemini ••••7f2q i linn AI na heagraíochta, agus is féidir leis an AI Provider Router ródú chuici anois." Bíonn 100 carachtar ar a mhéad i lipéad, agus is teaghrán amháin gan spásanna de 4,096 carachtar ar a mhéad í eochair. Diúltaítear d'aon réimse eile sa chorp, nó do réimse a ainmníonn eagraíocht nó duine.
Glacann tarraingt siar corp folamh. Stopann an ródaire ag ródú chuig an eochair láithreach, agus coinníonn nexus-auth í, liostaithe mar tharraingthe siar, ionas go bhfanann a stair. Ní scriostar aon rud sa linn riamh.
| Diúltú | HTTP | Cathain |
|---|---|---|
VALIDATION_FAILED |
400 | Corp nach {provider, api_key, label?} é, soláthraí anaithnid, nó síntiús duine féin tairgthe mar eochair eagraíochta |
AUTHORITY_EXCEEDED |
403 | Ní úinéir ná riarthóir de chuid na heagraíochta é an glaoiteoir |
RECORD_NOT_FOUND |
404 | Níl aon eochair leis an aitheantas sin i linn na heagraíochta |
TRANSITION_NOT_PERMITTED |
409 | Tá an eochair tarraingthe siar cheana féin |
TENANT_NOT_A_PARAMETER |
403 | D'ainmnigh an corp nó an t-iarratas eagraíocht |
Staideanna eochrach
Tá gach eochair sa linn i gceann amháin de shé staid. Ní fhreagraíonn ach eochair atá in úsáid comhrá.
| Stát | Cad is brí leis |
|---|---|
in_use |
Freagraíonn an eochair, go dtí a dáta éaga má tá ceann aici. |
resting |
Chuir an ródaire ar scíth í tar éis teipeanna, go dtí am socraithe. Téann iarratais chuig an gcéad eochair eile idir an dá linn. |
exhausted |
D'úsáid sí a teorainn ar fad ag an soláthraí. |
invalid |
Ní ghlacann an soláthraí léi a thuilleadh. |
expired |
Chuaigh sí in éag ar a dáta éaga. |
withdrawn |
Tharraing riarthóir siar í. Fanann sí liostaithe mar stair. |
Ligeann eochair a theipeann a scíth ar feadh 60 soicind. Tar éis 5 theip as a chéile múchann an ródaire í, bogann sé a sciar chuig na heochracha eile, agus taifeadann sé an fógra PROVIDER_KEY_SWITCHED_OFF. Ní dhiúltaítear d'aon duine fad is féidir le heochair eile freagairt.
Nuair nach mbíonn aon eochair in úsáid ag soláthraí, deir an linn cén fáth ("Gan eochair in úsáid: 1 tarraingthe siar, 1 imithe in éag"). Nuair nach mbíonn eochair in úsáid ag aon soláthraí sa linn, diúltaítear do chomhrá le NO_PROVIDER_FOR_ROLE (422) agus an leigheas: cuireann úinéir nó riarthóir eochair eagraíochta leis. Is staid chumraíochta é sin, agus fanann sé ar an scáileán go dtí go socraíonn duine éigin é.
Róil, polasaí agus mianta
Smaoiníonn an ródaire i róil. Is le haghaidh ceann amháin de chúig cinn gach iarratas: default, fast, reasoning, code nó long_context. Tá gach samhail i sraith freisin, frontier, standard nó fast, agus is fearr sraith níos airde nuair a cheadaíonn an ról é. Socraíonn an eagraíocht cén soláthraí a fhreastalaíonn ar gach ról (a sannacháin róil) agus an t-ord ina dtitear siar nuair a theipeann ar sholáthraí (a dréimire polasaí ródaithe). Socraíonn riarthóirí an dá cheann sa lascchlár AI. Freastalaíonn nexus-auth orthu freisin ag /auth/org/<organisation-id>/settings/ai-provider/role-assignments agus /auth/org/<organisation-id>/settings/ai-provider/routing-policy le haghaidh eochair riarthóra a shealbhaíonn ai_provider:manage.
Is féidir le glaoiteoirí a rá cad ba mhaith leo. D'fhéadfadh soláthraí roghnaithe agus samhail roghnaithe, mar aon le próifíl chumais, a bheith i ró scile. Pléann an ródaire le gach ceann acu ar bhealach difriúil:
- ugtar aird ar sholáthraí roghnaithe ach amháin nuair a bhíonn an soláthraí sin cumasaithe ag an eagraíocht agus eochair aici dó. Seachas sin cuireann an ródaire ceann eile ina áit.
- Tugtar aird ar shamhail roghnaithe nuair atá sí i gcatalóg an tsoláthraí sin agus nuair a oireann sí don phróifíl.
- Is scagaire í próifíl chumais nach roghnaíonn riamh. Is féidir léi íosfhuinneog chomhthéacs, úsáid uirlisí, fís, leabuithe, comhthéacs fada nó cónaitheacht sonraí a iarraidh. Níl aon rud a theipeann uirthi incháilithe.
Roghnaíonn an ródaire in ord socraithe. Tugann sé aird ar an mian nuair is féidir leis, ansin triailfidh sé samhail eile den soláthraí céanna, ansin sannachán an róil agus aon soláthraí eile a bhfuil eochair aige a oireann a chatalóg. Má tugadh próifíl agus nach n-oireann aon chatalóg di, diúltaítear don iarratas le MODEL_CAPABILITY_UNAVAILABLE (422). Mura bhfuil aon rud sannta agus nach meaitseálann aon rud, is NO_PROVIDER_FOR_ROLE (422) é. Níl aon samhail réamhshocraithe mar rogha dheireanach ann. Teipeann go glórach ar ról nár chumraigh tú, le focail an ródaire féin ag rá cad is cóir a shocrú.
Is í cónaitheacht sonraí an t-aon srian amháin nach féidir malartú timpeall air. Freastalaíonn soláthraí AE ar phróifíl le eu_only nó diúltaítear di. Socraíonn Harrow an glas seo don eagraíocht ar fad, agus tarraingíonn an lascchlár an dara soláthraí óstáilte, atá suite i réigiún de chuid SAM, mar mhúchta.
Is féidir le scil samhail bheacht amháin a phionnáil freisin nuair a bhíonn an tsamhail sin ag teastáil ón scil chun oibriú. Fiú ansin úsáideann an ródaire eochair na heagraíochta féin chuige, agus gan ceann ní fhreagraíonn aon rud. Ní féidir le glaoiteoir a chur ar Nexus riamh soláthraí nár chumraigh an eagraíocht a úsáid.
Nuair a roghnaítear soláthraí, is ceist ar leith é titeadh siar. Bogann 429, 5xx nó teip líonra an t-iarratas síos an dréimire chuig an gcéad soláthraí eile. Stopann 400, 401, 403 nó 404 láithreach, toisc nach n-iompraíonn dintiúir ná cruthanna iarratais trasna soláthraithe agus go ndófadh ath-iarracht cuóta chun an teip chéanna a shroicheadh.
Chun a fheiceáil cad a roghnódh an ródaire sula gcuireann aon duine ceist, léigh GET /api/ai/routing-policy/effective ar an ngeata le comhartha duine féin. Freagraíonn sé an tsamhail don eagraíocht atá sínithe isteach, nó diúltú an ródaire i bhfocail nuair nach bhfuil aon cheann ann, agus ní sheolann sé aon iarratas chuig samhail.
Faire ar an ródaire
Taispeánann an stríoc figiúirí ag bun gach leathanaigh an tsamhail atá in úsáid ("Samhail: logánta"). Ar Enterprise, tarraingíonn An lascchlár AI, beo trácht an ródaire de réir mar a tharlaíonn sé: iarratais ón gcúntóir, poist agus feidhmchláir ag sreabhadh trí róil chuig soláthraithe agus eochracha, eochair ina scíth 60 soicind tarraingthe i liath, eochair mhúchta tarraingthe i ndearg, agus titim siar chuig an soláthraí óstáilte nuair a bhíonn an tsamhail logánta gnóthach. Le hais an tsreafa, léiríonn sé i gcairt ualach in aghaidh an tsoláthraí, iarratais sa soicind agus am feithimh. Coinníonn Tomás oscailte é le linn na chéad seachtaine tar éis aon athraithe ar an bpolasaí ródaithe, toisc go dtaispeántar sannachán róil mícheart ansin laistigh de nóiméid mar thrácht ag dul áit éigin nach raibh i gceist ag aon duine.
Ar Community, tá cnaipe Tástáil gach samhail ar an leathanach Samhlacha AI a sheiceálann gach samhail chumraithe agus a mharcálann cibé an bhfreagraíonn sí. Is é an bealach is tapúla é chun a chruthú go n-oibríonn eochair nua sula mbíonn aon duine ag brath uirthi.
Leabuithe
Iompaíonn cuardach agus an graf eolais téacs ina veicteoirí. De réir réamhshocraithe déanann an tsuiteáil é seo le samhail leabaithe a ritheann taobh istigh den bhraisle ar an bpróiseálaí, mar sin ní fhágann aon téacs an láthair le bheith leabaithe agus ní bhíonn aon eochair ag teastáil ó eagraíocht chuige. Is rogha a dhéanann eagraíocht é soláthraí óstáilte a úsáid le haghaidh leabuithe; téann sé ansin tríd an linn chéanna agus na rialacha céanna.
Ní féidir ach le trí sheirbhís leabuithe nó athrangú a iarraidh ar an ródaire: nexus-graphrag, nexus-skills-engine agus nexus-workflows. Déanann GraphRAG leabú mar an eagraíocht ar léi an t-ábhar, le socruithe na heagraíochta sin, agus ní choinníonn sé aon eochair sholáthraí dá chuid féin. Nuair a athraíonn eagraíocht a samhail leabaithe, ritheann nexus-workflows an post ath-leabaithe do stórais na heagraíochta sin.
Fanann dintiúir in aghaidh an duine pearsanta
Baineann roinnt dintiúr le duine amháin. Is é síntiús Claude Max, sínithe isteach trí chuntas an duine sin féin, an cás coitianta. Ní eochair eagraíochta é a leithéid de dhintiúr riamh: diúltaíonn an linn dó le VALIDATION_FAILED, ní liostaítear riamh é i dtábla eochracha na heagraíochta, agus ní thaispeánann aon scáileán de chuid duine eile é.
Ní théann eochracha samhla go haon áit eile riamh ach oiread. Diúltaíonn an leathanach Eochracha sonraí seachtracha, a choinníonn eochracha d'fhoinsí sonraí lasmuigh, d'aon rud a bhreathnaíonn mar eochair shamhla AI le AI_PROVIDER_KEYS_BELONG_TO_ORG_POOL (422). Má aimsíonn an léitheoir comhad eochracha samhla taobh istigh de cháipéis nó de chumraíocht nach mbaineann siad léi, taifeadann sé CREDENTIALS_IN_WRONG_PLACE agus baineann riarthóir iad agus cuireann sé cinn eile ina n-áit.
Scripteanna, REST agus MCP
Tá trí óstach poiblí ag Nexus. Ag Harrow is iad console.harrow.example don chonsól, api.harrow.example don gheata agus auth.harrow.example le haghaidh síniú isteach. Úsáideann scripteanna agus uirlisí an dara agus an tríú ceann.
Eochracha do scripteanna
Síníonn script isteach le heochair a rinneadh ar Socruithe, Eochracha do scripteanna. Tá ainm, raon feidhme (mar shampla, "Tosaigh comhaireamh clóis dróin amháin"), an duine a rinne í agus dáta deiridh ag gach eochair; is féidir le heagraíocht an saolré is faide a d'fhéadfadh a bheith ag eochair a ghlasáil. Taispeántar an rún uair amháin nuair a dhéantar an eochair. Cóipeáil isteach i stór rúnda na scripte é, toisc nach gcoinníonn Nexus ach a cheithre charachtar dheireanacha. Tarraingítear eochair siar, ní bhaintear riamh í: stopann sí láithreach agus fanann sí liostaithe le gach glao a rinne sí. Tugann rothlú rún nua don eochair agus taispeánann sé uair amháin é.
Tá a leathanach féin ag gach eochair le glaonna in aghaidh an lae, glaonna de réir seirbhíse agus loga gníomhaíochta d'am, seoladh, seirbhís agus toradh. Diúltaítear do ghlao lasmuigh de raon feidhme na heochrach agus taispeántar sa loga é.
Freastalaíonn nexus-auth na heochracha céanna ar dhuine atá sínithe isteach ag https://auth.harrow.example/api-keys: cruthaigh agus liostaigh, ansin léigh, athraigh, cúlghairm nó rothlaigh eochair amháin de réir a haitheantais.
REST tríd an ngeata
Seol glaonna REST chuig https://api.harrow.example le Authorization: Bearer <token-or-key>. Caithfidh gach eochair bheith ina cuid d'eagraíocht. Diúltaítear d'eochair gan ceann le TOKEN_ORG_MISSING (403) ag gach seirbhís a sheiceálann eochracha trí nexus-auth.
Freagraítear glaoiteoir a fhiafraíonn ró-mhinic le 429 le RATE_LIMITED, ceanntásc Retry-After, agus an teorainn agus an fhuinneog sa chorp. Fan an líon soicindí a thugann sé. Ar Enterprise, socraíonn riarthóirí teorainneacha in aghaidh na heochrach, in aghaidh an fheidhmchláir agus in aghaidh an aonaid ar Socruithe, Teorainneacha ráta (féach caibidil 2.16, Slándáil agus líonrú).
MCP d'uirlisí AI
Ceanglaíonn uirlisí AI a labhraíonn an Model Context Protocol le https://api.harrow.example/mcp. Síníonn siad isteach tríd an bhfreastalaí OAuth 2.1 (is é OAuth an caighdeán oscailte d'údarú tarmligthe) ag https://auth.harrow.example, a thacaíonn le clárú cliaint ag an uirlis féin, ionas go gcláraíonn uirlis amhail Claude Code nó Cursor í féin agus go n-osclaíonn sí brabhsálaí an duine chun síniú isteach. Gníomhaíonn an nasc ansin don duine amháin sin, le cearta an duine sin agus gan aon rud eile. Is féidir le duine atá sínithe isteach cumraíocht réamhdhéanta d'uirlis líne ordaithe a fháil ó https://auth.harrow.example/api/v1/mcp/cli-config.
Téann glaonna uirlisí a dteastaíonn samhail uathu tríd an ródaire mar gach rud eile, faoi eagraíocht an duine.




