Jenga Kumbukumbu Imara, Zenye Aina kwa Wakala wa AI ukitumia loci

loci ni nini?

loci ni safu yenye aina maalum ya kumbukumbu ya muda mrefu kwa mawakala wa AI. Hutoa hoja za kudumu kutoka kwenye mazungumzo, huzihifadhi katika SQLite, huzipanga kwa ajili ya kukumbukwa baadaye, na huondoa taarifa ambazo hazina manufaa tena.

Mradi huu unatokana na wazo kwamba kumbukumbu zinahitaji mahali na muundo. Badala ya kuchukulia kila taarifa iliyohifadhiwa kwa njia ileile, loci hutofautisha mapendeleo, makataa, malengo, mahusiano, na aina nyingine za taarifa ili ziweze kufuata mizunguko ya maisha inayofaa.

loci ilihamishwa kutoka kwenye mfumo wa kumbukumbu unaotumiwa katika uzalishaji na Lima, kisha ikaandikwa upya ili ijitegemee bila programu mahususi ya mwenyeji.

Jinsi mfumo wa kumbukumbu unavyofanya kazi

Kumbukumbu zenye aina

Kila kumbukumbu ni ya mojawapo ya kategoria nane:

• routine
• study
• preferences
• finance
• goals
• relationships
• constraints
• ephemeral

Kumbukumbu pia zina viwango vinne vya umuhimu na mzunguko wa hali. Muundo huu huiwezesha mfumo kushughulikia upendeleo wa kudumu kwa njia tofauti na makataa ya muda au taarifa ya muda mfupi.

Njia mbili za uchanganuzi

Uchanganuzi unachanganya mbinu mbili. Kichanganuzi kinachotegemea modeli husoma mazungumzo ili kuelewa maana, huku mbinu za heuristiki za usemi wa kawaida zikigundua miundo ya maneno inayoungwa mkono waziwazi. Matokeo huunganishwa, huku matokeo ya modeli yakiwa na kipaumbele.

Njia ya regex inaweza kuendelea kufanya kazi wakati mtoa huduma wa modeli hayapatikani. Miito ya modeli, SDK za watoa huduma, na funguo za API zimeachwa kimakusudi kwa programu mwenyeji, ambayo inaweza kuingiza ModelExtractor.

Uchujaji, upangaji na kudhoofika

Kichujio cha uandishi huzuia hisia za muda na kauli nyingine za muda mfupi kuwa data ya kudumu ya wasifu. Kwa mfano, kauli kama “Nimechoka leo” inaweza kuwa ya kweli kwa saa chache lakini ikapotosha baada ya miezi kadhaa.

Kumbukumbu zinapoongezwa kwenye muktadha wa modeli, loci huweka matokeo kwenye upeo wa hoja kumi na mbili. Huzipanga kwa umuhimu, kisha huzingatia ukaribu wa makataa na uchangamfu wa taarifa. Kikomo hiki huzuia kidokezo kukua bila kikomo.

Ujumuishaji na kudhoofika kwa kila siku huufanya uhifadhi uwe na manufaa:

• Nakala zinazofanana kabisa huunganishwa.
• Makisio yasiyothibitishwa huisha hatimaye.
• Hoja za muda zina muda wa kuishi wa saa 24.
• Malengo yaliyokamilishwa huisha baada ya siku 90.

Chagua muunganisho

loci hutoa kiini kimoja cha pamoja na adapta mbili.

Seva ya MCP

Adapta ya MCP hufanya kazi na mteja yeyote wa MCP anayeoana. Hutoa zana tatu: remember, recall, na forget.

MCP hutegemea maombi na majibu, kwa hiyo haina ndoano ya kiotomatiki ya mwisho wa zamu. Wakala lazima aitumie remember kwa makusudi. Kumbukumbu inaweza kukumbukwa na kuingizwa kwenye muktadha inapohitajika.

Programu-jalizi ya Hermes

Adapta ya Hermes hutoa zana hizo tatu pia, lakini inaunga mkono uchanganuzi wa kiotomatiki na huingiza muktadha kabla ya kila mwito. Hili linawezekana kwa sababu Hermes hutoa ndoano ya post_llm_call inayoweza kukagua mazungumzo baada ya modeli kujibu.

Muunganisho wa moja kwa moja wa Python

Tumia maktaba kuu moja kwa moja unapodhibiti mzunguko wa wakala na unataka kuamua wakati wa uchanganuzi, uhifadhi, kumbukumbu, na uingizaji wa muktadha kutokea.

Usakinishaji na usanidi

Sakinisha kifurushi cha msingi

pip install mowave-loci

Sakinisha usaidizi wa MCP

pip install mowave-loci[mcp]

Baada ya kusakinisha nyongeza ya MCP, ongeza loci kwenye usanidi wa mteja wako wa MCP:

{
  "mcpServers": {
    "loci": {
      "command": "python",
      "args": ["-m", "loci.adapters.mcp_server.server"]
    }
  }
}

Anzisha upya au pakia upya mteja ili ugundue zana za remember, recall, na forget.

Sakinisha programu-jalizi ya Hermes

hermes plugins install <you>/loci
hermes plugins enable loci

Badilisha <you>/loci na hazina inayofaa ya programu-jalizi au chanzo kinachotumika kwa usakinishaji wako.

Sanidi hifadhi

Kwa chaguo-msingi, loci huhifadhi kumbukumbu katika hifadhidata ya SQLite iliyo kwenye ~/.loci/memory.db. Weka kigezo cha mazingira cha LOCI_DB ili kutumia faili tofauti.

export LOCI_DB=/path/to/memory.db

Hakuna seva tofauti ya hifadhidata inayohitajika.

Matumizi ya msingi katika Python

Mtiririko mkuu wa kazi ni kuunda hifadhi, kutoa kumbukumbu zinazowezekana, kuzichuja, kuhifadhi kumbukumbu zinazokubaliwa, na kuongeza kumbukumbu hai kwenye kidokezo cha mfumo.

from loci import Store, extract, should_persist, context_block

store = Store()

for memory in extract(
    "eu prefiro respostas curtas",
    assistant_text=reply,
):
    if should_persist(memory):
        store.upsert(memory)

system_prompt += "\n\n" + context_block(store.active())

Katika mfano huu, reply inawakilisha maandishi ya msaidizi yanayohusishwa na mazungumzo hayo. Ujumbe wa mtumiaji kwa Kireno unamaanisha kwamba mtumiaji anapendelea majibu mafupi.

1. Store() hufungua hifadhi ya kumbukumbu ya SQLite iliyosanidiwa.
2. extract(...) hutengeneza kumbukumbu zinazowezekana kutoka kwenye mazungumzo.
3. should_persist(memory) hutumia kichujio cha uandishi.
4. store.upsert(memory) huingiza au kusasisha kumbukumbu iliyokubaliwa.
5. store.active() hupata kumbukumbu hai.
6. context_block(...) hupangilia kumbukumbu hizo kwa ajili ya kuziingiza kwenye kidokezo.

Kutumia zana za MCP

Baada ya seva ya MCP kusanidiwa, wakala aliyeunganishwa anaweza kutumia shughuli tatu:

• remember: hifadhi kwa makusudi ukweli unaopaswa kudumu.
• recall: pata taarifa zilizohifadhiwa zinapohusika.
• forget: ondoa taarifa ambazo hazipaswi kuhifadhiwa tena.

Kwa kuwa adapta ya MCP haitoi kumbukumbu kiotomatiki, maagizo ya wakala yanapaswa kuweka wazi wakati wakala anatarajiwa kuita remember. Usidhani kwamba kila zamu ya mazungumzo iliyokamilika itakaguliwa na kuhifadhiwa.

Vidokezo vya ujumuishaji wa hali ya juu

Weka mantiki ya mtoa huduma nje ya kiini

Kiini cha loci kinatumia tu maktaba ya kawaida ya Python. Programu yako inamiliki miito ya modeli, funguo za API na SDK za watoa huduma. Ikiwa uchanganuzi wa kisemantiki unahitaji modeli, ingiza ModelExtractor kutoka kwa mwenyeji badala ya kuongeza utegemezi wa watoa huduma kwenye kiini.

Endesha kazi za mzunguko wa maisha kutoka kwa mwenyeji

loci hufafanua muundo wa kumbukumbu, uunganishaji na tabia ya kupungua kwa umuhimu, lakini haipangi kazi za kila siku. Tumia cron, s6, systemd ya mwenyeji au kipangaji sawa kuanzisha kazi za kila siku.

Hifadhi kikomo cha muktadha

Epuka kupita kwenye kizuizi cha muktadha kilichopangwa kwa kuongeza hifadhidata yote kwenye kila ombi. Kikomo cha mambo kumi na mawili kipo kudhibiti ukuaji wa muktadha huku kikipa kipaumbele taarifa muhimu, zinazofaa kwa wakati huo na za hivi karibuni.

Tumia adapta inayofaa

• Chagua MCP wakati uwezo wa kubebeka kati ya wateja wa MCP ni muhimu na shughuli za kumbukumbu zilizo wazi zinakubalika.
• Chagua Hermes unapotaka uchukuaji wa kiotomatiki baada ya miito ya modeli na kuingizwa kwa kumbukumbu kabla ya kila mwito.
• Chagua API ya moja kwa moja ya Python wakati programu yako inamiliki mzunguko wa wakala na inahitaji udhibiti sahihi wa uhifadhi na uundaji wa maombi.

Mwache mwenyeji adhibiti usafirishaji na vipindi

Mzunguko wa wakala, usambazaji wa zana, vipindi, usafirishaji na uthibitishaji viko nje ya wajibu wa kiini. Wenyeji kama Hermes, OpenClaw au Claude Code hudhibiti mazingira ya wakati wa utekelezaji, huku adapta zikishughulikia usafirishaji na uthibitishaji mahususi wa mwenyeji.

Endesha mkusanyiko wa majaribio

pytest -q

Mradi una majaribio 92 yanayoendeshwa dhidi ya hifadhi halisi ya SQLite katika faili la muda. Hifadhi yenyewe haiigwi, jambo linalosaidia kuthibitisha tabia dhidi ya teknolojia ileile ya uhifadhi inayotumika katika uwekaji halisi.

Hitimisho

loci huwapa mawakala wa AI safu ya kumbukumbu fupi, yenye aina zilizobainishwa na inayodumu bila kuhitaji seva tofauti. Kiini chake cha pamoja hushughulikia muundo wa kumbukumbu na mzunguko wa maisha, huku MCP, Hermes au wakala wako wa Python ukitoa mazingira yanayozunguka. Anza na adapta inayolingana na mwenyeji wako, weka wazi majukumu ya uchukuaji na upangaji, na utumie uingizaji wa muktadha uliopangwa ili kuzuia kumbukumbu kuzidi ombi.