1 Inleiding & Uitgawes

DeepCerebra Coder is 'n agentic koderingsassistent. Anders as 'n gewone outovoltooi-kopiloot, beplan, skryf, herfaktoriseer, voer opdragte uit, roep gereedskap aan, en itereer dit oor jou hele projek — met jou wat die veranderinge wat dit voorstel, hersien en goedkeur.

Drie maniere om dit te gebruik

Hierdie gids fokus op die webtoepassing by deepcerebra.ai; die rekenaartoepassing weerspieël dieselfde panele en werkvloeie.

2 Aan die Gang & Rekening

Ondersteunde blaaiers

Gebruik 'n huidige weergawe van Chrome, Edge, of Brave vir die volle ervaring — die opening van 'n plaaslike gids maak staat op die Chromium File System Access API. Firefox en Safari werk vir gesels en vir Git-gesteunde projekte, maar kan nie 'n plaaslike gids direk oopmaak nie.

Skep 'n rekening

1. Klik Begin op die landingsblad.
2. Vul jou opsionele vertoonnaam, e-pos, land, en geboortedatum in (jy moet minstens 18 wees).
3. Kies jou koppelvlaktaal en 'n wagwoord van minstens 12 karakters.
4. Lees die ooreenkoms kennisgewing en bevestig. Die skep van 'n rekening beteken jy stem in tot die Diensbepalings, Privaatheidsverklaring, Diensbeskrywing, en Globale DPA.
5. Klik Skep rekening, verifieer dan jou e-pos indien gevra, en meld aan.

Stel jou wagwoord terug

1. Op die aanmeldblad, klik Wagwoord vergeet?
2. Voer jou e-pos in en maak die herstelskakel oop wat na jou inkassie gestuur is.
3. Stel 'n nuwe wagwoord in (minimum 12 karakters).

3 Die Werkruimte in 'n Oogopslag

Nadat jy aangemeld het, land jy in die werkbank, wat elke paneel op een skerm plaas:

• Explorer (links) — die lêerboom vir die oop projek, met 'n verfris- en sluitknoppie.
• Editor (middel) — lêerinhoud met sintaksisuitligting en 'n minimap-oorsig; inlyn verskille verskyn hier wanneer die agent veranderinge voorstel.
• Terminal (onder die editor, skakel aan/af) — voer opdragte uit en lees uitvoer.
• Chat (regs) — die agent-gesprek; dit is die primêre, ruimte-vullende paneel.

Sleep die splitter tussen die editor en gesels om die uitleg te herbalanseer, en sleep die horisontale splitter om die terminal te verander. Die linker sybalk navigeer ook na Workspace, Extensions, API Keys, Billing, en Feedback.

4 Opening van 'n Projek

4.1 Maak 'n plaaslike gids oop

1. In die Explorer, klik Maak projekgids oop.
2. Kies 'n gids en gee die blaaier toestemming om dit te lees.
3. Lêers word in jou blaaier se geënkripteerde in-blaaier-werkruimte gelees — niks word opgelaai nie. Jy sal 'n lewendige telling en 'n finale opsomming sien (lêertelling · grootte, plus enige oorgeslaan of afgekapte lêers).

4.2 Maak oop vanaf Git (GitHub / GitLab)

1. Klik Open from Git in die Explorer.
2. Kies die GitHub of GitLab-oortjie en plak 'n persoonlike toegangstoken. Vir GitHub gebruik die repo-omvang (klassiek) of 'n fynkorrelige token met Contents + Pull requests; vir GitLab gebruik die api-omvang. Jou token word op die bediener gestoor — slegs lêerinhoud word in die blaaier ingetrek.
3. Tik die repository as owner/name (filter die lys om joune te vind), kies dan 'n branch.
4. Merk opsioneel Skep 'n nuwe werkende branch (bv. dcc/my-feature) om jou werk geïsoleer te hou van die verstek branch.
5. Aktiveer opsioneel die push webhook sodat die Explorer onmiddellik verfris wanneer spanmaats push (benodig 'n publieke gateway URL).
6. Klik Maak repository oop.

4.3 Verfris, wissel en sluit

• Verfris (↻ in die Explorer-opskrif) skandeer die gids weer of trek die nuutste van Git.
• Maak 'n ander gids oop of Open from Git vanaf die knoppies onder die boom.
• Sluit projek (asblik-ikoon) vee die in-blaaier-werkruimte uit.

4.4 Gids-geskopeerde geselsessies

Geselsgeskiedenis is gekoppel aan die oop projek. Die wissel van gidse begin outomaties 'n nuwe sessie en laai daardie gids se vorige sessies, en heropen die mees onlangse sodat jy kan voortgaan waar jy opgehou het.

4.5 Operasionele gidse

Gidse wat DeepCerebra intern gebruik — .deepcerebra, .sessions — verskyn in die boom maar is by verstek ingevou sodat dit nie jou bron verwar nie.

5 Werk met Lêers

• Klik 'n lêer in die Explorer om dit in die editor oop te maak; die minimap help jou om lang lêers te navigeer.
• Sleep 'n lêer van die Explorer na die gesels-prompt om dit as eksplisiete konteks vir jou volgende boodskap aan te heg.
• Wanneer die agent wysigings voorstel, wys die editor 'n inlyn diff vir die geselekteerde lêer.

6 Gesels met die Agent

Skryf 'n versoek

Beskryf wat jy wil hê in gewone taal — vra 'n vraag, versoek 'n funksie, of wys op 'n fout. Wees spesifiek oor lêers, raamwerke en beperkings om die beste resultaat te kry. Heg relevante lêers aan deur dit na die prompt te sleep.

Lees antwoorde, Cursor-styl

Antwoorde word soos Cursor georganiseer: die agent se redenasie word geskei van die lewerbare. Elke antwoordblok het 'n kopieer-ikoon in sy regter boonste hoek sodat jy 'n voltooide verslag, dokument, of 'n opdrag wat jy moet uitvoer, kan kopieer.

Stuur of stop 'n uitvoering

• Gebruik Stop om 'n uitvoering wat die verkeerde kant toe gaan, te stuit, en verfyn dan jou prompt.
• Gee wenke (bv. "gebruik lxml in plaas van html.parser") om die agent uit 'n lus te breek.

7 Die Vier Geselsmodusse

Kies 'n modus uit die modusselekteerder langs die prompt. Elkeen pas aan hoeveel die agent beplan en hoe vrylik dit wysig:

8 Hersiening & Toepassing van Veranderinge

Wanneer die agent lêerveranderinge voorstel, verskyn 'n Voorgestelde Veranderinge-paneel bo die geselsinvoer, wat elke aangeraakte lêer lys met bygevoegde (+) en verwyderde (−) lyn tellings.

• Klik 'n lêerry om sy inlyn diff in die editor oop te maak.
• Pas toe of Verwerp 'n enkele lêer, of gebruik Pas alles toe / Verwerp alles.
• Toegepaste veranderinge word gemerk applied (en · disk wanneer dit na 'n regte gids geskryf word).
• As daar geen skryfbare gids is nie, dui 'n slegs werkruimte-kenteken aan dat veranderinge op die in-blaaier-werkruimte van toepassing is.

9 Geïntegreerde Terminal

Skakel die terminal onder die editor aan om bouwerk, toetse en skripte uit te voer. Met jou magtiging kan die agent opdragte uitvoer en hul uitvoer lees om sy werk te verifieer; langlopende opdragte stroom uitvoer sodat jy vordering kan dophou. Sluit die terminal vanaf sy opskrif wanneer jy dit nie nodig het nie.

10 Planmodus & Uitvoering

Vir groter doelwitte, gebruik Plan-modus (of vra die agent om eers te beplan). Die beplanner skandeer jou projek, ontbind die doel in afhanklikheidsbewuste take, en ken elkeen toe aan die regte spesialis (argitek, kodeerder, toetser, dokumente).

• Hersien & wysig die plan — voeg take by, verwyder of wysig dit voor uitvoering.
• Voer laag vir laag uit — onafhanklike take loop saam; die beplanner kan herbeplan as 'n taak misluk.
• Onderbreek, hervat, of staak uitvoering te eniger tyd.

11 Kies Modelle & Auto

Maak die modelkieser langs die prompt oop. Opsies word gegroepeer as:

• Auto — laat DeepCerebra die beste beskikbare model kies (aanbeveel).
• Local (your GPU) — modelle wat vanaf jou eie masjien bedien word (sien §13).
• Platform gateways — gehuisvesde modelle, gegroepeer volgens gateway en dan volgens verskaffer (bv. Anthropic, OpenAI, Google).

Hoe Auto-seleksie werk

Op Auto gebruik DeepCerebra gelaagde, aanpasbare roetering: eenvoudige take gaan na 'n vinnige, ekonomiese model, terwyl komplekse of beplanning-swaar werk (byvoorbeeld, Plan-modus) na 'n sterker model gerig word. Dit balanseer koste en kwaliteit outomaties, sodat jy selde handmatig hoef te kies.

12 Bring Jou Eie Sleutel (BYOK)

Jy kan versoeke deur jou eie verskaffer-rekening roeteer in plaas van gemeterde platformgebruik.

1. Maak API Keys oop vanaf die sybalk.
2. Onder Bring Your Own Key, kies 'n verskaffer (bv. ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
3. Plak die sleutelwaarde en klik Stoor. Sleutels word geënkripteer in rus en word nooit na die blaaier teruggestuur nie — slegs 'n gemaskerde voorskou word gewys.

Platform (DeepCerebra) modelle benodig geen sleutel nie. Verwyder 'n sleutel enige tyd met Verwyder.

13 Plaaslike Masjien: GPU Models & Console (DCC Bridge)

Die DCC Bridge verbind jou eie rekenaar met die webtoepassing deur 'n klein dcc-bridge-konnektor, wat twee vermoëns gelyktydig ontsluit:

• Local GPU models — modelle wat deur Ollama of LM Studio op jou masjien bedien word, verskyn in die modelkieser onder Local (your GPU).
• Console / terminal on your machine — die webterminal en die agent kan regte opdragte op jou rekenaar uitvoer, insluitend CLI-gereedskap wat jy reeds gekonfigureer het (Railway, AWS CLI, OVH CLI, gh, docker, kubectl, WSL, …) met hul bestaande geloofsbriewe.

Die konnektor skakel uit oor 'n geoutentiseerde WebSocket — geen inkomende poorte benodig nie, en dit werk agter NAT en firewalls. Dit loop op Windows, macOS, en Linux (Python 3.10+).

13.1 Koppel jou rekenaar

1. Klik die skootrekenaar-ikoon in die linker aktiwiteitsbalk — Local Machine (GPU + Console). (Dieselfde paneel maak oop vanaf die modelkieser-voetstuk via Manage local GPU….)
2. Maak seker die Local execution-skakelaar is geaktiveer, gee die toestel 'n naam, en klik Voeg hierdie rekenaar by. Kopieer die eenmalige pairing token (dcc_brg_…) en die gereed-om-te-plak konnektor-opdrag — die token word presies een keer gewys.

13.2 Installeer & loop die konnektor

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

• Gebruik dieselfde domein wat jy in die blaaier gebruik as die gateway (wss://deepcerebra.ai of wss://deepcerebra.io) — die pairing card vul die regte een vooraf in. Die twee webwerwe is afsonderlike ontplooiings met afsonderlike rekeninge en tokens.
• Vir GPU-modelle, hou Ollama aan die gang, of aktiveer LM Studio se plaaslike bediener (verstekpoort 1234) met 'n model gelaai.
• Gekoppelde toestelle wys aanlyn/aflyn-status, modeltelling, en uitvoeromvang; jy kan 'n toestel te eniger tyd Herroep.

13.3 Gebruik jou konsole vanaf die webtoepassing

By verstek is opdragte beperk tot 'n toegewyde werkruimte-gids (~/DeepCerebra). Om in jou regte projekgidse met jou vooraf-gekonfigureerde CLIs te werk, gee hulle eksplisiet toestemming wanneer die konnektor begin word:

# 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

Maak dan die Terminal-paneel oop, klik die Execution target-opspringer (skootrekenaar-ikoon), kies My computer, en kies 'n werksgids. Beide jou getikte opdragte en die agent se bou-/toetsopdragte word dan op jou masjien uitgevoer.

14 Git Samewerkingswerkvloei

Met 'n Git-gesteunde projek oop, verskyn 'n branch-balk in die Explorer wat jou huidige branch en twee aksies wys:

• Check in (commit) — hersien die aantal veranderde lêers, skryf 'n commit-boodskap, en commit na jou werkende branch.
• Integreer — maak 'n pull request oop vanaf jou werkende branch na die verstek branch (bv. main). Jy moet op 'n werkende branch wees, nie die verstek branch nie.

As die push webhook geaktiveer is, verfris die Explorer outomaties wanneer spanmaats push, wat almal in sinkronisasie hou — die grondslag vir samewerkende spanontwikkeling deur DeepCerebra.

15 MCP Servers

Brei die agent uit met eksterne gereedskap en data via die Model Context Protocol. Konfigureer bedieners in 'n .deepcerebra/mcp.json-lêer, byvoorbeeld:

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

Geaktiveerde MCP-gereedskap word outomaties vir die agent beskikbaar wanneer dit relevant is vir jou versoek. Plaaslike (stdio) en afgeleë (http/sse) bedieners word albei ondersteun.

Ingeboude veiligheid

• Deny-by-default — wanneer 'n bediener 'n allowlist lys, kan slegs daardie gereedskap loop.
• Goedkeuring vir hoërisiko-gereedskap — muterende gereedskap (skryf/verwyder/ontplooi/…) benodig goedkeuring tensy jy dit vooraf goedkeur in autoApprove.
• Rate limiting, argument and output sanitation, en 'n ouditlog is van toepassing op elke oproep.

Hulpbronne & prompts

As 'n bediener MCP hulpbronne of prompt templates blootstel, kry die agent outomaties gereedskap om dit te gebruik (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt).

Outentikasie vir afgeleë bedieners

Voeg 'n auth-blok by 'n afgeleë bediener. Geheime ondersteun ${ENV_VAR}-interpolasie:

// 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 Pasmaak van die Agent: Reëls, Vaardighede, Hooks, Subagents & Plugins

Jy kan vorm hoe die agent dink en optree met 'n enkele, lêergebaseerde konvensie — die .deepcerebra/-gids — wat identies werk in die rekenaartoepassing, die webtoepassing, en die API. In die webtoepassing, bestuur al hierdie onder die Agent-aansig; op rekenaar en via die API is dit gewone lêers wat jy met jou projek commit.

Omvang & presedens

Konfigurasie word uit verskeie omvange ontdek; wanneer dieselfde item in meer as een bestaan, wen die hoër-presedens een:

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

• Workspace — <repo>/.deepcerebra/…, committed met die projek.
• Global — ~/.deepcerebra/…, jou persoonlike verstekke oor projekte heen.
• Team / org — 'n gedeelde basislyn (laagste presedens) sodat 'n gebruiker of projek dit altyd kan oorskryf. In die webtoepassing, stel 'n reël se Scope op Team.

Reëls (stuur)

Reëls is volgehoue instruksies — koderingsstandaarde, argitektuurkonvensies, domeinkonteks — wat in die agent se stelselprompt ingespuit word. Hulle leef as Markdown-lêers onder .deepcerebra/steering/, plus die altyd-aan AGENTS.md-standaard. Frontmatter beheer wanneer 'n reël laai:

---
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 — elke beurt (die verstek).
• fileMatch — slegs wanneer 'n in-konteks lêer ooreenstem met globs.
• auto — wanneer jou versoek ooreenstem met die reël se name/description.
• manual — slegs wanneer jy daarna verwys as #name of /name.

'n Wortel AGENTS.md is van toepassing op die hele repo; 'n geneste AGENTS.md (bv. services/api/AGENTS.md) is slegs van toepassing op lêers onder daardie gids. In die webtoepassing, die Agent → Steering-aansig gee elke reël 'n Scope-kieser (Global / Project / Team).

Vaardighede

Vaardighede is herbruikbare speelboeke wat die agent op aanvraag laai. Elke vaardigheid is 'n gids met 'n SKILL.md onder .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.

Die agent sien 'n liggewig katalogus (name + description) en trek die volle liggaam in met die load_skill-gereedskap wanneer relevant. Jy kan ook een eksplisiet aanroep met /skill <name>. Stel disable-model-invocation: true om 'n vaardigheid slegs-handmatig te maak.

Hooks

Hooks voer outomatisering uit op lewensiklusgebeurtenisse. Definieer hulle as .deepcerebra/hooks/*.hook.json:

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

Gebeurtenisse sluit in promptSubmit, preToolUse, postToolUse, fileCreate, fileSave, fileDelete, preTask, postTask, sessionStart, preCompact, en agentStop (Cursor/Claude-spellinge word ook aanvaar). 'n Aksie is óf shell (voer 'n opdrag uit) óf agentPrompt (vra die agent). 'n preToolUse-hook kan allow, deny, of ask vir die gereedskapoproep wat dit onderskep.

Subagents

Subagents is spesialisagente wat jy definieer en aan delegeer. Elkeen is 'n Markdown-lêer onder .deepcerebra/agents/ met frontmatter plus 'n liggaam (sy stelselprompt):

---
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…

Die hoofagent delegeer met task (blokkering), task_async + task_status / task_result (agtergrond), of task_parallel (fan-out).

Plugins

'n Plugin bundel reëls, vaardighede, hooks, subagents, en MCP-bedieners in een installeerbare pakket onder .deepcerebra/plugins/<name>/, beskryf deur 'n plugin.json-manifes:

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

Plugin-inhoud word saamgevoeg teen die laagste presedens, sodat jou eie reëls en vaardighede altyd 'n plugin s'n oorskryf. Deaktiveer 'n plugin met "enabled": false of 'n .disabled-merkerlêer.

17 Agentic Workflow Studio & Gebeurtenisgedrewe Agente

Die Workflow Studio is 'n visuele ontwerper vir multi-agent-outomatisering. Jy komponeer stages — elk 'n agent, 'n spesialisstap, of 'n beheerprimitief — in 'n grafiek, verbind hulle met afhanklikhede, en voer die hele orkestrasie op die enjin uit met lewendige vordering per stage, begrotings, en menslike-goedkeuringshekke. Werkvloeie word gestoor as 'n draagbare YAML/JSON-definisie wat jy kan uitvoer, invoer, weergawe in Git, en vanaf die API of CLI uitvoer.

17.1 Bou 'n werkvloei

• Palette (links) — sleep stage-soorte, klaargemaakte agent-tipes (navorsing, kode generering, QA, dokument-skrywer, mediese toestel, patent-advokaat, en jou eie pasgemaakte tipes), vaardighede uit die Vaardigheidsbiblioteek, en gereedskap op die doek.
• Canvas (middel) — rangskik stages en trek rande; 'n rand beteken "hierdie stage hang af van daardie een" en voer outomaties die stroomop-uitvoer in die stroomaf-prompt in.
• Inspector (regs, veranderbaar) — konfigureer die geselekteerde stage: sy prompt, vaardighede, gereedskap, model override per stage, uitvoer-artefak, hek, gebeurtenisse, en soortspesifieke parameters.
• Templates — begin vanaf 'n ingeboude bloudruk (Ship-It Pipeline, SaaS Starter, Data Pipeline with Evals, Customer Comms Hub, Design → Verified App) en pas dit aan.
• Genereer — beskryf die toepassing of proses in gewone taal en die Agent Builder genereer 'n volledige, gevalideerde werkvloei-grafiek wat jy kan hersien, aanpas en uitvoer.

17.2 Die stage-biblioteek

17.3 Gebeurtenisgedrewe agente (die agent-netwerk)

Elke stage — ongeag die soort — kan publiseer en inteken op getikte gebeurtenisse op die werkruimte-gebeurtenisbus, sodat agente koördineer soos dienste op 'n boodskapstof eerder as slegs deur die DAG:

• Gebeurtenisklasse — elke gebeurtenis dra 'n klas: lifecycle, agent, business, data, system, schedule, chat, external, of alert — filterbaar in intekeninge en herhaling.
• Intekenmodusse — trigger (die stage loop wanneer 'n ooreenstemmende gebeurtenis arriveer; 'n uitvoering met geparkeerde stages bly resident as listening), gate ('n masjienhek goedgekeur deur 'n gebeurtenis in plaas van 'n menslike klik), en data (die loonvrag word in die stage se konteks saamgevoeg).
• Aftrap deur gebeurtenis — enige agent kan deur 'n orkestrator of 'n ander agent begin word deur na sy adres agent.<stage-id>.request te publiseer.
• Uitvoer-triggers — 'n werkvloei se triggers:-blok bewapen dit om te begin op inkomende webhooks, cron schedules, events, of gesels — selfs terwyl die Studio gesluit is.
• Lewendige uitvoere — die uitvoerpaneel stroom lewensiklusgebeurtenisse oor SSE: stage-begin/voltooiings, hekke, waarskuwings, en voorskoue verskyn onmiddellik.
• Duursame log & herhaling — gebeurtenisse bly voortbestaan per werkruimte en kan herhaal word volgens onderwerppatroon en klas vir oudit en ontfouting.

17.3.1 Gebeurtenisryvorming vir agente

Agente wat op gebeurtenisse reageer, kan 'n duursame benoemde ry verklaar sodat ooreenstemmende gebeurtenisse nooit verlore gaan terwyl die agent besig is of voordat 'n uitvoering luister nie. Op 'n snellerintekening, stel queue: <name> — die enjin bind daardie onderwerp aan 'n FIFO-ry op die werkspasie-gebeurtenisbus (volgehou onder .deepcerebra/workflows/events/queues/). Elke ooreenstemmende gebeurtenis wat van daardie punt af gepubliseer word, word in die ry vasgelê; wanneer die stadium uitvoerbaar word, haal die enjin gebeurtenisse in oudste-eerste volgorde uit en verbruik dit een vir een.

• Niks verlore nie — gebeurtenisse wat gepubliseer word terwyl die werkvloei gesluit is, terwyl 'n ander stadium loop, of terwyl die uitvoering nog op afhanklikhede wag, word in die ry geplaas in plaas daarvan om laat val te word.
• Per-intekening count — vereis N gebeurtenisse in die ry (of gelewer) voordat die intekening bevredig word (nuttig wanneer verskeie werkers moet aanmeld).
• Studio — in die Inspekteur se Gebeurtenisse-paneel, stel die queue-veld op 'n snellerintekening; aktiveer snellers of begin 'n uitvoering om die binding outomaties te skep.
• API & gereedskap — GET /api/workflow/queues lys diepte en bindings; GET /api/workflow/queues/{name} loer na hangende gebeurtenisse; kletsagente kan event_queue_status en pop_queued_event aanroep.

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 Semafoor-orkestrasie (gedeelde-hulpbronbeskerming)

'n semafoor beperk hoeveel take gelyktydig op 'n gedeelde (beskermde) hulpbron mag werk: 'n databasis wat geskryf word, 'n globale veranderlike stoor, 'n lêer, of 'n eksterne agent met 'n beperkte tempo. Heg een aan enige stadium met semaphore: — voordat die stadium se werk loop, verkry die enjin een permit van die benoemde werkspasie-semafoor; die permit word altyd vrygestel daarna, selfs al misluk die stadium. permits: 1 maak dit 'n mutex: slegs een taak op 'n slag (oor alle parallelle uitvoerings in die werkspasie) voer die kritieke stap uit; elke ander taak wag totdat die houer klaar is.

• Kruis-uitvoering serialisering — semafore is werkspasie-omvangryk en volgehou, sodat twee gelyktydige werkvloei-uitvoerings nie dieselfde beskermde hulpbron kan korrupteer nie.
• Wag, nie hang nie — take blokkeer tot timeout_s vir 'n permit; as die hulpbron op kapasiteit bly, misluk die stadium sigbaar in plaas daarvan om vir ewig te hang.
• Ongelukveiligheid — elke permit dra 'n ttl_s; as 'n houer ineenstort sonder om vry te stel, verval die permit outomaties sodat die hulpbron nooit doodgesluit word nie.
• Waarnembaarheid — die bus stuur semaphore.<name>.waiting, .acquired, en .released stelselgebeurtenisse uit; GET /api/workflow/semaphores toon kapasiteit, houers, en beskikbare permitte.
• Kletsagente — acquire_semaphore, release_semaphore, en semaphore_status gereedskap koördineer ad-hoc kritieke afdelings buite 'n werkvloei.

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 Rendezvous-orkestrasie (wag vir alle voorwaardes)

Rendezvous wag totdat veelvuldige gebeurtenisvoorwaardes almal nagekom is voordat die volgende stap voortgaan — die teenoorgestelde van "eerste gebeurtenis wen." Stel join: all op die stadium se events: blok: elke snellerintekening moet bevredig word voordat die stadium loop. Kombineer met per-intekening count: N wanneer verskeie agente (of verskeie verslae van een agent) almal moet inklok — byvoorbeeld, ontwerpgoedkeuring, toetsvoltooiing, en sekuriteitsgoedkeuring voordat 'n vrystellingstadium uitgevoer word.

• join: any (verstek) — die stadium loop wanneer die eerste snellerintekening bevredig word.
• join: all — rendezvous: elke snellerintekening (elk met sy eie onderwerp, klasfilter, en opsionele count) moet bevredig word; slegs dan word die stadium uitvoerbaar.
• Laaie — alle verbruikte gebeurtenisse word op die stadium as trigger_events aangeteken en aan sjablone blootgestel as inputs.events ('n lys van gebeurtenisobjekte met laaie).
• Studio — wanneer 'n stadium twee of meer snellerintekeninge het, wys die Inspekteur 'n Join-kieser: any — eerste gebeurtenis wen of all — rendezvous (wag vir almal); die doek wys 'n samesmeltingskenteken op rendezvous-stadiums.

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 Die agent-gereedskapbiblioteek

Stages kies gereedskap uit dieselfde register wat die geselsagent gebruik:

• Kern — lêers, git, shell, kode-uitvoering, kode-soektog, blaaier-outomatisering, websoektog, visie/media, beeldgenerering.
• Databasisse — SQLite, PostgreSQL, MySQL, MongoDB, en Redis-navrae plus create_database, apply_migrations, en dump_schema vir eie datalae.
• Kommunikasie — telefoonoproepe en SMS (Twilio) en e-pos (SendGrid), met 'n simulasie-modus wat na 'n uitboks opneem wanneer geloofsbriewe afwesig is — demo's stuur nooit per ongeluk regte boodskappe nie.
• DevOps — docker_build / docker_push, compose up/down, SSH en cloud-CLI-ontplooiings (Fly, Render, Railway, Vercel), ook simulasie-veilig.
• Verifikasie — stapelopsporing, toetsuite-uitvoering met geparseerde slaagsyfers, afhanklikheidsoudits, en geheime skandering.
• SciCompute Engines — honderde wetenskaplike en ingenieursmetodes (genoem Class.method) oor wiskunde, seinverwerking, kontroles, statistiek, en meer.
• Expert Agency & MCP — gegronde domeinnavorsing plus enige eksterne MCP-bedieners wat jy verbind.

17.5 Uitvoering, hekke en uitvoere

• Valideer kontroleer die grafiek (unieke ID's, asikliese afhanklikhede, soortparameters) voordat jy uitvoer.
• Menslike hekke onderbreek die uitvoering nadat die stage sy konsep produseer, sodat jy regte werk goedkeur; gebeurtenishekke laat 'n ander stelsel outomaties goedkeur.
• Begrotings beperk besteding per uitvoering en per stage.
• Stoor uitvoere na projek kopieer elke artefak wat 'n uitvoering gegenereer het na jou oop projek.
• Voer toepassing uit verander die werkvloei in 'n selfstandige FastAPI-diens; die publieke /v1 API stel uitvoere, gebeurtenisse, triggers, templates, en generering vir CI en integrasies bloot.

18 Voorspellende Tab Completion

Voorspellende Tab completion bied inlyn, vul-in-die-middel kodevoorstelle terwyl jy in die editor tik — aanvaar 'n voorstel met Tab. Dit is opt-in op beide die enjin en die web-editor.

Aktiveer dit

• Enjin — stel die omgewingsvlag DCC_TAB_COMPLETE=1. Die editor roep die enjin se POST /api/complete-eindpunt aan, wat slegs die teks terugstuur om by die wyser in te voeg.
• Web-editor — aktiveer tydens bou met VITE_TAB_COMPLETE=1, of tydens looptyd met localStorage.setItem('dcc.tabComplete', '1') (herlaai dan).

Hoe dit optree

• Voorstelle verskyn as spookteks; druk Tab om te aanvaar, of hou aan tik om te verwerp.
• Versoeke word gedebounce en gekanselleer, sodat tik nooit geblokkeer word nie.
• Wanneer die vlag af is, is die funksie heeltemal gedeaktiveer en geen voltooiingsversoeke word gemaak nie.

19 Gebruik, Krediete & Billing

Maak Billing oop vanaf die sybalk om jou plan en gebruik te bestuur. KI-gebruik word gemeet in V.S.-dollar-krediete gebaseer op die tokens wat deur die onderliggende modelle verbruik word.

• Siklusbesteding & vooruitbetaalde krediet — volg gebruik hierdie siklus en enige vooruitbetaalde balans.
• Voeg oorskrydingskrediet by — magtig 'n addisionele bedrag (USD) om KI te bly gebruik nadat die ingeslote toelae bestee is; as jou begroting uitgeput is, sal jy 'n banier sien wat jou vra om krediet by te voeg.
• Gradeer op / verander plan — wissel vlakke te eniger tyd.
• Betaalmetode — voeg die kaart op lêer by of werk dit op (verwerk deur Stripe).
• Kanselleer — kies kanselleer aan die einde van die tydperk (behou toegang totdat die tydperk eindig) of kanselleer nou (terugbetaal die terugbetaalbare restant). Sien die Kansellasie- & Terugbetalingsbeleid.

20 Kry Jou Gateway API Key

'n Gateway API key ('n persoonlike toegangstoken) laat jou toe om die DeepCerebra publieke API en CLI programmaties te gebruik.

1. Meld aan en maak API Keys oop vanaf die sybalk.
2. Rollees na DeepCerebra API Keys.
3. Voer 'n etiket in (bv. "CI pipeline" of "laptop CLI").
4. Kies scopes — read, chat, code, agent — en 'n opsionele expiry in dae (leeg = nooit).
5. Klik Genereer. Die volle sleutel word slegs een keer gewys — klik Kopieer en stoor dit veilig.

Gebruik dit met die CLI of die API by 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/...

Jy kan 'n sleutel enige tyd hernoem of uitvee (herroep); elke sleutel wys sy voorvoegsel, scopes, geskep/expiry, en laaste-gebruik datum.

21 Sekuriteit & Privaatheid

• Vertroulike in-blaaier-berging — jou projeklêers bly in die blaaier se geënkripteerde werkruimte; slegs die minimale konteks wat per versoek benodig word, word na die bediener gestuur.
• Zero Data Retention (ZDR) — prompts en kode wat na modelle gerig word, word nie langer as die versoek behou nie en word nooit gebruik om grondslagmodelle op te lei nie.
• Sleutels bly bedienerkant — BYOK en SCM-tokens word geënkripteer in rus; slegs gemaskerde voorskoue word gewys.
• Enkripsie — TLS in transito; rekeningdata geënkripteer in rus; wagwoorde onherroeplik gehash.
• Jou kode is joune — jy besit jou inhoud en die gegenereerde uitvoer. Sien die Privaatheidsverklaring.

22 Probleemoplossing

"Folder loading needs a Chromium browser"

Skakel oor na Chrome, Edge, of Brave, of gebruik eerder Open from Git.

Die agent loop in dieselfde fout

Klik Stop, herformuleer dan met 'n konkrete wenk of beperking.

Model- of versoekfoute / "budget exhausted"

• Kontroleer jou verbinding en dat enige BYOK-sleutel geldig is.
• Skakel oor na Auto sodat DeepCerebra na 'n beskikbare model roeteer.
• As jou gebruiksbudget uitgeput is, maak Billing oop en voeg oorskrydingskrediet by of gradeer jou plan op.

Plaaslike modelle verskyn nie

• Bevestig dat die dcc-bridge-konnektor loop en die toestel aanlyn wys.
• Maak seker Ollama loop, of LM Studio se plaaslike bediener is geaktiveer (verstekpoort 1234) met 'n model gelaai.

Konnektor: "server rejected WebSocket connection: HTTP 401"

• Gebruik dieselfde domein wat jy in die blaaier gebruik as --gateway (wss://deepcerebra.ai of wss://deepcerebra.io) — die twee webwerwe is afsonderlike ontplooiings, en 'n token van die een werk nooit op die ander nie.
• Kopieer die presiese opdrag vanaf die pairing card op die Local Machine-bladsy.

My veranderinge het nie in werking getree nie

• Maak seker jy het Pas toe geklik (nie net die diff voorskou nie) in Voorgestelde Veranderinge.
• Gebruik die Explorer verfris om die gids weer te skandeer.

Git: "You are on the default branch"

Maak 'n werkende branch oop of skep dit voordat jy Integreer gebruik om 'n pull request oop te maak.

Steeds vas? Kontak support@deepcerebra.ai.

23 DeepCerebra Discovery — Vra Jou Data & Dokumente

Discovery is 'n ondersoekende kletsbot vir jou databasisse en dokumente. In plaas daarvan om met 'n enkele navraag te antwoord, werk dit soos 'n ontleder: dit vorm hipoteses, voer 'n reeks bewaakte ondersoeke uit (SQL, grafiek, dokumentsoektog, skemakontroles, webbevestiging), snoei die verduidelikings wat die bewyse weerlê, en sintetiseer 'n gegronde antwoord — met kaarte en 'n deursigtige koste-kwitansie. Maak dit oop vanaf die kompas-ikoon in die aktiwiteitsbalk (/app/discovery).

23.1 Spasies — jou saamgestelde omvang

'n Spasie bundel alles wat 'n ondersoeklyn benodig: databasisverbindings, dokumentversamelings, instruksies vir die ontleder, en begrotings. Skep een met + Nuwe spasie, gebruik dan die opstelpaneel aan die regterkant om:

• Koppel databasisse — SQLite, PostgreSQL, MySQL, SQL Server, of Snowflake. Voer 'n naam en DSN in, klik Toets om konnektiwiteit te verifieer (latensie en bedienerweergawe word getoon), of voer 'n bestaande verbindingkonfigurasie as JSON in. Verbindings is standaard slegs-lees.
• Voeg dokumente by — sleep & los lêers (PDF, DOCX, PPTX, Markdown, teks) direk in die klets, plak 'n URL, of wys na 'n vouerpad op die enjin-gasheer. Dokumente word in stukke verdeel, ingebed en geïndekseer vir hibriede vektor + kennisgrafiek-soektog.
• Voer tabelle in — plak of laai CSV/JSON op om onmiddellik navraag te doen sonder enige databasis.
• Leer die ontleder — voeg metrieke definisies, besigheidsreëls en waarskuwings, kurator-goedgekeurde betroubare navrae, en voorbeeld vraag→navraag-pare by sodat antwoorde jou definisies gebruik.

23.2 'n Vraag vra

Tik 'n vraag soos jy 'n kollega sou vra — byvoorbeeld "Waarom het MRI-skanderingvolume in Maart gedaal?". Die ondersoekbord stroom die hele proses regstreeks:

• Hipoteses — die kandidaatverduidelikings onder ondersoek, elk gemerk ondersteun, weerlê, of onbeslis soos bewyse arriveer.
• Ondersoeke — elke navraag wat die ontleder uitvoer, met sy status; gegenereerde SQL/Cypher word getoon vir volle deursigtigheid, en elke stelling slaag slegs-lees-wagreëls voor uitvoering.
• Bewyse — resultaattabelle en dokumentuittreksels, genommer in die finale antwoord.
• Antwoord + kaarte — 'n gegronde gevolgtrekking wat ook die verduidelikings noem wat uitgesluit is, plus moderne neon-tema kaarte saamgestel uit die bewyse.
• Kwitansie — tokens, koste per ondersoek, en rondtes, gehef aan jou AI Credits soos enige ander agent-uitvoering.

Opvolgvrae gaan voort met dieselfde draad, sodat die ontleder sy konteks behou.

23.3 Kaarte, verslae & uitvoere

Kaarte word inlyn op die ondersoekbord weergegee. Gebruik Uitvoer om die volledige navraag — die antwoord, hipoteses, bewyse en kaarte — af te laai as 'n selfstandige HTML-verslag of 'n drukkwaliteit PDF, gestileer met die neon-ontwerpstelsel.

23.4 Begrotings & kostebeheer

Elke spasie het begrotings per navraag: 'n maksimum aantal ondersoeke, ondersoekrondtes, sekondes, en USD. Die enjin stop netjies by die limiet en rapporteer wat dit tot dusver gevind het. Elke ondersoek se koste word op die kwitansie gespesifiseer, sodat jy altyd weet waar die uitgawe heen gegaan het.

23.5 Outomatisering: API, SDK, Workflow Studio & MCP

• REST API — alles wat die UI doen, is beskikbaar onder /v1/discovery/* met 'n PAT wat die discovery omvang dra (skep dit onder Rekening → API Tokens). Stroomnavrae gebruik SSE. Eksterne uitvoerders kan slegs die ondersoekende beplanning leen via die Thinking API (/v1/think/*, omvang think).
• Python SDK — pip install deepcerebra-discovery, dan DiscoveryClient(base_url, token).ask(space_id, question).
• Workflow Studio — sleep die Discovery Ask-fase (discovery.ask) in enige werkvloei om 'n ondersoek as 'n pyplynstap uit te voer; die antwoord, kaarte en kwitansie vloei na stroomaf fases.
• MCP — die enjin stel discovery_ask en discovery_list_spaces bloot as MCP-gereedskap, sodat eksterne MCP-kliënte ook ondersoeke kan uitvoer.