1 Johdanto & versiot

DeepCerebra Coder on agenttipohjainen koodausavustaja. Toisin kuin pelkkä automaattinen täydennys-copilot, se suunnittelee, kirjoittaa, refaktoroi, suorittaa komentoja, kutsuu työkaluja ja iteroi koko projektissasi — sinun tarkistaessasi ja hyväksyessäsi sen ehdottamat muutokset.

Kolme tapaa käyttää sitä

Tämä opas keskittyy verkkosovellukseen osoitteessa deepcerebra.ai; työpöytäsovellus peilaa samat paneelit ja työnkulut.

2 Aloitus & tili

Tuetut selaimet

Käytä uusinta versiota Chrome-, Edge- tai Brave-selaimesta saadaksesi täyden kokemuksen — paikallisen kansion avaaminen perustuu Chromium File System Access API:in. Firefox ja Safari toimivat keskustelussa ja Git-pohjaisissa projekteissa, mutta eivät voi avata paikallista kansiota suoraan.

Luo tili

1. Napsauta aloitussivulla Aloita.
2. Täytä valinnaiset näyttönimesi, sähköpostiosoitteesi, maasi ja syntymäaikasi (sinun on oltava vähintään 18-vuotias).
3. Valitse käyttöliittymäkielesi ja vähintään 12 merkin pituinen salasana.
4. Lue sopimusehdot ja vahvista. Tilin luominen tarkoittaa, että hyväksyt palveluehdot, tietosuojalausunnon, palvelukuvauksen ja maailmanlaajuisen DPA:n.
5. Napsauta Luo tili, vahvista sitten sähköpostiosoitteesi pyydettäessä ja kirjaudu sisään.

Palauta salasanasi

1. Napsauta kirjautumissivulla Unohditko salasanan?
2. Anna sähköpostiosoitteesi ja avaa postilaatikkoosi lähetetty palautuslinkki.
3. Aseta uusi salasana (vähintään 12 merkkiä).

3 Työtila yhdellä silmäyksellä

Sisäänkirjautumisen jälkeen päädyt työpöydälle, joka näyttää kaikki paneelit yhdellä näytöllä:

• Explorer (vasen) — avoimen projektin tiedostopuu, jossa on päivitys- ja sulkemispainike.
• Editor (keskellä) — tiedoston sisältö syntaksikorostuksella ja minimap-yleiskatsauksella; sisäiset erot näkyvät täällä, kun agentti ehdottaa muutoksia.
• Terminal (editorin alla, päälle/pois) — suorita komentoja ja lue tulosteita.
• Chat (oikealla) — agenttikeskustelu; tämä on ensisijainen, tilaa täyttävä paneeli.

Vedä editorin ja chatin välistä jakajaa tasapainottaaksesi asettelua, ja vedä vaakasuuntaista jakajaa muuttaaksesi terminaalin kokoa. Vasen sivupalkki navigoi myös kohti Workspace, Extensions, API Keys, Billing ja Feedback.

4 Projektin avaaminen

4.1 Avaa paikallinen kansio

1. Napsauta Explorerissa Avaa projektikansio.
2. Valitse kansio ja myönnä selaimelle lupa lukea se.
3. Tiedostot luetaan selaimesi salattuun selaimen sisäiseen työtilaan — mitään ei ladata. Näet reaaliaikaisen laskurin ja lopullisen yhteenvedon (tiedostojen määrä · koko, sekä mahdolliset ohitetut tai katkaistut tiedostot).

4.2 Avaa Gitistä (GitHub / GitLab)

1. Napsauta Avaa Gitistä Explorerissa.
2. Valitse GitHub- tai GitLab-välilehti ja liitä henkilökohtainen pääsytoken. GitHubissa käytä `repo`-aluetta (klassinen) tai hienojakoista tokenia Contents + Pull requests -oikeuksilla; GitLabissa käytä `api`-aluetta. Tokenisi tallennetaan palvelimelle — vain tiedostojen sisältö vedetään selaimeen.
3. Kirjoita repositorio muodossa `owner/name` (suodata luettelo löytääksesi omasi) ja valitse sitten haara.
4. Valinnaisesti valitse Luo uusi työhaara (esim. `dcc/my-feature`) pitääksesi työsi erillään oletushaarasta.
5. Valinnaisesti ota käyttöön push webhook, jotta Explorer päivittyy välittömästi, kun tiimikaverit pushaavat (vaatii julkisen yhdyskäytävän URL-osoitteen).
6. Napsauta Avaa repositorio.

4.3 Päivitä, vaihda ja sulje

• Päivitä (↻ Explorerin otsikossa) skannaa kansion uudelleen tai hakee uusimman Gitistä.
• Avaa toinen kansio tai Avaa Gitistä puun alla olevista painikkeista.
• Sulje projekti (roskakori-kuvake) tyhjentää selaimen sisäisen työtilan.

4.4 Kansioihin sidotut keskusteluistunnot

Keskusteluhistoria on sidottu avoimeen projektiin. Kansioiden vaihtaminen aloittaa automaattisesti uuden istunnon ja lataa kyseisen kansion edelliset istunnot, avaten uusimman uudelleen, jotta voit jatkaa siitä, mihin jäit.

4.5 Toiminnalliset kansiot

Kansiot, joita DeepCerebra käyttää sisäisesti — `.deepcerebra`, `.sessions` — näkyvät puussa, mutta ovat oletuksena piilotettuja, jotta ne eivät sotke lähdekoodiasi.

5 Tiedostojen käsittely

• Napsauta tiedostoa Explorerissa avataksesi sen editorissa; minimap auttaa sinua navigoimaan pitkissä tiedostoissa.
• Vedä tiedosto Explorerista keskustelukenttään liittääksesi sen eksplisiittiseksi kontekstiksi seuraavaan viestiisi.
• Kun agentti ehdottaa muokkauksia, editori näyttää sisäisen eron valitulle tiedostolle.

6 Keskustelu agentin kanssa

Kirjoita pyyntö

Kuvaile, mitä haluat, selkeällä kielellä — kysy kysymys, pyydä ominaisuutta tai osoita virhettä. Ole tarkka tiedostojen, kehysten ja rajoitusten suhteen saadaksesi parhaan tuloksen. Liitä asiaankuuluvat tiedostot vetämällä ne keskustelukenttään.

Lue vastaukset, Cursor-tyyliin

Vastaukset on järjestetty Cursorin tapaan: agentin päättely on erotettu toimitettavasta. Jokaisessa vastauslohkossa on kopiointikuvake oikeassa yläkulmassa, jotta voit kopioida valmiin raportin, asiakirjan tai komennon, joka sinun on tarkoitus suorittaa.

Ohjaa tai pysäytä ajo

• Käytä Pysäytä keskeyttääksesi ajon, joka on menossa väärään suuntaan, ja tarkenna sitten pyyntöäsi.
• Anna vihjeitä (esim. "käytä `lxml` `html.parser`:n sijaan") murtaaksesi agentin ulos silmukasta.

7 Neljä keskustelutilaa

Valitse tila pyyntökentän vieressä olevasta tilavalitsimesta. Jokainen säätää, kuinka paljon agentti suunnittelee ja kuinka vapaasti se muokkaa:

8 Muutosten tarkistaminen & soveltaminen

Kun agentti ehdottaa tiedostomuutoksia, keskustelukentän yläpuolelle ilmestyy Ehdotetut muutokset -paneeli, joka luettelee jokaisen muutetun tiedoston lisättyjen (+) ja poistettujen (−) rivien määrineen.

• Napsauta tiedostoriviä avataksesi sen sisäisen eron editorissa.
• Hyväksy tai Hylkää yksittäinen tiedosto, tai käytä Hyväksy kaikki / Hylkää kaikki.
• Hyväksytyt muutokset merkitään `applied` (ja `· disk`, kun ne on kirjoitettu oikeaan kansioon).
• Jos kirjoitettavaa kansiota ei ole, vain työtila -merkki osoittaa, että muutokset koskevat selaimen sisäistä työtilaa.

9 Integroitu pääte

Vaihda editorin alla olevaan päätteeseen suorittaaksesi koontiversioita, testejä ja skriptejä. Luvallasi agentti voi suorittaa komentoja ja lukea niiden tulosteita tarkistaakseen työnsä; pitkäkestoiset komennot suoratoistavat tulosteita, jotta voit seurata edistymistä. Sulje pääte sen otsikosta, kun et tarvitse sitä.

10 Suunnittelutila & toteutus

Suurempia tavoitteita varten käytä Suunnittelu-tilaa (tai pyydä agenttia suunnittelemaan ensin). Suunnittelija skannaa projektisi, hajottaa tavoitteen riippuvuustietoisiksi tehtäviksi ja määrittää kunkin oikealle asiantuntijalle (arkkitehti, koodaaja, testaaja, dokumentoija).

• Tarkista & muokkaa suunnitelmaa — lisää, poista tai muokkaa tehtäviä ennen toteutusta.
• Toteuta kerros kerrokselta — itsenäiset tehtävät suoritetaan yhdessä; suunnittelija voi suunnitella uudelleen, jos tehtävä epäonnistuu.
• Keskeytä, jatka tai peruuta toteutus milloin tahansa.

11 Mallien valinta & Auto

Avaa mallivalitsin pyyntökentän vierestä. Vaihtoehdot on ryhmitelty seuraavasti:

• Auto — anna DeepCerebran valita paras saatavilla oleva malli (suositus).
• Local (your GPU) — omalta koneeltasi tarjoillut mallit (katso §13).
• Platform gateways — isännöidyt mallit, ryhmitelty yhdyskäytävän ja sitten toimittajan mukaan (esim. Anthropic, OpenAI, Google).

Miten automaattinen valinta toimii

Automaattitilassa DeepCerebra käyttää kerroksellista, mukautuvaa reititystä: yksinkertaiset tehtävät ohjataan nopeaan, taloudelliseen malliin, kun taas monimutkainen tai paljon suunnittelua vaativa työ (esimerkiksi Suunnittelutila) ohjataan tehokkaampaan malliin. Tämä tasapainottaa kustannukset ja laadun automaattisesti, joten sinun tarvitsee harvoin valita manuaalisesti.

12 Oma avain (BYOK)

Voit reitittää pyynnöt oman palveluntarjoajatilisi kautta mitatun alustakäytön sijaan.

1. Avaa API Keys sivupalkista.
2. Kohdasta Bring Your Own Key valitse palveluntarjoaja (esim. ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
3. Liitä avaimen arvo ja napsauta Tallenna. Avaimet salataan levossa, eikä niitä koskaan palauteta selaimeen — näytetään vain maskattu esikatselu.

Alustan (DeepCerebra) mallit eivät tarvitse avainta. Poista avain milloin tahansa Poista-painikkeella.

13 Paikallinen kone: GPU-mallit & konsoli (DCC Bridge)

DCC Bridge yhdistää oman tietokoneesi verkkosovellukseen pienen dcc-bridge-liittimen kautta, avaten kaksi ominaisuutta samanaikaisesti:

• Paikalliset GPU-mallit — Ollaman tai LM Studion koneellasi tarjoilemat mallit näkyvät mallivalitsimessa kohdassa Local (your GPU).
• Konsoli / pääte koneellasi — verkkopääte ja agentti voivat suorittaa todellisia komentoja tietokoneellasi, mukaan lukien jo määrittämäsi CLI-työkalut (Railway, AWS CLI, OVH CLI, gh, docker, kubectl, WSL, …) olemassa olevilla tunnistetiedoillaan.

Liitin soittaa ulos todennetun WebSocketin kautta — ei tarvita sisäänpäin tulevia portteja, ja se toimii NAT:n ja palomuurien takana. Se toimii Windowsissa, macOS:ssä ja Linuxissa (Python 3.10+).

13.1 Parita tietokoneesi

1. Napsauta kannettavan kuvaketta vasemmassa toimintapalkissa — Local Machine (GPU + Console). (Sama paneeli avautuu mallivalitsimen alatunnisteesta kohdasta Manage local GPU….)
2. Varmista, että Local execution -kytkin on käytössä, nimeä laite ja napsauta Add this computer. Kopioi kertaluonteinen paritustoken (dcc_brg_…) ja valmiiksi liitettävä liitinkomento — token näytetään täsmälleen kerran.

13.2 Asenna & suorita liitin

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

• Käytä samaa verkkotunnusta, jota käytät selaimessa yhdyskäytävänä (wss://deepcerebra.ai tai wss://deepcerebra.io) — parituskortti esitäyttää oikean. Nämä kaksi sivustoa ovat erillisiä käyttöönottoja erillisillä tileillä ja tokeneilla.
• GPU-malleja varten pidä Ollama käynnissä tai ota käyttöön LM Studion paikallinen palvelin (oletusportti 1234) mallin ollessa ladattuna.
• Paritetut laitteet näyttävät online/offline-tilan, mallien määrän ja suorituslaajuuden; voit Revoke-toiminnolla kumota laitteen milloin tahansa.

13.3 Käytä konsoliasi verkkosovelluksesta

Oletuksena komennot rajoittuvat omaan työtilakansioon (~/DeepCerebra). Työskennelläksesi todellisissa projektikansioissasi esikonfiguroitujen CLI-työkalujesi kanssa, myönnä ne eksplisiittisesti liitintä käynnistettäessä:

# 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

Avaa sitten Terminal-paneeli, napsauta Execution target -ponnahdusikkunaa (kannettavan kuvake), valitse My computer ja valitse työkansio. Sekä kirjoittamasi komennot että agentin koonti-/testikomennot suoritetaan sitten koneellasi.

14 Git-yhteistyötyönkulku

Kun Git-pohjainen projekti on avoinna, Explorerissa näkyy haarapalkki, joka näyttää nykyisen haarasi ja kaksi toimintoa:

• Check in (commit) — tarkista muutettujen tiedostojen määrä, kirjoita commit-viesti ja committaa työhaaraasi.
• Integrate — avaa pull request työhaarastasi oletushaaraan (esim. `main`). Sinun on oltava työhaarassa, ei oletushaarassa.

Jos push webhook on käytössä, Explorer päivittyy automaattisesti, kun tiimikaverit pushaavat, pitäen kaikki synkronoituna — tämä on perusta yhteistyöhön perustuvalle tiimikehitykselle DeepCerebran kautta.

15 MCP-palvelimet

Laajenna agenttia ulkoisilla työkaluilla ja tiedoilla Model Context Protocolin kautta. Määritä palvelimet `.deepcerebra/mcp.json`-tiedostoon, esimerkiksi:

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

Käytössä olevat MCP-työkalut tulevat agentin saataville automaattisesti, kun ne ovat relevantteja pyyntöösi. Sekä paikalliset (`stdio`) että etäpalvelimet (`http`/`sse`) ovat tuettuja.

Sisäänrakennettu turvallisuus

• Deny-by-default — kun palvelin listaa `allowlist`-luettelon, vain nämä työkalut voivat suorittaa.
• Hyväksyntä korkean riskin työkaluille — muuttavat työkalut (kirjoitus/poisto/käyttöönotto/…) vaativat hyväksynnän, ellet esihyväksy niitä `autoApprove`-asetuksessa.
• Nopeusrajoitus, argumenttien ja tulosteiden puhdistus sekä auditointiloki koskevat jokaista kutsua.

Resurssit & kehotteet

Jos palvelin paljastaa MCP-resursseja tai prompt-malleja, agentti saa automaattisesti työkalut niiden käyttämiseen (`mcp_list_resources`, `mcp_read_resource`, `mcp_list_prompts`, `mcp_get_prompt`).

Todennus etäpalvelimille

Lisää `auth`-lohko etäpalvelimeen. Salaisuudet tukevat `${ENV_VAR}`-interpolointia:

// 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 Agentin mukauttaminen: säännöt, taidot, koukut, ala-agentit & laajennukset

Voit muokata agentin ajattelua ja toimintaa yhdellä, tiedostopohjaisella konventiolla — .deepcerebra/-hakemistolla — joka toimii identtisesti työpöytäsovelluksessa, verkkosovelluksessa ja API:ssa. Verkkosovelluksessa hallitse kaikkia näitä Agent-näkymässä; työpöydällä ja API:n kautta ne ovat tavallisia tiedostoja, jotka commitat projektisi kanssa.

Laajuudet & etusija

Konfiguraatio löydetään useista laajuuksista; kun sama kohde on olemassa useammassa kuin yhdessä, korkeamman etusijan omaava voittaa:

team/org  <  global (~/.deepcerebra)  <  workspace (<repo>/.deepcerebra)
(alin)                                              (ylin)

• Workspace — <repo>/.deepcerebra/…, commitattu projektin kanssa.
• Global — ~/.deepcerebra/…, henkilökohtaiset oletusasetuksesi kaikissa projekteissa.
• Team / org — jaettu peruslinja (alin etusija), jotta käyttäjä tai projekti voi aina ohittaa sen. Verkkosovelluksessa aseta säännön Scope-asetukseksi Team.

Säännöt (ohjaus)

Säännöt ovat pysyviä ohjeita — koodausstandardeja, arkkitehtuurikonventioita, toimialakontekstia — jotka injektoidaan agentin järjestelmäkehotteeseen. Ne sijaitsevat Markdown-tiedostoina .deepcerebra/steering/-hakemistossa, sekä aina päällä olevassa `AGENTS.md`-standardissa. Frontmatter ohjaa *milloin* sääntö ladataan:

---
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` — joka käänteellä (oletus).
• `fileMatch` — vain kun kontekstissa oleva tiedosto vastaa `globs`-määritelmää.
• `auto` — kun pyyntösi vastaa säännön `name`/`description`-määritelmää.
• `manual` — vain kun viittaat siihen muodossa `#name` tai `/name`.

Juurihakemiston `AGENTS.md` koskee koko repositoriota; sisäkkäinen `AGENTS.md` (esim. services/api/AGENTS.md) koskee vain kyseisen kansion alla olevia tiedostoja. Verkkosovelluksessa Agent → Steering -näkymä antaa jokaiselle säännölle Scope-valitsimen (Global / Project / Team).

Taidot

Taidot ovat uudelleenkäytettäviä toimintasuunnitelmia, jotka agentti lataa *tarvittaessa*. Jokainen taito on kansio, jossa on `SKILL.md` tiedosto hakemistossa `.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.

Agentti näkee kevyen luettelon (name + description) ja vetää koko sisällön `load_skill`-työkalulla, kun se on relevantti. Voit myös kutsua taidon eksplisiittisesti komennolla `/skill `. Aseta `disable-model-invocation: true` tehdaksesi taidosta vain manuaalisesti käytettävän.

Koukut

Koukut suorittavat automaatiota elinkaaritapahtumissa. Määritä ne tiedostoina `.deepcerebra/hooks/*.hook.json`:

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

Tapahtumiin kuuluvat `promptSubmit`, `preToolUse`, `postToolUse`, `fileCreate`, `fileSave`, `fileDelete`, `preTask`, `postTask`, `sessionStart`, `preCompact` ja `agentStop` (Cursor/Claude-kirjoitusasut hyväksytään myös). Toiminto on joko `shell` (suorita komento) tai `agentPrompt` (kysy agentilta). `preToolUse`-koukku voi allow, deny tai ask sieppaamansa työkalukutsun.

Ala-agentit

Ala-agentit ovat erikoisagentteja, jotka määrität ja joille delegoit tehtäviä. Jokainen on Markdown-tiedosto hakemistossa `.deepcerebra/agents/` etuosalla ja rungolla (sen järjestelmäkehote):

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

Pääagentti delegoi tehtäviä `task`-komennolla (estää), `task_async` + `task_status` / `task_result` (taustalla) tai `task_parallel`-komennolla (hajautus).

Laajennukset

Laajennus niputtaa säännöt, taidot, koukut, ala-agentit ja MCP-palvelimet yhdeksi asennettavaksi paketiksi hakemistoon `.deepcerebra/plugins//`, jota kuvaa `plugin.json`-manifesti:

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

Laajennuksen sisältö yhdistetään alimmalla etusijalla, joten omat sääntösi ja taitosi ohittavat aina laajennuksen säännöt ja taidot. Poista laajennus käytöstä asettamalla `"enabled": false` tai luomalla `.disabled`-merkintätiedosto.

17 Agenttipohjainen työnkulkustudio & tapahtumapohjaiset agentit

Workflow Studio on visuaalinen suunnittelutyökalu moniagenttiautomaatioon. Voit koostaa vaiheita — joista jokainen on agentti, erikoistunut vaihe tai ohjausprimitiivi — graafiksi, yhdistää ne riippuvuuksilla ja suorittaa koko orkestraation moottorilla, jossa on reaaliaikainen vaihekohtainen edistyminen, budjetit ja ihmisen hyväksyntäportit. Työnkulut tallennetaan siirrettävänä YAML/JSON-määrityksenä, jonka voit viedä, tuoda, versioida Gitissä ja suorittaa API:sta tai CLI:stä.

17.1 Työnkulun rakentaminen

• Paletti (vasen) — vedä vaihetyyppejä, valmiita agenttityyppejä (tutkimus, koodin generointi, laadunvarmistus, dokumenttien kirjoittaja, lääkinnällinen laite, patenttineuvoja ja omat mukautetut tyyppisi), taitoja taitokirjastosta ja työkaluja kankaalle.
• Canvas (keskellä) — järjestä vaiheita ja piirrä reunoja; reuna tarkoittaa "tämä vaihe riippuu tuosta" ja syöttää automaattisesti ylävirran tulosteen alavirran kehotteeseen.
• Inspector (oikealla, kokoa muutettavissa) — määritä valittu vaihe: sen kehote, taidot, työkalut, vaihekohtainen mallin ohitus, tulosteartefakti, portti, tapahtumat ja tyyppikohtaiset parametrit.
• Mallit — aloita sisäänrakennetusta suunnitelmasta (Ship-It Pipeline, SaaS Starter, Data Pipeline with Evals, Customer Comms Hub, Design → Verified App) ja mukauta sitä.
• Generate — kuvaile sovellus tai prosessi selkeällä kielellä, ja Agent Builder generoi täydellisen, validoidun työnkulkugraafin, jonka voit tarkistaa, säätää ja suorittaa.

17.2 Vaihekirjasto

17.3 Tapahtumapohjaiset agentit (agenttiverkko)

Jokainen vaihe — tyypistä riippumatta — voi julkaista ja tilata tyypitettyjä tapahtumia työtilan tapahtumaväylällä, jotta agentit koordinoivat kuin palvelut viestiverkossa pelkän DAG:n sijaan:

• Tapahtumaluokat — jokainen tapahtuma sisältää luokan: `lifecycle`, `agent`, `business`, `data`, `system`, `schedule`, `chat`, `external` tai `alert` — suodatettavissa tilauksissa ja toistossa.
• Tilaustilat — `trigger` (vaihe suoritetaan, kun vastaava tapahtuma saapuu; pysäytettyjen vaiheiden ajo pysyy residenttinä *kuuntelutilassa*), `gate` (koneportti, jonka tapahtuma hyväksyy ihmisen napsautuksen sijaan) ja `data` (hyötykuorma yhdistetään vaiheen kontekstiin).
• Käynnistys tapahtumalla — mikä tahansa agentti voidaan käynnistää orkestraattorin tai toisen agentin toimesta julkaisemalla sen osoitteeseen `agent..request`.
• Ajon käynnistimet — työnkulun `triggers:`-lohko aseistaa sen käynnistymään saapuvista webhooks-kutsuista, cron schedules-ajoituksista, events-tapahtumista tai chatista — vaikka Studio olisi suljettu.
• Live-ajot — ajopaneeli suoratoistaa elinkaaritapahtumia SSE:n kautta: vaiheiden aloitukset/valmistumiset, portit, hälytykset ja esikatselut ilmestyvät välittömästi.
• Kestävä loki & toisto — tapahtumat säilyvät työtilakohtaisesti ja ne voidaan toistaa aihekuvion ja luokan mukaan auditointia ja virheenkorjausta varten.

17.3.1 Tapahtumien jonotus agenteille

Tapahtumiin reagoivat agentit voivat määrittää kestävän nimetyn jonon, jotta vastaavat tapahtumat eivät koskaan katoa agentin ollessa varattu tai ennen kuin suoritus kuuntelee. Triggeritilauksessa aseta queue: <name> – moottori sitoo kyseisen aiheen työtilan tapahtumaväylän FIFO-jonoon (säilytetään polussa .deepcerebra/workflows/events/queues/). Jokainen siitä eteenpäin julkaistu vastaava tapahtuma tallennetaan jonoon; kun vaiheesta tulee suoritettavissa, moottori poimii tapahtumat vanhimmasta alkaen -järjestyksessä ja kuluttaa ne yksi kerrallaan.

• Mitään ei katoa — työnkulun ollessa suljettuna, toisen vaiheen ollessa käynnissä tai suorituksen odottaessa riippuvuuksia julkaistut tapahtumat jonotetaan pudottamisen sijaan.
• Tilauksen mukainen count — edellyttää N jonotettua (tai toimitettua) tapahtumaa ennen kuin tilaus täyttyy (hyödyllinen, kun useiden työntekijöiden on raportoitava).
• Studio — Inspectorin Tapahtumat-paneelissa aseta queue-kenttä triggeritilaukselle; aktivoi triggerit tai käynnistä suoritus luodaksesi sidoksen automaattisesti.
• API ja työkalut — GET /api/workflow/queues listaa syvyyden ja sidokset; GET /api/workflow/queues/{name} kurkistaa odottavia tapahtumia; chat-agentit voivat kutsua työkaluja 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 Semafoforien orkestrointi (jaetun resurssin suojaus)

Semafofori rajoittaa, kuinka monta tehtävää voi samanaikaisesti toimia jaetun (suojatun) resurssin parissa: kirjoitettava tietokanta, globaali muuttujavarasto, tiedosto tai nopeusrajoitettu ulkoinen agentti. Liitä semafofori mihin tahansa vaiheeseen semaphore:-kentällä — ennen vaiheen työn suorittamista moottori hankkii yhden luvan nimetystä työtilan semafoforista; lupa vapautetaan aina jälkeenpäin, vaikka vaihe epäonnistuisi. permits: 1 tekee siitä muteksin: vain yksi tehtävä kerrallaan (kaikissa työtilan rinnakkaisissa suorituksissa) suorittaa kriittisen vaiheen; kaikki muut tehtävät odottavat, kunnes haltija lopettaa.

• Suoritusten välinen sarjallistaminen — semaforit ovat työtilan laajuisia ja pysyviä, joten kaksi samanaikaista työnkulun suoritusta eivät voi vioittaa samaa suojattua resurssia.
• Odottaa, ei jumiudu — tehtävät estyvät timeout_s-ajan luvan odottamiseen; jos resurssi pysyy täynnä, vaihe epäonnistuu näkyvästi sen sijaan, että se jumiutuisi ikuisesti.
• Kaatumisturvallisuus — jokaisella luvalla on ttl_s; jos haltija kaatuu vapauttamatta, lupa vanhenee automaattisesti, jotta resurssi ei koskaan jumiudu.
• Havaittavuus — väylä lähettää semaphore.<name>.waiting, .acquired ja .released -järjestelmätapahtumia; GET /api/workflow/semaphores näyttää kapasiteetin, haltijat ja käytettävissä olevat luvat.
• Chat-agentit — työkalut acquire_semaphore, release_semaphore ja semaphore_status koordinoivat ad hoc -kriittisiä osioita työnkulun ulkopuolella.

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-orkestrointi (odota kaikkia ehtoja)

Rendezvous odottaa, kunnes useat tapahtumaehdot täyttyvät, ennen kuin seuraava vaihe etenee – vastakohta "ensimmäinen tapahtuma voittaa" -periaatteelle. Aseta join: all vaiheen events:-lohkoon: jokaisen triggeritilauksen on täytyttävä, ennen kuin vaihe suoritetaan. Yhdistä tämä tilauksen mukaiseen count: N -asetukseen, kun useiden agenttien (tai yhden agentin useiden raporttien) on kaikkien kirjauduttava sisään – esimerkiksi suunnittelun hyväksyntä, testien valmistuminen ja tietoturvan hyväksyntä ennen julkaisuvaiheen suorittamista.

• join: any (oletus) — vaihe suoritetaan, kun ensimmäinen triggeritilaus täyttyy.
• join: all — rendezvous: jokaisen triggeritilauksen (jokaisella oma aiheensa, luokkasuodattimensa ja valinnainen count) on täytyttävä; vasta sitten vaiheesta tulee suoritettavissa.
• Hyötykuormat — kaikki kulutetut tapahtumat tallennetaan vaiheeseen nimellä trigger_events ja ne ovat saatavilla malleille nimellä inputs.events (luettelo tapahtumaobjekteista hyötykuormineen).
• Studio — kun vaiheessa on kaksi tai useampi triggeritilaus, Inspector näyttää Join-valitsimen: any – ensimmäinen tapahtuma voittaa tai all – rendezvous (odota kaikkia); piirtoalusta näyttää yhdistämismerkin rendezvous-vaiheissa.

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 Agenttityökalukirjasto

Vaiheet valitsevat työkaluja samasta rekisteristä, jota chat-agentti käyttää:

• Core — tiedostot, git, shell, koodin suoritus, koodihaku, selainautomaatio, verkkohaku, näkö/media, kuvien generointi.
• Databases — SQLite, PostgreSQL, MySQL, MongoDB ja Redis-kyselyt sekä `create_database`, `apply_migrations` ja `dump_schema` omistetuille tietokerroksille.
• Communications — puhelut ja tekstiviestit (Twilio) ja sähköposti (SendGrid), simulaatiotilalla, joka tallentaa uloslähteviin viesteihin, kun tunnistetiedot puuttuvat — demot eivät koskaan lähetä oikeita viestejä vahingossa.
• DevOps — `docker_build` / `docker_push`, compose up/down, SSH ja pilvi-CLI-käyttöönotot (Fly, Render, Railway, Vercel), myös simulaatioturvallisia.
• Verification — pinon tunnistus, testisarjan suoritus jäsennettyine läpäisyasteineen, riippuvuustarkastukset ja salaisuuksien skannaus.
• SciCompute Engines — satoja tieteellisiä ja teknisiä menetelmiä (nimeltään `Class.method`) matematiikassa, signaalinkäsittelyssä, ohjauksessa, tilastoissa ja muussa.
• Expert Agency & MCP — perusteltu toimialatutkimus sekä kaikki yhdistämäsi ulkoiset MCP-palvelimet.

17.5 Suoritus, portit ja tulosteet

• Validate tarkistaa graafin (yksilölliset tunnukset, syklittömät riippuvuudet, tyyppiparametrit) ennen suoritusta.
• Human gates keskeyttävät ajon *sen jälkeen*, kun vaihe tuottaa luonnoksensa, jotta voit hyväksyä todellisen työn; event gates antavat toisen järjestelmän hyväksyä automaattisesti.
• Budgets rajoittavat kulutusta ajoa ja vaihetta kohti.
• Save outputs to project kopioi kaikki ajon generoimat artefaktit avoimeen projektiisi.
• Export App muuttaa työnkulun itsenäiseksi FastAPI-palveluksi; julkinen `/v1`-API paljastaa ajot, tapahtumat, käynnistimet, mallit ja generoinnin CI:tä ja integraatioita varten.

18 Ennakoiva sarkainten täydennys

Ennakoiva sarkainten täydennys tarjoaa sisäisiä, keskelle täytettäviä koodiehdotuksia kirjoittaessasi editoriin — hyväksy ehdotus Tab-näppäimellä. Se on opt-in sekä moottorissa että verkkopohjaisessa editorissa.

Ota se käyttöön

• Engine — aseta ympäristömuuttuja `DCC_TAB_COMPLETE=1`. Editori kutsuu moottorin `POST /api/complete`-päätepistettä, joka palauttaa vain kursorin kohdalle lisättävän tekstin.
• Web editor — ota käyttöön koontivaiheessa `VITE_TAB_COMPLETE=1`-asetuksella tai ajonaikaisesti `localStorage.setItem('dcc.tabComplete', '1')`-komennolla (ja lataa sitten sivu uudelleen).

Miten se toimii

• Ehdotukset näkyvät haamutekstinä; paina Tab hyväksyäksesi tai jatka kirjoittamista hylätäksesi.
• Pyynnöt debouncaataan ja ne voidaan peruuttaa, joten kirjoittaminen ei koskaan esty.
• Kun lippu on pois päältä, ominaisuus on kokonaan poistettu käytöstä, eikä täydennyspyyntöjä tehdä.

19 Käyttö, krediitit & laskutus

Avaa Laskutus sivupalkista hallitaksesi suunnitelmaasi ja käyttöäsi. Tekoälyn käyttö mitataan Yhdysvaltain dollarin krediiteillä perustuen taustalla olevien mallien kuluttamiin tokeneihin.

• Kierron kulutus & ennakkoon maksettu krediitti — seuraa tämän kierron käyttöä ja mahdollista ennakkoon maksettua saldoa.
• Lisää ylityskrediittiä — valtuuta lisämäärä (USD) jatkaaksesi tekoälyn käyttöä sisältyvän käyttöoikeuden jälkeen; jos budjettisi on käytetty loppuun, näet bannerin, joka kehottaa sinua lisäämään krediittiä.
• Päivitä / vaihda suunnitelmaa — vaihda tasoja milloin tahansa.
• Maksutapa — lisää tai päivitä tiedoissa oleva kortti (käsitelty Stripen toimesta).
• Peruuta — valitse *peruuta kauden lopussa* (pidä pääsy kauden loppuun asti) tai *peruuta nyt* (hyvitä hyvitettävä jäännös). Katso peruutus- ja hyvityskäytäntö.

20 Yhdyskäytävän API-avaimen hankkiminen

Yhdyskäytävän API-avain (henkilökohtainen pääsytoken) antaa sinun käyttää DeepCerebran julkista API:a ja CLI:tä ohjelmallisesti.

1. Kirjaudu sisään ja avaa API Keys sivupalkista.
2. Selaa kohtaan DeepCerebra API Keys.
3. Anna tunniste (esim. "CI pipeline" tai "laptop CLI").
4. Valitse scopes — `read`, `chat`, `code`, `agent` — ja valinnainen expiry päivinä (tyhjä = ei koskaan).
5. Napsauta Generate. Koko avain näytetään vain kerran — napsauta Copy ja tallenna se turvallisesti.

Käytä sitä CLI:n tai API:n kanssa osoitteessa 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/...

Voit nimetä uudelleen tai poistaa (kumota) avaimen milloin tahansa; jokainen avain näyttää etuliitteensä, laajuutensa, luonti-/vanhenemispäivänsä ja viimeisimmän käyttöpäivänsä.

21 Turvallisuus & yksityisyys

• Luottamuksellinen selaimen sisäinen tallennustila — projektitiedostosi pysyvät selaimen salatussa työtilassa; vain pyyntöä varten tarvittava minimaalinen konteksti lähetetään palvelimelle.
• Zero Data Retention (ZDR) — malleihin reititettyjä kehotteita ja koodia ei säilytetä pyynnön jälkeen, eikä niitä koskaan käytetä perusmallien kouluttamiseen.
• Avaimet pysyvät palvelinpuolella — BYOK- ja SCM-tokenit salataan levossa; näytetään vain maskatut esikatselut.
• Salaus — TLS siirron aikana; tilitiedot salataan levossa; salasanat hashataan peruuttamattomasti.
• Koodisi on sinun — omistat sisältösi ja generoidun tulosteen. Katso tietosuojalausunto.

22 Vianmääritys

"Kansion lataaminen vaatii Chromium-selaimen"

Vaihda Chromeen, Edgeen tai Braveen tai käytä sen sijaan Avaa Gitistä.

Agentti toistaa samaa virhettä

Napsauta Pysäytä ja muotoile sitten uudelleen konkreettisella vihjeellä tai rajoituksella.

Malli- tai pyyntövirheet / "budjetti käytetty loppuun"

• Tarkista yhteytesi ja että kaikki BYOK-avaimet ovat kelvollisia.
• Vaihda Auto-tilaan, jotta DeepCerebra reitittää saatavilla olevaan malliin.
• Jos käyttöbudjettisi on käytetty loppuun, avaa Laskutus ja lisää ylityskrediittiä tai päivitä suunnitelmasi.

Paikalliset mallit eivät näy

• Varmista, että `dcc-bridge`-liitin on käynnissä ja laite näyttää online-tilan.
• Varmista, että Ollama on käynnissä tai LM Studion paikallinen palvelin on käytössä (oletusportti `1234`) mallin ollessa ladattuna.

Liitin: "palvelin hylkäsi WebSocket-yhteyden: HTTP 401"

• Käytä samaa verkkotunnusta, jota käytät selaimessa `--gateway`-asetuksena (wss://deepcerebra.ai tai wss://deepcerebra.io) — nämä kaksi sivustoa ovat erillisiä käyttöönottoja, eikä toisen token toimi koskaan toisessa.
• Kopioi tarkka komento parituskortista Local Machine -sivulta.

Muutokseni eivät tulleet voimaan

• Varmista, että napsautit Hyväksy (et vain esikatsellut eroa) kohdassa *Ehdotetut muutokset*.
• Käytä Explorerin päivitys-toimintoa kansion uudelleen skannaamiseen.

Git: "Olet oletushaarassa"

Avaa tai luo työhaara ennen kuin käytät *Integrate*-toimintoa pull requestin avaamiseen.

Oletko edelleen jumissa? Ota yhteyttä osoitteeseen support@deepcerebra.ai.

23 DeepCerebra Discovery — Kysy tiedoiltasi ja asiakirjoiltasi

Discovery on tutkiva chatbot tietokannoillesi ja asiakirjoillesi. Sen sijaan, että se vastaisi yhdellä kyselyllä, se toimii kuin analyytikko: se muodostaa hypoteeseja, suorittaa sarjan valvottuja tutkimuksia (SQL, graafi, asiakirjahaku, skeematarkistukset, verkon vahvistus), karsii todisteiden kumoamat selitykset ja syntetisoi perustellun vastauksen – kaavioiden ja läpinäkyvän kustannuskuittauksen kera. Avaa se toimintapalkin kompassikuvakkeesta (/app/discovery).

23.1 Tilat – kuratoitu toiminta-alueesi

Tila kokoaa kaiken, mitä yksi kysymyssarja tarvitsee: tietokantayhteydet, asiakirjakokoelmat, ohjeet analyytikolle ja budjetit. Luo tila valitsemalla + Uusi tila ja käytä sitten oikealla olevaa asetuspaneelia seuraaviin toimiin:

• Yhdistä tietokantoja — SQLite, PostgreSQL, MySQL, SQL Server tai Snowflake. Anna nimi ja DSN, napsauta Testaa varmistaaksesi yhteyden (viive ja palvelimen versio näytetään), tai tuo olemassa oleva yhteyskokoonpano JSON-muodossa. Yhteydet ovat oletusarvoisesti vain luku -tilassa.
• Lisää asiakirjoja — vedä ja pudota tiedostoja (PDF, DOCX, PPTX, Markdown, teksti) suoraan chattiin, liitä URL-osoite tai osoita kansiopolkuun moottorin isännässä. Asiakirjat jaetaan osiin, upotetaan ja indeksoidaan hybridi vektori- + tietämysgraafihakua varten.
• Tuo taulukoita — liitä tai lataa CSV/JSON-tiedostoja kyselyyn välittömästi ilman tietokantaa.
• Opeta analyytikkoa — lisää mittarimääritelmiä, liiketoimintasääntöjä ja varoituksia, kuraattorin hyväksymiä luotettuja kyselyitä ja esimerkkikysymys→kyselypareja, jotta vastaukset käyttävät sinun määritelmiäsi.

23.2 Kysymyksen esittäminen

Kirjoita kysymys samalla tavalla kuin kysyisit kollegalta – esimerkiksi ”Miksi MRI-kuvausten määrä laski maaliskuussa?”. Tutkimustaulu näyttää koko prosessin reaaliaikaisesti:

• Hypoteesit — tutkittavat ehdokasselitykset, joista jokainen merkitään tuetuksi, kumotuksi tai epäselväksi todisteiden saapuessa.
• Tutkimukset — jokainen analyytikon suorittama kysely tiloineen; luotu SQL/Cypher näytetään täydellisen läpinäkyvyyden vuoksi, ja jokainen lauseke läpäisee vain luku -tilassa olevat suojasäännöt ennen suoritusta.
• Todisteet — tulostaulukot ja asiakirjaotteet, joihin viitataan numerolla lopullisessa vastauksessa.
• Vastaus + kaaviot — perusteltu johtopäätös, joka nimeää myös hylätyt selitykset, sekä modernit neon-teemaiset kaaviot, jotka on koottu todisteista.
• Kuitti — tunnukset, tutkimuskohtaiset kustannukset ja kierrokset, jotka veloitetaan AI Credits -saldostasi kuten mikä tahansa muu agentin suoritus.

Seurantakysymykset jatkavat samaa keskusteluketjua, joten analyytikko säilyttää kontekstinsa.

23.3 Kaaviot, raportit ja viennit

Kaaviot renderöidään suoraan tutkimustaululle. Käytä Vie-toimintoa ladataksesi koko kyselyn – vastauksen, hypoteesit, todisteet ja kaaviot – itsenäisenä HTML-raporttina tai tulostuslaatuisena PDF-tiedostona, joka on muotoiltu neon-suunnittelujärjestelmällä.

23.4 Budjetit ja kustannusten hallinta

Jokaisella tilalla on kyselykohtaiset budjetit: enimmäismäärä tutkimuksia, tutkimuskierroksia, sekunteja ja USD. Moottori pysähtyy siististi rajan saavutettuaan ja raportoi tähän mennessä löytämänsä. Jokaisen tutkimuksen kustannukset eritellään kuitissa, joten tiedät aina, mihin kulut menivät.

23.5 Automaatio: API, SDK, Workflow Studio & MCP

• REST API — kaikki, mitä käyttöliittymä tekee, on saatavilla osoitteessa /v1/discovery/* PAT-tunnuksella, jolla on discovery-laajuus (luo se kohdassa Tili → API-tunnukset). Striimaavat kyselyt käyttävät SSE:tä. Ulkoiset suorittajat voivat lainata vain tutkivan suunnittelun Thinking API:n kautta (/v1/think/*, laajuus think).
• Python SDK — pip install deepcerebra-discovery, sitten DiscoveryClient(base_url, token).ask(space_id, question).
• Workflow Studio — pudota Discovery Ask -vaihe (discovery.ask) mihin tahansa työnkulkuun suorittaaksesi tutkimuksen putkivaiheena; vastaus, kaaviot ja kuitti virtaavat alavirran vaiheisiin.
• MCP — moottori paljastaa discovery_ask- ja discovery_list_spaces-toiminnot MCP-työkaluina, joten ulkoiset MCP-asiakkaat voivat myös suorittaa tutkimuksia.