1 Utangulizi & Matoleo

DeepCerebra Coder ni msaidizi wa kuandika msimbo wakala. Tofauti na copilot rahisi ya kukamilisha kiotomatiki, hupanga, huandika, hurekebisha, huendesha amri, huita zana, na hurudia katika mradi wako wote — huku wewe ukikagua na kuidhinisha mabadiliko inayopendekeza.

Njia tatu za kuitumia

Mwongozo huu unazingatia programu ya wavuti kwenye deepcerebra.ai; programu ya kompyuta ya mezani inaakisi paneli na mtiririko wa kazi sawa.

2 Kuanza & Akaunti

Vivinjari vinavyotumika

Tumia toleo la sasa la Chrome, Edge, au Brave kwa uzoefu kamili — kufungua folda ya ndani kunategemea API ya Ufikiaji wa Mfumo wa Faili wa Chromium. Firefox na Safari hufanya kazi kwa gumzo na miradi inayoungwa mkono na Git, lakini haziwezi kufungua folda ya ndani moja kwa moja.

Fungua akaunti

1. Bofya Anza kwenye ukurasa wa kutua.
2. Jaza jina la kuonyesha lako la hiari, barua pepe, nchi, na tarehe ya kuzaliwa (lazima uwe na umri wa miaka 18 au zaidi).
3. Chagua lugha ya kiolesura chako na nenosiri la angalau herufi 12.
4. Soma ilani ya makubaliano na uthibitishe. Kuunda akaunti kunamaanisha unakubaliana na Masharti ya Huduma, Taarifa ya Faragha, Maelezo ya Huduma, na DPA ya Kimataifa.
5. Bofya Fungua akaunti, kisha thibitisha barua pepe yako ikiombwa, na uingie.

Weka upya nenosiri lako

1. Kwenye ukurasa wa kuingia, bofya Umesahau nenosiri?
2. Weka barua pepe yako na ufungue kiungo cha kuweka upya kilichotumwa kwenye kikasha chako.
3. Weka nenosiri jipya (angalau herufi 12).

3 Muhtasari wa Eneo Kazi

Baada ya kuingia utatua kwenye eneo la kazi, ambalo huweka kila kidirisha kwenye skrini moja:

• Kichunguzi (kushoto) — mti wa faili kwa mradi uliofunguliwa, na kitufe cha kuonyesha upya na kufunga.
• Kihariri (katikati) — yaliyomo kwenye faili na kuangazia sintaksia na muhtasari wa minimap; tofauti za ndani huonekana hapa wakati wakala anapendekeza mabadiliko.
• Kituo (chini ya kihariri, washa/zima) — endesha amri na usome matokeo.
• Gumzo (kulia) — mazungumzo ya wakala; hiki ndicho kidirisha kikuu, kinachojaza nafasi.

Buruta kigawanyaji kati ya kihariri na gumzo ili kusawazisha mpangilio upya, na buruta kigawanyaji cha mlalo ili kurekebisha ukubwa wa kituo. Upau wa kando wa kushoto pia huenda kwenye Eneo Kazi, Viendelezi, Funguo za API, Malipo, na Maoni.

4 Kufungua Mradi

4.1 Fungua folda ya ndani

1. Katika Kichunguzi, bofya Fungua folda ya mradi.
2. Chagua folda na upe kivinjari ruhusa ya kuisoma.
3. Faili husomwa kwenye eneo kazi lililosimbwa ndani ya kivinjari chako — hakuna kinachopakiwa. Utaona hesabu ya moja kwa moja na muhtasari wa mwisho (idadi ya faili · ukubwa, pamoja na faili zozote zilizorukwa au zilizopunguzwa).

4.2 Fungua kutoka Git (GitHub / GitLab)

1. Bofya Fungua kutoka Git katika Kichunguzi.
2. Chagua kichupo cha GitHub au GitLab na ubandike tokeni ya ufikiaji wa kibinafsi. Kwa GitHub tumia repo scope (ya kawaida) au tokeni yenye maelezo madogo na Contents + Pull requests; kwa GitLab tumia api scope. Tokeni yako huhifadhiwa kwenye seva — ni yaliyomo kwenye faili tu yanayovutwa kwenye kivinjari.
3. Andika hazina kama owner/name (chunga orodha ili kupata yako), kisha chagua tawi.
4. Kwa hiari weka alama kwenye Unda tawi jipya la kufanya kazi (k.m. dcc/my-feature) ili kuweka kazi yako imetengwa na tawi chaguo-msingi.
5. Kwa hiari wezesha push webhook ili Kichunguzi kionyeshe upya mara moja wakati wachezaji wenzako wanaposukuma (inahitaji URL ya lango la umma).
6. Bofya Fungua hazina.

4.3 Onyesha upya, badilisha, na funga

• Onyesha upya (↻ kwenye kichwa cha Kichunguzi) huchanganua upya folda au kuvuta toleo jipya zaidi kutoka Git.
• Fungua folda nyingine au Fungua kutoka Git kutoka vitufe vilivyo chini ya mti.
• Funga mradi (ikoni ya takataka) hufuta eneo kazi lililo ndani ya kivinjari.

4.4 Vipindi vya gumzo vilivyowekwa kwenye folda

Historia ya gumzo imeunganishwa na mradi uliofunguliwa. Kubadilisha folda huanzisha kipindi kipya kiotomatiki na kupakia vipindi vya awali vya folda hiyo, kufungua tena cha hivi karibuni ili uweze kuendelea ulipoishia.

4.5 Folda za uendeshaji

Folda ambazo DeepCerebra hutumia ndani — .deepcerebra, .sessions — huonekana kwenye mti lakini zimefungwa kwa chaguo-msingi ili zisijaze chanzo chako.

5 Kufanya Kazi na Faili

• Bofya faili katika Kichunguzi ili kuifungua kwenye kihariri; minimap hukusaidia kuabiri faili ndefu.
• Buruta faili kutoka Kichunguzi hadi kwenye kidokezo cha gumzo ili kuiambatanisha kama muktadha wazi kwa ujumbe wako unaofuata.
• Wakala anapopendekeza marekebisho, kihariri huonyesha tofauti ya ndani kwa faili iliyochaguliwa.

6 Kuzungumza na Wakala

Andika ombi

Eleza unachotaka kwa lugha rahisi — uliza swali, omba kipengele, au onyesha hitilafu. Kuwa maalum kuhusu faili, mifumo, na vikwazo ili kupata matokeo bora. Ambatanisha faili zinazohusika kwa kuziburuta kwenye kidokezo.

Soma majibu, kwa mtindo wa Cursor

Majibu yamepangwa kama Cursor: hoja za wakala zimetenganishwa na kinachoweza kutolewa. Kila kizuizi cha jibu kina ikoni ya kunakili kwenye kona yake ya juu kulia ili uweze kunakili ripoti iliyokamilika, hati, au amri unayotakiwa kuendesha.

Elekeza au simamisha utekelezaji

• Tumia Simamisha kusitisha utekelezaji unaoelekea vibaya, kisha urekebishe kidokezo chako.
• Toa vidokezo (k.m. "tumia lxml badala ya html.parser") ili kumtoa wakala kwenye kitanzi.

7 Njia Nne za Gumzo

Chagua hali kutoka kwa kiteuzi cha hali karibu na kidokezo. Kila moja hurekebisha ni kiasi gani wakala anapanga na jinsi anavyohariri kwa uhuru:

8 Kukagua & Kutumia Mabadiliko

Wakala anapopendekeza mabadiliko ya faili, paneli ya Mabadiliko Yanayopendekezwa huonekana juu ya ingizo la gumzo, ikiorodhesha kila faili iliyoguswa na idadi ya mistari iliyoongezwa (+) na iliyoondolewa (−).

• Bofya safu ya faili ili kufungua tofauti yake ya ndani kwenye kihariri.
• Tumia au Kataa faili moja, au tumia Tumia zote / Kataa zote.
• Mabadiliko yaliyotumika huwekwa alama applied (na · disk yanapoandikwa kwenye folda halisi).
• Ikiwa hakuna folda inayoweza kuandikwa, beji ya eneo kazi pekee inaonyesha mabadiliko yanatumika kwenye eneo kazi lililo ndani ya kivinjari.

9 Kituo Kilichounganishwa

Washa/zima kituo chini ya kihariri ili kuendesha ujenzi, majaribio, na hati. Kwa idhini yako, wakala anaweza kutekeleza amri na kusoma matokeo yake ili kuthibitisha kazi yake; amri zinazoendeshwa kwa muda mrefu hutiririsha matokeo ili uweze kutazama maendeleo. Funga kituo kutoka kwenye kichwa chake wakati huna haja nacho.

10 Njia ya Mpango & Utekelezaji

Kwa malengo makubwa zaidi, tumia hali ya Panga (au muombe wakala apange kwanza). Mpangaji huchanganua mradi wako, hugawanya lengo katika kazi zinazojua utegemezi, na kugawa kila moja kwa mtaalamu sahihi (mbunifu, mwandishi wa msimbo, mjaribu, nyaraka).

• Kagua & hariri mpango — ongeza, ondoa, au rekebisha kazi kabla ya utekelezaji.
• Tekeleza safu kwa safu — kazi huru huendeshwa pamoja; mpangaji anaweza kupanga upya ikiwa kazi itashindwa.
• Sitisha, endelea, au ghairi utekelezaji wakati wowote.

11 Kuchagua Miundo & Otomatiki

Fungua kiteuzi cha miundo karibu na kidokezo. Chaguzi zimepangwa kama:

• Otomatiki — acha DeepCerebra ichague mfumo bora unaopatikana (inapendekezwa).
• Ndani (GPU yako) — miundo inayotolewa kutoka kwenye mashine yako mwenyewe (angalia §13).
• Lango za jukwaa — miundo iliyopangishwa, iliyopangwa kwa lango na kisha kwa muuzaji (k.m. Anthropic, OpenAI, Google).

Jinsi uteuzi wa Otomatiki unavyofanya kazi

Kwenye Otomatiki, DeepCerebra hutumia uelekezaji wa ngazi mbalimbali, unaobadilika: kazi rahisi huenda kwenye mfumo wa haraka, wa kiuchumi, wakati kazi ngumu au inayohitaji upangaji mkubwa (kwa mfano, hali ya Panga) huelekezwa kwenye mfumo wenye nguvu zaidi. Hii husawazisha gharama na ubora kiotomatiki, kwa hivyo mara chache huhitaji kuchagua mwenyewe.

12 Lete Ufunguo Wako Mwenyewe (BYOK)

Unaweza kuelekeza maombi kupitia akaunti yako mwenyewe ya mtoa huduma badala ya matumizi ya jukwaa yanayopimwa.

1. Fungua Funguo za API kutoka upau wa kando.
2. Chini ya Lete Ufunguo Wako Mwenyewe, chagua mtoa huduma (k.m. ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
3. Bandika thamani ya ufunguo na ubofye Hifadhi. Funguo zimesimbwa zikiwa zimetulia na hazirudishwi kamwe kwenye kivinjari — ni onyesho la kukagua lililofichwa tu linaonyeshwa.

Miundo ya Jukwaa (DeepCerebra) haihitaji ufunguo. Ondoa ufunguo wakati wowote na Ondoa.

13 Mashine ya Ndani: Miundo ya GPU & Dashibodi (DCC Bridge)

DCC Bridge huunganisha kompyuta yako mwenyewe kwenye programu ya wavuti kupitia kiunganishi kidogo cha dcc-bridge, ikifungua uwezo mbili kwa wakati mmoja:

• Miundo ya GPU ya ndani — miundo inayotolewa na Ollama au LM Studio kwenye mashine yako huonekana kwenye kiteuzi cha miundo chini ya Ndani (GPU yako).
• Dashibodi / kituo kwenye mashine yako — kituo cha wavuti na wakala wanaweza kuendesha amri halisi kwenye kompyuta yako, ikiwemo zana za CLI ulizosanidi tayari (Railway, AWS CLI, OVH CLI, gh, docker, kubectl, WSL, …) na vitambulisho vyao vilivyopo.

Kiunganishi huunganisha nje kupitia WebSocket iliyothibitishwa — hakuna bandari za ndani zinazohitajika, na hufanya kazi nyuma ya NAT na firewalls. Huendesha kwenye Windows, macOS, na Linux (Python 3.10+).

13.1 Oanisha kompyuta yako

1. Bofya ikoni ya kompyuta ndogo kwenye upau wa shughuli wa kushoto — Mashine ya Ndani (GPU + Dashibodi). (Paneli hiyo hiyo hufunguka kutoka kwenye kijachagua cha miundo kupitia Dhibiti GPU ya ndani….)
2. Hakikisha kigeuzi cha Utekelezaji wa ndani kimewashwa, taja kifaa, na ubofye Ongeza kompyuta hii. Nakili tokeni ya kuoanisha ya mara moja (dcc_brg_…) na amri ya kiunganishi iliyo tayari kubandikwa — tokeni huonyeshwa mara moja tu.

13.2 Sakinisha & endesha kiunganishi

pip install git+https://github.com/mohammadkhair7/DeepCerebra-connector

# then run the command copied from the pairing card, e.g.:
python -m dcc_bridge --gateway wss://deepcerebra.ai --token dcc_brg_xxxxx

• Tumia kikoa kilekile unachotumia kwenye kivinjari kama lango (wss://deepcerebra.ai au wss://deepcerebra.io) — kadi ya kuoanisha hujaza mapema sahihi. Tovuti hizo mbili ni usambazaji tofauti na akaunti na tokeni tofauti.
• Kwa miundo ya GPU, endelea kuendesha Ollama, au wezesha LM Studio's local server (bandari chaguo-msingi 1234) na mfumo uliopakia.
• Vifaa vilivyooanishwa huonyesha hali ya mtandaoni/nje ya mtandao, idadi ya miundo, na wigo wa utekelezaji; unaweza Kubatilisha kifaa wakati wowote.

13.3 Tumia dashibodi yako kutoka programu ya wavuti

Kwa chaguo-msingi, amri zimefungwa kwenye folda maalum ya eneo kazi (~/DeepCerebra). Ili kufanya kazi katika folda zako halisi za mradi na CLI zako zilizosanidiwa mapema, zipe ruhusa waziwazi unapoanzisha kiunganishi:

# grant one or more real folders (repeatable)
python -m dcc_bridge --gateway wss://deepcerebra.ai --token dcc_brg_xxxxx --host-dir "F:\MyProjects"

# or the whole machine (prints a warning; prefer --host-dir)
python -m dcc_bridge ... --allow-any-dir

Kisha fungua paneli ya Kituo, bofya popover ya Lengo la utekelezaji (ikoni ya kompyuta ndogo), chagua Kompyuta yangu, na uchague saraka ya kufanya kazi. Amri zako ulizoandika na amri za ujenzi/jaribio za wakala kisha zitatekelezwa kwenye mashine yako.

14 Mchakato wa Kazi wa Ushirikiano wa Git

Ukiwa na mradi unaoungwa mkono na Git umefunguliwa, upau wa tawi huonekana kwenye Kichunguzi ukionyesha tawi lako la sasa na vitendo viwili:

• Ingiza (commit) — kagua idadi ya faili zilizobadilishwa, andika ujumbe wa commit, na commit kwenye tawi lako la kufanya kazi.
• Unganisha — fungua ombi la kuvuta kutoka tawi lako la kufanya kazi hadi kwenye tawi chaguo-msingi (k.m. main). Lazima uwe kwenye tawi la kufanya kazi, sio tawi chaguo-msingi.

Ikiwa push webhook imewashwa, Kichunguzi huonyesha upya kiotomatiki wakati wachezaji wenzako wanaposukuma, ikiweka kila mtu katika usawazishaji — msingi wa ukuzaji wa timu shirikishi kupitia DeepCerebra.

15 Seva za MCP

Panua wakala na zana na data za nje kupitia Itifaki ya Muktadha wa Mfumo. Sanidi seva katika faili ya .deepcerebra/mcp.json, kwa mfano:

{
  "mcpServers": {
    "my-tools": {
      "url": "https://example.com/mcp",
      "disabled": false,
      "allowlist": ["search_issues", "get_pr"],
      "autoApprove": ["create_issue"],
      "auth": { "type": "bearer", "tokenEnv": "MY_TOKEN" }
    }
  }
}

Zana za MCP zilizowezeshwa zinapatikana kwa wakala kiotomatiki zinapohusika na ombi lako. Seva za ndani (stdio) na za mbali (http/sse) zote zinaungwa mkono.

Usalama uliojengwa ndani

• Kataa-kwa-chaguo-msingi — seva inapoorodhesha allowlist, zana hizo tu ndizo zinaweza kuendeshwa.
• Idhini kwa zana hatarishi — zana zinazobadilisha (kuandika/kufuta/kupeleka/…) zinahitaji idhini isipokuwa umeidhinisha mapema katika autoApprove.
• Kikomo cha kasi, usafishaji wa hoja na matokeo, na logi ya ukaguzi hutumika kwa kila simu.

Rasilimali & vidokezo

Ikiwa seva itaonyesha rasilimali za MCP au template za kidokezo, wakala hupata zana kiotomatiki za kuzitumia (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt).

Uthibitishaji kwa seva za mbali

Ongeza kizuizi cha auth kwenye seva ya mbali. Siri huunga mkono uingizaji wa ${ENV_VAR}:

// Static bearer token (literal or from env)
"auth": { "type": "bearer", "token": "${GITHUB_TOKEN}" }
"auth": { "type": "bearer", "tokenEnv": "GITHUB_TOKEN" }

// Custom header (e.g. API key)
"auth": { "type": "header", "header": "x-api-key", "value": "${MY_KEY}" }

// OAuth 2.0 client-credentials
"auth": {
  "type": "oauth", "grant": "client_credentials",
  "tokenUrl": "https://auth.example.com/oauth/token",
  "clientId": "${MCP_CLIENT_ID}", "clientSecret": "${MCP_CLIENT_SECRET}",
  "scope": "mcp.read mcp.write"
}

16 Kubinafsisha Wakala: Sheria, Ujuzi, Hooks, Wakala Wadogo & Plugins

Unaweza kuunda jinsi wakala anavyofikiri na kutenda kwa makubaliano moja, yanayotegemea faili — saraka ya .deepcerebra/ — ambayo hufanya kazi sawa katika programu ya kompyuta ya mezani, programu ya wavuti, na API. Katika programu ya wavuti, dhibiti haya yote chini ya mwonekano wa Wakala; kwenye kompyuta ya mezani na kupitia API ni faili rahisi unazozituma na mradi wako.

Wigo & kipaumbele

Usanidi hugunduliwa kutoka wigo kadhaa; kipengee kilekile kinapokuwepo katika zaidi ya moja, kile chenye kipaumbele cha juu hushinda:

team/org  <  global (~/.deepcerebra)  <  workspace (<repo>/.deepcerebra)
(lowest)                                              (highest)

• Eneo Kazi — <repo>/.deepcerebra/…, imetumwa na mradi.
• Kimataifa — ~/.deepcerebra/…, mipangilio yako ya kibinafsi katika miradi yote.
• Timu / shirika — msingi wa pamoja (kipaumbele cha chini kabisa) ili mtumiaji au mradi uweze kuibatilisha kila wakati. Katika programu ya wavuti, weka Wigo wa sheria kuwa Timu.

Sheria (uelekezaji)

Sheria ni maagizo yanayoendelea — viwango vya kuandika msimbo, mikataba ya usanifu, muktadha wa kikoa — yaliyowekwa kwenye kidokezo cha mfumo wa wakala. Huishi kama faili za Markdown chini ya .deepcerebra/steering/, pamoja na kiwango cha AGENTS.md kinachowashwa kila wakati. Frontmatter hudhibiti lini sheria inapopakia:

---
inclusion: fileMatch          # always | fileMatch | auto | manual
globs: "src/**/*.ts"          # or fileMatchPattern
name: api-design
description: REST conventions
---
# API design
- Use REST resource nouns, plural.

• always — kila zamu (chaguo-msingi).
• fileMatch — tu wakati faili iliyo katika muktadha inalingana na globs.
• auto — wakati ombi lako linalingana na name/description ya sheria.
• manual — tu unapoirejelea kama #name au /name.

AGENTS.md ya mizizi inatumika kwa repo nzima; AGENTS.md iliyowekwa ndani (k.m. services/api/AGENTS.md) inatumika tu kwa faili zilizo chini ya folda hiyo. Katika programu ya wavuti, mwonekano wa Wakala → Uelekezaji huipa kila sheria kiteuzi cha Wigo (Kimataifa / Mradi / Timu).

Ujuzi

Ujuzi ni vitabu vya kucheza vinavyoweza kutumika tena ambavyo wakala hupakia kwa mahitaji. Kila ujuzi ni folda yenye SKILL.md chini ya .deepcerebra/skills/:

---
name: deploy-release
description: How to cut and publish a versioned release.
disable-model-invocation: false   # true => manual-only (/skill)
---
# Deploy a release
1. Bump the version, build, and test.
2. Tag and publish.

Wakala huona katalogi nyepesi (jina + maelezo) na kuvuta mwili kamili na zana ya load_skill inapohusika. Unaweza pia kuita moja waziwazi na /skill <name>. Weka disable-model-invocation: true ili kufanya ujuzi uwe wa mwongozo pekee.

Hooks

Hooks huendesha otomatiki kwenye matukio ya mzunguko wa maisha. Zifafanue kama .deepcerebra/hooks/*.hook.json:

{
  "title": "Format on save",
  "event": "fileSave",
  "filePattern": ["**/*.ts"],
  "action": { "type": "shell", "command": "npm run lint:fix -- $FILE" },
  "enabled": true
}

Matukio ni pamoja na promptSubmit, preToolUse, postToolUse, fileCreate, fileSave, fileDelete, preTask, postTask, sessionStart, preCompact, na agentStop (tahajia za Cursor/Claude pia zinakubaliwa). Kitendo ni aidha shell (endesha amri) au agentPrompt (uliza wakala). Hook ya preToolUse inaweza kuruhusu, kukataa, au kuuliza kwa simu ya zana inayoingilia.

Wakala Wadogo

Wakala wadogo ni wakala wataalamu unaowafafanua na kuwakabidhi. Kila mmoja ni faili ya Markdown chini ya .deepcerebra/agents/ na frontmatter pamoja na mwili (kidokezo chake cha mfumo):

---
name: security-reviewer
description: Audits a diff for security issues; read-only.
model: gpt-5
readonly: true
tools: [read_file, grep_files, list_directory]
background: false
---
You are a meticulous security reviewer…

Wakala mkuu hukabidhi kwa task (kuzuia), task_async + task_status / task_result (chinichini), au task_parallel (kusambaza).

Plugins

Plugin huunganisha sheria, ujuzi, hooks, wakala wadogo, na seva za MCP katika kifurushi kimoja kinachoweza kusakinishwa chini ya .deepcerebra/plugins/<name>/, kilichoelezwa na manifest ya plugin.json:

{
  "name": "Acme Standards",
  "version": "1.2.0",
  "description": "Acme rules + skills + review agents.",
  "enabled": true
}

Yaliyomo kwenye plugin huunganishwa kwa kipaumbele cha chini kabisa, kwa hivyo sheria na ujuzi wako mwenyewe huibatilisha kila wakati ile ya plugin. Zima plugin na "enabled": false au faili ya alama ya .disabled.

17 Studio ya Mtiririko wa Kazi wa Wakala & Wakala Wanaotumia Matukio

Studio ya Mtiririko wa Kazi ni mbuni wa kuona kwa otomatiki ya wakala wengi. Unatunga hatua — kila moja ikiwa wakala, hatua maalum, au msingi wa udhibiti — kuwa grafu, kuziunganisha na utegemezi, na kuendesha uratibu mzima kwenye injini na maendeleo ya moja kwa moja kwa kila hatua, bajeti, na milango ya idhini ya binadamu. Mitiririko ya kazi huhifadhiwa kama ufafanuzi wa YAML/JSON unaoweza kuhamishika unaoweza kusafirisha, kuingiza, kuweka toleo katika Git, na kuendesha kutoka API au CLI.

17.1 Kujenga mtiririko wa kazi

• Palette (kushoto) — buruta aina za hatua, aina za wakala zilizotengenezwa tayari (utafiti, uzalishaji wa msimbo, QA, mwandishi wa hati, kifaa cha matibabu, mwanasheria wa hataza, na aina zako maalum), ujuzi kutoka Maktaba ya Ujuzi, na zana kwenye turubai.
• Turubai (katikati) — panga hatua na chora kingo; kingo inamaanisha "hatua hii inategemea ile" na hulisha kiotomatiki matokeo ya juu kwenye kidokezo cha chini.
• Mkaguzi (kulia, inayoweza kurekebishwa ukubwa) — sanidi hatua iliyochaguliwa: kidokezo chake, ujuzi, zana, mfumo wa kubatilisha kwa kila hatua, matokeo ya artifact, lango, matukio, na vigezo maalum vya aina.
• Templates — anza kutoka kwenye mpango uliopo (Ship-It Pipeline, SaaS Starter, Data Pipeline with Evals, Customer Comms Hub, Design → Verified App) na uubinafsishe.
• Tengeneza — eleza programu au mchakato kwa lugha rahisi na Mjenzi wa Wakala hutengeneza grafu kamili, iliyothibitishwa ya mtiririko wa kazi unayoweza kukagua, kurekebisha, na kuendesha.

17.2 Maktaba ya hatua

17.3 Wakala wanaotumia matukio (mtandao wa wakala)

Kila hatua — bila kujali aina — inaweza kuchapisha na kujiandikisha kwa matukio yaliyochapishwa kwenye basi la matukio ya eneo kazi, ili wakala waratibu kama huduma kwenye kitambaa cha ujumbe badala ya kupitia DAG pekee:

• Madarasa ya matukio — kila tukio hubeba darasa: lifecycle, agent, business, data, system, schedule, chat, external, au alert — yanayoweza kuchujwa katika usajili na uchezaji upya.
• Njia za kujiandikisha — trigger (hatua huendeshwa tukio linalolingana linapofika; utekelezaji na hatua zilizosimama hubaki kama kusikiliza), gate (lango la mashine lililoidhinishwa na tukio badala ya kubofya kwa binadamu), na data (payload huunganishwa kwenye muktadha wa hatua).
• Kuanzisha kwa tukio — wakala yeyote anaweza kuanzishwa na mratibu au wakala mwingine kwa kuchapisha kwenye anwani yake agent.<stage-id>.request.
• Vianzisha utekelezaji — kizuizi cha triggers: cha mtiririko wa kazi hukiwezesha kuanza kwenye webhooks zinazoingia, ratiba za cron, matukio, au gumzo — hata wakati Studio imefungwa.
• Utekelezaji wa moja kwa moja — paneli ya utekelezaji hutiririsha matukio ya mzunguko wa maisha kupitia SSE: kuanza/kukamilika kwa hatua, milango, tahadhari, na hakiki huonekana mara moja.
• Logi inayodumu & uchezaji upya — matukio hudumu kwa kila eneo kazi na yanaweza kuchezwa upya kwa muundo wa mada na darasa kwa ukaguzi na utatuzi wa matatizo.

17.3.1 Foleni ya matukio kwa wakala

Wakala wanaojibu matukio wanaweza kutangaza foleni inayodumu yenye jina ili matukio yanayolingana yasipotee kamwe wakati wakala ana shughuli au kabla ya utekelezaji kusikiliza. Kwenye usajili wa kichochezi, weka queue: <name> — injini huunganisha mada hiyo kwenye foleni ya FIFO kwenye basi la matukio ya eneo kazi (iliyohifadhiwa chini ya .deepcerebra/workflows/events/queues/). Kila tukio linalolingana lililochapishwa kuanzia wakati huo linanaswa kwenye foleni; hatua inapokuwa tayari kuendeshwa, injini hutoa matukio kwa mpangilio wa zamani-kwanza na kuyatumia moja baada ya jingine.

• Hakuna kinachopotea — matukio yaliyochapishwa wakati mtiririko wa kazi umefungwa, wakati hatua nyingine inaendeshwa, au wakati utekelezaji bado unasubiri utegemezi huwekwa kwenye foleni badala ya kuachwa.
• count kwa kila usajili — hitaji matukio N yaliyowekwa kwenye foleni (au yaliyotolewa) kabla ya usajili kuridhika (muhimu wakati wafanyakazi kadhaa wanapaswa kuripoti).
• Studio — kwenye paneli ya Matukio ya Mkaguzi, weka sehemu ya queue kwenye usajili wa kichochezi; washa vianzisha au anza utekelezaji ili kuunda muunganisho kiotomatiki.
• API & zana — GET /api/workflow/queues huorodhesha kina na miunganisho; GET /api/workflow/queues/{name} huangalia matukio yanayosubiri; wakala wa gumzo wanaweza kuita event_queue_status na pop_queued_event.

events:
  subscribe:
    - topic: ticket.created
      mode: trigger
      queue: triage-inbox        # durable FIFO — events wait here for this agent
      map:
        payload.ticket_id: ticket_id

17.3.2 Uratibu wa Semaphore (ulinzi wa rasilimali iliyoshirikiwa)

Semaphore huweka kikomo cha kazi ngapi zinaweza kufanya kazi kwa wakati mmoja kwenye rasilimali iliyoshirikiwa (iliyolindwa): hifadhidata inayorekodiwa, hifadhi ya vigezo vya kimataifa, faili, au wakala wa nje mwenye kikomo cha kasi. Ambatanisha moja kwenye hatua yoyote na semaphore: — kabla ya kazi ya hatua kuendeshwa, injini hupata kibali kimoja cha semaphore ya eneo kazi iliyotajwa; kibali hutolewa kila wakati baadaye, hata kama hatua itashindwa. permits: 1 huifanya kuwa mutex: kazi moja tu kwa wakati mmoja (katika utekelezaji wote sambamba katika eneo kazi) hutekeleza hatua muhimu; kila kazi nyingine husubiri hadi mshikaji amalize.

• Ufuatano wa utekelezaji mbalimbali — semaphores zimefungwa kwa wigo wa eneo kazi na hudumu, kwa hivyo utekelezaji miwili ya mtiririko wa kazi kwa wakati mmoja haiwezi kuharibu rasilimali iliyolindwa.
• Kusubiri, sio kukwama — kazi huzuia hadi timeout_s kwa kibali; ikiwa rasilimali inabaki kwenye uwezo kamili, hatua hushindwa waziwazi badala ya kukwama milele.
• Usalama wa ajali — kila kibali hubeba ttl_s; ikiwa mshikaji ataanguka bila kutoa, kibali huisha kiotomatiki ili rasilimali isiwahi kukwama.
• Uwezo wa kuangalia — basi hutoa matukio ya mfumo semaphore.<name>.waiting, .acquired, na .released; GET /api/workflow/semaphores huonyesha uwezo, wamiliki, na vibali vinavyopatikana.
• Wakala wa gumzo — zana za acquire_semaphore, release_semaphore, na semaphore_status huratibu sehemu muhimu za ad-hoc nje ya mtiririko wa kazi.

semaphore:
  name: emr-db-writer
  permits: 1          # mutex — one writer at a time
  timeout_s: 300      # fail if still waiting after 5 minutes
  ttl_s: 900          # auto-release crashed holders after 15 minutes

17.3.3 Uratibu wa Rendezvous (subiri masharti yote)

Rendezvous husubiri hadi masharti mengi ya tukio yatimizwe kabla ya hatua inayofuata kuendelea — kinyume cha "tukio la kwanza hushinda." Weka join: all kwenye kizuizi cha events: cha hatua: kila usajili wa kichochezi lazima utimizwe kabla ya hatua kuendeshwa. Unganisha na count: N kwa kila usajili wakati wakala kadhaa (au ripoti kadhaa kutoka kwa wakala mmoja) lazima wote waingie — kwa mfano, idhini ya usanifu, kukamilika kwa jaribio, na idhini ya usalama kabla ya hatua ya kutolewa kutekelezwa.

• join: any (chaguo-msingi) — hatua huendeshwa wakati usajili wa kichochezi wa kwanza umetimizwa.
• join: all — rendezvous: kila usajili wa kichochezi (kila mmoja na mada yake mwenyewe, kichujio cha darasa, na count ya hiari) lazima utimizwe; ndipo tu hatua inakuwa tayari kuendeshwa.
• Payloads — matukio yote yaliyotumika hurekodiwa kwenye hatua kama trigger_events na kuonyeshwa kwa templates kama inputs.events (orodha ya vitu vya tukio na payloads).
• Studio — hatua inapokuwa na usajili wa kichochezi mbili au zaidi, Mkaguzi huonyesha kiteuzi cha Jiunge: yoyote — tukio la kwanza hushinda au zote — rendezvous (subiri zote); turubai huonyesha beji ya kuunganisha kwenye hatua za rendezvous.

events:
  join: all                    # rendezvous — wait for EVERY subscription below
  subscribe:
    - topic: design.approved
      mode: trigger
    - topic: tests.passed
      mode: trigger
    - topic: security.cleared
      mode: trigger
      count: 1

17.4 Maktaba ya zana za wakala

Hatua huchagua zana kutoka kwenye rejista ileile ambayo wakala wa gumzo hutumia:

• Msingi — faili, git, shell, utekelezaji wa msimbo, utafutaji wa msimbo, otomatiki ya kivinjari, utafutaji wa wavuti, maono/media, uzalishaji wa picha.
• Hifadhidata — SQLite, PostgreSQL, MySQL, MongoDB, na maswali ya Redis pamoja na create_database, apply_migrations, na dump_schema kwa safu za data zinazomilikiwa.
• Mawasiliano — simu na SMS (Twilio) na barua pepe (SendGrid), na hali ya uigaji inayorekodi kwenye kikasha cha kutuma wakati vitambulisho havipo — maonyesho hayatumii ujumbe halisi kimakosa.
• DevOps — docker_build / docker_push, compose up/down, SSH na usambazaji wa cloud-CLI (Fly, Render, Railway, Vercel), pia salama kwa uigaji.
• Uthibitishaji — utambuzi wa stack, utekelezaji wa seti ya majaribio na viwango vya kupita vilivyochanganuliwa, ukaguzi wa utegemezi, na uchanganuzi wa siri.
• Injini za SciCompute — mamia ya mbinu za kisayansi na uhandisi (zinazoitwa Class.method) katika hisabati, usindikaji wa ishara, udhibiti, takwimu, na zaidi.
• Wakala Mtaalamu & MCP — utafiti wa kikoa uliojikita pamoja na seva zozote za nje za MCP unazounganisha.

17.5 Kuendesha, milango, na matokeo

• Thibitisha huangalia grafu (vitambulisho vya kipekee, utegemezi usio na mzunguko, vigezo vya aina) kabla ya kuendesha.
• Milango ya binadamu husitisha utekelezaji baada ya hatua kutoa rasimu yake, kwa hivyo unakubali kazi halisi; milango ya matukio huruhusu mfumo mwingine kuidhinisha kiotomatiki.
• Bajeti huweka kikomo cha matumizi kwa kila utekelezaji na kwa kila hatua.
• Hifadhi matokeo kwenye mradi hunakili kila artifact iliyotengenezwa na utekelezaji kwenye mradi wako uliofunguliwa.
• Hamisha Programu hubadilisha mtiririko wa kazi kuwa huduma ya FastAPI inayojitegemea; API ya umma ya /v1 huonyesha utekelezaji, matukio, vianzisha, templates, na uzalishaji kwa CI na miunganisho.
💡 Kidokezo: Anza na template ya Ship-It Pipeline: it chains design → db.provision → implementation → generated tests → security audit → deploy packaging → CI generation, with a human gate before packaging — a complete brief-to-production path you can adapt in minutes.

18 Ukamilishaji wa Kichupo wa Kutabiri

Ukamilishaji wa Kichupo wa Kutabiri hutoa mapendekezo ya msimbo ya ndani, ya kujaza katikati unapoandika kwenye kihariri — kubali pendekezo kwa Tab. Ni hiari kwenye injini na kihariri cha wavuti.

Washa

• Injini — weka bendera ya mazingira DCC_TAB_COMPLETE=1. Kihariri huita kituo cha POST /api/complete cha injini, ambacho hurejesha tu maandishi ya kuingiza kwenye kishale.
• Kihariri cha wavuti — washa wakati wa ujenzi na VITE_TAB_COMPLETE=1, au wakati wa utekelezaji na localStorage.setItem('dcc.tabComplete', '1') (kisha pakia upya).

Jinsi inavyofanya kazi

• Mapendekezo huonekana kama maandishi ya kivuli; bonyeza Tab kukubali, au endelea kuandika ili kufuta.
• Maombi hucheleweshwa na yanaweza kughairiwa, kwa hivyo kuandika hakuzuiwi kamwe.
• Bendera ikiwa imezimwa, kipengele kimezimwa kabisa na hakuna maombi ya ukamilishaji yanayofanywa.

19 Matumizi, Salio & Malipo

Fungua Malipo kutoka upau wa kando ili kudhibiti mpango na matumizi yako. Matumizi ya AI hupimwa kwa salio la dola za Marekani kulingana na tokeni zinazotumiwa na miundo ya msingi.

• Matumizi ya mzunguko & salio la kulipia kabla — fuatilia matumizi ya mzunguko huu na salio lolote la kulipia kabla.
• Ongeza salio la ziada — idhinisha kiasi cha ziada (USD) ili kuendelea kutumia AI baada ya posho iliyojumuishwa kutumika; ikiwa bajeti yako imeisha utaona bango likikuhimiza kuongeza salio.
• Panda daraja / badilisha mpango — badilisha viwango wakati wowote.
• Njia ya malipo — ongeza au sasisha kadi iliyo kwenye faili (inashughulikiwa na Stripe).
• Ghairi — chagua ghairi mwishoni mwa kipindi (endelea kupata huduma hadi kipindi kiishe) au ghairi sasa (rejesha salio linaloweza kurejeshwa). Angalia Sera ya Kughairi & Kurejesha Pesa.

20 Kupata Ufunguo Wako wa API wa Lango

Ufunguo wa API wa lango (tokeni ya ufikiaji wa kibinafsi) hukuruhusu kutumia API ya umma ya DeepCerebra na CLI kwa programu.

1. Ingia na ufungue Funguo za API kutoka upau wa kando.
2. Sogeza hadi Funguo za API za DeepCerebra.
3. Weka lebo (k.m. "CI pipeline" au "laptop CLI").
4. Chagua wigo — read, chat, code, agent — na tarehe ya mwisho ya hiari kwa siku (tupu = kamwe).
5. Bofya Tengeneza. Ufunguo kamili huonyeshwa mara moja tu — bofya Nakili na uuhifadhi kwa usalama.

Itumie na CLI au API kwenye deepcerebra.ai:

dcc config set endpoint https://deepcerebra.ai
dcc config set api-key <your-key>

# or as a Bearer token
curl -H "Authorization: Bearer <your-key>" https://deepcerebra.ai/v1/...

Unaweza kubadilisha jina au kufuta (kubatilisha) ufunguo wakati wowote; kila ufunguo huonyesha kiambishi chake, wigo, tarehe ya kuundwa/kumalizika, na tarehe ya mwisho kutumika.

21 Usalama & Faragha

• Hifadhi ya siri ndani ya kivinjari — faili zako za mradi hubaki kwenye eneo kazi lililosimbwa la kivinjari; ni muktadha mdogo tu unaohitajika kwa kila ombi hutumwa kwenye seva.
• Uhifadhi wa Data Sifuri (ZDR) — vidokezo na msimbo unaoelekezwa kwa miundo hauhifadhiwi zaidi ya ombi na hautumiwi kamwe kufundisha miundo ya msingi.
• Funguo hubaki upande wa seva — tokeni za BYOK na SCM zimesimbwa zikiwa zimetulia; ni hakiki zilizofichwa tu huonyeshwa.
• Usimbaji fiche — TLS katika usafiri; data ya akaunti imesimbwa zikiwa zimetulia; nywila zimehashiwa bila kurekebishwa.
• Msimbo wako ni wako — unamiliki maudhui yako na matokeo yaliyotengenezwa. Angalia Taarifa ya Faragha.

22 Utatuzi wa Matatizo

"Upakiaji wa folda unahitaji kivinjari cha Chromium"

Badilisha hadi Chrome, Edge, au Brave, au tumia Fungua kutoka Git badala yake.

Wakala hurudia kosa lilelile

Bofya Simamisha, kisha urekebishe maneno kwa kidokezo au kikwazo maalum.

Makosa ya mfumo au ombi / "bajeti imeisha"

• Angalia muunganisho wako na uhakikishe kuwa ufunguo wowote wa BYOK ni halali.
• Badilisha hadi Otomatiki ili DeepCerebra ielekeze kwenye mfumo unaopatikana.
• Ikiwa bajeti yako ya matumizi imeisha, fungua Malipo na ongeza salio la ziada au panda daraja la mpango wako.

Miundo ya ndani haionekani

• Thibitisha kuwa kiunganishi cha dcc-bridge kinaendesha na kifaa kinaonyesha mtandaoni.
• Hakikisha Ollama inaendesha, au seva ya ndani ya LM Studio imewashwa (bandari chaguo-msingi 1234) na mfumo umepakiwa.

Kiunganishi: "seva imekataa muunganisho wa WebSocket: HTTP 401"

• Tumia kikoa kilekile unachotumia kwenye kivinjari kama --gateway (wss://deepcerebra.ai au wss://deepcerebra.io) — tovuti hizo mbili ni usambazaji tofauti, na tokeni kutoka moja haifanyi kazi kamwe kwenye nyingine.
• Nakili amri halisi kutoka kwenye kadi ya kuoanisha kwenye ukurasa wa Mashine ya Ndani.

Mabadiliko yangu hayakufanya kazi

• Hakikisha ulibofya Tumia (sio tu kukagua tofauti) katika Mabadiliko Yanayopendekezwa.
• Tumia onyesha upya ya Kichunguzi ili kuchanganua upya folda.

Git: "Uko kwenye tawi chaguo-msingi"

Fungua au unda tawi la kufanya kazi kabla ya kutumia Unganisha kufungua ombi la kuvuta.

Bado umekwama? Wasiliana na support@deepcerebra.ai.

23 DeepCerebra Discovery — Uliza Data na Nyaraka Zako

Discovery ni chatbot ya uchunguzi kwa ajili ya hifadhidata na nyaraka zako. Badala ya kujibu kwa swali moja, inafanya kazi kama mchambuzi: inaunda nadharia, inaendesha mfululizo wa uchunguzi uliolindwa (SQL, grafu, utafutaji wa nyaraka, ukaguzi wa schema, uthibitisho wa wavuti), inapunguza maelezo ambayo ushahidi unakanusha, na kuunganisha jibu lenye msingi — ikiwa na chati na risiti ya gharama iliyo wazi. Ifungue kutoka kwenye ikoni ya dira kwenye upau wa shughuli (/app/discovery).

23.1 Nafasi — wigo wako ulioratibiwa

Nafasi inajumuisha kila kitu kinachohitajika kwa mfululizo mmoja wa maswali: miunganisho ya hifadhidata, mikusanyiko ya nyaraka, maelekezo kwa mchambuzi, na bajeti. Unda moja kwa kutumia + Nafasi mpya, kisha tumia paneli ya usanidi upande wa kulia ili:

• Unganisha hifadhidata — SQLite, PostgreSQL, MySQL, SQL Server, au Snowflake. Weka jina na DSN, bofya Jaribu ili kuthibitisha muunganisho (kuchelewa na toleo la seva huonyeshwa), au ingiza usanidi wa muunganisho uliopo kama JSON. Miunganisho ni soma-tu kwa chaguo-msingi.
• Ongeza nyaraka — buruta na udondoshe faili (PDF, DOCX, PPTX, Markdown, maandishi) moja kwa moja kwenye soga, bandika URL, au elekeza kwenye njia ya folda kwenye seva pangishi ya injini. Nyaraka hugawanywa, hupachikwa, na kuorodheshwa kwa utafutaji mseto wa vekta + grafu ya maarifa.
• Ingiza majedwali — bandika au pakia CSV/JSON ili kuuliza papo hapo bila hifadhidata yoyote.
• Mfundishe mchambuzi — ongeza ufafanuzi wa metriki, sheria za biashara na tahadhari, maswali yaliyoidhinishwa na msimamizi ya kuaminika, na mifano ya jozi za swali→hoja ili majibu yatumie ufafanuzi wako.

23.2 Kuuliza swali

Andika swali kama vile unavyomuuliza mfanyakazi mwenzako — kwa mfano "Why did MRI scan volume dip in March?". Bodi ya uchunguzi huonyesha mchakato mzima moja kwa moja:

• Nadharia — maelezo yanayowezekana yanayochunguzwa, kila moja ikiwa imetiwa alama imeungwa mkono, imekanushwa, au haina hitimisho kadri ushahidi unavyofika.
• Uchunguzi — kila hoja anayoendesha mchambuzi, ikiwa na hali yake; SQL/Cypher iliyotengenezwa huonyeshwa kwa uwazi kamili, na kila taarifa hupita sheria za ulinzi za kusoma-tu kabla ya utekelezaji.
• Ushahidi — majedwali ya matokeo na dondoo za nyaraka, zikinukuliwa kwa namba katika jibu la mwisho.
• Jibu + chati — hitimisho lenye msingi ambalo pia linataja maelezo yaliyotengwa, pamoja na chati za kisasa zenye mandhari ya neon zilizoundwa kutokana na ushahidi.
• Risiti — tokeni, gharama kwa kila uchunguzi, na raundi, zinazotozwa kwenye AI Credits zako kama utekelezaji mwingine wowote wa wakala.

Maswali ya kufuatilia yanaendeleza mada ileile, hivyo mchambuzi huendelea na muktadha wake.

23.3 Chati, ripoti & usafirishaji

Chati huonyeshwa moja kwa moja kwenye bodi ya uchunguzi. Tumia Hamisha kupakua swali kamili — jibu, nadharia, ushahidi, na chati — kama ripoti ya HTML inayojitegemea au PDF ya ubora wa kuchapisha, iliyoundwa kwa mfumo wa muundo wa neon.

23.4 Bajeti & udhibiti wa gharama

Kila nafasi ina bajeti kwa kila swali: idadi ya juu ya uchunguzi, raundi za uchunguzi, sekunde, na USD. Injini huacha vizuri kwenye kikomo na huripoti kile ilichopata hadi sasa. Gharama ya kila uchunguzi imeorodheshwa kwenye risiti, hivyo unajua kila wakati matumizi yalikwenda wapi.

23.5 Uendeshaji Kiotomatiki: API, SDK, Workflow Studio & MCP

• REST API — kila kitu ambacho UI inafanya kinapatikana chini ya /v1/discovery/* kwa PAT yenye wigo wa discovery (iunde chini ya Akaunti → Tokeni za API). Streaming asks use SSE. Waendeshaji wa nje wanaweza kukopa tu upangaji wa uchunguzi kupitia Thinking API (/v1/think/*, wigo think).
• Python SDK — pip install deepcerebra-discovery, kisha DiscoveryClient(base_url, token).ask(space_id, question).
• Workflow Studio — dondosha hatua ya Discovery Ask (discovery.ask) kwenye mtiririko wowote wa kazi ili kuendesha uchunguzi kama hatua ya bomba; jibu, chati, na risiti hutiririka kwenda hatua za chini.
• MCP — injini huonyesha discovery_ask na discovery_list_spaces kama zana za MCP, hivyo wateja wa nje wa MCP wanaweza pia kuendesha uchunguzi.