Кіраўніцтва карыстальніка
Поўнае практычнае кіраўніцтва па стварэнні праграмнага забеспячэння з DeepCerebra Coder — для вэб, настольных праграм і CLI

📖 Змест

  1. Уводзіны і выданні
  2. Пачатак працы і ўліковы запіс
  3. Агляд працоўнай прасторы
  4. Адкрыццё праекта
  5. Праца з файламі
  6. Размаўляем з агентам
  7. Чатыры рэжымы чата
  8. Прагляд і прымяненне змяненняў
  9. Убудаваны тэрмінал
  10. Рэжым планавання і выканання
  11. Выбар мадэляў і аўтаматычны рэжым
  12. Выкарыстанне ўласнага ключа (BYOK)
  13. Лакальная машына: мадэлі GPU і кансоль (DCC Bridge)
  14. Працоўны працэс сумеснай працы з Git
  15. Серверы MCP
  16. Настройка агента: правілы, навыкі, хукі, субагенты і плагіны
  17. Студыя агенцкіх працоўных працэсаў і агенты, кіраваныя падзеямі
  18. Прэдыкцыйнае аўтазапаўненне па Tab
  19. Выкарыстанне, крэдыты і выстаўленне рахункаў
  20. Атрыманне ключа API шлюза
  21. Бяспека і прыватнасць
  22. Вырашэнне праблем
  23. DeepCerebra Discovery — Запытайце Вашы даныя і дакументы

1 Уводзіны і выданні

DeepCerebra Coder з'яўляецца агентным памочнікам па кадаванні. У адрозненне ад простага аўтазапаўняльнага капілота, ён плануе, піша, рэфактарызуе, выконвае каманды, выклікае інструменты і ітэруе па ўсім вашым праекце — пры гэтым вы праглядаеце і зацвярджаеце змены, якія ён прапануе.

Тры спосабы выкарыстання

ВыданнеЛепш за ўсё падыходзіць дляДоступ да файлаў
Вэб-праграмаБез усталёўкі, працуйце з любой машыныКанфідэнцыйнае сховішча ў браўзеры (і рэпазітарыі Git)
Настольная праграма (Windows / Linux / macOS)Распрацоўка з прыярытэтам лакальнага, лакальныя мадэліПрамая лакальная файлавая сістэма
CLI і APIСкрыптынг, CI/CD, аўтаматызацыяЛакальныя файлы / праграмны

Гэта кіраўніцтва сканцэнтравана на вэб-праграме па адрасе deepcerebra.ai; настольная праграма адлюстроўвае тыя ж панэлі і працоўныя працэсы.

2 Пачатак працы і ўліковы запіс

Падтрымліваемыя браўзеры

Выкарыстоўвайце актуальную версію Chrome, Edge або Brave для поўнага вопыту — адкрыццё лакальнай папкі абапіраецца на Chromium File System Access API. Firefox і Safari працуюць для чата і для праектаў, якія падтрымліваюцца Git, але не могуць адкрыць лакальную папку непасрэдна.

Стварыць уліковы запіс

  1. Націсніце Пачаць на мэтавай старонцы.
  2. Запоўніце неабавязковыя імя для адлюстравання, электронную пошту, краіну і дату нараджэння (вам павінна быць не менш за 18 гадоў).
  3. Выберыце мову інтэрфейсу і пароль даўжынёй не менш за 12 сімвалаў.
  4. Прачытайце паведамленне аб згодзе і пацвердзіце. Стварэнне ўліковага запісу азначае, што вы згаджаецеся з Умовамі абслугоўвання, Заявай аб прыватнасці, Апісаннем паслуг і Глабальным DPA.
  5. Націсніце Стварыць уліковы запіс, затым пацвердзіце сваю электронную пошту, калі будзе прапанавана, і ўвайдзіце.
💡 Парада: Вы можаце выбраць тарыфны план падчас рэгістрацыі, наведаўшы /register?plan=basic (або pro / ultimate), або пачаць зараз і выбраць план пазней у раздзеле Выстаўленне рахункаў.

Скінуць пароль

  1. На старонцы ўваходу націсніце Забылі пароль?
  2. Увядзіце свой адрас электроннай пошты і адкрыйце спасылку для скіду, адпраўленую на вашу паштовую скрыню.
  3. Усталюйце новы пароль (мінімум 12 сімвалаў).

3 Агляд працоўнай прасторы

Пасля ўваходу вы трапляеце ў працоўны стол, дзе ўсе панэлі размешчаны на адным экране:

Перацягніце раздзяляльнік паміж рэдактарам і чатам, каб пераразмеркаваць макет, і перацягніце гарызантальны раздзяляльнік, каб змяніць памер тэрмінала. Левая бакавая панэль таксама дазваляе пераходзіць да Працоўнай прасторы, Пашырэнняў, Ключоў API, Выстаўлення рахункаў і Зваротнай сувязі.

4 Адкрыццё праекта

4.1 Адкрыць лакальную папку

  1. У Правадыры націсніце Адкрыць папку праекта.
  2. Выберыце папку і дайце браўзеру дазвол на яе чытанне.
  3. Файлы чытаюцца ў зашыфраваную працоўную прастору ў браўзеры — нічога не загружаецца. Вы ўбачыце лічыльнік у рэальным часе і канчатковае рэзюмэ (колькасць файлаў · памер, а таксама любыя прапушчаныя або абрэзаныя файлы).
⚠️ Падтрымка браўзера: Калі вы бачыце заўвагу, што для загрузкі папкі патрэбен браўзер Chromium, пераключыцеся на Chrome/Edge/Brave або выкарыстоўвайце замест гэтага Адкрыць з Git.

4.2 Адкрыць з Git (GitHub / GitLab)

  1. Націсніце Адкрыць з Git у Правадыры.
  2. Выберыце ўкладку GitHub або GitLab і ўстаўце асабісты токен доступу. Для GitHub выкарыстоўвайце вобласць дзеяння repo (класічны) або дэталёвы токен з Contents + Pull requests; для GitLab выкарыстоўвайце вобласць дзеяння api. Ваш токен захоўваецца на серверы — у браўзер загружаецца толькі змесціва файлаў.
  3. Увядзіце рэпазітарый як owner/name (адфільтруйце спіс, каб знайсці свой), затым выберыце галіну.
  4. Пры жаданні пастаўце галачку Стварыць новую працоўную галіну (напрыклад, dcc/my-feature), каб ізаляваць вашу працу ад галіны па змаўчанні.
  5. Пры жаданні ўключыце push webhook, каб Правадыр імгненна абнаўляўся, калі таварышы па камандзе робяць push (патрабуецца публічны URL шлюза).
  6. Націсніце Адкрыць рэпазітарый.

4.3 Абнавіць, пераключыць і закрыць

4.4 Сесіі чата, прывязаныя да папкі

Гісторыя чата прывязана да адкрытага праекта. Пераключэнне папак аўтаматычна пачынае новую сесію і загружае папярэднія сесіі гэтай папкі, адкрываючы самую апошнюю, каб вы маглі працягнуць з таго месца, дзе спыніліся.

4.5 Аперацыйныя папкі

Папкі, якія DeepCerebra выкарыстоўвае ўнутры — .deepcerebra, .sessions — з'яўляюцца ў дрэве, але згорнутыя па змаўчанні, каб не загрувашчваць ваш зыходны код.

5 Праца з файламі

6 Размаўляем з агентам

Напісаць запыт

Апішыце, што вы хочаце, простай мовай — задайце пытанне, запытайце функцыю або пакажыце на памылку. Будзьце канкрэтнымі адносна файлаў, фрэймворкаў і абмежаванняў, каб атрымаць найлепшы вынік. Далучыце адпаведныя файлы, перацягнуўшы іх у запыт.

Чытаць адказы, у стылі Cursor

Адказы арганізаваны як у Cursor: развагі агента аддзелены ад выніку. Кожны блок адказу мае значок капіравання ў правым верхнім куце, каб вы маглі скапіяваць гатовы справаздачу, дакумент або каманду, якую вы павінны выканаць.

Кіраваць або спыніць выкананне

💡 Парада (настольная праграма): У настольнай праграме вы выклікаеце агента ў чаце з дапамогай @deepcerebra, а прэфіксы накшталт [deep] запытваюць больш глыбокія развагі.

7 Чатыры рэжымы чата

Выберыце рэжым з селектара рэжымаў побач з полем уводу. Кожны рэгулюе, наколькі агент плануе і наколькі свабодна ён рэдагуе:

РэжымШто ён робіцьВыкарыстоўваць, калі…
АгентПлануе і рэдагуе ваш праект аўтаномнаВы хочаце, каб памочнік рэалізаваў змену ад пачатку да канца
СпытацьАдказы на пытанні аб вашым кодзе без рэдагаванняВы хочаце разабрацца ў кодавай базе
ПланРаспрацоўвае падыход перад любым рэдагаваннемЗадача вялікая або мае кампрамісы, якія трэба вырашыць спачатку
РэдагавацьРобіць сфакусаваныя змены ў бягучым кантэксцеВы хочаце невялікую, мэтавую змену

8 Прагляд і прымяненне змяненняў

Калі агент прапануе змены ў файлах, над полем уводу чата з'яўляецца панэль Прапанаваныя змены, якая пералічвае кожны закрануты файл з колькасцю дададзеных (+) і выдаленых (−) радкоў.

⚠️ Заўсёды праглядайце: Код, згенераваны AI, можа ўтрымліваць памылкі або небяспечныя шаблоны. Праглядзіце адрозненні і пратэстуйце, перш чым спадзявацца на яго або разгортваць.

9 Убудаваны тэрмінал

Пераключыце тэрмінал пад рэдактарам для запуску зборак, тэстаў і скрыптоў. З вашага дазволу агент можа выконваць каманды і чытаць іх вывад, каб праверыць сваю працу; доўгачасовыя каманды транслююць вывад, каб вы маглі назіраць за ходам выканання. Зачыніце тэрмінал з яго загалоўка, калі ён вам не патрэбны.

10 Рэжым планавання і выканання

Для больш буйных мэтаў выкарыстоўвайце рэжым План (або папрасіце агента спачатку спланаваць). Планіроўшчык скануе ваш праект, разбівае мэту на задачы, якія ўлічваюць залежнасці, і прызначае кожную патрэбнаму спецыялісту (архітэктару, праграмісту, тэсціроўшчыку, дакументатару).

11 Выбар мадэляў і аўтаматычны рэжым

Адкрыйце выбар мадэлі побач з полем уводу. Параметры згрупаваны наступным чынам:

Як працуе аўтаматычны выбар

У аўтаматычным рэжыме DeepCerebra выкарыстоўвае шматузроўневую, адаптыўную маршрутызацыю: простыя задачы накіроўваюцца да хуткай, эканамічнай мадэлі, у той час як складаная або патрабуючая планавання праца (напрыклад, рэжым планавання) накіроўваецца да больш магутнай мадэлі. Гэта аўтаматычна балансуе кошт і якасць, таму вам рэдка трэба выбіраць уручную.

12 Выкарыстанне ўласнага ключа (BYOK)

Вы можаце накіроўваць запыты праз свой уласны ўліковы запіс пастаўшчыка замест выкарыстання платформы з аплатай па лічыльніку.

  1. Адкрыйце API Keys з бакавой панэлі.
  2. У раздзеле Bring Your Own Key выберыце пастаўшчыка (напрыклад, ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
  3. Устаўце значэнне ключа і націсніце Save. Ключы шыфруюцца ў стане спакою і ніколі не вяртаюцца ў браўзер — паказваецца толькі маскіраваны папярэдні прагляд.

Мадэлям платформы (DeepCerebra) ключ не патрэбны. Выдаліць ключ можна ў любы час з дапамогай Remove.

13 Лакальная машына: мадэлі GPU і кансоль (DCC Bridge)

DCC Bridge падключае ваш уласны камп'ютар да вэб-праграмы праз невялікі dcc-bridge канэктар, адкрываючы адначасова дзве магчымасці:

Канэктар выконвае выходнае злучэнне праз аўтэнтыфікаваны WebSocket — не патрабуецца ўваходных партоў, і ён працуе за NAT і брандмаўэрамі. Ён працуе на Windows, macOS і Linux (Python 3.10+).

13.1 Спалучыць ваш камп'ютар

  1. Націсніце значок ноўтбука ў левай панэлі актыўнасці — Local Machine (GPU + Console). (Тая ж панэль адкрываецца з ніжняга калонтытула выбару мадэлі праз Manage local GPU….)
  2. Пераканайцеся, што пераключальнік Local execution уключаны, назавіце прыладу і націсніце Add this computer. Скапіруйце аднаразовы pairing token (dcc_brg_…) і гатовую да ўстаўкі каманду канэктара — токен паказваецца толькі адзін раз.

13.2 Усталяваць і запусціць канэктар

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 Выкарыстоўваць вашу кансоль з вэб-праграмы

Па змаўчанні каманды абмежаваныя спецыяльнай працоўнай тэчкай (~/DeepCerebra). Каб працаваць у вашых рэальных тэчках праектаў з вашымі папярэдне настроенымі CLI, прадастаўце ім доступ яўна пры запуску канектара:

# 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

Затым адкрыйце панэль Terminal, націсніце ўсплывальнае акно Execution target (значок ноўтбука), выберыце My computer і выберыце працоўны каталог. Абедзве вашы ўведзеныя каманды і каманды зборкі/тэставання агента будуць выкананы на вашай машыне.

⚠️ Бяспека: доступ да хоста ніколі не перавышае папкі, якія вы пералічылі на камандным радку канэктара; токены хэшуюцца ў стане спакою і могуць быць ануляваны ў любы час; --no-exec робіць прыладу толькі для вываду (мадэлі GPU, без каманд).
💡 Парада: Настольная праграма можа выкарыстоўваць лакальныя мадэлі непасрэдна без канэктара. Поўная даведка па канэктары: github.com/mohammadkhair7/DeepCerebra-connector.

14 Працоўны працэс сумеснай працы з Git

Калі праект, які падтрымліваецца Git, адкрыты, у Правадыры з'яўляецца панэль галін, якая паказвае вашу бягучую галіну і два дзеянні:

Калі push webhook уключаны, Правадыр аўтаматычна абнаўляецца, калі таварышы па камандзе робяць push, падтрымліваючы сінхранізацыю ўсіх — гэта аснова для сумеснай каманднай распрацоўкі праз DeepCerebra.

15 Серверы MCP

Пашырыце агента знешнімі інструментамі і дадзенымі праз Model Context Protocol. Наладзьце серверы ў файле .deepcerebra/mcp.json, напрыклад:

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

Уключаныя інструменты MCP становяцца даступнымі для агента аўтаматычна, калі яны адпавядаюць вашаму запыту. Лакальныя (stdio) і аддаленыя (http/sse) серверы абодва падтрымліваюцца.

Убудаваная бяспека

Рэсурсы і падказкі

Калі сервер выстаўляе рэсурсы MCP або prompt templates, агент аўтаматычна атрымлівае інструменты для іх выкарыстання (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt).

Аўтэнтыфікацыя для аддаленых сервераў

Дадайце блок auth да аддаленага сервера. Сакрэты падтрымліваюць інтэрпаляцыю ${ENV_VAR}:

// Статычны токен носьбіта (літаральны або з асяроддзя)
"auth": { "type": "bearer", "token": "${GITHUB_TOKEN}" }
"auth": { "type": "bearer", "tokenEnv": "GITHUB_TOKEN" }

// Карыстальніцкі загаловак (напрыклад, ключ API)
"auth": { "type": "header", "header": "x-api-key", "value": "${MY_KEY}" }

// OAuth 2.0 уліковыя дадзеныя кліента
"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 Настройка агента: правілы, навыкі, хукі, субагенты і плагіны

Вы можаце фарміраваць, як агент думае і дзейнічае, з дапамогай адзінай, файлавай канвенцыі — каталога .deepcerebra/ — якая працуе ідэнтычна ў настольнай праграме, вэб-праграме, і API. У вэб-праграме кіруйце ўсім гэтым у раздзеле Agent; на настольных праграмах і праз API гэта звычайныя файлы, якія вы фіксуеце разам з вашым праектам.

Вобласці дзеяння і прыярытэт

Канфігурацыя выяўляецца з некалькіх абласцей дзеяння; калі адзін і той жа элемент існуе ў некалькіх, перамагае той, які мае больш высокі прыярытэт:

team/org  <  global (~/.deepcerebra)  <  workspace (<repo>/.deepcerebra)
(самы нізкі)                                              (самы высокі)

Правілы (кіраванне)

Правілы — гэта пастаянныя інструкцыі — стандарты кадавання, архітэктурныя канвенцыі, кантэкст дамена — якія ўводзяцца ў сістэмны запыт агента. Яны знаходзяцца ў файлах Markdown у каталогу .deepcerebra/steering/, а таксама ў заўсёды ўключаным стандарце AGENTS.md. Frontmatter кантралюе, калі правіла загружаецца:

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

Каранёвы AGENTS.md прымяняецца да ўсяго рэпазітарыя; укладзены AGENTS.md (напрыклад, services/api/AGENTS.md) прымяняецца толькі да файлаў у гэтай папцы. У вэб-праграме ў раздзеле Agent → Steering кожнаму правілу даецца выбар Scope (Global / Project / Team).

Навыкі

Навыкі — гэта шматразовыя сцэнарыі, якія агент загружае па патрабаванні. Кожны навык — гэта папка з файлам 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.

Агент бачыць лёгкі каталог (name + description) і загружае поўны змест з дапамогай інструмента load_skill, калі гэта актуальна. Вы таксама можаце выклікаць яго яўна з дапамогай /skill <name>. Усталюйце disable-model-invocation: true, каб зрабіць навык толькі ручным.

Хукі

Хукі выконваюць аўтаматызацыю на падзеях жыццёвага цыклу. Вызначце іх як .deepcerebra/hooks/*.hook.json:

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

Падзеі ўключаюць promptSubmit, preToolUse, postToolUse, fileCreate, fileSave, fileDelete, preTask, postTask, sessionStart, preCompact і agentStop (таксама прымаюцца напісанні Cursor/Claude). Дзеянне можа быць альбо shell (выканаць каманду), альбо agentPrompt (запытаць агента). Хук preToolUse можа дазволіць, забараніць або запытаць выклік інструмента, які ён перахоплівае.

Субагенты

Субагенты — гэта спецыялізаваныя агенты, якіх вы вызначаеце і якім дэлегуеце. Кожны з іх — гэта файл Markdown у каталогу .deepcerebra/agents/ з frontmatter плюс целам (яго сістэмным запытам):

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

Галоўны агент дэлегуе з дапамогай task (блакіруючы), task_async + task_status / task_result (фонавы) або task_parallel (разгалінаваны).

Плагіны

Плагін аб'ядноўвае правілы, навыкі, хукі, субагенты і серверы MCP у адзін усталявальны пакет у каталогу .deepcerebra/plugins/<name>/, апісаны маніфестам plugin.json:

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

Змесціва плагіна аб'ядноўваецца з самым нізкім прыярытэтам, таму вашы ўласныя правілы і навыкі заўсёды перавызначаюць плагін. Адключыце плагін з дапамогай "enabled": false або файла-маркера .disabled.

💡 Парада: Каманда можа публікаваць агульныя налады па змаўчанні, накіроўваючы DCC_ORG_CONFIG_DIR на агульны каталог .deepcerebra, або ўсталёўваючы правілы ў вобласць дзеяння Team у вэб-праграме.

17 Студыя агенцкіх працоўных працэсаў і агенты, кіраваныя падзеямі

The Workflow Studio з'яўляецца візуальным дызайнерам для шматагентнай аўтаматызацыі. Вы складаеце этапы — кожны з якіх з'яўляецца агентам, спецыялізаваным крокам або прымітывам кіравання — у граф, злучаеце іх з залежнасцямі і запускаеце ўсю аркестрацыю на рухавіку з жывым прагрэсам па этапах, бюджэтамі і варотамі чалавечага зацвярджэння. Працоўныя працэсы захоўваюцца як партатыўнае вызначэнне YAML/JSON, якое вы можаце экспартаваць, імпартаваць, версіянаваць у Git і запускаць з API або CLI.

17.1 Стварэнне працоўнага працэсу

17.2 Бібліятэка этапаў

Тып этапуШто ён робіць
agentАдзін ход агента з навыкамі і інструментамі, якія вы далучаеце.
spec.requirements / spec.design / spec.execute Дастаўка па спецыфікацыі: распрацоўка патрабаванняў, дызайн, затым разбіццё на задачы і выкананне — кожны этап можа быць зацверджаны.
documents.generateСтварыць адшліфаваны дакумент з вывадаў папярэдніх этапаў.
fan_outПаралельнае шырокае даследаванне па многіх падтэмах з сінтэзам.
map / loop / switch Прымітывы кіравання: выканаць цела для кожнага элемента, паўтараць да выканання ўмовы або разгалінаваць па выпадках.
verify / browser_verify Запускаць тэсты або каманды ў пясочніцы; правяраць запушчаны інтэрфейс з дапамогай аўтаматызацыі браўзера.
orchestrateДынамічная маршрутызацыя: агент-аркестратар чытае запыт і адпраўляе яго лепшым наступным агентам праз падзеі.
external.agentВыклікаць зарэгістраванага старонняга агента праз HTTP (A2A), як калі б гэта быў натыўны этап.
evalАцаніць вывад папярэдняга этапу па праверках (утрымлівае / рэгулярны выраз / даўжыня / LLM-суддзя); праваліцца ніжэй парога.
db.provisionСтварыць уласны пласт дадзеных: docker-compose для базы дадзеных, версіяваныя міграцыі SQL, пачатковыя дадзеныя, шаблон .env і Mermaid ERD; неабавязковы каркас аўтэнтыфікацыі; можа неадкладна прымяняць міграцыі да SQLite.
ci.generateСтварыць гатовы да фіксацыі канвеер CI/CD (GitHub Actions, GitLab CI, або Azure Pipelines) з lint → test → scan → build → deploy і прасоўваннем асяроддзя.
deploy.packageСтварыць актывы для разгортвання ў вытворчасці: шматэтапны Dockerfile, docker-compose, маніфесты Kubernetes або Helm-дыяграму — файлы, якімі вы валодаеце і якія фіксуеце.
test.generateСтварыць наборы юніт / API / E2E тэстаў для сабранай праграмы плюс матрыцу прасочвання патрабаванняў да тэстаў.
test.verifyВыканаць набор тэстаў (pytest, vitest, jest, Playwright) і зацвердзіць выкананне па яго працэнтнай стаўцы праходжання.
security.auditСканіраваць залежнасці на вядомыя ўразлівасці і дрэва на жорстка закадаваныя сакрэты; публікуе падзеі абвесткі і піша справаздачу аб выніках.
previewЗапусціць згенераваную праграму лакальна і адлюстраваць яе жывы URL на панэлі запуску (спасылка + убудаваны фрэйм) праз падзею preview.ready.
design.importПераўтварыць выяву дызайну карыстальніцкага інтэрфейсу (скрыншот, макет, экспарт Figma) у структураваную спецыфікацыю рэалізацыі для наступных этапаў.

17.3 Агенты, кіраваныя падзеямі (сетка агентаў)

Кожны этап — незалежна ад тыпу — можа публікаваць і падпісвацца на тыпізаваныя падзеі ў шыне падзей працоўнай прасторы, так што агенты каардынуюцца як сэрвісы ў сетцы паведамленняў, а не толькі праз 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 Бібліятэка інструментаў агента

Этапы выбіраюць інструменты з таго ж рэестра, які выкарыстоўвае чат-агент:

17.5 Запуск, шлюзы і вывады

💡 Парада: Пачніце з шаблону Канвеер пастаўкі: ён звязвае дызайн → db.provision → рэалізацыю → згенераваныя тэсты → аўдыт бяспекі → упакоўку для разгортвання → генерацыю CI, з чалавечым шлюзам перад упакоўкай — поўны шлях ад брыфа да вытворчасці, які вы можаце адаптаваць за лічаныя хвіліны.

18 Прэдыкцыйнае аўтазапаўненне па Tab

Прэдыкцыйнае аўтазапаўненне па Tab прапануе ўбудаваныя падказкі кода з запаўненнем у сярэдзіне падчас уводу ў рэдактары — прыміце падказку з дапамогай Tab. Гэта добраахвотная функцыя як для рухавіка, так і для вэб-рэдактара.

Уключыць

Як гэта працуе

19 Выкарыстанне, крэдыты і выстаўленне рахункаў

Адкрыйце Billing з бакавой панэлі, каб кіраваць сваім планам і выкарыстаннем. Выкарыстанне AI вымяраецца ў крэдытах у доларах ЗША на аснове токенаў, спажытых базавымі мадэлямі.

ПланШтомесячная цанаУключанае штомесячнае выкарыстанне ШІ
Базавы$20$10
Прафесійны$75$30
Максімальны$200$150
💡 Эканомце на выкарыстанні: Выкарыстоўвайце аўтаматычны выбар мадэлі, прынясіце свой уласны ключ (BYOK) або запускайце лакальныя мадэлі, каб паменшыць або пазбегнуць выкарыстання з аплатай па лічыльніку.

20 Атрыманне ключа API шлюза

Ключ API шлюза (асабісты токен доступу) дазваляе вам праграмна выкарыстоўваць публічны API DeepCerebra і CLI.

  1. Увайдзіце і адкрыйце API Keys з бакавой панэлі.
  2. Пракруціце да DeepCerebra API Keys.
  3. Увядзіце метку (напрыклад, "CI pipeline" або "laptop CLI").
  4. Выберыце scopesread, chat, code, agent — і неабавязковы expiry ў днях (пуста = ніколі).
  5. Націсніце Generate. Поўны ключ паказваецца толькі адзін раз — націсніце Copy і захоўвайце яго надзейна.

Выкарыстоўвайце яго з 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/...

Вы можаце перайменаваць або выдаліць (ануляваць) ключ у любы час; кожны ключ паказвае свой прэфікс, scopes, created/expiry і last-used date.

⚠️ Захоўвайце ў сакрэце. Любы, хто мае ваш ключ, можа выкарыстоўваць ваш уліковы запіс і выклікаць выдаткі. Неадкладна анулюйце і згенеруйце яго зноў, калі ён калі-небудзь будзе раскрыты.

21 Бяспека і прыватнасць

22 Вырашэнне праблем

"Для загрузкі папкі патрэбен браўзер Chromium"

Пераключыцеся на Chrome, Edge або Brave, або выкарыстоўвайце замест гэтага Адкрыць з Git.

Агент зацыкліваецца на адной і той жа памылцы

Націсніце Спыніць, затым перафразируйце з канкрэтнай падказкай або абмежаваннем.

Памылкі мадэлі або запыту / "бюджэт вычарпаны"

Лакальныя мадэлі не з'яўляюцца

Канэктар: "сервер адхіліў злучэнне WebSocket: HTTP 401"

Мае змены не ўступілі ў сілу

Git: "Вы знаходзіцеся на галіне па змаўчанні"

Адкрыйце або стварыце працоўную галіну перад выкарыстаннем Інтэграваць для адкрыцця pull request.

Усё яшчэ не атрымліваецца? Звяжыцеся з support@deepcerebra.ai.

23 DeepCerebra Discovery — Запытвайце свае даныя і дакументы

Discovery — гэта даследчы чат-бот для вашых баз даных і дакументаў. Замест таго, каб адказваць адным запытам, ён працуе як аналітык: фармуе гіпотэзы, праводзіць шэраг кантраляваных зондаў (SQL, граф, пошук дакументаў, праверкі схемы, вэб-пацвярджэнне), адсякае тлумачэнні, якія абвяргаюцца доказамі, і сінтэзуе абгрунтаваны адказ — з дыяграмамі і празрыстай квітанцыяй аб кошце. Адкрыйце яго з значка компаса на панэлі актыўнасці (/app/discovery).

23.1 Прасторы — ваша курыраваная вобласць

Адна Прастора аб'ядноўвае ўсё, што неабходна для адной лініі запытаў: падключэнні да баз даных, калекцыі дакументаў, інструкцыі для аналітыка і бюджэты. Стварыце яе з дапамогай + Новая прастора, затым выкарыстоўвайце панэль налад справа, каб:

23.2 Заданне пытання

Увядзіце пытанне так, як вы б спыталі калегу — напрыклад "Why did MRI scan volume dip in March?". Дошка расследавання транслюе ўвесь працэс у прамым эфіры:

Наступныя пытанні працягваюць тую ж нітку, таму аналітык захоўвае свой кантэкст.

23.3 Дыяграмы, справаздачы і экспарт

Дыяграмы адлюстроўваюцца ўбудавана на дошцы расследавання. Выкарыстоўвайце Экспарт, каб спампаваць поўны запыт — адказ, гіпотэзы, доказы і дыяграмы — у выглядзе аўтаномнай HTML-справаздачы або якаснага для друку PDF, аформленага ў неонавым дызайне.

23.4 Бюджэты і кантроль выдаткаў

Кожная прастора мае бюджэты на запыт: максімальную колькасць зондаў, раўндаў расследавання, секунд і USD. Рухавік акуратна спыняецца па дасягненні ліміту і паведамляе, што ён знайшоў да гэтага часу. Кошт кожнага зонда падрабязна пазначаны ў квітанцыі, таму вы заўсёды ведаеце, куды пайшлі выдаткі.

23.5 Аўтаматызацыя: API, SDK, Workflow Studio і MCP