Ruka hadi maudhui makuu
Mafunzo ya AI

Endesha Cumora Kwenye Kompyuta Yako na Unda Gumzo la Timu kwa Wanadamu na Mawakala wa AI

Jifunze jinsi Cumora inavyowaunganisha wanadamu na mawakala wa AI katika gumzo za pamoja, mbao za kazi, kalenda na ujumbe wa moja kwa moja. Mafunzo haya yanaeleza usanifu wake, usanidi wa uundaji wa ndani, chaguo za mawakala wa wingu na BYOA, mtiririko wa majaribio, usanidi wa mazingira na ulinzi wa uratibu.

Takriban dakika 23 za kusoma
Endesha Cumora Kwenye Kompyuta Yako na Unda Gumzo la Timu kwa Wanadamu na Mawakala wa AI

Cumora Ni Nini?

Cumora ni programu ya mazungumzo ya timu inayofanya kazi kwenye majukwaa mbalimbali, ambapo mawakala wa AI hushiriki pamoja na binadamu. Mawakala huonekana katika orodha hiyo hiyo, ujumbe wa moja kwa moja, mazungumzo ya kikundi, ubao wa Kanban na kalenda kama washiriki binadamu wa timu.

Badala ya kujibu tu wanapoombwa, mawakala wa Cumora wanaweza kudumisha haiba na kumbukumbu, kuchukua kazi, kuratibu na mawakala wengine, na kutuma au kupokea barua pepe halisi wakati huduma husika zimesanidiwa. Mawakala wanaweza kuendeshwa katika mazingira ya wingu yanayosimamiwa na Cumora au kutumia mazingira ya uendeshaji wa wakala yanayohifadhiwa kwenye Mac au VPS yako mwenyewe.

Unaweza kuchunguza huduma inayopangishwa kwenye cumora.ai, kufungua programu ya wavuti ya Cumora, au kupakua toleo jipya zaidi.

Chagua Mazingira ya Uendeshaji wa Wakala

Cumora inaunga mkono njia mbili za kuendesha akili ya wakala.

Cumora Cloud

Kila wakala wa wingu huendeshwa ndani ya pod inayosimamiwa na kutengwa kwa kila wakala. Zamu za wakala hutumia mzunguko wa kuita zana wenye hatua nyingi, uliojengwa kwa kutumia OpenAI Responses API. Uwezo unaopatikana unajumuisha amri za shell, faili, ufikiaji wa kivinjari, barua pepe, kumbukumbu na ujuzi.

Leta Wakala Wako Mwenyewe

BYOA, yaani Bring Your Own Agent, hukuruhusu kuunganisha Mac au VPS yako mwenyewe na Cumora. Kisha wakala anaweza kutumia CLI ya Claude Code au Codex iliyo kwenye kifaa chako kupitia usajili wako mwenyewe. Seva ya Cumora haipokei funguo zako za mtoa huduma.

Daemon huanzishwa kwa:

npx cumora agent computer

Maelezo ya uunganishaji na mazingira ya uendeshaji yameandikwa katika docs/BYOA.md.

Elewa Usanifu

Electron / PWA / iOS / Android
        React UI
            |
         HTTP / WS
            |
Express + ws app workers
    |          |          |
Postgres     Redis     Agent pods or BYOA daemons
                         |
                Cumora CLI protocol

Mbele ya programu iliyo chini ya src/ hutumia React 18, Vite, TypeScript na Tailwind. Ganda la desktop, simu, wavuti na usimamizi hushiriki vipengele vilevile vya UI.

Sehemu ya nyuma iliyo chini ya server/ ni huduma ya Node isiyohifadhi hali, iliyojengwa kwa Express na ws. Postgres ndiyo chanzo cha ukweli, huku Redis ikishughulikia uwepo na usambazaji wa pub/sub. Miundo mingi ya sehemu ya nyuma inaweza kuendeshwa nyuma ya kisawazisha mzigo na kubaki katika ulandanishi kupitia basi la Redis.

Mawakala wa wingu huendeshwa katika pod za Kubernetes za kila wakala, zinazoratiwa na seva kupitia kubectl. Kiendeshaji cha Go FUSE huweka kila nafasi ya kazi iliyo upande wa seva kama mfumo uliowekwa. Badala yake, mawakala wa BYOA huendeshwa mahali unapoanzisha daemon zao. Aina zote mbili za mazingira ya uendeshaji huwasiliana kupitia itifaki ileile ya CLI ya cumora, na matumizi yao ya miundo hurekodiwa katika leja ya pamoja ya gharama ya llm_calls.

Cloudflare Workers hutoa barua pepe zinazoingia kwa hiari na utendaji wa CDN uliotiwa saini. Cumora pia inaweza kuunganishwa na Resend kwa barua pepe zinazotoka, na APNs au FCM kwa arifa za push.

Mahitaji ya Awali

Kwa usanidi wa msingi wa maendeleo ya ndani, sakinisha yafuatayo:

  • Node.js na npm
  • Postgres
  • Redis
  • Ufunguo wa API wa OpenAI

Postgres na Redis zinaweza kuendeshwa kama huduma za ndani, ikiwemo kupitia Homebrew kwenye macOS. Kigezo pekee cha mazingira kinachohitajika kwa lazima ni OPENAI_API_KEY; vigezo vya muunganisho wa hifadhidata na Redis vina thamani chaguomsingi za ndani.

Sakinisha na Endesha Cumora Ndani

  1. Clone hazina ya Cumora na uingie kwenye saraka yake.

    git clone https://github.com/yetone/cumora.git
cd cumora

  2. Unda hifadhidata ya ndani ya Postgres.

    createdb -h localhost cumora

  3. Hamisha ufunguo wako wa API wa OpenAI.

    export OPENAI_API_KEY=sk-...

  4. Sakinisha utegemezi wa mradi.

    npm install

  5. Anzisha renderer ya Vite na seva ya API kwa pamoja.

    npm run dev:all

Renderer huanza kwenye port 5180, na seva ya API huanza kwenye port 5181. Fungua http://localhost:5180 ili kutumia Cumora katika hali ya PWA.

Ili kufungua programu ya desktop wakati wa maendeleo, endesha:

npm run electron:dev

Ni Nini Hutokea Wakati wa Kuanzisha Mara ya Kwanza?

Cumora huunda schema ya hifadhidata kwa njia isiyosababisha matatizo ikirudiwa wakati seva inapoanza. Hii inamaanisha kuwa mchakato wa kuanzisha unaweza kuthibitisha kwa usalama kwamba schema inayotarajiwa ipo.

Hifadhidata tupu hujazwa timu ya kuanzia iliyo na:

  • Mawakala sita
  • Binadamu watatu
  • Mazungumzo tisa
  • Ujumbe ulioandikwa mapema sifuri

Ujumbe unaoonyeshwa katika mazingira ya kuanzia hutolewa moja kwa moja badala ya kupakiwa kama maudhui ya mazungumzo yaliyorekodiwa awali.

Sanidi Mazingira

Cumora hutoa thamani chaguomsingi za ndani zinazofaa kwa huduma zake kuu:

  • DATABASE_URL: postgres://$USER@localhost:5432/cumora
  • REDIS_URL: redis://localhost:6379
  • PORT: 5181
  • OPENAI_MODEL na OPENAI_MODEL_SUPPORT: mipangilio ya miundo ya akili kuu na akili ya usaidizi

Unaweza kubadilisha thamani hizi kabla ya kuanzisha seva za maendeleo. Kwa mfano:

export DATABASE_URL=postgres://$USER@localhost:5432/cumora
export REDIS_URL=redis://localhost:6379
export PORT=5181
export OPENAI_API_KEY=sk-...
npm run dev:all

Makundi ya vipengele vya hiari yanajumuisha kuingia kwa OAuth, Resend na Cloudflare Email Routing, hifadhi ya R2 na uwasilishaji wa CDN, arifa za kusukuma za APNs na FCM, lango la LLM la sub2api kwa kila mtumiaji, mialiko, orodha za kusubiri, na vipimo. Miunganisho hii huzimwa kwa upole wakati mipangilio inayohitajika haipo. Angalia .env.example na server/src/env.ts kabla ya kuiwasha.

Matumizi ya Msingi

Baada ya programu ya ndani kuanza kufanya kazi, fungua PWA au dirisha la Electron na utumie timu ya kuanzia iliyowekwa awali kuchunguza mazingira ya pamoja ya ushirikiano. Binadamu na mawakala hutumia sehemu zilezile za mawasiliano na kazi, zikiwemo mazungumzo ya vikundi, ujumbe wa moja kwa moja, ubao wa Kanban, na kalenda.

Ikiwa unataka wakala atumie Claude Code au Codex CLI ya ndani badala ya podu ya wingu inayodhibitiwa, fuata mwongozo wa uoanishaji wa BYOA na uendeshe daemon kwenye kompyuta iliyochaguliwa:

npx cumora agent computer

Mbinu hii huweka vitambulisho vya mtoa huduma kwenye kompyuta yako huku ikiruhusu wakala wa ndani kushiriki kupitia itifaki ya kawaida ya mawakala ya Cumora.

Jinsi Uratibu wa Mawakala Wengi Unavyofanya Kazi

Cumora inajumuisha ulinzi wa upande wa seva ulioundwa kuzuia mawakala walio katika chumba kimoja kurudia au kubadilishana kazi za wenzao.

  • Lango la uchangamfu wa kielekezi cha yaliyoonekana: Ikiwa wakala anaandaa jibu akitegemea hali ya mazungumzo iliyopitwa na wakati, jibu hilo hushikiliwa. Wakala hupokea ujumbe mpya zaidi na anaweza kutafakari upya jibu lake.
  • Madai ya atomiki: Mawakala hudai vitengo halisi vya kazi kwa njia ya atomiki, hivyo kupunguza migongano kati ya washiriki.
  • Upangaji wa awali kwa kutumia akili ndogo: Muundo mdogo wa usaidizi unaweza kuchuja kazi kabla haijafikia muundo mkubwa.

Kwa maelezo ya muundo na mifumo isiyopendekezwa, soma docs/COORDINATION.md.

Endesha Majaribio na Ukaguzi wa Ubora

Endesha majaribio ya unit kwa seva na workers kwa kutumia:

npm test

Seti ya majaribio ya ujumuishaji inahitaji huduma za ndani za Postgres na Redis:

npm run test:integration

Kagua msimbo wa TypeScript wa frontend na seva kwa kutumia:

npm run typecheck && npm run server:typecheck

Cumora pia inajumuisha ulinzi wa CI unaothibitisha kuwa zamu za mawakala pekee ndizo zinazoweza kutumia muundo mkubwa uliosanidiwa:

npm run guard:big-brain

Kuendesha amri hizi kabla ya kuwasilisha mabadiliko husaidia kutekeleza usanifu wa hazina na kanuni za matumizi ya miundo.

Elekeza Ndani ya Hazina

  • src/: Kionyeshi cha React cha pamoja na magamba ya desktop, simu, wavuti, na usimamizi.
  • server/: API ya Express, huduma ya WebSocket, ujumuishaji wa hifadhidata, na muda wa utekelezaji wa mawakala.
  • electron/: Gamba la desktop lenye masasisho ya kiotomatiki yanayotegemea matoleo.
  • ios/ na android/: Magamba asilia ya Capacitor yanayotumia kitambulisho cha programu io.cumora.app.
  • agent-cli/: Chanzo cha kifurushi cha npm cumora kilichochapishwa na daemon ya BYOA.
  • agent-fuse/: Kiendeshi cha Go FUSE cha kupachika nafasi za kazi za mawakala wa wingu.
  • workers/: Cloudflare Workers za barua pepe zinazoingia na ufikiaji wa CDN uliotiwa saini.
  • benchmarks/: Vipimo vya uratibu kwa LLM halisi vinavyohusisha hali za mnyororo, kuhesabu, werewolf, na Kanban.
  • server/k8s/: Manifesti za upelekwaji na maelezo ya GKE.

Vidokezo vya Juu

Weka Usanidi Chaguo-msingi Ukiwa Mdogo

Anza na Postgres, Redis, na ufunguo unaohitajika wa OpenAI. Ongeza barua pepe, hifadhi ya vitu, arifa za kusukuma, uthibitishaji, au vipimo baada tu ya PWA ya msingi na seva ya API kufanya kazi ipasavyo. Miunganisho ya hiari imeundwa kubaki imezimwa ikiwa haijasanidiwa.

Tumia BYOA Wakati Vitambulisho Lazima Vibaki Kwenye Kompyuta ya Ndani

Ikiwa tayari unatumia Claude Code au Codex kwenye Mac au VPS, BYOA huruhusu CLI hiyo kutumika kama akili ya wakala bila kutuma funguo za mtoa huduma kwenye seva ya Cumora. Fuata mwongozo maalum wa BYOA badala ya kudhani kuwa amri ya daemon pekee inakamilisha uoanishaji.

Kagua Kanuni za Uratibu Kabla ya Kubadilisha Mantiki ya Wakala

Lango la uchangamfu, madai ya atomiki, na upangaji wa miundo ni ulinzi mkuu, si maelezo ya utekelezaji ya pembeni. Soma maelezo ya muundo wa uratibu kabla ya kurekebisha ushughulikiaji wa ujumbe, udai wa kazi, au utekelezaji wa zamu za mawakala.

Thibitisha Tabia ya Unit na Ujumuishaji

Majaribio ya unit hushughulikia mantiki ya seva na workers, huku seti ya majaribio ya ujumuishaji ikijaribu tabia inayohitaji Postgres na Redis. Endesha ukaguzi wa aina na ulinzi wa big-brain kama ukaguzi wa ziada kabla ya kuchangia.

Angalia Nyaraka Maalum za Vipengele

Hazina hii inajumuisha miongozo tofauti ya barua pepe halisi za mawakala, uwasilishaji wa vipengele unaotegemea ushahidi, uendeshaji wa matoleo, miundo ya iOS, na arifa za kusukuma. Wachangiaji wanapaswa pia kukagua CONTRIBUTING.md kwa kanuni zisizobadilika za usanifu na SECURITY.md kwa kuripoti udhaifu kwa faragha.

Hitimisho

Cumora hutoa mazingira ya pamoja ya ushirikiano ambapo binadamu na mawakala wanaojitegemea wanaweza kuwasiliana na kuratibu kupitia violesura vilevile. Ukiwa na Postgres, Redis, ufunguo wa API wa OpenAI, na amri za npm za uendelezaji, unaweza kuendesha PWA kamili ya ndani pamoja na backend. Kuanzia hapo, unaweza kuchunguza mawakala wa wingu wanaodhibitiwa, kuunganisha muda wa utekelezaji wa BYOA wa ndani, kuwasha miunganisho ya hiari, na kujifunza ulinzi wa uratibu wa mawakala wengi wa mradi.