Օգտագործողի ուղեցույց
DeepCerebra Coder-ի միջոցով ծրագրակազմի մշակման ամբողջական, գործնական ուղեցույց՝web, desktop և CLI

📖 Բովանդակություն

  1. Ներածություն և Թողարկումներ
  2. Սկսելու և Հաշվի Ստեղծում
  3. Աշխատանքային տարածքը մի հայացքով
  4. Նախագծի բացում
  5. Ֆայլերի հետ աշխատանք
  6. Գործակալի հետ զրույց
  7. Զրույցի չորս ռեժիմները
  8. Փոփոխությունների վերանայում և կիրառում
  9. Ինտեգրված Terminal
  10. Plan ռեժիմ և Կատարում
  11. Մոդելների ընտրություն և Auto
  12. Բերեք Ձեր Սեփական Բանալին (BYOK)
  13. Տեղական մեքենա. GPU Models և Console (DCC Bridge)
  14. Git համագործակցության աշխատանքային հոսք
  15. MCP Servers
  16. Գործակալի հարմարեցում. Rules, Skills, Hooks, Subagents և Plugins
  17. Գործակալական Աշխատանքային Հոսքի Ստուդիա և Իրադարձությունների վրա հիմնված գործակալներ
  18. Կանխատեսող Tab Completion
  19. Օգտագործում, Կրեդիտներ և Հաշվարկ
  20. Ձեր Gateway API Key-ը ստանալը
  21. Անվտանգություն և Գաղտնիություն
  22. Խնդիրների լուծում
  23. DeepCerebra Discovery — Հարցրեք Ձեր տվյալներին & Փաստաթղթերին

1 Ներածություն և Թողարկումներ

DeepCerebra Coder-ը agentic կոդավորման օգնական է։ Ի տարբերություն պարզ autocomplete copilot-ի, այն plans, writes, refactors, runs commands, calls tools և iterates Ձեր ամբողջ նախագծի վրա՝ Ձեր կողմից վերանայելով և հաստատելով իր առաջարկած փոփոխությունները։

Օգտագործման երեք եղանակ

ԹողարկումԼավագույնըՖայլի մուտք
Web appԶրոյական տեղադրում, աշխատանք ցանկացած մեքենայիցԳաղտնի ներբրաուզերային պահեստ (և Git repos)
Desktop (Windows / Linux / macOS)Local-first մշակում, local modelsՈւղղակի տեղական ֆայլային համակարգ
CLI & APIScripting, CI/CD, ավտոմատացումՏեղական ֆայլեր / programmatic

Այս ուղեցույցը կենտրոնանում է deepcerebra.ai կայքի web app-ի վրա. desktop app-ը արտացոլում է նույն panels-ը և workflows-ը։

2 Սկսելու և Հաշվի Ստեղծում

Աջակցվող բրաուզերներ

Օգտագործեք Chrome, Edge կամ Brave-ի ընթացիկ տարբերակը լիարժեք փորձի համար. local folder բացելը հիմնված է Chromium File System Access API-ի վրա։ Firefox-ը և Safari-ն աշխատում են chat-ի և Git-backed projects-ի համար, բայց չեն կարող ուղղակիորեն բացել local folder։

Ստեղծել հաշիվ

  1. Սեղմեք Get Started վայրէջքի էջում։
  2. Լրացրեք Ձեր կամընտիր display name-ը, email-ը, country-ն և date of birth-ը (դուք պետք է լինեք առնվազն 18 տարեկան)։
  3. Ընտրեք Ձեր interface language-ը և առնվազն 12 նիշ պարունակող password։
  4. Կարդացեք համաձայնագրի ծանուցումը և հաստատեք։ Հաշիվ ստեղծելը նշանակում է, որ դուք համաձայնում եք Terms of Service-ի, Privacy Statement-ի, Services Description-ի և Global DPA-ի հետ։
  5. Սեղմեք Create account, այնուհետև հաստատեք Ձեր email-ը, եթե հուշվի, և մուտք գործեք։
💡 Tip: Դուք կարող եք ընտրել plan գրանցման ընթացքում՝ այցելելով /register?plan=basic (կամ pro / ultimate), կամ սկսել հիմա և ընտրել plan ավելի ուշ Billing բաժնում։

Վերականգնել Ձեր password-ը

  1. Login էջում սեղմեք Forgot password?
  2. Մուտքագրեք Ձեր email-ը և բացեք Ձեր inbox ուղարկված reset link-ը։
  3. Սահմանեք նոր password (նվազագույնը 12 նիշ)։

3 Աշխատանքային տարածքը մի հայացքով

Մուտք գործելուց հետո դուք հայտնվում եք workbench-ում, որը բոլոր pane-երը դնում է մեկ էկրանի վրա.

Քաշեք splitter-ը editor-ի և chat-ի միջև՝ layout-ը հավասարակշռելու համար, և քաշեք հորիզոնական splitter-ը՝ terminal-ի չափը փոխելու համար։ Ձախ sidebar-ը նաև տանում է դեպի Workspace, Extensions, API Keys, Billing և Feedback։

4 Նախագծի բացում

4.1 Բացել local folder

  1. Explorer-ում սեղմեք Open project folder։
  2. Ընտրեք folder և տվեք browser-ին թույլտվություն այն կարդալու համար։
  3. Files-ը կարդացվում է Ձեր browser-ի encrypted in-browser workspace — ոչինչ չի uploaded։ Դուք կտեսնեք live count և վերջնական summary (file count · size, գումարած ցանկացած skipped կամ truncated files)։
⚠️ Browser support: Եթե տեսնում եք ծանոթագրություն, որ folder loading-ը Chromium browser է պահանջում, անցեք Chrome/Edge/Brave, կամ փոխարենը օգտագործեք Open from Git։

4.2 Բացել Git-ից (GitHub / GitLab)

  1. Սեղմեք Open from Git Explorer-ում։
  2. Ընտրեք GitHub կամ GitLab tab-ը և տեղադրեք personal access token։ GitHub-ի համար օգտագործեք repo scope (classic) կամ fine-grained token Contents + Pull requests-ով. GitLab-ի համար օգտագործեք api scope։ Ձեր token-ը պահվում է server-ի վրա. միայն file contents-ն է քաշվում browser։
  3. Մուտքագրեք repository-ն որպես owner/name (ֆիլտրեք ցուցակը՝ Ձերը գտնելու համար), այնուհետև ընտրեք branch։
  4. Կամընտիր նշեք Create a new working branch (օրինակ՝ dcc/my-feature)՝ Ձեր աշխատանքը default branch-ից մեկուսացված պահելու համար։
  5. Կամընտիր միացրեք push webhook-ը, որպեսզի Explorer-ը ակնթարթորեն refresh լինի, երբ teammates-ը push անեն (պահանջում է public gateway URL)։
  6. Սեղմեք Open repository։

4.3 Refresh, switch և close

4.4 Folder-scoped chat sessions

Chat history-ն կապված է բաց նախագծի հետ։ Folders-ը փոխելը ավտոմատ կերպով սկսում է նոր session և բեռնում այդ folder-ի նախորդ sessions-ը՝ վերաբացելով ամենավերջինը, որպեսզի կարողանաք շարունակել այնտեղից, որտեղից դադարեցրել եք։

4.5 Operational folders

Folders, որոնք DeepCerebra-ն օգտագործում է ներքին՝ .deepcerebra, .sessions — հայտնվում են tree-ում, բայց collapsed են by default, որպեսզի չխճճեն Ձեր source-ը։

5 Ֆայլերի հետ աշխատանք

6 Գործակալի հետ զրույց

Գրել request

Նկարագրեք, թե ինչ եք ուզում plain language-ով. տվեք հարց, խնդրեք feature կամ մատնանշեք bug։ Եղեք կոնկրետ files-ի, frameworks-ի և constraints-ի վերաբերյալ՝ լավագույն արդյունք ստանալու համար։ Կցեք համապատասխան files-ը՝ դրանք prompt-ի մեջ քաշելով։

Կարդալ responses, Cursor-style

Responses-ը կազմակերպված են Cursor-ի նման. գործակալի reasoning-ը առանձնացված է deliverable-ից։ Յուրաքանչյուր response block ունի copy icon իր վերին աջ անկյունում, որպեսզի կարողանաք copy անել ավարտված report, document կամ command, որը պետք է run անեք։

Steer կամ stop run

💡 Tip (desktop): Desktop app-ում դուք invoke եք անում գործակալին chat-ում @deepcerebra-ով, իսկ prefixes-ը, ինչպիսին է [deep], խնդրում են deeper reasoning։

7 Զրույցի չորս ռեժիմները

Ընտրեք mode prompt-ի կողքի mode selector-ից։ Յուրաքանչյուրը կարգավորում է, թե որքան է գործակալը plan անում և որքան ազատ է edit անում.

ՌեժիմԻնչ է անումՕգտագործել, երբ…
AgentPlans և edits է անում Ձեր նախագծի վրա ինքնավարԴուք ցանկանում եք, որ օգնականը end-to-end իրականացնի փոփոխություն
AskՊատասխանում է Ձեր կոդի մասին հարցերին՝ առանց editing-իԴուք ցանկանում եք հասկանալ codebase-ը
PlanDrafts է անում մոտեցումը մինչև ցանկացած editingTask-ը մեծ է կամ ունի trade-offs, որոնք պետք է նախ լուծվեն
EditԿատարում է focused edits ընթացիկ context-ումԴուք ցանկանում եք փոքր, թիրախային փոփոխություն

8 Փոփոխությունների վերանայում և կիրառում

Երբ գործակալն առաջարկում է file changes, Proposed Changes panel է հայտնվում chat input-ի վերևում՝ ցուցակագրելով յուրաքանչյուր touched file-ը ավելացված (+) և հեռացված (−) line counts-ով։

⚠️ Միշտ վերանայեք. AI-generated code-ը կարող է պարունակել սխալներ կամ insecure patterns։ Վերանայեք diff-ը և test արեք նախքան դրան ապավինելը կամ deploy անելը։

9 Ինտեգրված Terminal

Toggle արեք terminal-ը editor-ի տակ՝ builds, tests և scripts run անելու համար։ Ձեր թույլտվությամբ գործակալը կարող է execute անել commands և read անել դրանց output-ը՝ իր աշխատանքը verify անելու համար. long-running commands-ը stream են անում output-ը, որպեսզի կարողանաք դիտել progress-ը։ Close արեք terminal-ը դրա header-ից, երբ այն Ձեզ պետք չէ։

10 Plan ռեժիմ և Կատարում

Ավելի մեծ goals-ի համար օգտագործեք Plan mode (կամ խնդրեք գործակալին նախ plan անել)։ Planner-ը scan է անում Ձեր նախագիծը, decomposes է անում goal-ը dependency-aware tasks-ի, և assigns է անում յուրաքանչյուրը ճիշտ specialist-ին (architect, coder, tester, docs)։

11 Մոդելների ընտրություն և Auto

Բացեք model picker-ը prompt-ի կողքին։ Options-ը խմբավորված են որպես.

Ինչպես է աշխատում Auto selection-ը

Auto-ի վրա DeepCerebra-ն օգտագործում է tiered, adaptive routing. simple tasks-ը գնում են fast, economical model-ի, մինչդեռ complex կամ planning-heavy աշխատանքը (օրինակ՝ Plan mode) ուղղորդվում է stronger model-ի։ Սա ավտոմատ կերպով balances է անում cost-ը և quality-ն, այնպես որ հազվադեպ է անհրաժեշտ manual ընտրություն կատարել։

12 Բերեք Ձեր Սեփական Բանալին (BYOK)

Դուք կարող եք route անել requests-ը Ձեր սեփական provider account-ի միջոցով՝ metered platform usage-ի փոխարեն։

  1. Բացեք API Keys sidebar-ից։
  2. Bring Your Own Key բաժնում ընտրեք provider (օրինակ՝ ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY
  3. Տեղադրեք key value-ն և սեղմեք Save։ Keys-ը encrypted են at rest և երբեք չեն վերադարձվում browser. ցուցադրվում է միայն masked preview։

Platform (DeepCerebra) models-ին key պետք չէ։ Հեռացրեք key-ը ցանկացած պահի Remove-ով։

13 Տեղական մեքենա. GPU Models և Console (DCC Bridge)

DCC Bridge-ը միացնում է Ձեր սեփական համակարգիչը web app-ին փոքր dcc-bridge connector-ի միջոցով՝ միաժամանակ բացելով երկու հնարավորություն.

Connector-ը dials out է անում authenticated WebSocket-ի միջոցով. inbound ports պետք չեն, և այն աշխատում է NAT-ի և firewalls-ի հետևում։ Այն run է լինում Windows, macOS և Linux-ի վրա (Python 3.10+)։

13.1 Pair անել Ձեր համակարգիչը

  1. Սեղմեք laptop icon-ը ձախ activity rail-ում — Local Machine (GPU + Console)։ (Նույն panel-ը բացվում է model picker footer-ից Manage local GPU…-ի միջոցով)։
  2. Համոզվեք, որ Local execution toggle-ը enabled է, անվանեք device-ը և սեղմեք Add this computer։ Copy արեք one-time pairing token-ը (dcc_brg_…) և ready-to-paste connector command-ը. token-ը ցուցադրվում է ճիշտ մեկ անգամ։

13.2 Տեղադրել և run անել connector-ը

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

13.3 Օգտագործել Ձեր console-ը web app-ից

By default, commands-ը սահմանափակված են dedicated workspace folder-ով (~/DeepCerebra)։ Ձեր իրական project folders-ում Ձեր pre-configured CLIs-ով աշխատելու համար, դրանք հստակորեն տվեք connector-ը սկսելիս.

# 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

Այնուհետև բացեք Տերմինալ վահանակը, սեղմեք Կատարման թիրախ բացվող պատուհանը (նոութբուքի պատկերակը), ընտրեք Իմ համակարգիչը, և ընտրեք աշխատանքային գրացուցակ: Ձեր մուտքագրված հրամանները և գործակալի կառուցման/փորձարկման հրամաններն այնուհետև կատարվում են ձեր մեքենայի վրա:

⚠️ Security: host access-ը երբեք չի գերազանցում այն folders-ը, որոնք դուք նշել եք connector command line-ում. tokens-ը hashed են at rest և revocable ցանկացած պահի. --no-exec-ը device-ը դարձնում է inference-only (GPU models, no commands)։
💡 Tip: Desktop app-ը կարող է օգտագործել local models-ը ուղղակիորեն՝ առանց connector-ի։ Full connector reference: github.com/mohammadkhair7/DeepCerebra-connector։

14 Git համագործակցության աշխատանքային հոսք

Բաց Git-backed project-ի դեպքում Explorer-ում հայտնվում է branch bar, որը ցույց է տալիս Ձեր ընթացիկ branch-ը և երկու actions.

Եթե push webhook-ը enabled է, Explorer-ը auto-refresh է լինում, երբ teammates-ը push են անում՝ բոլորին sync պահելով. սա DeepCerebra-ի միջոցով collaborative team development-ի հիմքն է։

15 MCP Servers

Ընդլայնեք գործակալին external tools-ով և data-ով Model Context Protocol-ի միջոցով։ Configure արեք servers .deepcerebra/mcp.json file-ում, օրինակ.

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

Enabled MCP tools-ը ավտոմատ կերպով հասանելի են դառնում գործակալին, երբ դրանք relevant են Ձեր request-ին։ Local (stdio) և remote (http/sse) servers-ը երկուսն էլ աջակցվում են։

Built-in safety

Resources & prompts

Եթե server-ը exposes է անում MCP resources կամ prompt templates, գործակալը ավտոմատ կերպով ստանում է tools դրանք օգտագործելու համար (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt

Authentication for remote servers

Ավելացրեք auth block remote server-ին։ Secrets-ը աջակցում է ${ENV_VAR} interpolation-ին.

// 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 Գործակալի հարմարեցում. Rules, Skills, Hooks, Subagents & Plugins

Դուք կարող եք shape անել, թե ինչպես է գործակալը մտածում և գործում մեկ, file-based convention-ով՝ .deepcerebra/ directory-ով, որը նույնականորեն աշխատում է desktop app-ում, web app-ում և API-ում։ Web app-ում դրանք բոլորը կառավարեք Agent view-ի տակ. desktop-ում և API-ի միջոցով դրանք պարզ files են, որոնք դուք commit եք անում Ձեր նախագծի հետ։

Scopes & precedence

Configuration-ը հայտնաբերվում է մի քանի scopes-ից. երբ նույն item-ը գոյություն ունի մեկից ավելիում, higher-precedence-ովը հաղթում է.

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

Rules (steering)

Rules-ը persistent instructions են՝ coding standards, architecture conventions, domain context, որոնք injected են լինում գործակալի system prompt-ի մեջ։ Դրանք գոյություն ունեն որպես Markdown files .deepcerebra/steering/-ի տակ, գումարած միշտ միացված AGENTS.md standard-ը։ Frontmatter-ը controls է անում, թե երբ է rule-ը loads լինում.

---
inclusion: fileMatch          # always | fileMatch | auto | manual
globs: "src/**/*.ts"          # or fileMatchPattern
name: api-design
description: REST conventions
---
# API design
- Use REST resource nouns, plural.

Root AGENTS.md-ը կիրառվում է repo-wide. nested AGENTS.md-ը (օրինակ՝ services/api/AGENTS.md) կիրառվում է միայն այդ folder-ի տակ գտնվող files-ի համար։ Web app-ում Agent → Steering view-ը յուրաքանչյուր rule-ին տալիս է Scope picker (Global / Project / Team

Skills

Skills-ը reusable playbooks են, որոնք գործակալը loads է անում on demand։ Յուրաքանչյուր skill folder է SKILL.md-ով .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.

Գործակալը տեսնում է lightweight catalog (name + description) և pulls է անում full body-ն load_skill tool-ով, երբ relevant է։ Դուք կարող եք նաև invoke անել մեկը հստակորեն /skill <name>-ով։ Սահմանեք disable-model-invocation: true՝ skill-ը manual-only դարձնելու համար։

Hooks

Hooks-ը run են անում automation lifecycle events-ի վրա։ Սահմանեք դրանք որպես .deepcerebra/hooks/*.hook.json.

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

Events-ը ներառում են promptSubmit, preToolUse, postToolUse, fileCreate, fileSave, fileDelete, preTask, postTask, sessionStart, preCompact և agentStop (Cursor/Claude spellings-ը նույնպես ընդունվում են)։ Action-ը կա՛մ shell է (run a command), կա՛մ agentPrompt (ask the agent)։ preToolUse hook-ը կարող է allow, deny կամ ask անել tool call-ի համար, որը այն intercepts է անում։

Subagents

Subagents-ը specialist agents են, որոնք դուք սահմանում և delegate եք անում։ Յուրաքանչյուրը Markdown file է .deepcerebra/agents/-ի տակ frontmatter-ով գումարած body (դրա system prompt)։

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

Main agent-ը delegates է անում task-ով (blocking), task_async + task_status / task_result-ով (background) կամ task_parallel-ով (fan-out)։

Plugins

Plugin-ը bundles է անում rules, skills, hooks, subagents և MCP servers մեկ installable package-ի մեջ .deepcerebra/plugins/<name>/-ի տակ, որը նկարագրված է plugin.json manifest-ով։

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

Plugin contents-ը merged են լինում lowest precedence-ով, այնպես որ Ձեր սեփական rules-ը և skills-ը միշտ override են անում plugin-ի։ Disable արեք plugin-ը "enabled": false-ով կամ .disabled marker file-ով։

💡 Tip: Team-ը կարող է publish անել shared defaults՝ DCC_ORG_CONFIG_DIR-ը ուղղելով shared .deepcerebra directory-ին, կամ rules-ը սահմանելով Team scope-ին web app-ում։

17 Գործակալական Աշխատանքային Հոսքի Ստուդիա և Իրադարձությունների վրա հիմնված գործակալներ

Workflow Studio-ն multi-agent automation-ի visual designer է։ Դուք compose եք անում stages-ը՝ յուրաքանչյուրը agent, specialist step կամ control primitive՝ graph-ի մեջ, միացնում եք դրանք dependencies-ով և run եք անում ամբողջ orchestration-ը engine-ի վրա live per-stage progress-ով, budgets-ով և human-approval gates-ով։ Workflows-ը պահվում են որպես portable YAML/JSON definition, որը դուք կարող եք export, import, version անել Git-ում և run անել API-ից կամ CLI-ից։

17.1 Building a workflow

17.2 The stage library

Stage kindԻնչ է անում
agentՄեկ agent turn Ձեր կցած skills-ով և tools-ով։
spec.requirements / spec.design / spec.execute Spec-first delivery. draft requirements, design, այնուհետև break into tasks և execute — յուրաքանչյուրը gateable։
documents.generateԱրտադրել polished document նախորդ stage outputs-ից։
fan_outParallel wide-research բազմաթիվ subtopics-ի միջոցով synthesis-ով։
map / loop / switch Control primitives. run a body per item, repeat until a condition, կամ branch across cases։
verify / browser_verify Run tests կամ commands sandbox-ում. verify a running UI browser automation-ով։
orchestrateDynamic routing. an orchestrator agent reads the request և dispatches է անում այն լավագույն downstream agent(s)-ին events-ի միջոցով։
external.agentCall a registered third-party agent HTTP-ի միջոցով (A2A) կարծես այն native stage լիներ։
evalScore an upstream output against checks (contains / regex / length / LLM-judge). fail below a threshold։
db.provisionGenerate an owned data layer. docker-compose for the database, versioned SQL migrations, seed data, .env template, և Mermaid ERD. optional auth scaffold. can apply migrations to SQLite immediately։
ci.generateGenerate a ready-to-commit CI/CD pipeline (GitHub Actions, GitLab CI, կամ Azure Pipelines) lint → test → scan → build → deploy և environment promotion-ով։
deploy.packageGenerate production deployment assets. multi-stage Dockerfile, docker-compose, Kubernetes manifests, կամ Helm chart — files, որոնք դուք եք սեփականատեր և commit եք անում։
test.generateGenerate unit / API / E2E suites for the built app գումարած requirement-to-test traceability matrix։
test.verifyExecute a test suite (pytest, vitest, jest, Playwright) և gate the run on its pass rate։
security.auditScan dependencies for known vulnerabilities և tree-ն hard-coded secrets-ի համար. publishes alert events և writes a findings report։
previewStart the generated app locally և surface its live URL in the run panel (link + inline frame) preview.ready event-ի միջոցով։
design.importTurn a UI design image (screenshot, mockup, Figma export) into a structured implementation spec for downstream stages։

17.3 Event-driven agents (the agent mesh)

Յուրաքանչյուր stage՝ անկախ kind-ից, կարող է publish և subscribe անել typed events-ին workspace event bus-ի վրա, այնպես որ agents-ը coordinate են անում ինչպես services-ը message fabric-ի վրա, այլ ոչ միայն DAG-ի միջոցով.

17.3.1 Գործակալների համար իրադարձությունների հերթագրում

Իրադարձություններին արձագանքող գործակալները կարող են հայտարարել կայուն անվանական հերթ, որպեսզի համապատասխան իրադարձությունները երբեք չկորչեն, մինչ գործակալը զբաղված է կամ մինչև գործարկումը լսում է։ Միացման բաժանորդագրության դեպքում սահմանեք queue: <name> — շարժիչը կապում է այդ թեման աշխատանքային տարածքի իրադարձությունների ավտոբուսի FIFO հերթին (պահպանվում է .deepcerebra/workflows/events/queues/ տակ)։ Այդ պահից սկսած հրապարակված յուրաքանչյուր համապատասխան իրադարձություն գրավվում է հերթում. երբ փուլը դառնում է գործարկելի, շարժիչը հերթից հանում է իրադարձությունները ամենահինը-առաջինը կարգով և սպառում է դրանք մեկ առ մեկ։

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 Սեմաֆորի կազմակերպում (ընդհանուր ռեսուրսների պաշտպանություն)

Մի սեմաֆորը սահմանափակում է, թե քանի առաջադրանք կարող է միաժամանակ գործել ընդհանուր (պաշտպանված) ռեսուրսի վրա՝ գրվող տվյալների բազա, գլոբալ փոփոխականների պահեստ, ֆայլ կամ արագությամբ սահմանափակված արտաքին գործակալ։ Կցեք մեկը ցանկացած փուլին՝ semaphore: — մինչև փուլի աշխատանքի մեկնարկը, շարժիչը ձեռք է բերում անվանված աշխատանքային տարածքի սեմաֆորի մեկ թույլտվություն. թույլտվությունը միշտ ազատվում է հետո, նույնիսկ եթե փուլը ձախողվի։ permits: 1 այն դարձնում է մյուտեքս։ միաժամանակ միայն մեկ առաջադրանք (աշխատանքային տարածքի բոլոր զուգահեռ գործարկումների ընթացքում) կատարում է կրիտիկական քայլը. յուրաքանչյուր այլ առաջադրանք սպասում է մինչև պահողն ավարտի։

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 Ռանդևուի կազմակերպում (սպասել բոլոր պայմաններին)

Ռանդևուն սպասում է մինչև բազմաթիվ իրադարձությունների պայմաններ բոլորը բավարարվեն, նախքան հաջորդ քայլը կշարունակվի — հակառակը «առաջին իրադարձությունը հաղթում է» սկզբունքին։ Սահմանեք join: all փուլի events: բլոկում. յուրաքանչյուր միացման բաժանորդագրությունը պետք է բավարարվի, նախքան փուլը կգործարկվի։ Համատեղեք բաժանորդագրության համար count: N-ի հետ, երբ մի քանի գործակալ (կամ մեկ գործակալից մի քանի հաշվետվություն) պետք է բոլորը գրանցվեն — օրինակ, դիզայնի հաստատում, թեստի ավարտ և անվտանգության հաստատում մինչև թողարկման փուլի կատարումը։

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 The agent tools library

Stages-ը tools են ընտրում նույն registry-ից, որը օգտագործում է chat agent-ը.

17.5 Running, gates և outputs

💡 Tip: Սկսեք Ship-It Pipeline template-ից. այն chains է անում design → db.provision → implementation → generated tests → security audit → deploy packaging → CI generation, human gate-ով մինչև packaging — complete brief-to-production path, որը դուք կարող եք adapt անել րոպեների ընթացքում։

18 Կանխատեսող Tab Completion

Predictive Tab completion-ը առաջարկում է inline, fill-in-the-middle code suggestions, երբ դուք typing եք անում editor-ում — accept արեք suggestion-ը Tab-ով։ Այն opt-in է և՛ engine-ի, և՛ web editor-ի վրա։

Միացնել այն

Ինչպես է այն behaves

19 Օգտագործում, Կրեդիտներ և Հաշվարկ

Բացեք Billing sidebar-ից՝ Ձեր plan-ը և usage-ը կառավարելու համար։ AI usage-ը metered է U.S.-dollar credits-ով՝ հիմնված underlying models-ի կողմից consumed tokens-ի վրա։

PlanԱմսական գինՆերառված ամսական AI usage
Basic$20$10
Pro$75$30
Ultimate$200$150
💡 Save on usage: Օգտագործեք Auto model selection, բերեք Ձեր սեփական key-ը (BYOK), կամ run արեք local models՝ metered usage-ը նվազեցնելու կամ խուսափելու համար։

20 Ձեր Gateway API Key-ը ստանալը

Gateway API key-ը (personal access token) թույլ է տալիս Ձեզ օգտագործել DeepCerebra public API-ն և CLI-ն programmatically։

  1. Sign in արեք և բացեք API Keys sidebar-ից։
  2. Scroll արեք դեպի DeepCerebra API Keys։
  3. Մուտքագրեք label (օրինակ՝ "CI pipeline" կամ "laptop CLI")։
  4. Ընտրեք scopesread, chat, code, agent — և կամընտիր expiry days-ով (blank = never)։
  5. Սեղմեք Generate։ Full key-ը ցուցադրվում է միայն մեկ անգամ — սեղմեք Copy և պահեք այն securely։

Օգտագործեք այն CLI-ի կամ API-ի հետ 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/...

Դուք կարող եք rename կամ delete (revoke) անել key-ը ցանկացած պահի. յուրաքանչյուր key ցույց է տալիս իր prefix-ը, scopes-ը, created/expiry-ն և last-used date-ը։

⚠️ Պահեք այն secret։ Ձեր key-ով ցանկացած մարդ կարող է օգտագործել Ձեր account-ը և incur անել usage։ Revoke և regenerate արեք այն անմիջապես, եթե այն երբևէ exposed լինի։

21 Անվտանգություն և Գաղտնիություն

22 Խնդիրների լուծում

"Folder loading needs a Chromium browser"

Անցեք Chrome, Edge կամ Brave, կամ փոխարենը օգտագործեք Open from Git։

Գործակալը loops է անում նույն error-ի վրա

Սեղմեք Stop, այնուհետև rephrase արեք concrete hint-ով կամ constraint-ով։

Model կամ request errors / "budget exhausted"

Local models-ը չեն հայտնվում

Connector: "server rejected WebSocket connection: HTTP 401"

Իմ changes-ը չեն take effect արել

Git: "You are on the default branch"

Բացեք կամ ստեղծեք working branch մինչև Integrate-ը օգտագործելը pull request բացելու համար։

Դեռ stuck եք։ Կապվեք support@deepcerebra.ai։

23 DeepCerebra Discovery — Հարցրեք Ձեր Տվյալներին և Փաստաթղթերին

Discovery-ն հետազոտական չաթ-բոտ է Ձեր տվյալների բազաների և փաստաթղթերի համար։ Մեկ հարցմամբ պատասխանելու փոխարեն, այն աշխատում է որպես վերլուծաբան. այն ձևավորում է վարկածներ, իրականացնում է մի շարք պաշտպանված հետազոտություններ (SQL, գրաֆիկ, փաստաթղթերի որոնում, սխեմաների ստուգում, վեբ հաստատում), կրճատում է այն բացատրությունները, որոնք հերքվում են ապացույցներով, և սինթեզում է հիմնավորված պատասխան — գծապատկերներով և ծախսերի թափանցիկ անդորրագրով։ Բացեք այն ակտիվության վահանակում գտնվող կողմնացույցի պատկերակից (/app/discovery

23.1 Տարածքներ — Ձեր ընտրված շրջանակը

Մեկ Տարածքը միավորում է այն ամենը, ինչ անհրաժեշտ է հարցերի մեկ շարքի համար. տվյալների բազայի միացումներ, փաստաթղթերի հավաքածուներ, վերլուծաբանի համար հրահանգներ և բյուջեներ։ Ստեղծեք մեկը + Նոր տարածք-ով, ապա օգտագործեք աջ կողմի կարգավորումների վահանակը՝

23.2 Հարց տալը

Մուտքագրեք հարց այնպես, ինչպես կհարցնեիք գործընկերոջը, օրինակ՝ «Ինչու՞ է ՄՌՏ սկանավորման ծավալը նվազել մարտին»։ Հետաքննության վահանակը ուղիղ եթերում ցուցադրում է ամբողջ գործընթացը.

Հետագա հարցերը շարունակում են նույն թելը, այնպես որ վերլուծաբանը պահպանում է իր համատեքստը։

23.3 Գծապատկերներ, հաշվետվություններ և արտահանումներ

Գծապատկերները ցուցադրվում են հետաքննության վահանակում։ Օգտագործեք Արտահանել ամբողջական հարցումը ներբեռնելու համար՝ պատասխանը, վարկածները, ապացույցները և գծապատկերները՝ որպես ինքնուրույն HTML հաշվետվություն կամ տպագրական որակի PDF, ձևավորված նեոնային դիզայնի համակարգով։

23.4 Բյուջեներ և ծախսերի վերահսկում

Յուրաքանչյուր տարածք ունի յուրաքանչյուր հարցման համար նախատեսված բյուջեներ՝ հետազոտությունների առավելագույն քանակ, հետաքննության փուլեր, վայրկյաններ և USD։ Շարժիչը կանգնում է սահմանաչափին հասնելուն պես և զեկուցում է այն, ինչ գտել է մինչ այդ։ Յուրաքանչյուր հետազոտության արժեքը մանրամասն նշված է անդորրագրում, այնպես որ դուք միշտ կիմանաք, թե ուր է գնացել ծախսը։

23.5 Ավտոմատացում. API, SDK, Workflow Studio և MCP