1 Sissejuhatus ja väljaanded

DeepCerebra Coder on agentne kodeerimisassistent. Erinevalt tavalisest automaatse täitmise kaasabilistest planeerib, kirjutab, refaktoriseerib, käivitab käske, kutsub tööriistu ja itereerib üle teie terve projekti — teie vaatate üle ja kinnitate selle pakutud muudatused.

Kolm kasutusviisi

See juhend keskendub veebirakendusele aadressil deepcerebra.ai; töölauarakendus peegeldab samu paneele ja töövooge.

2 Alustamine ja konto

Toetatud brauserid

Kasutage täieliku kogemuse saamiseks Chrome'i, Edge'i või Brave'i praegust versiooni — kohaliku kausta avamine tugineb Chromiumi File System Access API-le. Firefox ja Safari töötavad vestluse ja Giti toetatud projektide puhul, kuid ei saa kohalikku kausta otse avada.

Loo konto

1. Klõpsake maandumislehel nuppu Alusta.
2. Täitke oma valikuline kuvatav nimi, e-posti aadress, riik ja sünnikuupäev (peate olema vähemalt 18-aastane).
3. Valige oma liidese keel ja vähemalt 12-kohaline parool.
4. Lugege läbi lepingu teatis ja kinnitage. Konto loomine tähendab, et nõustute teenusetingimustega, privaatsusavaldusega, teenuste kirjeldusega ja ülemaailmse DPA-ga.
5. Klõpsake nuppu Loo konto, seejärel kinnitage oma e-posti aadress, kui seda küsitakse, ja logige sisse.

Lähtesta oma parool

1. Sisselogimislehel klõpsake nuppu Unustasid parooli?
2. Sisestage oma e-posti aadress ja avage postkasti saadetud lähtestamislink.
3. Määrake uus parool (vähemalt 12 märki).

3 Tööruum lühidalt

Pärast sisselogimist jõuate töölauda, mis koondab kõik paneelid ühele ekraanile:

• Avastaja (vasakul) — avatud projekti failipuu koos värskendamise ja sulgemise nupuga.
• Redaktor (keskel) — faili sisu süntaksi esiletõstmise ja minimapi ülevaatega; siin kuvatakse reasisesed erinevused, kui agent pakub muudatusi.
• Terminal (redaktori all, lülitatav sisse/välja) — käskude käivitamine ja väljundi lugemine.
• Vestlus (paremal) — agendi vestlus; see on peamine, ruumi täitev paneel.

Lohistage redaktori ja vestluse vahelist jagajat paigutuse tasakaalustamiseks ning lohistage horisontaalset jagajat terminali suuruse muutmiseks. Vasak külgriba navigeerib ka jaotistesse Tööruum, Laiendused, API võtmed, Arveldamine ja Tagasiside.

4 Projekti avamine

4.1 Ava kohalik kaust

1. Avastajas klõpsake nuppu Ava projekti kaust.
2. Valige kaust ja andke brauserile luba seda lugeda.
3. Failid loetakse teie brauseri krüpteeritud brauserisisesesse tööruumi — midagi ei laadita üles. Näete reaalajas loendust ja lõplikku kokkuvõtet (failide arv · suurus, pluss kõik vahele jäetud või lühendatud failid).

4.2 Ava Gitist (GitHub / GitLab)

1. Klõpsake Avastajas nuppu Ava Gitist.
2. Valige vahekaart GitHub või GitLab ja kleepige isiklik juurdepääsutoken. GitHubi puhul kasutage repo ulatust (klassikaline) või peeneteralist tokenit koos sisuga + Pull requests; GitLab'i puhul kasutage api ulatust. Teie token salvestatakse serverisse — brauserisse tõmmatakse ainult faili sisu.
3. Sisestage repositoorium kujul owner/name (filtreerige loendit oma leidmiseks), seejärel valige haru.
4. Valikuliselt märkige Loo uus tööharu (nt dcc/my-feature), et hoida oma töö vaikeharust eraldatuna.
5. Valikuliselt lubage push webhook, et Avastaja värskenduks koheselt, kui meeskonnakaaslased pushivad (vajab avalikku värava URL-i).
6. Klõpsake nuppu Ava repositoorium.

4.3 Värskenda, vaheta ja sulge

• Värskenda (↻ Avastaja päises) skaneerib kausta uuesti või tõmbab Gitist uusima.
• Ava teine kaust või Ava Gitist puu all olevatest nuppudest.
• Sulge projekt (prügikasti ikoon) kustutab brauserisisese tööruumi.

4.4 Kaustapõhised vestlusseansid

Vestluse ajalugu on seotud avatud projektiga. Kaustade vahetamine käivitab automaatselt uue seansi ja laadib selle kausta eelmised seansid, avades uuesti kõige värskema, et saaksite jätkata sealt, kus pooleli jäite.

4.5 Operatiivkaustad

Kaustad, mida DeepCerebra sisemiselt kasutab — .deepcerebra, .sessions — ilmuvad puus, kuid on vaikimisi kokku tõmmatud, et need teie allikat ei risustaks.

5 Failidega töötamine

• Klõpsake failil Avastajas, et avada see redaktoris; minimap aitab teil pikkades failides navigeerida.
• Lohistage fail Avastajast vestluse sisestusväljale, et lisada see oma järgmise sõnumi selgesõnaliseks kontekstiks.
• Kui agent pakub muudatusi, näitab redaktor valitud faili reasiseseid erinevusi.

6 Agendiga vestlemine

Kirjuta päring

Kirjeldage, mida soovite lihtsas keeles — esitage küsimus, taotlege funktsiooni või osutage veale. Olge failide, raamistike ja piirangute osas täpne, et saada parim tulemus. Lisage asjakohased failid, lohistades need sisestusväljale.

Loe vastuseid, Cursor-stiilis

Vastused on korraldatud nagu Cursor: agendi põhjendus on eraldatud tulemusest. Igal vastuseplokil on paremas ülemises nurgas kopeerimisikoon, et saaksite kopeerida valmis aruande, dokumendi või käsu, mida peaksite käivitama.

Juhi või peata käivitus

• Kasutage nuppu Peata, et peatada vales suunas liikuv käivitus, seejärel täpsustage oma sisestust.
• Andke vihjeid (nt "kasuta lxml asemel html.parser"), et agent silmusest välja tuua.

7 Neli vestlusrežiimi

Valige režiim sisestusvälja kõrval olevast režiimivalijast. Igaüks neist reguleerib, kui palju agent planeerib ja kui vabalt ta redigeerib:

8 Muudatuste ülevaatamine ja rakendamine

Kui agent pakub failimuudatusi, ilmub vestluse sisestusvälja kohale paneel Pakutud muudatused, mis loetleb iga puudutatud faili lisatud (+) ja eemaldatud (−) ridade arvuga.

• Klõpsake failireal, et avada selle reasisene erinevus redaktoris.
• Rakenda või Keeldu ühest failist, või kasutage Rakenda kõik / Keeldu kõigist.
• Rakendatud muudatused on märgitud applied (ja · disk, kui need on kirjutatud reaalsesse kausta).
• Kui kirjutatavat kausta pole, näitab ainult tööruumi märk, et muudatused kehtivad brauserisisesele tööruumile.

9 Integreeritud terminal

Lülitage redaktori all olev terminal sisse/välja, et käivitada ehitusi, teste ja skripte. Teie loal saab agent käivitada käske ja lugeda nende väljundit oma töö kontrollimiseks; pikalt kestvad käsud edastavad väljundit voogedastusega, et saaksite edenemist jälgida. Sulgege terminal selle päisest, kui te seda ei vaja.

10 Plaani režiim ja täitmine

Suuremate eesmärkide jaoks kasutage Plaani režiimi (või paluge agendil esmalt planeerida). Planeerija skaneerib teie projekti, jaotab eesmärgi sõltuvustundlikeks ülesanneteks ja määrab igaühe õigele spetsialistile (arhitekt, kodeerija, testija, dokumendid).

• Vaadake plaan üle ja redigeerige seda — lisage, eemaldage või muutke ülesandeid enne täitmist.
• Täitke kiht kihi haaval — sõltumatud ülesanded käivituvad koos; planeerija saab ümber planeerida, kui ülesanne ebaõnnestub.
• Peatage, jätkake või katkestage täitmine igal ajal.

11 Mudelite valimine ja automaatne

Avage sisestusvälja kõrval olev mudelivalija. Valikud on rühmitatud järgmiselt:

• Automaatne — laske DeepCerebral valida parim saadaolev mudel (soovitatav).
• Kohalik (teie GPU) — teie enda masinast pakutavad mudelid (vt §13).
• Platvormi väravad — hostitud mudelid, rühmitatud värava ja seejärel müüja järgi (nt Anthropic, OpenAI, Google).

Kuidas automaatne valik töötab

Automaatrežiimis kasutab DeepCerebra astmelist, adaptiivset marsruutimist: lihtsad ülesanded suunatakse kiirele ja ökonoomsele mudelile, samas kui keeruline või planeerimist nõudev töö (näiteks Plaani režiim) suunatakse tugevamale mudelile. See tasakaalustab automaatselt kulusid ja kvaliteeti, nii et te peate harva käsitsi valima.

12 Too oma võti (BYOK)

Saate suunata päringud oma teenusepakkuja konto kaudu, selle asemel et kasutada mõõdetud platvormikasutust.

1. Avage külgribalt API võtmed.
2. Jaotises Too oma võti valige pakkuja (nt ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
3. Kleepige võtme väärtus ja klõpsake nuppu Salvesta. Võtmed on puhkeolekus krüpteeritud ja neid ei tagastata kunagi brauserisse — kuvatakse ainult maskeeritud eelvaade.

Platvormi (DeepCerebra) mudelid ei vaja võtit. Eemaldage võti igal ajal nupuga Eemalda.

13 Kohalik masin: GPU mudelid ja konsool (DCC Bridge)

DCC Bridge ühendab teie enda arvuti veebirakendusega väikese dcc-bridge konnektori kaudu, avades korraga kaks võimalust:

• Kohalikud GPU mudelid — teie masinas Ollama või LM Studio poolt pakutavad mudelid ilmuvad mudelivalijas jaotises Kohalik (teie GPU).
• Konsool / terminal teie masinas — veebiterminal ja agent saavad teie arvutis käivitada reaalseid käske, sealhulgas CLI tööriistu, mille olete juba konfigureerinud (Railway, AWS CLI, OVH CLI, gh, docker, kubectl, WSL, …) koos nende olemasolevate mandaatidega.

Konnektor helistab välja autentitud WebSocketi kaudu — sissetulevaid porte pole vaja ja see töötab NAT-i ja tulemüüride taga. See töötab Windowsis, macOS-is ja Linuxis (Python 3.10+).

13.1 Siduge oma arvuti

1. Klõpsake vasakpoolsel tegevusribal sülearvuti ikoonil — Kohalik masin (GPU + konsool). (Sama paneel avaneb mudelivalija jalusest nupu Halda kohalikku GPU-d… kaudu.)
2. Veenduge, et Kohalik täitmine lüliti on lubatud, nimetage seade ja klõpsake nuppu Lisa see arvuti. Kopeerige ühekordne sidumistoken (dcc_brg_…) ja kleepimiseks valmis konnektori käsk — tokenit näidatakse täpselt üks kord.

13.2 Installige ja käivitage 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

• Kasutage väravana sama domeeni, mida kasutate brauseris (wss://deepcerebra.ai või wss://deepcerebra.io) — sidumiskaart eeltäidab õige. Need kaks saiti on eraldi juurutused eraldi kontode ja tokenitega.
• GPU mudelite puhul hoidke Ollama töös või lubage LM Studio kohalik server (vaikeport 1234) laetud mudeliga.
• Seotud seadmed näitavad võrgus/võrguühenduseta olekut, mudelite arvu ja täitmise ulatust; saate seadme igal ajal tühistada.

13.3 Kasutage oma konsooli veebirakendusest

Vaikimisi on käsud piiratud spetsiaalse tööruumi kaustaga (~/DeepCerebra). Et töötada oma reaalsetes projektikaustades oma eelkonfigureeritud CLI-dega, andke neile luba konnektori käivitamisel:

# 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

Seejärel avage paneel Terminal, klõpsake Täitmise sihtmärgi hüpikaknal (sülearvuti ikoon), valige Minu arvuti ja valige töökataloog. Nii teie sisestatud käsud kui ka agendi ehitus-/testimiskäsud täidetakse seejärel teie masinas.

14 Giti koostöö töövoog

Kui Giti toetatud projekt on avatud, ilmub Avastajasse haruriba, mis näitab teie praegust haru ja kahte toimingut:

• Sisse registreerimine (commit) — vaadake üle muudetud failide arv, kirjutage commit-sõnum ja commitige oma tööharusse.
• Integreeri — avage tõmbepäring oma tööharust vaikeharusse (nt main). Peate olema tööharus, mitte vaikeharus.

Kui push webhook on lubatud, värskendab Avastaja automaatselt, kui meeskonnakaaslased pushivad, hoides kõik sünkroonis — see on DeepCerebra kaudu toimuva meeskondliku koostöö alus.

15 MCP serverid

Laiendage agenti väliste tööriistade ja andmetega Model Context Protocol kaudu. Konfigureerige serverid failis .deepcerebra/mcp.json, näiteks:

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

Lubatud MCP tööriistad muutuvad agendile automaatselt kättesaadavaks, kui need on teie päringu jaoks asjakohased. Toetatud on nii kohalikud (stdio) kui ka kaugserverid (http/sse).

Sisseehitatud turvalisus

• Vaikimisi keelamine — kui serveris on loetletud allowlist, saavad käivituda ainult need tööriistad.
• Kõrge riskiga tööriistade heakskiit — muutvad tööriistad (kirjutamine/kustutamine/juurutamine/…) vajavad heakskiitu, välja arvatud juhul, kui te need eelnevalt heaks kiidate sättes autoApprove.
• Iga kõne puhul kehtivad määrade piiramine, argumentide ja väljundi puhastamine ning auditi logi.

Ressursid ja viiped

Kui server eksponeerib MCP ressursse või viipemalle, saab agent automaatselt tööriistad nende kasutamiseks (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt).

Kaugserverite autentimine

Lisage kaugserverile auth plokk. Saladused toetavad ${ENV_VAR} interpolatsiooni:

// 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 Agendi kohandamine: reeglid, oskused, konksud, alamagendid ja pluginad

Saate kujundada, kuidas agent mõtleb ja tegutseb ühe failipõhise konventsiooniga — kataloogiga .deepcerebra/ —, mis töötab identselt töölauarakenduses, veebirakenduses ja API-s. Veebirakenduses hallake kõiki neid jaotises Agent; töölaual ja API kaudu on need tavalised failid, mille te oma projektiga commitite.

Ulatused ja prioriteet

Konfiguratsioon avastatakse mitmest ulatusest; kui sama element eksisteerib mitmes, võidab kõrgema prioriteediga:

team/org  <  global (~/.deepcerebra)  <  workspace (<repo>/.deepcerebra)
(madalaim)                                              (kõrgeim)

• Tööruum — <repo>/.deepcerebra/…, commititud projektiga.
• Globaalne — ~/.deepcerebra/…, teie isiklikud vaikesätted kõigi projektide lõikes.
• Meeskond / organisatsioon — jagatud baasjoon (madalaim prioriteet), nii et kasutaja või projekt saab seda alati tühistada. Veebirakenduses määrake reegli Ulatus väärtuseks Meeskond.

Reeglid (juhtimine)

Reeglid on püsivad juhised — kodeerimisstandardid, arhitektuurikonventsioonid, domeenikontekst —, mis süstitakse agendi süsteemiviipesse. Need asuvad Markdowni failidena kataloogis .deepcerebra/steering/, lisaks alati aktiivne AGENTS.md standard. Frontmatter kontrollib millal reegel laaditakse:

---
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 — igal pöördel (vaikimisi).
• fileMatch — ainult siis, kui kontekstis olev fail vastab globs-ile.
• auto — kui teie päring vastab reegli name/description-ile.
• manual — ainult siis, kui viitate sellele kui #name või /name.

Juur AGENTS.md kehtib kogu repositooriumile; pesastatud AGENTS.md (nt services/api/AGENTS.md) kehtib ainult selle kausta all olevatele failidele. Veebirakenduses annab vaade Agent → Juhtimine igale reeglile Ulatuse valija (Globaalne / Projekt / Meeskond).

Oskused

Oskused on korduvkasutatavad mänguraamatud, mida agent laadib nõudmisel. Iga oskus on kaust, mis sisaldab SKILL.md faili kataloogis .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.

Agent näeb kerget kataloogi (name + description) ja tõmbab täieliku sisu load_skill tööriistaga, kui see on asjakohane. Saate seda ka selgesõnaliselt käivitada käsuga /skill <name>. Seadke disable-model-invocation: true, et muuta oskus ainult käsitsi kasutatavaks.

Konksud

Konksud käivitavad automatiseerimise elutsükli sündmuste puhul. Määrake need kui .deepcerebra/hooks/*.hook.json:

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

Sündmused hõlmavad promptSubmit, preToolUse, postToolUse, fileCreate, fileSave, fileDelete, preTask, postTask, sessionStart, preCompact ja agentStop (aktsepteeritakse ka Cursor/Claude kirjapilte). Tegevus on kas shell (käsu käivitamine) või agentPrompt (agendi küsimine). preToolUse konks saab lubada, keelata või küsida tööriista kutset, mida see kinni püüab.

Alamagendid

Alamagendid on spetsialistagendid, mille te määratlete ja millele delegeerite. Igaüks neist on Markdowni fail kataloogis .deepcerebra/agents/ koos frontmatteri ja sisuga (selle süsteemiviip):

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

Peaagent delegeerib käsuga task (blokeeriv), task_async + task_status / task_result (taustal) või task_parallel (hajutamine).

Pluginad

Plugin koondab reeglid, oskused, konksud, alamagendid ja MCP serverid ühte installitavasse paketti kataloogis .deepcerebra/plugins/<name>/, mida kirjeldab plugin.json manifest:

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

Plugina sisu liidetakse madalaima prioriteediga, nii et teie enda reeglid ja oskused tühistavad alati plugina omad. Keelake plugin käsuga "enabled": false või .disabled markerfailiga.

17 Agentne töövoo stuudio ja sündmustepõhised agendid

Töövoo stuudio on visuaalne disainer mitmeagendi automatiseerimiseks. Te koostate etappe — igaüks neist on agent, spetsialisti samm või juhtimisprimitiiv — graafikuks, ühendate need sõltuvustega ja käivitate kogu orkestratsiooni mootoril koos reaalajas etappide kaupa edenemise, eelarvete ja inimliku heakskiidu väravatega. Töövoog salvestatakse kaasaskantava YAML/JSON definitsioonina, mida saate eksportida, importida, versioonida Gitis ja käivitada API-st või CLI-st.

17.1 Töövoo loomine

• Palett (vasakul) — lohistage lõuendile etappide tüüpe, valmis agendi tüüpe (uurimine, koodi genereerimine, QA, dokumendikirjutaja, meditsiiniseade, patendinõunik ja teie enda kohandatud tüübid), oskusi oskusteekist ja tööriistu.
• Lõuend (keskel) — paigutage etappe ja joonistage servi; serv tähendab "see etapp sõltub sellest" ja suunab automaatselt ülesvoolu väljundi allavoolu viipesse.
• Inspektor (paremal, muudetava suurusega) — konfigureerige valitud etapp: selle viip, oskused, tööriistad, etapi kohta mudeli tühistamine, väljundartefakt, värav, sündmused ja tüübi-spetsiifilised parameetrid.
• Mallid — alustage sisseehitatud kavandist (Ship-It Pipeline, SaaS Starter, Data Pipeline with Evals, Customer Comms Hub, Design → Verified App) ja kohandage seda.
• Genereeri — kirjeldage rakendust või protsessi lihtsas keeles ja Agendi Ehitaja genereerib täieliku, valideeritud töövoo graafiku, mida saate üle vaadata, kohandada ja käivitada.

17.2 Etappide teek

17.3 Sündmustepõhised agendid (agendivõrk)

Iga etapp — olenemata tüübist — saab avaldada ja tellida tüübitud sündmusi tööruumi sündmuste siinil, nii et agendid koordineerivad nagu teenused sõnumivõrgus, mitte ainult DAG-i kaudu:

• Sündmuste klassid — iga sündmus kannab klassi: lifecycle, agent, business, data, system, schedule, chat, external või alert — filtreeritav tellimustes ja taasesituses.
• Tellimisrežiimid — trigger (etapp käivitub, kui saabub sobiv sündmus; pargitud etappidega käivitus jääb residentseks kui kuulamine), gate (masinvärav, mille kinnitab sündmus inimliku kliki asemel) ja data (andmepakett liidetakse etapi konteksti).
• Käivitamine sündmuse kaudu — iga agenti saab käivitada orkestraator või teine agent, avaldades selle aadressile agent.<stage-id>.request.
• Käivita päästikud — töövoo triggers: plokk relvastab selle käivitamiseks sissetulevate webhookide, cron-ajakavade, sündmuste või vestluse kaudu — isegi kui stuudio on suletud.
• Reaalajas käivitused — käivituspaneel voogedastab elutsükli sündmusi SSE kaudu: etapi algused/lõpetamised, väravad, hoiatused ja eelvaated ilmuvad koheselt.
• Püsiv logi ja taasesitus — sündmused püsivad tööruumi kohta ja neid saab taasesitada teema mustri ja klassi järgi auditeerimiseks ja silumiseks.

17.3.1 Sündmuste järjekorda panemine agentidele

Sündmustele reageerivad agendid saavad deklareerida püsiva nimega järjekorra, et vastavad sündmused ei läheks kunagi kaotsi, kui agent on hõivatud või enne, kui käivitus kuulab. Päästiku tellimisel määrake queue: <name> — mootor seob selle teema tööruumi sündmuste siini FIFO järjekorraga (püsivalt salvestatud asukohas .deepcerebra/workflows/events/queues/). Iga sellest hetkest alates avaldatud vastav sündmus jäädvustatakse järjekorda; kui etapp muutub käivitatavaks, võtab mootor sündmused järjekorrast välja vanimast alates ja tarbib neid ükshaaval.

• Midagi ei lähe kaotsi — sündmused, mis avaldatakse töövoo sulgemise ajal, teise etapi töötamise ajal või kui käivitus ootab endiselt sõltuvusi, pannakse järjekorda, mitte ei visata ära.
• Tellimusepõhine count — nõuab N järjekorras olevat (või edastatud) sündmust enne, kui tellimus on täidetud (kasulik, kui mitu töötajat peavad aru andma).
• Studio — Inspector'i sündmuste paneelil määrake päästiku tellimisel väli queue; aktiveerige päästikud või käivitage käivitus, et sidumine automaatselt luua.
• API & tööriistad — GET /api/workflow/queues loetleb sügavuse ja sidumised; GET /api/workflow/queues/{name} näitab ootel sündmusi; vestlusagendid saavad kutsuda event_queue_status ja 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 Semaforkorraldus (jagatud ressursside kaitse)

Semafor piirab, kui mitu ülesannet võivad samaaegselt tegutseda jagatud (kaitstud) ressursiga: andmebaas, kuhu kirjutatakse, globaalsete muutujate hoidla, fail või piiratud kiirusega väline agent. Lisage see mis tahes etapile semaphore: abil — enne etapi töö käivitamist omandab mootor ühe loa nimetatud tööruumi semaforist; luba vabastatakse alati pärast seda, isegi kui etapp ebaõnnestub. permits: 1 muudab selle muteksiks: ainult üks ülesanne korraga (kõigis tööruumi paralleelsetes käivitustes) täidab kriitilise sammu; kõik teised ülesanded ootavad, kuni hoidja lõpetab.

• Käivitusteülene serialiseerimine — semaforid on tööruumi ulatuses ja püsivad, nii et kaks samaaegset töövoo käivitust ei saa sama kaitstud ressurssi rikkuda.
• Ootamine, mitte rippumine — ülesanded blokeerivad loa saamiseks kuni timeout_s; kui ressurss jääb täis, ebaõnnestub etapp nähtavalt, selle asemel et igavesti rippuda.
• Krahhikindlus — iga luba sisaldab ttl_s; kui hoidja kukub kokku ilma vabastamata, aegub luba automaatselt, nii et ressurss ei jää kunagi ummikusse.
• Jälgitavus — siin väljastatakse semaphore.<name>.waiting, .acquired ja .released süsteemisündmused; GET /api/workflow/semaphores näitab mahtu, hoidjaid ja saadaolevaid lubasid.
• Vestlusagendid — acquire_semaphore, release_semaphore ja semaphore_status tööriistad koordineerivad ad hoc kriitilisi sektsioone väljaspool töövoogu.

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-korraldus (oota kõiki tingimusi)

Rendezvous ootab, kuni mitu sündmustingimust on kõik täidetud, enne kui järgmine samm jätkub — vastupidine põhimõttele "esimene sündmus võidab". Määrake etapi events: plokis join: all: iga päästiku tellimus peab olema täidetud enne, kui etapp käivitub. Kombineerige tellimusepõhise count: N-ga, kui mitu agenti (või mitu aruannet ühelt agendilt) peavad kõik sisse logima — näiteks disaini heakskiit, testide lõpetamine ja turvalisuse kinnitus enne väljalaske etapi käivitamist.

• join: any (vaikimisi) — etapp käivitub, kui esimene päästiku tellimus on täidetud.
• join: all — rendezvous: iga päästiku tellimus (igaühel oma teema, klassifilter ja valikuline count) peab olema täidetud; alles siis muutub etapp käivitatavaks.
• Andmekogumid — kõik tarbitud sündmused salvestatakse etapile kui trigger_events ja tehakse mallidele kättesaadavaks kui inputs.events (sündmuseobjektide loend koos andmekogumitega).
• Studio — kui etapil on kaks või enam päästiku tellimust, näitab Inspector Join valijat: any — esimene sündmus võidab või all — rendezvous (oota kõiki); lõuendil kuvatakse rendezvous-etappidel ühendamise märk.

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 Agendi tööriistade teek

Etapid valivad tööriistu samast registrist, mida vestlusagent kasutab:

• Tuum — failid, git, shell, koodi täitmine, koodiotsing, brauseri automatiseerimine, veebiotsing, nägemine/meedia, piltide genereerimine.
• Andmebaasid — SQLite, PostgreSQL, MySQL, MongoDB ja Redis päringud pluss create_database, apply_migrations ja dump_schema omanduses olevate andmekihtide jaoks.
• Side — telefonikõned ja SMS-id (Twilio) ning e-post (SendGrid), simulatsioonirežiimiga, mis salvestab väljaminevate kirjade kausta, kui mandaadid puuduvad — demode käigus ei saadeta kunagi kogemata päris sõnumeid.
• DevOps — docker_build / docker_push, compose up/down, SSH ja pilve-CLI juurutused (Fly, Render, Railway, Vercel), samuti simulatsioonikindel.
• Kontrollimine — virna tuvastamine, testikomplekti täitmine parsimise läbimise määradega, sõltuvuste auditid ja saladuste skaneerimine.
• Teadusarvutuse mootorid — sajad teaduslikud ja insenerimeetodid (nimetatud Class.method) matemaatikas, signaalitöötluses, juhtimises, statistikas ja mujal.
• Ekspertagentuur ja MCP — põhjendatud domeeniuuringud pluss kõik välised MCP serverid, mille te ühendate.

17.5 Käivitamine, väravad ja väljundid

• Valideeri kontrollib graafikut (unikaalsed id-d, atsüklilised sõltuvused, tüübi parameetrid) enne käivitamist.
• Inimväravad peatavad käivituse pärast etapi mustandi loomist, nii et te kinnitate tegeliku töö; sündmuste väravad lasevad teisel süsteemil automaatselt kinnitada.
• Eelarved piiravad kulutusi käivituse ja etapi kohta.
• Salvesta väljundid projekti kopeerib iga käivituse genereeritud artefakti teie avatud projekti.
• Ekspordi rakendus muudab töövoo iseseisvaks FastAPI teenuseks; avalik /v1 API eksponeerib käivitusi, sündmusi, päästikuid, malle ja genereerimist CI ja integratsioonide jaoks.

18 Ennustav tabeli täitmine

Ennustav tabeli täitmine pakub reasiseseid, keskele täitmise koodisoovitusi redaktoris tippimise ajal — aktsepteerige soovitust klahviga Tab. See on valikuline nii mootori kui ka veebiredaktori puhul.

Luba see

• Mootor — seadke keskkonna lipp DCC_TAB_COMPLETE=1. Redaktor kutsub mootori POST /api/complete lõpp-punkti, mis tagastab ainult kursori asukohta sisestatava teksti.
• Veebiredaktor — lubage ehitusajal käsuga VITE_TAB_COMPLETE=1, või käitusajal käsuga localStorage.setItem('dcc.tabComplete', '1') (seejärel laadige uuesti).

Kuidas see käitub

• Soovitused ilmuvad kummitustekstina; vajutage Tab, et aktsepteerida, või jätkake tippimist, et tagasi lükata.
• Päringud on viivitatud ja tühistatavad, nii et tippimine ei ole kunagi blokeeritud.
• Kui lipp on välja lülitatud, on funktsioon täielikult keelatud ja täitmispäringuid ei tehta.

19 Kasutus, krediidid ja arveldamine

Avage külgribalt Arveldamine, et hallata oma plaani ja kasutust. AI kasutust mõõdetakse USA dollari krediitides, mis põhinevad alusmudelite tarbitud tokenitel.

• Tsükli kulutus ja ettemakstud krediit — jälgige selle tsükli kasutust ja mis tahes ettemakstud saldot.
• Lisa ülekulu krediit — volitage lisasumma (USD), et jätkata AI kasutamist pärast kaasatud limiidi kulutamist; kui teie eelarve on ammendatud, näete bännerit, mis palub teil krediiti lisada.
• Uuenda / muuda plaani — vaheta tasemeid igal ajal.
• Makseviis — lisage või uuendage failis olevat kaarti (töödeldud Stripe'i poolt).
• Tühista — valige tühista perioodi lõpus (säilitage juurdepääs kuni perioodi lõpuni) või tühista kohe (tagastage tagastatav jääk). Vaadake tühistamis- ja tagasimaksepoliitikat.

20 Värava API võtme hankimine

Värava API võti (isiklik juurdepääsutoken) võimaldab teil kasutada DeepCerebra avalikku API-t ja CLI-d programmilise juurdepääsuga.

1. Logige sisse ja avage külgribalt API võtmed.
2. Kerige jaotiseni DeepCerebra API võtmed.
3. Sisestage silt (nt "CI torujuhe" või "sülearvuti CLI").
4. Valige ulatus — read, chat, code, agent — ja valikuline aegumiskuupäev päevades (tühi = mitte kunagi).
5. Klõpsake nuppu Genereeri. Täielik võti kuvatakse ainult üks kord — klõpsake nuppu Kopeeri ja salvestage see turvaliselt.

Kasutage seda CLI või API-ga aadressil 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/...

Saate võtit igal ajal ümber nimetada või kustutada (tühistada); iga võti näitab oma eesliidet, ulatust, loomise/aegumise kuupäeva ja viimase kasutamise kuupäeva.

21 Turvalisus ja privaatsus

• Konfidentsiaalne brauserisisene salvestusruum — teie projektifailid jäävad brauseri krüpteeritud tööruumi; serverisse saadetakse ainult iga päringu jaoks vajalik minimaalne kontekst.
• Andmete nullsäilitamine (ZDR) — mudelitele suunatud viiped ja koodi ei säilitata pärast päringut ja neid ei kasutata kunagi alusmudelite treenimiseks.
• Võtmed jäävad serveripoolseks — BYOK ja SCM tokenid on puhkeolekus krüpteeritud; kuvatakse ainult maskeeritud eelvaated.
• Krüpteerimine — TLS edastamisel; kontoandmed krüpteeritud puhkeolekus; paroolid pöördumatult räsitud.
• Teie kood on teie oma — teile kuulub teie sisu ja genereeritud väljund. Vaadake privaatsusavaldust.

22 Veaotsing

"Kausta laadimiseks on vaja Chromiumi brauserit"

Lülituge Chrome'i, Edge'i või Brave'i peale või kasutage selle asemel Ava Gitist.

Agent kordab sama viga

Klõpsake nuppu Peata, seejärel sõnastage uuesti konkreetse vihje või piiranguga.

Mudeli või päringu vead / "eelarve ammendatud"

• Kontrollige oma ühendust ja veenduge, et mis tahes BYOK võti on kehtiv.
• Lülituge Automaatsele, et DeepCerebra suunaks saadaolevale mudelile.
• Kui teie kasutuslimiit on ammendatud, avage Arveldamine ja lisage ülekulu krediiti või uuendage oma plaani.

Kohalikud mudelid ei ilmu

• Kinnitage, et dcc-bridge konnektor töötab ja seade näitab võrgus olekut.
• Veenduge, et Ollama töötab või LM Studio kohalik server on lubatud (vaikeport 1234) laetud mudeliga.

Konnektor: "server keeldus WebSocketi ühendusest: HTTP 401"

• Kasutage --gateway-na sama domeeni, mida kasutate brauseris (wss://deepcerebra.ai või wss://deepcerebra.io) — need kaks saiti on eraldi juurutused ja ühelt saadud token ei tööta kunagi teisel.
• Kopeerige täpne käsk sidumiskaardilt lehel Kohalik masin.

Minu muudatused ei jõustunud

• Veenduge, et klõpsasite Rakenda (mitte ainult ei vaadanud erinevust eelvaates) jaotises Pakutud muudatused.
• Kasutage Avastaja värskendamist kausta uuesti skaneerimiseks.

Git: "Olete vaikeharus"

Avage või looge tööharu enne Integreeri kasutamist tõmbepäringu avamiseks.

Ikka ummikus? Võtke ühendust support@deepcerebra.ai.

23 DeepCerebra Discovery — Küsige oma andmetelt & dokumentidelt

Discovery on uuriv vestlusrobot teie **andmebaaside ja dokumentide** jaoks. Selle asemel, et vastata ühe päringuga, töötab see nagu analüütik: see moodustab **hüpoteese**, viib läbi rea kaitstud sonde (SQL, graafik, dokumendiotsing, skeemi kontrollid, veebi kinnitamine), kärbib tõenditega ümberlükatud selgitusi ja sünteesib **põhjendatud vastuse** — koos diagrammide ja läbipaistva kulukviitungiga. Avage see tegevusribal asuva **kompassi ikooni** kaudu (/app/discovery).

23.1 Ruumid — teie kureeritud ulatus

**Ruum** koondab kõik, mida üks küsimustering vajab: andmebaasiühendused, dokumendikogud, juhised analüütikule ja eelarved. Looge see nupuga **+ Uus ruum**, seejärel kasutage paremal asuvat seadistuspaneeli, et:

• **Ühendage andmebaasid** — SQLite, PostgreSQL, MySQL, SQL Server või Snowflake. Sisestage nimi ja DSN, klõpsake **Testi**, et kontrollida ühenduvust (näidatakse latentsust ja serveri versiooni), või importige olemasolev ühenduse konfiguratsioon JSON-ina. Ühendused on **vaikimisi ainult lugemiseks**.
• **Lisage dokumente** — lohistage failid (PDF, DOCX, PPTX, Markdown, tekst) otse vestlusesse, kleepige URL või osutage kausta teele mootori hostis. Dokumendid tükeldatakse, manustatakse ja indekseeritakse hübriidse vektori + teadmusgraafi otsingu jaoks.
• **Importige tabeleid** — kleepige või laadige üles CSV/JSON, et koheselt päringuid teha ilma andmebaasita.
• **Õpetage analüütikut** — lisage mõõdikute definitsioone, ärireegleid ja hoiatusi, kuraatori heakskiiduga usaldusväärseid päringuid ning näidisküsimus→päring paare, et vastused kasutaksid teie definitsioone.

23.2 Küsimuse esitamine

Sisestage küsimus nii, nagu küsiksite kolleegilt — näiteks "Miks MRI skaneerimise maht märtsis langes?". **Uurimislaud** edastab kogu protsessi otseülekandena:

• **Hüpoteesid** — uuritavad kandidaatselgitused, millest igaüks on tõendite saabumisel märgitud **toetatuks**, **ümberlükatuks** või **ebaselgeks**.
• **Sondid** — iga päring, mida analüütik käivitab, koos selle olekuga; genereeritud SQL/Cypher kuvatakse täieliku läbipaistvuse tagamiseks ja iga lause läbib enne täitmist ainult lugemiseks mõeldud kaitse-eeskirjad.
• **Tõendid** — tulemustabelid ja dokumendiväljavõtted, viidatud numbriga lõppvastuses.
• **Vastus + diagrammid** — põhjendatud järeldus, mis nimetab ka välistatud selgitused, lisaks kaasaegsed neoonteemalised diagrammid, mis on koostatud tõendite põhjal.
• **Kviitung** — märgid, sondi kohta maksumus ja voorud, mis arvestatakse teie AI Credits'i alla nagu iga teine agendi käivitus.

Järgnevad küsimused jätkavad sama teemat, nii et analüütik säilitab oma konteksti.

23.3 Diagrammid, aruanded & eksport

Diagrammid renderdatakse uurimislaual otse. Kasutage **Eksporti**, et alla laadida kogu päring — vastus, hüpoteesid, tõendid ja diagrammid — iseseisva **HTML-aruandena** või trükikvaliteediga **PDF-ina**, mis on kujundatud neoon-disainisüsteemiga.

23.4 Eelarved & kulude kontroll

Igal ruumil on päringupõhised eelarved: maksimaalne sondide arv, uurimisvoorud, sekundid ja USD. Mootor peatub puhtalt piirangu juures ja annab aru, mida see seni leidis. Iga sondi maksumus on kviitungil üksikasjalikult kirjas, nii et teate alati, kuhu kulutused läksid.

23.5 Automatiseerimine: API, SDK, Workflow Studio & MCP

• **REST API** — kõik, mida kasutajaliides teeb, on saadaval /v1/discovery/* all koos PAT-iga, mis kannab discovery ulatust (looge see jaotises **Konto → API märgid**). Voogedastuse päringud kasutavad SSE-d. Välised täiturid saavad laenata ainult uurimisplaneerimist Thinking API kaudu (/v1/think/*, ulatus think).
• **Python SDK** — pip install deepcerebra-discovery, seejärel DiscoveryClient(base_url, token).ask(space_id, question).
• **Workflow Studio** — lohistage **Discovery Ask** etapp (discovery.ask) mis tahes töövoogu, et käivitada uurimine torujuhtme sammuna; vastus, diagrammid ja kviitung liiguvad allavoolu etappidesse.
• **MCP** — mootor pakub discovery_ask ja discovery_list_spaces MCP tööriistadena, nii et välised MCP kliendid saavad samuti uurimisi läbi viia.