Guardian Agent # He aha te Live in Production — He Rārangi Kāhore i Whakapaipaihia
Raupapa: Whakahaere Hanganga AI i te Taumata Hapori — He Arotakenga Hangarau o te Village AI (Tūhinga 4 o te 5) Kaituhi: My Digital Sovereignty Ltd Rā: Poutū-te-rangi 2026 Līseni: CC BY 4.0 ā-Ao
Te Roanga
E whakamārama ana tēnei tuhinga i te pūnaha i tōna āhua i te wā e whakaputahia ana i te Poutū-te-rangi 2026. Ki ngā wāhanga e whakamaherehia ana, engari kāore anō kia whakatinanahia, ka kī mātou pēnei. Ki ngā wāhanga kua whakatinanahia, engari he here mōhiotia āna, ka whakamārama mātou i aua here. Ko te whāinga he rārangi taonga ka taea e tētahi kairangahau te whakamahi hei aromātai i te pakeketanga o te pūnaha me ngā kī kua whakapuaki i ētahi atu wāhanga o tēnei raupapa.
Village AI kua noho i te whakaputanga mai i te Oketopa 2025. He pūnaha rangatahi tēnei e whakahaere ana i te rahi āhua iti. Ko te whai ake nei he whakamārama hangarau mō te hanganga kua whakatinanahia.
Hanganga Tauira
Tauira turanga: villageai-8b-corrected-v4 — he tauira 8B ngā tawhā e mahi ana hei paparanga turanga mō ngā kaipā katoa. I whakangungua ki ngā ihirangi whakahaere o te tūāpapa: ngā tuhinga āhuatanga, ngā tauira whakatere, ngā tauira pātai āwhina, me ngā tikanga whakawhitinga kōrero ā-hapori.
Ngā paparanga motuhake: Ngā tauira kua whakangāwarihia mō ia momo hua, kua whakaurua mā tētahi paparanga whakatere (model-routing.js). Ko te motuhake tuatahi mō te whakaputa ko villageai-8b-episcopal-v2, kua whakangāwarihia ki ngā ihirangi karakia, tiaki, me te whakahaere o te Hāhi Ēpīkopa/Anglikana. Kei te whakamahere ētahi atu motuhake (whānau, tiaki taiao, hapori), engari kāore anō kia whakangungua.
Te whakatere tauira: Ka kōwhiri te InferenceRouter i te tauira e tika ana i runga i te momo hua a te kaipā. Mēnā e wātea ana he motuhake mō te momo hua a te kaipā, ka whakamahia tērā; ki te kore, ko te tauira taketake ka whakautu i te tono. Kua tautuhia he taumata kua whakarei ake i roto i te hanganga, engari kāore anō kia whakakiia.
Taputapu mō te tātaritanga: Ka whakahaere te tātaritanga matua i runga i tētahi GPU AMD RX 7900 XTX, ā, ka taea te uru mā te WireGuard VPN mai i te tūmau taupānga (OVH France). Kei te wātea te hokinga ki te CPU mā te whakamahi i tētahi tauira kua whakaitia ngā tawhā 3B hei wātea i ngā wā e aukati ana te GPU. Kāore te GPU i te wāhi kotahi me te tūmau taupānga — ka haere ngā tono tātaritanga i roto i tētahi araha VPN, ā, ka tāpiri i te roa o te whatunga ki te huarahi tātaritanga.
Anga: Ka whakahaerehia te tātaritanga mā Ollama, ā, ko te InferenceRouter e whakahaere ana i te kōwhiringa tauira me te arataki tono. Kāore te pūnaha e whakamahi i tētahi API tātaritanga a tētahi atu; ka puta katoa ngā whakaputa i runga i te hanganga e whakahaerehia ana.
Whakaputa-āpiti Tiki
Pātaka rārangi-ā-vector: Qdrant, e rokiroki ana i ngā whakaurunga o ngā ihirangi hapori (pūrākau, pānui, tuhinga, whakamārama kaupapa, rēhita whakahaere).
Pūnaha whakaurunga: Ka tukatuka te EmbeddingService i ngā ihirangi hapori hei whakaaturanga pūwero. Ka wehea ngā ihirangi ki ngā wāhanga, ka whakauru, ka tāruatia ia kaipā, ā, ka pupuri i te wehe motuhake o ia kaipā i te taumata o te putunga pūwero.
Te tiki i te wā whakamātau: Ka whakauru ngā pātai a te kaiwhakamahi, ā, ka whakamahia hei rapu ōritetanga kōsini ki te kohinga tuhinga o te kaipā. Ka whakaratohia ngā tuhinga kua tiki hei horopaki ki te tauira whakaputa, hei whakapūmau i āna whakautu ki ngā ihirangi tūturu o te hapori.
Tāruatanga ihirangi: Ka tukatuka tētahi ratonga ContentIndexer i ngā ihirangi hou me ngā ihirangi kua whakahōutia ki roto i te putunga pūwāhanga. Ka whakaute te tāruatanga i ngā rohe whakaaetanga — kāore ngā ihirangi kāore i tohatohahia mō te whakamahinga AI e tāruatia ana.
Te Pipelini ** Guardian Agent **
Ka puta ia whakautu AI mā ngā paparanga whakamātau whakautu e whā i mua i tōna tae atu ki te kaiwhakamahi. Kua whakatinanahia te pipelini i roto i te src/services/guardians/ ā, kāore tōna hanganga e whakawhirinaki ki te tauira whakaputa.
Papanga 1: AccuracyVerifier
- Ka whakauru i te whakautu a te tauira, ka tatau i te ōritetanga kōsini ki ngā tuhinga taketake i tiki mō te pātai
- Ka tohu i ngā whakautu kei raro iho i tētahi pae ōritetanga ka taea te whakarite
- Ka whakarato i tētahi tohu tūāpapa hei whāngai ki te tohu māia e kitea ana e te kaiwhakamahi
- Herenga kua mōhiotia: He ine tata ā-aronga te ōritetanga kōsini, ehara i te whakamana tika ā-pono. Ka taea e ngā rerenga kōrero e rua te tata ā-aronga ahakoa he rerekē ā rātou taipitopito matua.
Papanga 2: Kaiwhakatau Whakamatapae
- Ka wehewehe i ngā whakautu ki ngā kerēme takitahi
- Ka whakamana ia kerēme motuhake ki te kohinga pūtake
- Ka tohu i ngā kerēme takitahi kāore he turanga, ahakoa kei roto i ngā whakautu kua tino tautokona
- Herenga kua mōhiotia: Ka whakamahi te wehenga o ngā kerēme i te whakamātau tauira reo, ā, ka whakauru i te whakawhirinaki ki ngā āheinga o te tauira. Mēnā kāore i te tika te wehenga o ngā kerēme, ka puta pea he hē-kore.
Papanga 3: AnomalyDetector + PressureMonitor
- E aroturuki ana i ngā āhuatanga tohatoha o ngā putanga tauira i te wā
- E kitea ana te rereke o te rārangi kupu, ngā āhuatanga rerekē o ngā kaupapa, me ngā panonitanga āhuatanga o ngā whakautu
- E aroturuki ana te PressureMonitor i ngā tikanga whakamātau: te roa o te horopaki, te matatini o te pātai, te kawenga mahi i te wā kotahi
- I raro i te pēhanga nui ake, ka whakakaha ake ngā pae whakamana, ā, ka whakaitia ngā taumata māia
- Herenga kua mōhiotia: Mō te kitenga hē, me whai wā tūāpapa. Mō ngā mema hou he iti tō rātou hītori whakawhitinga kōrero, he ngoikore te tūāpapa, ā, kāore e tino whai hua te kitenga hē.
Papanga 4: KaiArotakeWhakautu + KaiAroturukiHuringa + Urupare Whaiwhakarite
- Ka tukatuka i ngā urupare a ngā mema (ngā tohu ringaringa-raro, ngā whakatikatika a te kaiwhakahaere)
- Ka whakarōpū a RootCauseClassifier i ngā momo hapa
- Ka tirotiro a FeedbackInvestigator mēnā e tohu ana ngā hapa i ngā tauira pūnaha
- Ka aroturuki a RegressionMonitor mēnā ka hoki mai anō ngā momo hapa i whakatikahia i mua
- Ka waihanga a TrainingPairGenerator i ngā raraunga whakangungu mai i ngā whakatikatika kua whakauhia mō ngā huringa whakangungu taipitopito ā muri ake nei
- Herenga kua mōhiotia: E whakawhirinaki ana te porowhita urupare ki te whai wāhi a ngā mema. Kāore e nui ana te tohu e puta mai i ngā hapori he iti te rōrahi urupare, ā, kāore e taea te kite i ngā tauira whai tikanga.
Tiaki I mua i te Whakapae
Ka mahi te PreInferenceProtector i mua i te whakaputa, e tātari ana i ngā urunga mō ngā tauira werohanga, ā, ka whakatere tika i ētahi momo pātai ki te arotake a te tangata. He tātari tūpato tēnei — he hē tōna ki te aukati — ā, he motuhake i te putorino Guardian i muri i te whakaputa.
Ngā Mahi e Taea ana e te Pūnaha i Tēnei Rā
Whakautu pātai e hāngai ana ki te hapori. Mēnā ka tukuna he pātai mō ngā ihirangi hapori ("Ahea te hui ā-komiti whakahaere e whai ake nei?", "He aha tā te minita matua i kī mō te pūtea whare?"), ka tiki te pūnaha i ngā tuhinga hāngai, ā, ka waihanga i tētahi whakautu e hāngai ana ki aua ihirangi. Ki te kore e kitea he tuhinga hāngai, ka tohu te pūnaha i tēnei āhuatanga, kaua e waihanga i runga i ngā tūmanako o te tauira pūtake.
Āwhina tuhi tuatahi. Ka taea e te pūnaha te waihanga i ngā pānui tuatahi, ngā pānuitanga, me ngā reta e whakaata ana i te āhua reo me ngā kupu a te hapori. Ka arotakehia ngā tuhinga tuatahi katoa e tētahi kaiwhakahaere i mua i te whakaputa.
Whakarāpopototanga tuhinga. Ka taea te whakarāpopoto i ngā tuhinga roa (pēnei i ngā meneti hui o te komiti whakahaere, ngā tuhinga kaupapa here) mā te tango i ngā kōrero matua.
Tautoko whakamāori. E tautoko ana te papanga i ngā reo e rima: te reo Ingarihi, te reo Tiamana, te reo Wīwī, te reo Holani, me te reo Māori. Ka whakamahi te whakamāori i a DeepL (ehara i te tauira whakaputa) hei whakarite i te tika.
Te whakarōpūtanga urupare. Ka whakarōpū aunoa i ngā urupare a ngā mema, ka tirotirohia mēnā ka taea, ā, ka tukuna ki te kaiwhakahaere e tika ana. Ko te HelpFeedbackSweepService me te GeneralFeedbackProcessor e whakahaere ana i te tirotiro me te whakatau aunoa.
OCR me te tukatuka tuhinga. Ko te ratonga DocumentExtractor e tukatuka ana i ngā tuhinga kua karapahia, kia taea ai te rapu i ā rātou ihirangi, ā, kia wātea hoki mō te tiki RAG.
Pūnaha Kupu
Ka urutau te pūnaha kupu (product-vocabularies.js, vocabulary.js) i ngā kupu motuhake o te tūāpapa ki te momo hapori. Ka mahi tēnei i ngā taumata e rua:
Taumata atanga: Ka whakakapia ngā tapanga UI, ngā kupu whakatere, me ngā ingoa āhuatanga ki ngā kupu e hāngai ana ki te rohe. Ka kite te pārihi Ēpīkopa i ngā kupu pērā i te "kai-pārihi", te "whakahaere whare-pārihi", me te "panui pārihi" hei utu mō ngā kupu motuhake whānui o te tūāpapa.
Taumata tauira: Ka āhua te kupu ki te horopaki e whakaratohia ana ki te tauira. Ina kī te pūnaha i te kupu "parishioners" (ngā mema o te pārihi) hei utu mō te "users" (kaiwhakamahi) i te horopaki o te tono, ka whakaata te putanga a te tauira i taua anga. He pokanoa māmā tēnei — ka mahi i te taumata tono, ehara i te taumata taumaha — engari ka whakaiti i te aukatinga i waenga i ngā tūāpapa tohatoha o te tauira me ngā kupu a te hapori.
E iwa ngā momo hua kua tautuhia: hapori, whānau, tiaki taiao, diaspora, karapu, pakihi, alumni, whānau, me te epikopā. He mapi kupu motuhake tō ia.
Ngā Mea Kāore Anō kia Whakamana
Ka whakarārangihia e mātou ngā kerēme motuhake kāore anō kia whakamanahia:
Guardian Agent: te whai hua i raro i ngā āhuatanga taupatupatu. Kāore te pūnaha i whakamātauria mā te whakamātau whakatumatuma ā-tukatuka. Kāore i te mōhiotia te mahi a te Guardian Agent i raro i te whakahau taupatupatu, ngā ngana whai whakaaro ki te whakaputa i ngā moemoeā, me ngā whakaeke werohanga kua whakaritea.
Whānuitanga o te paparanga motuhake. Kua whakamahia te motuhaketanga Ēpīkopa (villageai-8b-episcopal-v2) mō tētahi momo hua. Kāore i whakamātauria mā te rangahau pūtaiao mēnā ka whānui pai te rautaki Papanga Motuhake ki ētahi atu rohe (pērā i te taiao tiaki, ngā horopaki ahurea o te reo Māori, te whakapapa whānau).
Whakatikatika pae taurite cosine. I tautuhia ngā pae taurite i whakamahia e te AccuracyVerifier i runga i ngā whakamātautau whakawhanake me ngā wheako o te tīmatanga o te whakaputanga. Kāore ēnei i whakapaihia mā te aromatawai pūnaha ki tētahi huinga raraunga kua tapaina, e whai ana i ngā whakautu e ū ana ki te ao tūturu me ngā whakautu kāore i pērā.
Te pumau o te tohatoha mō te wā-roa. Kua tata ki te rima marama te roa o te pūnaha e whakaputahia ana. Kāore anō kia kitea i roto i te roanga o te wā e tika ana kia taea te whakatau mēnā ka whakahoki anō ngā priors o te tauira pūtake i a rātou anō i te haere o te wā — arā, te huri pōturi ki te tohatoha whakangungu ahakoa te whakapai ā-taiao (fine-tuning) —.
Whakamana whakawhiti-ā-reo. Mō ngā hapori e whakamahi ana i ētahi atu reo kē atu i te reo Ingarihi, ka whakahaere te ara Guardian Agent i runga i ngā whakaurunga o ngā tuhinga kāore i te reo Ingarihi. Kāore anō kia aromatawaihia ā-tukatuka mēnā he ōrite te whaihua o te whakamana ōritetanga kōsini puta noa i ngā reo.
Te whakakotahitanga o te porowhita urupare. Kua hoahoatia te pūnaha urupare urutau (Papanga 4) kia whakapai ake i te whanonga o te pūnaha i te wā. Kāore anō kia tātaritia ā-ture mēnā ka whakakotahi ki tētahi mahinga pumau, kua pai ake rānei, ka whakaatu rānei i te whanonga huri haere, wehe haere rānei i raro i ētahi tauira urupare.
E whakaatu ana mātou i ēnei ehara i te mea he whakaroa, engari hei pātai tuwhera. Kei te whakahaere te pūnaha; kāore ēnei pātai i whakautua.
Hanganga
- Tūmau taupānga: OVH France (ture raraunga EU)
- Pūnaha raraunga: MongoDB me te wehewehe kiritaki tino pakari (ka tātarihia ia uiui e te tenantId)
- Pātaka wīra: Qdrant (kohinga ā-kiritaki)
- Tātaritanga GPU: AMD RX 7900 XTX mā WireGuard VPN
- Hokinga ki te CPU: Tauira 3B kua whakaitihia hei wātea
- Tautuhinga: pihikete httpOnly, wehewehenga horopaki kaipā, kāore he uru tūmatanui
- Whakaurunga: Whakahaere-ā-roto, kāore he ratonga AI kapua a ētahi atu
- Pāpāho: Bunny CDN mō te penapena pito whatunga (tūmau OVH)
Ka tū katoa ngā whakamātau tauanga i roto i ngā hanganga o te kaiwhakahaere. Kāore he whakahau, he whakautu, he ihirangi hapori rānei e tukuna ki ngā kaiwhakarato AI tuatoru.
Ko tēnei te Tuhinga 4 o te 5 i te raupapa "Architectural AI Governance at Community Scale". Mō te hanganga hangarau katoa, tirohia Village AI on Agentic Governance.
I mua: He aha te take i rahua ai te Whakahaere i te wā Whakangungu — Ngā here hanganga hei huarahi kē E whai ake: I tua atu i te Tauira — Hanganga Pūrama me te Whakaurunga Whakahaere