1 Hyrje & Edicione

DeepCerebra Coder është një asistent kodimi agentik. Ndryshe nga një copilot i thjeshtë autoplotësimi, ai planifikon, shkruan, refaktoron, ekzekuton komanda, thërret mjete dhe iteron në të gjithë projektin tuaj — me ju që rishikoni dhe miratoni ndryshimet që ai propozon.

Tri mënyra për ta përdorur

Ky udhëzues fokusohet në aplikacionin web në deepcerebra.ai; aplikacioni desktop pasqyron të njëjtat panele dhe rrjedha pune.

2 Fillimi & Llogaria

Shfletuesit e mbështetur

Përdorni një version aktual të Chrome, Edge, ose Brave për përvojën e plotë — hapja e një dosjeje lokale mbështetet në API-në e Aksesit në Sistemin e Skedarëve të Chromium. Firefox dhe Safari funksionojnë për bisedë dhe për projekte të mbështetura në Git, por nuk mund të hapin një dosje lokale drejtpërdrejt.

Krijoni një llogari

1. Klikoni Fillo në faqen kryesore.
2. Plotësoni emrin tuaj të shfaqjes (opsional), email-in, shtetin dhe datën e lindjes (duhet të jeni të paktën 18 vjeç).
3. Zgjidhni gjuhën e ndërfaqes dhe një fjalëkalim prej të paktën 12 karakteresh.
4. Lexoni njoftimin e marrëveshjes dhe konfirmoni. Krijimi i një llogarie nënkupton që ju bini dakord me Kushtet e Shërbimit, Deklaratën e Privatësisë, Përshkrimin e Shërbimeve dhe DPA Globale.
5. Klikoni Krijo llogari, pastaj verifikoni email-in tuaj nëse kërkohet, dhe hyni.

Rivendosni fjalëkalimin tuaj

1. Në faqen e hyrjes, klikoni Keni harruar fjalëkalimin?
2. Futni email-in tuaj dhe hapni lidhjen e rivendosjes të dërguar në kutinë tuaj postare.
3. Vendosni një fjalëkalim të ri (minimumi 12 karaktere).

3 Hapësira e Punës me një Vështrim

Pasi hyni, ju gjendeni në bankën e punës, e cila i vendos të gjitha panelet në një ekran:

• Eksploruesi (majtas) — pema e skedarëve për projektin e hapur, me një buton rifreskimi dhe mbylljeje.
• Redaktori (në qendër) — përmbajtja e skedarëve me theksim sintakse dhe një pasqyrë minimap; diff-et inline shfaqen këtu kur agjenti propozon ndryshime.
• Terminali (nën redaktor, aktivizohet/çaktivizohet) — ekzekutoni komanda dhe lexoni daljen.
• Biseda (djathtas) — biseda me agjentin; ky është paneli kryesor që zë hapësirën më të madhe.

Zvarritni ndarësin midis redaktorit dhe bisedës për të ribalancuar paraqitjen, dhe zvarritni ndarësin horizontal për të ndryshuar madhësinë e terminalit. Shiriti anësor i majtë gjithashtu navigon te Hapësira e Punës, Zgjerimet, Çelësat API, Faturimi dhe Reagimet.

4 Hapja e një Projekti

4.1 Hapni një dosje lokale

1. Në Eksplorues, klikoni Hap dosjen e projektit.
2. Zgjidhni një dosje dhe jepini leje shfletuesit për ta lexuar atë.
3. Skedarët lexohen në hapësirën e punës së enkriptuar brenda shfletuesit — asgjë nuk ngarkohet. Do të shihni një numërim të drejtpërdrejtë dhe një përmbledhje përfundimtare (numri i skedarëve · madhësia, plus çdo skedar i kaluar ose i shkurtuar).

4.2 Hap nga Git (GitHub / GitLab)

1. Klikoni Hap nga Git në Eksplorues.
2. Zgjidhni skedën GitHub ose GitLab dhe ngjisni një token aksesi personal. Për GitHub përdorni fushën repo (klasik) ose një token të detajuar me Contents + Pull requests; për GitLab përdorni fushën api. Tokeni juaj ruhet në server — vetëm përmbajtja e skedarëve tërhiqet në shfletues.
3. Shkruani repozitorin si pronar/emër (filtroni listën për të gjetur tuajin), pastaj zgjidhni një degë.
4. Opsionalisht, shënoni Krijo një degë të re pune (p.sh. dcc/my-feature) për ta mbajtur punën tuaj të izoluar nga dega e parazgjedhur.
5. Opsionalisht, aktivizoni push webhook në mënyrë që Eksploruesi të rifreskohet menjëherë kur anëtarët e ekipit bëjnë push (kërkon një URL gateway publike).
6. Klikoni Hap repozitorin.

4.3 Rifresko, ndrysho dhe mbyll

• Rifresko (↻ në kokën e Eksploruesit) ri-skanon dosjen ose tërheq versionin më të fundit nga Git.
• Hap një tjetër dosje ose Hap nga Git nga butonat nën pemë.
• Mbyll projektin (ikona e koshit) fshin hapësirën e punës brenda shfletuesit.

4.4 Sesionet e bisedës të kufizuara në dosje

Historia e bisedës është e lidhur me projektin e hapur. Ndryshimi i dosjeve fillon automatikisht një sesion të ri dhe ngarkon sesionet e mëparshme të asaj dosjeje, duke rihapur më të fundit në mënyrë që të mund të vazhdoni aty ku e keni lënë.

4.5 Dosjet operacionale

Dosjet që DeepCerebra përdor brenda — .deepcerebra, .sessions — shfaqen në pemë por janë të palosura si parazgjedhje në mënyrë që të mos ngatërrojnë kodin tuaj burimor.

5 Puna me Skedarët

• Klikoni një skedar në Eksplorues për ta hapur atë në redaktor; minimap-i ju ndihmon të lundroni në skedarë të gjatë.
• Zvarritni një skedar nga Eksploruesi në fushën e bisedës për ta bashkëngjitur atë si kontekst të qartë për mesazhin tuaj të ardhshëm.
• Kur agjenti propozon redaktime, redaktori tregon një diff inline për skedarin e zgjedhur.

6 Biseda me Agjentin

Shkruani një kërkesë

Përshkruani atë që dëshironi në gjuhë të thjeshtë — bëni një pyetje, kërkoni një veçori, ose tregoni një gabim. Jini specifik për skedarët, framework-et dhe kufizimet për të marrë rezultatin më të mirë. Bashkëngjitni skedarët përkatës duke i zvarritur në fushën e kërkesës.

Lexoni përgjigjet, në stilin Cursor

Përgjigjet janë të organizuara si Cursor: arsyetimi i agjentit është i ndarë nga produkti i dorëzueshëm. Çdo bllok përgjigjeje ka një ikonë kopjimi në këndin e sipërm të djathtë, kështu që mund të kopjoni një raport të përfunduar, një dokument, ose një komandë që duhet të ekzekutoni.

Drejtoni ose ndaloni një ekzekutim

• Përdorni Ndalo për të ndaluar një ekzekutim që po shkon në drejtimin e gabuar, pastaj përmirësoni kërkesën tuaj.
• Jepni sugjerime (p.sh. "përdor lxml në vend të html.parser") për ta nxjerrë agjentin nga një cikël.

7 Katër Mënyrat e Bisedës

Zgjidhni një mënyrë nga përzgjedhësi i mënyrave pranë fushës së kërkesës. Secila rregullon sa shumë planifikon agjenti dhe sa lirshëm redakton:

8 Rishikimi & Zbatimi i Ndryshimeve

Kur agjenti propozon ndryshime në skedarë, një panel Ndryshime të Propozuara shfaqet mbi fushën e bisedës, duke listuar çdo skedar të prekur me numrin e rreshtave të shtuar (+) dhe hequr (−).

• Klikoni një rresht skedari për të hapur diff-in e tij inline në redaktor.
• Zbato ose Refuzo një skedar të vetëm, ose përdorni Zbato të gjitha / Refuzo të gjitha.
• Ndryshimet e zbatuara shënohen si applied (dhe · disk kur shkruhen në një dosje reale).
• Nëse nuk ka një dosje të shkruajtshme, një etiketë vetëm hapësirë pune tregon se ndryshimet zbatohen në hapësirën e punës brenda shfletuesit.

9 Terminali i Integruar

Aktivizoni terminalin nën redaktor për të ekzekutuar ndërtime, teste dhe skripte. Me autorizimin tuaj, agjenti mund të ekzekutojë komanda dhe të lexojë daljen e tyre për të verifikuar punën e tij; komandat me ekzekutim të gjatë transmetojnë daljen në mënyrë që të mund të ndiqni progresin. Mbylleni terminalin nga koka e tij kur nuk ju nevojitet.

10 Mënyra e Planit & Ekzekutimi

Për qëllime më të mëdha, përdorni mënyrën Plan (ose kërkojini agjentit të planifikojë fillimisht). Planifikuesi skanon projektin tuaj, zbërthen qëllimin në detyra të ndërgjegjshme për varësitë, dhe ia cakton secilën specialistit të duhur (arkitekt, kodues, testues, dokumentues).

• Rishikoni & redaktoni planin — shtoni, hiqni ose modifikoni detyra para ekzekutimit.
• Ekzekutoni shtresë pas shtrese — detyrat e pavarura ekzekutohen së bashku; planifikuesi mund të riplanifikojë nëse një detyrë dështon.
• Ndalo, rifillo, ose anulo ekzekutimin në çdo kohë.

11 Zgjedhja e Modeleve & Auto

Hapni përzgjedhësin e modeleve pranë fushës së kërkesës. Opsionet janë të grupuara si:

• Auto — lejoni DeepCerebra të zgjedhë modelin më të mirë të disponueshëm (rekomandohet).
• Lokal (GPU-ja juaj) — modele të shërbyera nga pajisja tuaj (shih §13).
• Gateway-t e platformës — modele të hostuara, të grupuara sipas gateway-t dhe pastaj sipas ofruesit (p.sh. Anthropic, OpenAI, Google).

Si funksionon përzgjedhja Auto

Në Auto, DeepCerebra përdor rrugëzim të shkallëzuar dhe adaptiv: detyrat e thjeshta i dërgohen një modeli të shpejtë dhe ekonomik, ndërsa puna komplekse ose me planifikim të rëndë (për shembull, mënyra Plan) i dërgohet një modeli më të fuqishëm. Kjo balancon koston dhe cilësinë automatikisht, kështu që rrallëherë keni nevojë të zgjidhni manualisht.

12 Sillni Çelësin Tuaj (BYOK)

Mund t'i drejtoni kërkesat përmes llogarisë suaj të ofruesit në vend të përdorimit të matur të platformës.

1. Hapni Çelësat API nga shiriti anësor.
2. Nën Sillni Çelësin Tuaj, zgjidhni një ofrues (p.sh. ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
3. Ngjisni vlerën e çelësit dhe klikoni Ruaj. Çelësat enkriptohen në qetësi dhe nuk kthehen kurrë në shfletues — shfaqet vetëm një pamje e maskuar.

Modelet e platformës (DeepCerebra) nuk kanë nevojë për çelës. Hiqni një çelës në çdo kohë me Hiq.

13 Pajisja Lokale: Modelet GPU & Konsola (DCC Bridge)

DCC Bridge lidh kompjuterin tuaj me aplikacionin web përmes një lidhësi të vogël dcc-bridge, duke zhbllokuar dy aftësi njëherësh:

• Modelet lokale GPU — modelet e shërbyera nga Ollama ose LM Studio në pajisjen tuaj shfaqen në përzgjedhësin e modeleve nën Lokal (GPU-ja juaj).
• Konsola / terminali në pajisjen tuaj — terminali web dhe agjenti mund të ekzekutojnë komanda reale në kompjuterin tuaj, duke përfshirë mjetet CLI që i keni konfiguruar tashmë (Railway, AWS CLI, OVH CLI, gh, docker, kubectl, WSL, …) me kredencialet e tyre ekzistuese.

Lidhësi bën thirrje dalëse përmes një WebSocket të vërtetuar — nuk nevojiten porte hyrëse, dhe funksionon pas NAT dhe firewall-eve. Ai funksionon në Windows, macOS dhe Linux (Python 3.10+).

13.1 Çifto kompjuterin tënd

1. Klikoni ikonën e laptopit në shiritin e aktiviteteve të majtë — Pajisja Lokale (GPU + Konsola). (I njëjti panel hapet nga fundi i përzgjedhësit të modeleve përmes Menaxho GPU lokale….)
2. Sigurohuni që çelësi Ekzekutimi lokal është i aktivizuar, emërtoni pajisjen dhe klikoni Shto këtë kompjuter. Kopjoni tokenin e çiftimit njëpërdorimësh (dcc_brg_…) dhe komandën e lidhësit gati për t'u ngjitur — tokeni shfaqet vetëm një herë.

13.2 Instalo & ekzekuto lidhësin

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

• Përdorni të njëjtin domen që përdorni në shfletues si gateway (wss://deepcerebra.ai ose wss://deepcerebra.io) — karta e çiftimit e parambush atë të duhurin. Të dy faqet janë vendosje të ndara me llogari dhe tokenë të ndarë.
• Për modelet GPU, mbani Ollama-n në punë, ose aktivizoni serverin lokal të LM Studio (porta e parazgjedhur 1234) me një model të ngarkuar.
• Pajisjet e çiftuara tregojnë statusin online/offline, numrin e modeleve dhe fushën e ekzekutimit; mund të Revokoni një pajisje në çdo kohë.

13.3 Përdorni konsolën tuaj nga aplikacioni web

Si parazgjedhje, komandat janë të kufizuara në një dosje të dedikuar të hapësirës së punës (~/DeepCerebra). Për të punuar në dosjet tuaja reale të projektit me CLI-të tuaja të parakonfiguruara, jepini ato në mënyrë eksplicite kur filloni lidhësin:

# 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

Pastaj hapni panelin Terminal, klikoni popover-in Objektivi i Ekzekutimit (ikona e laptopit), zgjidhni Kompjuteri im, dhe zgjidhni një direktori pune. Të dyja komandat tuaja të shtypura dhe komandat e ndërtimit/testimit të agjentit ekzekutohen pastaj në pajisjen tuaj.

14 Rrjedha e Punës së Bashkëpunimit me Git

Me një projekt të mbështetur në Git të hapur, një shirit dege shfaqet në Eksplorues duke treguar degën tuaj aktuale dhe dy veprime:

• Regjistro (commit) — rishikoni numrin e skedarëve të ndryshuar, shkruani një mesazh commit-i, dhe bëni commit në degën tuaj të punës.
• Integro — hapni një pull request nga dega juaj e punës në degën e parazgjedhur (p.sh. main). Duhet të jeni në një degë pune, jo në degën e parazgjedhur.

Nëse push webhook është i aktivizuar, Eksploruesi rifreskohet automatikisht kur anëtarët e ekipit bëjnë push, duke i mbajtur të gjithë të sinkronizuar — themeli për zhvillimin bashkëpunues të ekipit përmes DeepCerebra.

15 Serverët MCP

Zgjeroni agjentin me mjete dhe të dhëna të jashtme përmes Model Context Protocol. Konfiguroni serverët në një skedar .deepcerebra/mcp.json, për shembull:

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

Mjetet e aktivizuara MCP bëhen të disponueshme për agjentin automatikisht kur ato janë relevante për kërkesën tuaj. Serverët lokalë (stdio) dhe të largët (http/sse) mbështeten të dy.

Siguria e integruar

• Refuzim-si-parazgjedhje — kur një server liston një allowlist, vetëm ato mjete mund të ekzekutohen.
• Miratim për mjetet me rrezik të lartë — mjetet mutuese (shkruaj/fshij/vendos/…) kërkojnë miratim nëse nuk i miratoni paraprakisht në autoApprove.
• Kufizimi i shkallës, pastrimi i argumenteve dhe daljes, dhe një regjistër auditimi zbatohen për çdo thirrje.

Burimet & kërkesat

Nëse një server ekspozon burime MCP ose modele kërkesash, agjenti fiton automatikisht mjete për t'i përdorur ato (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt).

Vërtetimi për serverët e largët

Shtoni një bllok auth në një server të largët. Sekretet mbështesin interpolimin ${ENV_VAR}:

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

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

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

16 Personalizimi i Agjentit: Rregullat, Aftësitë, Hooks, Nën-agjentët & Plugins

Mund të formësoni se si agjenti mendon dhe vepron me një konventë të vetme të bazuar në skedarë — direktorinë .deepcerebra/ — që funksionon identikisht në aplikacionin desktop, aplikacionin web dhe API. Në aplikacionin web, menaxhoni të gjitha këto nën pamjen Agjent; në desktop dhe përmes API-së ato janë skedarë të thjeshtë që i bëni commit me projektin tuaj.

Fushat & përparësia

Konfigurimi zbulohet nga disa fusha; kur i njëjti element ekziston në më shumë se një, ai me përparësi më të lartë fiton:

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

• Hapësira e punës — <repo>/.deepcerebra/…, e bërë commit me projektin.
• Globale — ~/.deepcerebra/…, parazgjedhjet tuaja personale nëpër projekte.
• Ekipi / organizata — një bazë e përbashkët (përparësia më e ulët) kështu që një përdorues ose projekt mund gjithmonë ta mbishkruajë atë. Në aplikacionin web, vendosni Fushën e një rregulli në Ekip.

Rregullat (drejtimi)

Rregullat janë udhëzime të vazhdueshme — standarde kodimi, konventa arkitekture, kontekst domeni — të injektuara në kërkesën e sistemit të agjentit. Ato jetojnë si skedarë Markdown nën .deepcerebra/steering/, plus standardin gjithmonë aktiv AGENTS.md. Frontmatter kontrollon kur ngarkohet një rregull:

---
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 — çdo herë (parazgjedhja).
• fileMatch — vetëm kur një skedar në kontekst përputhet me globs.
• auto — kur kërkesa juaj përputhet me name/description të rregullit.
• manual — vetëm kur i referoheni si #name ose /name.

Një AGENTS.md rrënjë zbatohet në të gjithë repo-n; një AGENTS.md i folezuar (p.sh. services/api/AGENTS.md) zbatohet vetëm për skedarët nën atë dosje. Në aplikacionin web, pamja Agjent → Drejtimi i jep çdo rregulli një përzgjedhës Fushe (Globale / Projekt / Ekip).

Aftësitë

Aftësitë janë manuale të ripërdorshme që agjenti i ngarkon sipas kërkesës. Çdo aftësi është një dosje me një SKILL.md nën .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.

Agjenti sheh një katalog të lehtë (emër + përshkrim) dhe tërheq trupin e plotë me mjetin load_skill kur është relevante. Mund ta thërrisni gjithashtu një në mënyrë eksplicite me /skill <name>. Vendosni disable-model-invocation: true për ta bërë një aftësi vetëm manuale.

Hooks

Hooks ekzekutojnë automatizim në ngjarjet e ciklit jetësor. Përcaktojini ato si .deepcerebra/hooks/*.hook.json:

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

Ngjarjet përfshijnë promptSubmit, preToolUse, postToolUse, fileCreate, fileSave, fileDelete, preTask, postTask, sessionStart, preCompact, dhe agentStop (pranohen edhe drejtshkrimet e Cursor/Claude). Një veprim është ose shell (ekzekuto një komandë) ose agentPrompt (pyet agjentin). Një hook preToolUse mund të allow, deny, ose ask për thirrjen e mjetit që ndërpret.

Nën-agjentët

Nën-agjentët janë agjentë specialistë që ju i përcaktoni dhe u delegoni detyra. Secili është një skedar Markdown nën .deepcerebra/agents/ me frontmatter plus një trup (kërkesa e tij e sistemit):

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

Agjenti kryesor delegon me task (bllokues), task_async + task_status / task_result (në sfond), ose task_parallel (shpërndarje).

Plugins

Një plugin paketon rregulla, aftësi, hooks, nën-agjentë dhe serverë MCP në një paketë të vetme të instalueshme nën .deepcerebra/plugins/<name>/, të përshkruar nga një manifest plugin.json:

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

Përmbajtja e plugin-it bashkohet me përparësinë më të ulët, kështu që rregullat dhe aftësitë tuaja gjithmonë mbishkruajnë ato të një plugin-i. Çaktivizoni një plugin me "enabled": false ose një skedar shënues .disabled.

17 Studio e Rrjedhës së Punës Agentike & Agjentët e Drejtuar nga Ngjarjet

Studio e Rrjedhës së Punës është një projektues vizual për automatizimin me shumë agjentë. Ju kompozoni faza — secila një agjent, një hap specialist, ose një primitiv kontrolli — në një grafik, i lidhni ato me varësi, dhe ekzekutoni të gjithë orkestrimin në motor me progres të drejtpërdrejtë për çdo fazë, buxhete dhe porta miratimi njerëzor. Rrjedhat e punës ruhen si një përkufizim i transportueshëm YAML/JSON që mund ta eksportoni, importoni, versiononi në Git, dhe ta ekzekutoni nga API ose CLI.

17.1 Ndërtimi i një rrjedhe pune

• Paleta (majtas) — zvarritni llojet e fazave, llojet e agjentëve të gatshëm (kërkim, kode gjenerimi, QA, shkrues dokumentesh, pajisje mjekësore, këshilltar patentash, dhe llojet tuaja të personalizuara), aftësitë nga Biblioteka e Aftësive, dhe mjetet në kanavacë.
• Kanavaca (në qendër) — rregulloni fazat dhe vizatoni skajet; një skaj do të thotë "kjo fazë varet nga ajo" dhe automatikisht ushqen daljen e fazës së mëparshme në kërkesën e fazës pasuese.
• Inspektori (djathtas, i ndryshueshëm në madhësi) — konfiguroni fazën e zgjedhur: kërkesën e saj, aftësitë, mjetet, mbishkrimin e modelit për fazë, artefaktin e daljes, portën, ngjarjet dhe parametrat specifikë të llojit.
• Modelet — filloni nga një plan i integruar (Tubacioni Ship-It, Nismëtari SaaS, Tubacioni i të Dhënave me Vlerësime, Qendra e Komunikimeve me Klientët, Dizajn → Aplikacion i Verifikuar) dhe personalizojeni atë.
• Gjenero — përshkruani aplikacionin ose procesin në gjuhë të thjeshtë dhe Ndërtuesi i Agjentit gjeneron një grafik të plotë dhe të vlefshëm të rrjedhës së punës që mund ta rishikoni, rregulloni dhe ekzekutoni.

17.2 Biblioteka e fazave

17.3 Agjentët e drejtuar nga ngjarjet (rrjeta e agjentëve)

Çdo fazë — pavarësisht llojit — mund të publikojë dhe abonojë në ngjarje të tipizuara në bus-in e ngjarjeve të hapësirës së punës, kështu që agjentët koordinohen si shërbime në një strukturë mesazhesh në vend që të jenë vetëm përmes DAG:

• Klasat e ngjarjeve — çdo ngjarje mbart një klasë: lifecycle, agent, business, data, system, schedule, chat, external, ose alert — të filtueshme në abonime dhe riprodhim.
• Mënyrat e abonimit — trigger (faza ekzekutohet kur arrin një ngjarje përputhëse; një ekzekutim me faza të parkuara mbetet rezident si në dëgjim), gate (një portë makine e miratuar nga një ngjarje në vend të një klikimi njerëzor), dhe data (ngarkesa bashkohet në kontekstin e fazës).
• Nisja me ngjarje — çdo agjent mund të niset nga një orkestrues ose një agjent tjetër duke publikuar në adresën e tij agent.<stage-id>.request.
• Shkrepësit e ekzekutimit — blloku triggers: i një rrjedhe pune e armatos atë për të filluar me webhook hyrës, orare cron, ngjarje, ose bisedë — edhe kur Studio është e mbyllur.
• Ekzekutimet e drejtpërdrejta — paneli i ekzekutimit transmeton ngjarjet e ciklit jetësor përmes SSE: fillimet/përfundimet e fazave, portat, alarmet dhe pamjet paraprake shfaqen menjëherë.
• Regjistri i qëndrueshëm & riprodhimi — ngjarjet vazhdojnë për çdo hapësirë pune dhe mund të riprodhohen sipas modelit të temës dhe klasës për auditim dhe korrigjim gabimesh.

17.3.1 Radhitja e ngjarjeve për agjentët

Agjentët që reagojnë ndaj ngjarjeve mund të deklarojnë një radhë të emërtuar të qëndrueshme kështu që ngjarjet përputhëse nuk humbasin kurrë ndërsa agjenti është i zënë ose para se një ekzekutim të jetë në dëgjim. Në një abonim shkrepës, vendosni queue: <name> — motori e lidh atë temë me një radhë FIFO në bus-in e ngjarjeve të hapësirës së punës (e ruajtur nën .deepcerebra/workflows/events/queues/). Çdo ngjarje përputhëse e publikuar nga atë moment e tutje kapet në radhë; kur faza bëhet e ekzekutueshme, motori nxjerr ngjarjet në rendin më e vjetra-e para dhe i konsumon ato një nga një.

• Asgjë nuk humbet — ngjarjet e publikuara ndërsa rrjedha e punës është e mbyllur, ndërsa një fazë tjetër është në ekzekutim, ose ndërsa ekzekutimi është ende duke pritur për varësi, vendosen në radhë në vend që të hidhen poshtë.
• count për abonim — kërkoni N ngjarje në radhë (ose të dorëzuara) para se abonimi të plotësohet (e dobishme kur disa punëtorë duhet të raportojnë).
• Studio — në panelin e Ngjarjeve të Inspektorit, vendosni fushën queue në një abonim shkrepës; armatosni shkrepësit ose filloni një ekzekutim për të krijuar lidhjen automatikisht.
• API & mjete — GET /api/workflow/queues liston thellësinë dhe lidhjet; GET /api/workflow/queues/{name} shikon ngjarjet në pritje; agjentët e bisedës mund të thërrasin event_queue_status dhe 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 Orkestrimi me semafor (mbrojtja e burimeve të përbashkëta)

Një semafor kufizon sa detyra mund të operojnë njëkohësisht në një burim të përbashkët (të mbrojtur): një bazë të dhënash ku po shkruhet, një dyqan variablash globale, një skedar, ose një agjent i jashtëm me kufizim shkalle. Bashkëngjiteni atë në çdo fazë me semaphore: — para se të ekzekutohet puna e fazës, motori merr një leje të semaforit të emërtuar të hapësirës së punës; leja lëshohet gjithmonë më pas, edhe nëse faza dështon. permits: 1 e bën atë një mutex: vetëm një detyrë në të njëjtën kohë (në të gjitha ekzekutimet paralele në hapësirën e punës) ekzekuton hapin kritik; çdo detyrë tjetër pret derisa mbajtësi të përfundojë.

• Serializimi ndër-ekzekutime — semaforët janë të kufizuar në hapësirën e punës dhe të ruajtur, kështu që dy ekzekutime të njëkohshme të rrjedhës së punës nuk mund të korruptojnë të njëjtin burim të mbrojtur.
• Në pritje, jo i bllokuar — detyrat bllokohen deri në timeout_s për një leje; nëse burimi mbetet në kapacitet të plotë, faza dështon në mënyrë të dukshme në vend që të ngecë përgjithmonë.
• Siguria ndaj ndërprerjeve — çdo leje mbart një ttl_s; nëse një mbajtës ndërpritet pa e lëshuar, leja skadon automatikisht kështu që burimi nuk bllokohet kurrë.
• Vëzhgueshmëria — bus-i emeton ngjarje sistemi semaphore.<name>.waiting, .acquired, dhe .released; GET /api/workflow/semaphores tregon kapacitetin, mbajtësit dhe lejet e disponueshme.
• Agjentët e bisedës — mjetet acquire_semaphore, release_semaphore, dhe semaphore_status koordinojnë seksione kritike ad-hoc jashtë një rrjedhe pune.

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 Orkestrimi Rendezvous (prit për të gjitha kushtet)

Rendezvous pret derisa shumë kushte ngjarjesh të plotësohen të gjitha para se hapi tjetër të vazhdojë — e kundërta e "ngjarja e parë fiton". Vendosni join: all në bllokun events: të fazës: çdo abonim shkrepës duhet të plotësohet para se faza të ekzekutohet. Kombinojeni me count: N për abonim kur disa agjentë (ose disa raporte nga një agjent) duhet të raportojnë të gjithë — për shembull, miratimi i dizajnit, përfundimi i testit dhe miratimi i sigurisë para se të ekzekutohet një fazë lëshimi.

• join: any (parazgjedhje) — faza ekzekutohet kur plotësohet abonimi i parë shkrepës.
• join: all — rendezvous: çdo abonim shkrepës (secili me temën e vet, filtrin e klasës dhe count opsional) duhet të plotësohet; vetëm atëherë faza bëhet e ekzekutueshme.
• Ngarkesat — të gjitha ngjarjet e konsumuara regjistrohen në fazë si trigger_events dhe ekspozohen në modele si inputs.events (një listë objektesh ngjarjesh me ngarkesa).
• Studio — kur një fazë ka dy ose më shumë abonime shkrepëse, Inspektori tregon një përzgjedhës Join: any — ngjarja e parë fiton ose all — rendezvous (prit për të gjitha); kanavaca tregon një etiketë bashkimi në fazat rendezvous.

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

17.4 Biblioteka e mjeteve të agjentit

Fazat zgjedhin mjete nga i njëjti regjistër që përdor agjenti i bisedës:

• Thelbësore — skedarë, git, shell, ekzekutim kodi, kërkim kodi, automatizim shfletuesi, kërkim web, vizion/media, gjenerim imazhesh.
• Baza të dhënash — pyetje SQLite, PostgreSQL, MySQL, MongoDB dhe Redis plus create_database, apply_migrations, dhe dump_schema për shtresat e të dhënave të zotëruara.
• Komunikimet — thirrje telefonike dhe SMS (Twilio) dhe email (SendGrid), me një mënyrë simulimi që regjistron në një kuti dalëse kur kredencialet mungojnë — demonstrimet nuk dërgojnë kurrë mesazhe reale aksidentalisht.
• DevOps — docker_build / docker_push, compose up/down, SSH dhe vendosje cloud-CLI (Fly, Render, Railway, Vercel), gjithashtu të sigurta për simulim.
• Verifikimi — zbulimi i stack-ut, ekzekutimi i suitave të testimit me shkallë kalimi të analizuara, auditime varësish, dhe skanim sekretesh.
• Motorë SciCompute — qindra metoda shkencore dhe inxhinierike (të emërtuara Class.method) në matematikë, përpunim sinjalesh, kontrolle, statistika dhe më shumë.
• Agjenci Eksperte & MCP — kërkim domeni i bazuar plus çdo server të jashtëm MCP që lidhni.

17.5 Ekzekutimi, portat dhe daljet

• Vlerëso kontrollon grafikun (id unike, varësi aciklike, parametra lloji) para se të ekzekutoni.
• Portat njerëzore ndalojnë ekzekutimin pasi faza prodhon draftin e saj, kështu që ju miratoni punën reale; portat e ngjarjeve lejojnë një sistem tjetër të miratojë automatikisht.
• Buxhetet kufizojnë shpenzimet për ekzekutim dhe për fazë.
• Ruaj daljet në projekt kopjon çdo artefakt që një ekzekutim ka gjeneruar në projektin tuaj të hapur.
• Eksporto Aplikacionin kthen rrjedhën e punës në një shërbim të pavarur FastAPI; API-ja publike /v1 ekspozon ekzekutimet, ngjarjet, shkrepësit, modelet dhe gjenerimin për CI dhe integrime.

18 Plotësimi Parashikues me Tab

Plotësimi Parashikues me Tab ofron sugjerime kodi inline, plotësim-në-mes, ndërsa shkruani në redaktor — pranoni një sugjerim me Tab. Ai është opt-in si në motor ashtu edhe në redaktorin web.

Aktivizojeni atë

• Motori — vendosni flamurin e mjedisit DCC_TAB_COMPLETE=1. Redaktori thërret pikën fundore POST /api/complete të motorit, e cila kthen vetëm tekstin për t'u futur në kursor.
• Redaktori web — aktivizojeni në kohën e ndërtimit me VITE_TAB_COMPLETE=1, ose në kohën e ekzekutimit me localStorage.setItem('dcc.tabComplete', '1') (pastaj ringarkoni).

Si sillet

• Sugjerimet shfaqen si tekst fantazmë; shtypni Tab për të pranuar, ose vazhdoni të shkruani për ta hequr.
• Kërkesat janë me debounced dhe të anulueshme, kështu që shkrimi nuk bllokohet kurrë.
• Kur flamuri është i fikur, veçoria është plotësisht e çaktivizuar dhe nuk bëhen kërkesa për plotësim.

19 Përdorimi, Kreditet & Faturimi

Hapni Faturimi nga shiriti anësor për të menaxhuar planin dhe përdorimin tuaj. Përdorimi i AI matet në kredite dollari amerikan bazuar në tokenët e konsumuar nga modelet themelore.

• Shpenzimet e ciklit & krediti i parapaguar — ndiqni përdorimin e këtij cikli dhe çdo balancë të parapaguar.
• Shto kredit shtesë — autorizoni një shumë shtesë (USD) për të vazhduar përdorimin e AI pasi të jetë shpenzuar sasia e përfshirë; nëse buxheti juaj është ezauruar, do të shihni një baner që ju kërkon të shtoni kredit.
• Përmirëso / ndrysho planin — ndryshoni nivelet në çdo kohë.
• Metoda e pagesës — shtoni ose përditësoni kartën në dosje (e përpunuar nga Stripe).
• Anulo — zgjidhni anulo në fund të periudhës (mbani aksesin deri në fund të periudhës) ose anulo tani (rimbursoni mbetjen e rimbursueshme). Shihni Politikën e Anulimit & Rimbursimit.

20 Marrja e Çelësit Tuaj API të Gateway

Një çelës API i gateway (një token aksesi personal) ju lejon të përdorni API-në publike dhe CLI-në e DeepCerebra në mënyrë programatike.

1. Hyni dhe hapni Çelësat API nga shiriti anësor.
2. Lëvizni poshtë te Çelësat API të DeepCerebra.
3. Futni një etiketë (p.sh. "tubacioni CI" ose "CLI i laptopit").
4. Zgjidhni fushat — read, chat, code, agent — dhe një skadencë opsionale në ditë (bosh = kurrë).
5. Klikoni Gjenero. Çelësi i plotë shfaqet vetëm një herë — klikoni Kopjo dhe ruajeni në mënyrë të sigurt.

Përdoreni atë me CLI ose API në 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/...

Mund të riemërtoni ose fshini (revokoni) një çelës në çdo kohë; çdo çelës tregon prefiksin e tij, fushat, datën e krijimit/skadencës dhe datën e përdorimit të fundit.

21 Siguria & Privatësia

• Ruajtje konfidenciale brenda shfletuesit — skedarët e projektit tuaj qëndrojnë në hapësirën e punës së enkriptuar të shfletuesit; vetëm konteksti minimal i nevojshëm për çdo kërkesë dërgohet në server.
• Zero Data Retention (ZDR) — kërkesat dhe kodi i dërguar te modelet nuk ruhen përtej kërkesës dhe nuk përdoren kurrë për të trajnuar modelet themelore.
• Çelësat qëndrojnë në anën e serverit — tokenët BYOK dhe SCM enkriptohen në qetësi; vetëm pamje të maskuara shfaqen.
• Enkriptimi — TLS në tranzit; të dhënat e llogarisë të enkriptuara në qetësi; fjalëkalimet të hashuara në mënyrë të pakthyeshme.
• Kodi juaj është i juaji — ju zotëroni përmbajtjen tuaj dhe daljen e gjeneruar. Shihni Deklaratën e Privatësisë.

22 Zgjidhja e Problemeve

"Ngarkimi i dosjes kërkon një shfletues Chromium"

Kaloni në Chrome, Edge, ose Brave, ose përdorni Hap nga Git në vend të kësaj.

Agjenti ciklon në të njëjtin gabim

Klikoni Ndalo, pastaj riformuloni me një sugjerim ose kufizim konkret.

Gabime modeli ose kërkese / "buxheti i ezauruar"

• Kontrolloni lidhjen tuaj dhe që çdo çelës BYOK është i vlefshëm.
• Kaloni në Auto kështu që DeepCerebra të drejtojë te një model i disponueshëm.
• Nëse buxheti juaj i përdorimit është ezauruar, hapni Faturimi dhe shtoni kredit shtesë ose përmirësoni planin tuaj.

Modelet lokale nuk shfaqen

• Konfirmoni që lidhësi dcc-bridge është në punë dhe pajisja tregon online.
• Sigurohuni që Ollama është në punë, ose serveri lokal i LM Studio është i aktivizuar (porta e parazgjedhur 1234) me një model të ngarkuar.

Lidhësi: "serveri refuzoi lidhjen WebSocket: HTTP 401"

• Përdorni të njëjtin domen që përdorni në shfletues si --gateway (wss://deepcerebra.ai ose wss://deepcerebra.io) — të dy faqet janë vendosje të ndara, dhe një token nga njëra nuk funksionon kurrë në tjetrën.
• Kopjoni komandën e saktë nga karta e çiftimit në faqen Pajisja Lokale.

Ndryshimet e mia nuk hynë në fuqi

• Sigurohuni që keni klikuar Zbato (jo vetëm keni parë diff-in) te Ndryshimet e Propozuara.
• Përdorni rifreskimin e Eksploruesit për të ri-skanuar dosjen.

Git: "Jeni në degën e parazgjedhur"

Hapni ose krijoni një degë pune para se të përdorni Integro për të hapur një pull request.

Ende keni probleme? Kontaktoni support@deepcerebra.ai.

23 DeepCerebra Discovery — Pyet të Dhënat & Dokumentet Tuaja

Discovery është një chatbot hetues për bazat e të dhënave dhe dokumentet tuaja. Në vend që të përgjigjet me një pyetje të vetme, ai funksionon si një analist: formon hipoteza, kryen një seri hetimesh të mbrojtura (SQL, grafik, kërkim dokumentesh, kontrolle skeme, vërtetim në ueb), shkurton shpjegimet që provat i kundërshtojnë, dhe sintetizon një përgjigje të bazuar — me grafikë dhe një faturë kostoje transparente. Hapeni nga ikona e kompasit në shiritin e aktiviteteve (/app/discovery).

23.1 Hapësirat — fushëveprimi juaj i kuruar

Një Hapësirë përmbledh gjithçka që i nevojitet një linje pyetjesh: lidhje me bazat e të dhënave, koleksione dokumentesh, udhëzime për analistin dhe buxhete. Krijoni një me + Hapësirë e re, pastaj përdorni panelin e konfigurimit në të djathtë për të:

• Lidhni bazat e të dhënave — SQLite, PostgreSQL, MySQL, SQL Server, ose Snowflake. Futni një emër dhe DSN, klikoni Testo për të verifikuar lidhjen (tregohen vonesa dhe versioni i serverit), ose importoni një konfigurim ekzistues lidhjeje si JSON. Lidhjet janë vetëm për lexim si parazgjedhje.
• Shtoni dokumente — tërhiqni dhe lëshoni skedarë (PDF, DOCX, PPTX, Markdown, tekst) direkt në bisedë, ngjisni një URL, ose tregoni një shteg dosjeje në hostin e motorit. Dokumentet ndahen në pjesë, nguliten dhe indeksohen për kërkim hibrid vektor + grafik njohurish.
• Importoni tabela — ngjisni ose ngarkoni CSV/JSON për të pyetur menjëherë pa asnjë bazë të dhënash.
• Mësoni analistin — shtoni përkufizime metrikash, rregulla biznesi dhe paralajmërime, pyetje të besuara të miratuara nga kuratori, dhe çifte shembull pyetje→pyetje në mënyrë që përgjigjet të përdorin përkufizimet tuaja.

23.2 Bërja e një pyetjeje

Shtypni një pyetje ashtu siç do t'i bënit një kolegu — për shembull "Pse ra volumi i skanimeve MRI në mars?". Paneli i hetimit transmeton të gjithë procesin drejtpërdrejt:

• Hipotezat — shpjegimet kandidate nën hetim, secila e shënuar e mbështetur, e kundërshtuar, ose e paqartë ndërsa mbërrijnë provat.
• Hetimet — çdo pyetje që ekzekuton analisti, me statusin e saj; SQL/Cypher i gjeneruar tregohet për transparencë të plotë, dhe çdo deklaratë kalon rregullat e mbrojtjes vetëm për lexim para ekzekutimit.
• Provat — tabela rezultatesh dhe ekstrakte dokumentesh, të cituara me numër në përgjigjen përfundimtare.
• Përgjigja + grafikët — një përfundim i bazuar që gjithashtu emëron shpjegimet që u përjashtuan, plus grafikë modernë me temë neoni të përbërë nga provat.
• Fatura — tokena, kosto për hetim, dhe raunde, të ngarkuara në AI Credits tuaja si çdo ekzekutim tjetër agjenti.

Pyetjet pasuese vazhdojnë të njëjtën fije, kështu që analisti ruan kontekstin e tij.

23.3 Grafikë, raporte & eksporte

Grafikët shfaqen brenda panelit të hetimit. Përdorni Eksporto për të shkarkuar pyetjen e plotë — përgjigjen, hipotezat, provat dhe grafikët — si një raport HTML i vetë-përmbajtur ose një PDF me cilësi printimi, i stilizuar me sistemin e dizajnit neon.

23.4 Buxhetet & kontrolli i kostos

Çdo hapësirë ka buxhete për pyetje: një numër maksimal hetimesh, raundesh hetimi, sekondash dhe USD. Motori ndalon pastër në kufi dhe raporton atë që ka gjetur deri më tani. Kostoja e çdo hetimi detajohet në faturë, kështu që ju gjithmonë e dini ku shkuan shpenzimet.

23.5 Automatizimi: API, SDK, Workflow Studio & MCP

• REST API — gjithçka që bën ndërfaqja e përdoruesit është e disponueshme nën /v1/discovery/* me një PAT që mbart fushëveprimin discovery (krijojeni nën Llogaria → Tokenat API). Pyetjet me transmetim përdorin SSE. Ekzekutorët e jashtëm mund të marrin vetëm planifikimin hetues nëpërmjet Thinking API (/v1/think/*, fushëveprimi think).
• Python SDK — pip install deepcerebra-discovery, pastaj DiscoveryClient(base_url, token).ask(space_id, question).
• Workflow Studio — hidhni fazën Discovery Ask (discovery.ask) në çdo fluks pune për të ekzekutuar një hetim si një hap të tubacionit; përgjigja, grafikët dhe fatura kalojnë në fazat pasuese.
• MCP — motori ekspozon discovery_ask dhe discovery_list_spaces si mjete MCP, kështu që klientët e jashtëm MCP mund të kryejnë gjithashtu hetime.