1 Uvod & izdaje

DeepCerebra Coder je agentni pomočnik za kodiranje. Za razliko od navadnega samodejnega dopolnjevanja, načrtuje, piše, refaktorira, izvaja ukaze, kliče orodja in iterira po vašem celotnem projektu — vi pa pregledujete in odobravate spremembe, ki jih predlaga.

Trije načini uporabe

Ta priročnik se osredotoča na spletno aplikacijo na deepcerebra.ai; namizna aplikacija odraža enake plošče in poteke dela.

2 Začetek & račun

Podprti brskalniki

Za popolno izkušnjo uporabite trenutno različico brskalnika Chrome, Edge ali Brave — odpiranje lokalne mape se zanaša na API za dostop do datotečnega sistema Chromium. Firefox in Safari delujeta za klepet in projekte, podprte z Gitom, vendar ne moreta neposredno odpreti lokalne mape.

Ustvarite račun

1. Na pristajalni strani kliknite Začnite.
2. Izpolnite svoje neobvezno prikazno ime, e-pošto, državo in datum rojstva (morate biti stari vsaj 18 let).
3. Izberite svoj jezik vmesnika in geslo z vsaj 12 znaki.
4. Preberite obvestilo o sporazumu in potrdite. Z ustvarjanjem računa se strinjate s Pogoji storitve, Izjavo o zasebnosti, Opisom storitev in Globalnim DPA.
5. Kliknite Ustvari račun, nato po potrebi preverite svojo e-pošto in se prijavite.

Ponastavite geslo

1. Na strani za prijavo kliknite Ste pozabili geslo?
2. Vnesite svoj e-poštni naslov in odprite povezavo za ponastavitev, poslano v vaš nabiralnik.
3. Nastavite novo geslo (najmanj 12 znakov).
4. DeepCerebra Discovery — Vprašajte svoje podatke & dokumente

3 Delovni prostor na hitro

Po prijavi pristanete v delovnem okolju, ki združuje vse plošče na enem zaslonu:

• Raziskovalec (levo) — drevo datotek za odprti projekt, z gumboma za osvežitev in zapiranje.
• Urejevalnik (sredina) — vsebina datoteke z označevanjem sintakse in pregledom minimape; tukaj se prikažejo vgrajene razlike, ko agent predlaga spremembe.
• Terminal (pod urejevalnikom, vklop/izklop) — izvajanje ukazov in branje izhoda.
• Klepet (desno) — pogovor z agentom; to je primarna plošča, ki zapolnjuje prostor.

Povlecite razdelilnik med urejevalnikom in klepetom, da ponovno uravnotežite postavitev, in povlecite vodoravni razdelilnik, da spremenite velikost terminala. Leva stranska vrstica omogoča tudi navigacijo do Delovnega prostora, Razširitev, Ključev API, Obračunavanja in Povratnih informacij.

4 Odpiranje projekta

4.1 Odprite lokalno mapo

1. V Raziskovalcu kliknite Odpri mapo projekta.
2. Izberite mapo in brskalniku dodelite dovoljenje za branje.
3. Datoteke se preberejo v šifriran delovni prostor v brskalniku — nič se ne naloži. Videli boste štetje v živo in končni povzetek (število datotek · velikost, plus morebitne preskočene ali skrajšane datoteke).

4.2 Odprite iz Gita (GitHub / GitLab)

1. V Raziskovalcu kliknite Odpri iz Gita.
2. Izberite zavihek GitHub ali GitLab in prilepite osebni dostopni žeton. Za GitHub uporabite obseg repo (klasični) ali podroben žeton z vsebino + zahtevki za združitev; za GitLab uporabite obseg api. Vaš žeton je shranjen na strežniku — v brskalnik se povleče samo vsebina datotek.
3. Vnesite repozitorij kot owner/name (filtrirajte seznam, da najdete svojega), nato izberite vejo.
4. Po želji označite Ustvari novo delovno vejo (npr. dcc/my-feature), da ohranite svoje delo izolirano od privzete veje.
5. Po želji omogočite potisni webhook, da se Raziskovalec takoj osveži, ko soigralci potisnejo spremembe (potrebuje javni URL prehoda).
6. Kliknite Odpri repozitorij.

4.3 Osveži, preklopi in zapri

• Osveži (↻ v glavi Raziskovalca) ponovno skenira mapo ali povleče najnovejše iz Gita.
• Odpri drugo mapo ali Odpri iz Gita z gumbov pod drevesom.
• Zapri projekt (ikona smetnjaka) izbriše delovni prostor v brskalniku.

4.4 Klepetalni seje, omejene na mapo

Zgodovina klepeta je vezana na odprti projekt. Preklapljanje map samodejno začne novo sejo in naloži prejšnje seje te mape, pri čemer ponovno odpre najnovejšo, da lahko nadaljujete tam, kjer ste končali.

4.5 Operativne mape

Mape, ki jih DeepCerebra uporablja interno — .deepcerebra, .sessions — se pojavijo v drevesu, vendar so privzeto strnjene, da ne obremenjujejo vaše izvorne kode.

5 Delo z datotekami

• Kliknite datoteko v Raziskovalcu, da jo odprete v urejevalniku; minimapa vam pomaga pri navigaciji po dolgih datotekah.
• Povlecite datoteko iz Raziskovalca v klepetalni poziv, da jo priložite kot eksplicitni kontekst za vaše naslednje sporočilo.
• Ko agent predlaga urejanja, urejevalnik prikaže vgrajeno razliko za izbrano datoteko.

6 Klepetanje z agentom

Napišite zahtevo

Opišite, kaj želite, v preprostem jeziku — postavite vprašanje, zahtevajte funkcijo ali pokažite na napako. Bodite specifični glede datotek, ogrodij in omejitev, da dosežete najboljši rezultat. Priložite ustrezne datoteke tako, da jih povlečete v poziv.

Preberite odgovore, v slogu Cursor

Odgovori so organizirani kot Cursor: razmišljanje agenta je ločeno od rezultata. Vsak blok odgovora ima ikono za kopiranje v zgornjem desnem kotu, tako da lahko kopirate dokončano poročilo, dokument ali ukaz, ki ga nameravate zagnati.

Usmerite ali ustavite izvajanje

• Uporabite Ustavi, da zaustavite izvajanje, ki gre v napačno smer, nato pa izboljšajte svoj poziv.
• Dajte namige (npr. "uporabite lxml namesto html.parser"), da prekinete zanko agenta.

7 Štirje načini klepeta

Izberite način iz izbirnika načinov poleg poziva. Vsak prilagodi, koliko agent načrtuje in kako svobodno ureja:

8 Pregledovanje & uporaba sprememb

Ko agent predlaga spremembe datotek, se nad vnosom klepeta prikaže plošča Predlagane spremembe, ki navaja vsako spremenjeno datoteko s številom dodanih (+) in odstranjenih (−) vrstic.

• Kliknite vrstico datoteke, da odprete njeno vgrajeno razliko v urejevalniku.
• Uporabi ali Zavrni eno datoteko, ali uporabite Uporabi vse / Zavrni vse.
• Uporabljene spremembe so označene z applied (in · disk, ko so zapisane v pravo mapo).
• Če ni mape, v katero bi bilo mogoče pisati, značka samo delovni prostor označuje, da se spremembe nanašajo na delovni prostor v brskalniku.

9 Integrirani terminal

Preklopite terminal pod urejevalnikom za izvajanje gradenj, testov in skript. Z vašim dovoljenjem lahko agent izvaja ukaze in bere njihov izhod, da preveri svoje delo; dolgotrajni ukazi pretakajo izhod, tako da lahko spremljate napredek. Zaprite terminal iz njegove glave, ko ga ne potrebujete.

10 Način načrtovanja & izvedba

Za večje cilje uporabite način Načrt (ali prosite agenta, naj najprej načrtuje). Načrtovalec pregleda vaš projekt, razgradi cilj v naloge, ki upoštevajo odvisnosti, in vsako dodeli pravemu specialistu (arhitekt, koder, tester, dokumentacija).

• Preglejte & uredite načrt — dodajte, odstranite ali spremenite naloge pred izvedbo.
• Izvedite plast za plastjo — neodvisne naloge se izvajajo skupaj; načrtovalec lahko ponovno načrtuje, če naloga ne uspe.
• Zaustavite, nadaljujte ali prekličite izvajanje kadar koli.

11 Izbira modelov & samodejno

Odprite izbirnik modelov poleg poziva. Možnosti so razvrščene kot:

• Samodejno — naj DeepCerebra izbere najboljši razpoložljivi model (priporočeno).
• Lokalno (vaš GPU) — modeli, ki jih streže vaš lastni računalnik (glejte §13).
• Prehodi platforme — gostujoči modeli, razvrščeni po prehodu in nato po ponudniku (npr. Anthropic, OpenAI, Google).

Kako deluje samodejna izbira

Pri samodejni izbiri DeepCerebra uporablja stopnjevano, prilagodljivo usmerjanje: preproste naloge gredo k hitremu, ekonomičnemu modelu, medtem ko se kompleksno ali načrtovalno intenzivno delo (na primer način načrtovanja) usmeri k močnejšemu modelu. To samodejno uravnoteži stroške in kakovost, zato vam redko ni treba izbirati ročno.

12 Prinesite svoj ključ (BYOK)

Zahteve lahko usmerite prek svojega računa ponudnika namesto prek merjene uporabe platforme.

1. Odprite Ključi API iz stranske vrstice.
2. Pod Prinesite svoj ključ izberite ponudnika (npr. ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
3. Prilepite vrednost ključa in kliknite Shrani. Ključi so šifrirani v mirovanju in se nikoli ne vrnejo v brskalnik — prikazan je le maskiran predogled.

Modeli platforme (DeepCerebra) ne potrebujejo ključa. Ključ lahko kadar koli odstranite z Odstrani.

13 Lokalni računalnik: modeli GPU & konzola (DCC Bridge)

DCC Bridge povezuje vaš lastni računalnik s spletno aplikacijo prek majhnega dcc-bridge priključka, s čimer hkrati odklene dve zmožnosti:

• Lokalni modeli GPU — modeli, ki jih streže Ollama ali LM Studio na vašem računalniku, se pojavijo v izbirniku modelov pod Lokalno (vaš GPU).
• Konzola / terminal na vašem računalniku — spletni terminal in agent lahko izvajata resnične ukaze na vašem računalniku, vključno z orodji CLI, ki ste jih že konfigurirali (Railway, AWS CLI, OVH CLI, gh, docker, kubectl, WSL, …) z njihovimi obstoječimi poverilnicami.

Priključek se povezuje navzven prek avtenticiranega WebSocket-a — vhodna vrata niso potrebna, in deluje za NAT-om in požarnimi zidovi. Deluje na sistemih Windows, macOS in Linux (Python 3.10+).

13.1 Povežite svoj računalnik

1. Kliknite ikono prenosnika v levi vrstici dejavnosti — Lokalni računalnik (GPU + Konzola). (Ista plošča se odpre iz noge izbirnika modelov prek Upravljaj lokalni GPU….)
2. Prepričajte se, da je preklopnik Lokalno izvajanje omogočen, poimenujte napravo in kliknite Dodaj ta računalnik. Kopirajte enkratni žeton za seznanjanje (dcc_brg_…) in ukaz priključka, pripravljen za prilepitev — žeton je prikazan samo enkrat.

13.2 Namestite & zaženite priključek

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

# nato zaženite ukaz, kopiran iz kartice za seznanjanje, npr.:
python -m dcc_bridge --gateway wss://deepcerebra.ai --token dcc_brg_xxxxx

• Uporabite isto domeno, ki jo uporabljate v brskalniku kot prehod (wss://deepcerebra.ai ali wss://deepcerebra.io) — kartica za seznanjanje predhodno izpolni pravo. Obe spletni mesti sta ločeni namestitvi z ločenimi računi in žetoni.
• Za modele GPU naj Ollama deluje, ali omogočite lokalni strežnik LM Studio (privzeta vrata 1234) z naloženim modelom.
• Seznanjene naprave prikazujejo status na spletu/brez povezave, število modelov in obseg izvajanja; napravo lahko kadar koli prekličete.

13.3 Uporabite svojo konzolo iz spletne aplikacije

Privzeto so ukazi omejeni na namensko mapo delovnega prostora (~/DeepCerebra). Za delo v vaših resničnih projektnih mapah z vašimi predkonfiguriranimi CLI-ji, jim izrecno dodelite dovoljenja ob zagonu priključka:

# dodelite eno ali več resničnih map (ponovljivo)
python -m dcc_bridge --gateway wss://deepcerebra.ai --token dcc_brg_xxxxx --host-dir "F:\MyProjects"

# ali celoten računalnik (izpiše opozorilo; raje uporabite --host-dir)
python -m dcc_bridge ... --allow-any-dir

Nato odprite ploščo Terminal, kliknite pojavno okno Cilj izvajanja (ikona prenosnika), izberite Moj računalnik in izberite delovni imenik. Tako vaši vneseni ukazi kot tudi agentovi ukazi za gradnjo/testiranje se nato izvedejo na vašem računalniku.

14 Potek dela sodelovanja z Gitom

Ko je odprt projekt, podprt z Gitom, se v Raziskovalcu prikaže vrstica veje, ki prikazuje vašo trenutno vejo in dve dejanji:

• Prijavi (potrdi) — preglejte število spremenjenih datotek, napišite sporočilo potrditve in potrdite v svojo delovno vejo.
• Integriraj — odprite zahtevek za združitev iz vaše delovne veje v privzeto vejo (npr. main). Morate biti na delovni veji, ne na privzeti veji.

Če je potisni webhook omogočen, se Raziskovalec samodejno osveži, ko soigralci potisnejo spremembe, s čimer so vsi sinhronizirani — to je temelj za sodelovalni razvoj ekipe prek DeepCerebra.

15 MCP strežniki

Razširite agenta z zunanjimi orodji in podatki prek protokola konteksta modela. Konfigurirajte strežnike v datoteki .deepcerebra/mcp.json, na primer:

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

Omogočena orodja MCP postanejo agentu samodejno na voljo, ko so relevantna za vašo zahtevo. Lokalni (stdio) in oddaljeni (http/sse) strežniki so podprti.

Vgrajena varnost

• Privzeto zavrni — ko strežnik navede allowlist, se lahko izvajajo samo ta orodja.
• Odobritev za visoko tvegana orodja — orodja za spreminjanje (pisanje/brisanje/uvajanje/…) zahtevajo odobritev razen če jih predhodno odobrite v autoApprove.
• Omejevanje hitrosti, čiščenje argumentov in izhodov ter revizijski dnevnik veljajo za vsak klic.

Viri & pozivi

Če strežnik izpostavlja MCP vire ali predloge pozivov, agent samodejno pridobi orodja za njihovo uporabo (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt).

Avtentikacija za oddaljene strežnike

Dodajte blok auth oddaljenemu strežniku. Skrivnosti podpirajo interpolacijo ${ENV_VAR}:

// Statični nosilni žeton (dobesedno ali iz okolja)
"auth": { "type": "bearer", "token": "${GITHUB_TOKEN}" }
"auth": { "type": "bearer", "tokenEnv": "GITHUB_TOKEN" }

// Glava po meri (npr. ključ API)
"auth": { "type": "header", "header": "x-api-key", "value": "${MY_KEY}" }

// OAuth 2.0 poverilnice odjemalca
"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 Prilagajanje agenta: pravila, spretnosti, kaveljci, podagenti & vtičniki

Način razmišljanja in delovanja agenta lahko oblikujete z enotno, datotečno konvencijo — imenikom .deepcerebra/ — ki deluje enako v namizni aplikaciji, spletni aplikaciji in API-ju. V spletni aplikaciji vse to upravljate pod pogledom Agent; na namizju in prek API-ja so to navadne datoteke, ki jih potrdite s svojim projektom.

Obsegi & prednost

Konfiguracija se odkrije iz več obsegov; ko isti element obstaja v več kot enem, zmaga tisti z višjo prednostjo:

team/org  <  global (~/.deepcerebra)  <  workspace (<repo>/.deepcerebra)
(najnižja)                                              (najvišja)

• Delovni prostor — <repo>/.deepcerebra/…, potrjeno s projektom.
• Globalno — ~/.deepcerebra/…, vaše osebne privzete nastavitve za vse projekte.
• Ekipa / org — skupna izhodiščna vrednost (najnižja prednost), tako da jo lahko uporabnik ali projekt vedno preglasi. V spletni aplikaciji nastavite Obseg pravila na Ekipa.

Pravila (usmerjanje)

Pravila so trajna navodila — standardi kodiranja, arhitekturne konvencije, kontekst domene — vstavljena v sistemski poziv agenta. Nahajajo se kot datoteke Markdown pod .deepcerebra/steering/, plus vedno vključenega standarda AGENTS.md. Frontmatter nadzoruje, kdaj se pravilo naloži:

---
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 — vsak obrat (privzeto).
• fileMatch — samo, ko se datoteka v kontekstu ujema z globs.
• auto — ko se vaša zahteva ujema z name/description pravila.
• manual — samo, ko se nanj sklicujete kot #name ali /name.

Korenski AGENTS.md velja za celoten repozitorij; ugnezdeni AGENTS.md (npr. services/api/AGENTS.md) velja samo za datoteke v tej mapi. V spletni aplikaciji pogled Agent → Usmerjanje vsakemu pravilu dodeli izbirnik Obsega (Globalno / Projekt / Ekipa).

Spretnosti

Spretnosti so ponovno uporabljivi priročniki, ki jih agent naloži na zahtevo. Vsaka spretnost je mapa z datoteko SKILL.md pod .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 vidi lahek katalog (ime + opis) in povleče celotno vsebino z orodjem load_skill, ko je to relevantno. Lahko ga tudi izrecno prikličete z /skill <name>. Nastavite disable-model-invocation: true, da bo spretnost samo ročna.

Kaveljci

Kaveljci izvajajo avtomatizacijo ob dogodkih življenjskega cikla. Definirajte jih kot .deepcerebra/hooks/*.hook.json:

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

Dogodki vključujejo promptSubmit, preToolUse, postToolUse, fileCreate, fileSave, fileDelete, preTask, postTask, sessionStart, preCompact in agentStop (sprejemajo se tudi zapisi Cursor/Claude). Dejanje je bodisi shell (izvedi ukaz) ali agentPrompt (vprašaj agenta). Kavelj preToolUse lahko dovoli, zavrni ali vpraša za klic orodja, ki ga prestreže.

Podagenti

Podagenti so specialistični agenti, ki jih definirate in jim delegirate naloge. Vsak je datoteka Markdown pod .deepcerebra/agents/ z frontmatterjem in telesom (njegov sistemski poziv):

---
name: security-reviewer
description: Revizira razliko za varnostne težave; samo za branje.
model: gpt-5
readonly: true
tools: [read_file, grep_files, list_directory]
background: false
---
Ste natančen varnostni pregledovalec…

Glavni agent delegira z task (blokiranje), task_async + task_status / task_result (ozadje) ali task_parallel (razpršitev).

Vtičniki

Vtičnik združuje pravila, spretnosti, kaveljce, podagente in strežnike MCP v en namestljiv paket pod .deepcerebra/plugins/<name>/, opisan z manifestom plugin.json:

{
  "name": "Acme Standards",
  "version": "1.2.0",
  "description": "Acme pravila + spretnosti + agenti za pregled.",
  "enabled": true
}

Vsebina vtičnika se združi z najnižjo prednostjo, tako da vaša lastna pravila in spretnosti vedno preglasijo vtičnikove. Vtičnik onemogočite z "enabled": false ali z datoteko označevalca .disabled.

17 Agentni studio za potek dela & dogodkovno gnani agenti

Studio za potek dela je vizualni oblikovalec za avtomatizacijo z več agenti. Faze — vsaka je agent, specialistični korak ali kontrolna primitiva — sestavite v graf, jih povežete z odvisnostmi in celotno orkestracijo zaženete na pogonu z napredkom v živo za vsako fazo, proračuni in vrati za človeško odobritev. Poteki dela so shranjeni kot prenosljiva definicija YAML/JSON, ki jo lahko izvozite, uvozite, verzijate v Gitu in zaženete iz API-ja ali CLI-ja.

17.1 Gradnja poteka dela

• Paleta (levo) — povlecite vrste faz, pripravljene vrste agentov (raziskave, generiranje kode, QA, pisec dokumentov, medicinski pripomočki, patentni svetovalec in vaše lastne vrste po meri), spretnosti iz knjižnice spretnosti in orodja na platno.
• Platno (sredina) — razporedite faze in narišite robove; rob pomeni "ta faza je odvisna od tiste" in samodejno dovaja izhod predhodne faze v naslednji poziv.
• Inšpektor (desno, spremenljiva velikost) — konfigurirajte izbrano fazo: njen poziv, spretnosti, orodja, preglasitev modela za posamezno fazo, izhodni artefakt, vrata, dogodke in parametre, specifične za vrsto.
• Predloge — začnite z vgrajenim načrtom (Ship-It Pipeline, SaaS Starter, Data Pipeline z Evalvacijami, Customer Comms Hub, Design → Verified App) in ga prilagodite.
• Generiraj — opišite aplikacijo ali proces v preprostem jeziku in Agent Builder bo generiral popoln, validiran graf poteka dela, ki ga lahko pregledate, prilagodite in zaženete.

17.2 Knjižnica faz

17.3 Dogodkovno gnani agenti (mreža agentov)

Vsaka faza — ne glede na vrsto — lahko objavlja in naroča na tipizirane dogodke na dogodkovnem vodilu delovnega prostora, tako da se agenti koordinirajo kot storitve na sporočilni tkanini in ne le prek DAG-a:

• Razredi dogodkov — vsak dogodek nosi razred: lifecycle, agent, business, data, system, schedule, chat, external ali alert — filtrabilno v naročninah in ponovnem predvajanju.
• Načini naročanja — trigger (faza se izvede, ko prispe ujemajoč se dogodek; izvajanje s parkiranimi fazami ostane rezidentno kot poslušanje), gate (strojna vrata, odobrena z dogodkom namesto s človeškim klikom) in data (vsebina se združi v kontekst faze).
• Začetek z dogodkom — vsakega agenta lahko zažene orkestrator ali drug agent z objavo na njegov naslov agent.<stage-id>.request.
• Sprožilci izvajanja — blok triggers: poteka dela ga oboroži za zagon ob dohodnih webhookih, cron urnikih, dogodkih ali klepetu — tudi ko je Studio zaprt.
• Izvajanja v živo — plošča za izvajanje pretaka dogodke življenjskega cikla prek SSE: začetki/dokončanja faz, vrata, opozorila in predogledi se prikažejo takoj.
• Trajni dnevnik & ponovno predvajanje — dogodki se ohranijo za vsak delovni prostor in jih je mogoče ponovno predvajati po vzorcu teme in razredu za revizijo in odpravljanje napak.

17.3.1 Čakalna vrsta dogodkov za agente

Agenti, ki se odzivajo na dogodke, lahko deklarirajo trajno imenovano čakalno vrsto, tako da se ujemajoči se dogodki nikoli ne izgubijo, medtem ko je agent zaseden ali preden izvajanje posluša. Pri naročnini na sprožilec nastavite queue: <name> — pogon veže to temo na FIFO čakalno vrsto na dogodkovnem vodilu delovnega prostora (shranjeno pod .deepcerebra/workflows/events/queues/). Vsak ujemajoči se dogodek, objavljen od te točke naprej, se zajame v čakalno vrsto; ko faza postane izvedljiva, pogon izloči dogodke v vrstnem redu najstarejši prvi in jih porabi enega za drugim.

• Nič izgubljenega — dogodki, objavljeni medtem ko je potek dela zaprt, medtem ko se izvaja druga faza, ali medtem ko izvajanje še čaka na odvisnosti, se postavijo v čakalno vrsto namesto da bi bili zavrženi.
• count na naročnino — zahtevajte N dogodkov v čakalni vrsti (ali dostavljenih), preden je naročnina izpolnjena (uporabno, ko mora poročati več delavcev).
• Studio — v plošči Dogodki inšpektorja nastavite polje queue na naročnini sprožilca; aktivirajte sprožilce ali zaženite izvajanje, da samodejno ustvarite vezavo.
• API & orodja — GET /api/workflow/queues navaja globino in vezave; GET /api/workflow/queues/{name} pregleduje čakajoče dogodke; klepetalni agenti lahko kličejo event_queue_status in pop_queued_event.

events:
  subscribe:
    - topic: ticket.created
      mode: trigger
      queue: triage-inbox        # trajna FIFO — dogodki čakajo tukaj na tega agenta
      map:
        payload.ticket_id: ticket_id

17.3.2 Orkestracija semaforjev (zaščita skupnih virov)

Semafor omejuje, koliko nalog lahko hkrati deluje na skupnem (zaščitenem) viru: bazi podatkov, ki se piše, globalni shrambi spremenljivk, datoteki ali zunanjem agentu z omejeno hitrostjo. Semafor priključite na katero koli fazo z semaphore: — preden se delo faze izvede, pogon pridobi eno dovoljenje imenovanega semaforja delovnega prostora; dovoljenje se vedno sprosti po tem, tudi če faza ne uspe. permits: 1 ga naredi mutex: samo ena naloga naenkrat (med vsemi vzporednimi izvajanjem v delovnem prostoru) izvede kritični korak; vsaka druga naloga čaka, dokler imetnik ne konča.

• Serijsko izvajanje med izvajanjem — semaforji so omejeni na delovni prostor in trajni, zato dva sočasna izvajanja poteka dela ne moreta poškodovati istega zaščitenega vira.
• Čakanje, ne zatikanje — naloge blokirajo do timeout_s za dovoljenje; če vir ostane na zmogljivosti, faza vidno ne uspe, namesto da bi se zataknila za vedno.
• Varnost pred zrušitvijo — vsako dovoljenje nosi ttl_s; če imetnik strmoglavi, ne da bi ga sprostil, dovoljenje samodejno poteče, tako da vir nikoli ni v mrtvi zanki.
• Opazljivost — vodilo oddaja sistemske dogodke semaphore.<name>.waiting, .acquired in .released; GET /api/workflow/semaphores prikazuje zmogljivost, imetnike in razpoložljiva dovoljenja.
• Klepetalni agenti — acquire_semaphore, release_semaphore in semaphore_status orodja koordinirajo ad-hoc kritične sekcije zunaj poteka dela.

semaphore:
  name: emr-db-writer
  permits: 1          # mutex — en pisec naenkrat
  timeout_s: 300      # neuspeh, če še vedno čaka po 5 minutah
  ttl_s: 900          # samodejno sprosti zrušene imetnike po 15 minutah

17.3.3 Orkestracija srečanja (čakanje na vse pogoje)

Srečanje čaka, dokler niso izpolnjeni vsi pogoji dogodka, preden se nadaljuje naslednji korak — nasprotje "prvi dogodek zmaga". Nastavite join: all v bloku events: faze: vsaka naročnina na sprožilec mora biti izpolnjena, preden se faza izvede. Kombinirajte z count: N na naročnino, ko se mora prijaviti več agentov (ali več poročil enega agenta) — na primer, odobritev zasnove, dokončanje testov in varnostna odobritev pred izvedbo faze izdaje.

• join: any (privzeto) — faza se izvede, ko je izpolnjena prva naročnina na sprožilec.
• join: all — srečanje: vsaka naročnina na sprožilec (vsaka s svojo temo, filtrom razreda in neobveznim count) mora biti izpolnjena; šele nato faza postane izvedljiva.
• Vsebine — vsi porabljeni dogodki so zabeleženi na fazi kot trigger_events in izpostavljeni predlogam kot inputs.events (seznam objektnih dogodkov z vsebinami).
• Studio — ko ima faza dve ali več naročnin na sprožilec, Inšpektor prikaže izbirnik Join: any — prvi dogodek zmaga ali all — srečanje (čakanje na vse); platno prikazuje značko združitve na fazah srečanja.

events:
  join: all                    # srečanje — počakajte na VSAKO naročnino spodaj
  subscribe:
    - topic: design.approved
      mode: trigger
    - topic: tests.passed
      mode: trigger
    - topic: security.cleared
      mode: trigger
      count: 1

17.4 Knjižnica orodij agenta

Faze izbirajo orodja iz istega registra, ki ga uporablja klepetalni agent:

• Jedro — datoteke, git, lupina, izvajanje kode, iskanje kode, avtomatizacija brskalnika, spletno iskanje, vizija/mediji, generiranje slik.
• Baze podatkov — SQLite, PostgreSQL, MySQL, MongoDB in Redis poizvedbe ter create_database, apply_migrations in dump_schema za lastne podatkovne plasti.
• Komunikacije — telefonski klici in SMS (Twilio) ter e-pošta (SendGrid), s simulacijskim načinom, ki beleži v odhodno pošto, ko poverilnice manjkajo — demonstracije nikoli po nesreči ne pošljejo resničnih sporočil.
• DevOps — docker_build / docker_push, compose up/down, SSH in namestitve v oblaku prek CLI (Fly, Render, Railway, Vercel), tudi varno za simulacijo.
• Preverjanje — zaznavanje sklada, izvajanje testnih zbirk z analiziranimi stopnjami uspešnosti, revizije odvisnosti in skeniranje skrivnosti.
• SciCompute pogoni — na stotine znanstvenih in inženirskih metod (imenovanih Class.method) v matematiki, obdelavi signalov, krmiljenju, statistiki in še več.
• Strokovna agencija & MCP — utemeljene domenske raziskave plus vsi zunanji strežniki MCP, ki jih povežete.

17.5 Izvajanje, vrata in izhodi

• Potrdi preveri graf (edinstvene ID-je, aciklične odvisnosti, parametre vrste), preden ga zaženete.
• Človeška vrata zaustavijo izvajanje po tem, ko faza ustvari svoj osnutek, tako da odobrite resnično delo; dogodkovna vrata omogočajo drugemu sistemu samodejno odobritev.
• Proračuni omejijo porabo na izvajanje in na fazo.
• Shrani izhode v projekt kopira vsak artefakt, ki ga je izvajanje ustvarilo, v vaš odprti projekt.
• Izvozi aplikacijo pretvori potek dela v samostojno storitev FastAPI; javni API /v1 izpostavlja izvajanja, dogodke, sprožilce, predloge in generiranje za CI in integracije.

18 Prediktivno dopolnjevanje z zavihkom

Prediktivno dopolnjevanje z zavihkom ponuja vgrajene predloge kode za vmesno izpolnjevanje med tipkanjem v urejevalniku — predlog sprejmete s Tab. Je izbirno tako na pogonu kot v spletnem urejevalniku.

Omogoči

• Pogon — nastavite okoljsko zastavico DCC_TAB_COMPLETE=1. Urejevalnik pokliče končno točko POST /api/complete pogona, ki vrne samo besedilo za vstavitev na kazalec.
• Spletni urejevalnik — omogočite ob času gradnje z VITE_TAB_COMPLETE=1, ali ob času izvajanja z localStorage.setItem('dcc.tabComplete', '1') (nato ponovno naložite).

Kako se obnaša

• Predlogi se prikažejo kot besedilo duha; pritisnite Tab za sprejem ali nadaljujte s tipkanjem za zavrnitev.
• Zahteve so debounced in preklicljive, zato tipkanje ni nikoli blokirano.
• Ko je zastavica izklopljena, je funkcija popolnoma onemogočena in ne pošiljajo se zahteve za dopolnjevanje.

19 Uporaba, dobropisi & obračunavanje

Odprite Obračunavanje iz stranske vrstice za upravljanje vašega načrta in uporabe. Uporaba AI se meri v dobropisih v ameriških dolarjih na podlagi žetonov, ki jih porabijo osnovni modeli.

• Poraba cikla & predplačani dobropis — spremljajte porabo v tem ciklu in morebitno predplačano stanje.
• Dodaj dobropis za presežek — odobrite dodaten znesek (USD) za nadaljnjo uporabo AI po porabi vključene količine; če je vaš proračun izčrpan, boste videli pasico, ki vas bo pozvala k dodajanju dobropisa.
• Nadgradite / spremenite načrt — preklopite nivoje kadar koli.
• Način plačila — dodajte ali posodobite kartico v evidenci (obdeluje Stripe).
• Prekliči — izberite preklic ob koncu obdobja (ohranite dostop do konca obdobja) ali prekliči zdaj (vrnitev povračljivega preostanka). Glejte Politiko odpovedi & vračil.

20 Pridobivanje ključa API za prehod

Ključ API za prehod (osebni dostopni žeton) vam omogoča programsko uporabo javnega API-ja DeepCerebra in CLI-ja.

1. Prijavite se in odprite Ključi API iz stranske vrstice.
2. Pomaknite se do Ključi API DeepCerebra.
3. Vnesite oznako (npr. "CI pipeline" ali "laptop CLI").
4. Izberite obsege — read, chat, code, agent — in neobvezno potek v dneh (prazno = nikoli).
5. Kliknite Generiraj. Celoten ključ je prikazan samo enkrat — kliknite Kopiraj in ga varno shranite.

Uporabite ga z CLI-jem ali API-jem na deepcerebra.ai:

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

# ali kot nosilni žeton
curl -H "Authorization: Bearer <your-key>" https://deepcerebra.ai/v1/...

Ključ lahko kadar koli preimenujete ali izbrišete (prekličete); vsak ključ prikazuje svojo predpono, obsege, datum ustvaritve/poteka in datum zadnje uporabe.

21 Varnost & zasebnost

• Zaupno shranjevanje v brskalniku — datoteke vašega projekta ostanejo v šifriranem delovnem prostoru brskalnika; na strežnik se pošlje le minimalni kontekst, potreben za vsako zahtevo.
• Ničelno zadrževanje podatkov (ZDR) — pozivi in koda, usmerjeni k modelom, se ne hranijo po zahtevi in se nikoli ne uporabljajo za usposabljanje temeljnih modelov.
• Ključi ostanejo na strežniku — BYOK in SCM žetoni so šifrirani v mirovanju; prikazani so le maskirani predogledi.
• Šifriranje — TLS v prenosu; podatki računa šifrirani v mirovanju; gesla nepovratno zgoščena.
• Vaša koda je vaša — ste lastnik svoje vsebine in generiranega izhoda. Glejte Izjavo o zasebnosti.

22 Odpravljanje težav

"Nalaganje mape potrebuje brskalnik Chromium"

Preklopite na Chrome, Edge ali Brave, ali namesto tega uporabite Odpri iz Gita.

Agent se ponavlja pri isti napaki

Kliknite Ustavi, nato preoblikujte z konkretnim namigom ali omejitvijo.

Napake modela ali zahteve / "proračun izčrpan"

• Preverite svojo povezavo in veljavnost morebitnega ključa BYOK.
• Preklopite na Samodejno, da DeepCerebra usmeri na razpoložljiv model.
• Če je vaš proračun za uporabo izčrpan, odprite Obračunavanje in dodajte dobropis za presežek ali nadgradite svoj načrt.

Lokalni modeli se ne prikažejo

• Potrdite, da priključek dcc-bridge deluje in da naprava prikazuje na spletu.
• Prepričajte se, da Ollama deluje, ali da je lokalni strežnik LM Studio omogočen (privzeta vrata 1234) z naloženim modelom.

Priključek: "strežnik je zavrnil povezavo WebSocket: HTTP 401"

• Uporabite isto domeno, ki jo uporabljate v brskalniku kot --gateway (wss://deepcerebra.ai ali wss://deepcerebra.io) — obe spletni mesti sta ločeni namestitvi, in žeton z enega nikoli ne deluje na drugem.
• Kopirajte natančen ukaz iz kartice za seznanjanje na strani Lokalni računalnik.

Moje spremembe niso začele veljati

• Prepričajte se, da ste kliknili Uporabi (ne samo predogledali razlike) v Predlaganih spremembah.
• Uporabite osvežitev Raziskovalca za ponovno skeniranje mape.

Git: "Ste na privzeti veji"

Odprite ali ustvarite delovno vejo, preden uporabite Integriraj za odprtje zahtevka za združitev.

Še vedno imate težave? Kontaktirajte support@deepcerebra.ai.

23 DeepCerebra Discovery — Vprašajte svoje podatke & dokumente

Discovery je preiskovalni chatbot za vaše baze podatkov in dokumente. Namesto da bi odgovoril z eno samo poizvedbo, deluje kot analitik: oblikuje hipoteze, izvede vrsto nadzorovanih preiskav (SQL, graf, iskanje dokumentov, preverjanje sheme, spletna potrditev), izloči razlage, ki jih dokazi ovržejo, in sintetizira utemeljen odgovor — z grafikoni in preglednim računom stroškov. Odprite ga z ikono kompasa v stranski vrstici dejavnosti (/app/discovery).

23.1 Prostori — vaš urejen obseg

Prostor združuje vse, kar potrebuje eno vprašanje: povezave z bazami podatkov, zbirke dokumentov, navodila za analitika in proračune. Ustvarite ga z + Nov prostor, nato uporabite nastavitveno ploščo na desni za:

• Povežite baze podatkov — SQLite, PostgreSQL, MySQL, SQL Server ali Snowflake. Vnesite ime in DSN, kliknite Preizkusi za preverjanje povezljivosti (prikazana sta zakasnitev in različica strežnika) ali uvozite obstoječo konfiguracijo povezave kot JSON. Povezave so privzeto samo za branje.
• Dodajte dokumente — povlecite in spustite datoteke (PDF, DOCX, PPTX, Markdown, besedilo) neposredno v klepet, prilepite URL ali pokažite na pot do mape na gostitelju pogona. Dokumenti so razdeljeni na dele, vdelani in indeksirani za hibridno vektorsko + iskanje po grafu znanja.
• Uvozite tabele — prilepite ali naložite CSV/JSON za takojšnje poizvedovanje brez baze podatkov.
• Učite analitika — dodajte definicije metrik, poslovna pravila in opozorila, kuratorjevo odobrene zaupanja vredne poizvedbe in primere parov vprašanje→poizvedba, tako da odgovori uporabljajo vaše definicije.

23.2 Postavljanje vprašanja

Vnesite vprašanje, kot bi ga postavili kolegu — na primer "Zakaj se je obseg MRI pregledov zmanjšal marca?". Preiskovalna plošča prikazuje celoten proces v živo:

• Hipoteze — kandidatne razlage v preiskavi, vsaka označena kot podprta, ovržena ali nedokončna, ko prispejo dokazi.
• Preiskave — vsaka poizvedba, ki jo izvede analitik, s svojim statusom; generiran SQL/Cypher je prikazan za popolno preglednost, in vsaka izjava pred izvedbo prestane pravila zaščite samo za branje.
• Dokazi — rezultatne tabele in izvlečki dokumentov, navedeni po številki v končnem odgovoru.
• Odgovor + grafikoni — utemeljen zaključek, ki navaja tudi razlage, ki so bile izključene, ter sodobne grafikone z neonsko tematiko, sestavljene iz dokazov.
• Potrdilo — žetoni, stroški na preiskavo in krogi, zaračunani vašim AI Credits kot vsak drug zagon agenta.

Nadaljnja vprašanja nadaljujejo isto nit, tako da analitik ohranja svoj kontekst.

23.3 Grafikoni, poročila & izvozi

Grafikoni se prikažejo neposredno na preiskovalni plošči. Uporabite Izvozi za prenos celotnega vprašanja — odgovora, hipotez, dokazov in grafikonov — kot samostojno HTML poročilo ali PDF kakovosti za tisk, oblikovano z neonskim oblikovalskim sistemom.

23.4 Proračuni & nadzor stroškov

Vsak prostor ima proračune na vprašanje: največje število preiskav, preiskovalnih krogov, sekund in USD. Pogon se čisto ustavi pri omejitvi in poroča, kaj je do sedaj našel. Stroški vsake preiskave so podrobno navedeni na potrdilu, tako da vedno veste, kam je šla poraba.

23.5 Avtomatizacija: API, SDK, Workflow Studio & MCP

• REST API — vse, kar počne uporabniški vmesnik, je na voljo pod /v1/discovery/* z PAT-om, ki nosi obseg discovery (ustvarite ga pod Račun → API žetoni). Pretočna vprašanja uporabljajo SSE. Zunanji izvajalci si lahko izposodijo samo preiskovalno načrtovanje prek Thinking API (/v1/think/*, obseg think).
• Python SDK — pip install deepcerebra-discovery, nato DiscoveryClient(base_url, token).ask(space_id, question).
• Workflow Studio — povlecite stopnjo Discovery Ask (discovery.ask) v kateri koli potek dela za izvedbo preiskave kot korak cevovoda; odgovor, grafikoni in potrdilo se prenašajo v nadaljnje stopnje.
• MCP — pogon izpostavlja discovery_ask in discovery_list_spaces kot orodja MCP, tako da lahko tudi zunanji odjemalci MCP izvajajo preiskave.