Hướng dẫn sử dụng
Hướng dẫn toàn diện, thực hành để xây dựng phần mềm với DeepCerebra Coder — web, desktop và CLI

📖 Mục lục

  1. Giới thiệu & Các phiên bản
  2. Bắt đầu & Tài khoản
  3. Tổng quan về Không gian làm việc
  4. Mở một dự án
  5. Làm việc với tệp
  6. Trò chuyện với Agent
  7. Bốn chế độ trò chuyện
  8. Xem xét & Áp dụng thay đổi
  9. Terminal tích hợp
  10. Chế độ lập kế hoạch & Thực thi
  11. Chọn mô hình & Tự động
  12. Mang khóa riêng của bạn (BYOK)
  13. Máy cục bộ: Mô hình GPU & Bảng điều khiển (DCC Bridge)
  14. Quy trình làm việc cộng tác Git
  15. Máy chủ MCP
  16. Tùy chỉnh Agent: Quy tắc, Kỹ năng, Hooks, Subagents & Plugins
  17. Agentic Workflow Studio & Agent điều khiển sự kiện
  18. Hoàn thành tab dự đoán
  19. Sử dụng, Tín dụng & Thanh toán
  20. Lấy khóa API Gateway của bạn
  21. Bảo mật & Quyền riêng tư
  22. Khắc phục sự cố

1 Giới thiệu & Các phiên bản

DeepCerebra Coder là một trợ lý mã hóa agentic. Không giống như một copilot tự động hoàn thành đơn thuần, nó lập kế hoạch, viết, tái cấu trúc, chạy lệnh, gọi công cụ và lặp lại trên toàn bộ dự án của bạn — với bạn xem xét và phê duyệt các thay đổi mà nó đề xuất.

Ba cách để sử dụng

Phiên bảnTốt nhất choTruy cập tệp
Ứng dụng webKhông cần cài đặt, làm việc từ bất kỳ máy nàoLưu trữ bảo mật trong trình duyệt (và kho lưu trữ Git)
Desktop (Windows / Linux / macOS)Phát triển ưu tiên cục bộ, mô hình cục bộHệ thống tệp cục bộ trực tiếp
CLI & APIViết script, CI/CD, tự động hóaTệp cục bộ / theo chương trình

Hướng dẫn này tập trung vào ứng dụng web tại deepcerebra.ai; ứng dụng desktop phản ánh các bảng điều khiển và quy trình làm việc tương tự.

2 Bắt đầu & Tài khoản

Trình duyệt được hỗ trợ

Sử dụng phiên bản hiện tại của Chrome, Edge, hoặc Brave để có trải nghiệm đầy đủ — việc mở một thư mục cục bộ dựa vào API Truy cập Hệ thống Tệp của Chromium. Firefox và Safari hoạt động cho trò chuyện và cho các dự án được hỗ trợ bởi Git, nhưng không thể mở trực tiếp một thư mục cục bộ.

Tạo tài khoản

  1. Nhấp vào Bắt đầu trên trang đích.
  2. Điền tên hiển thị (tùy chọn), email, quốc giangày sinh của bạn (bạn phải từ 18 tuổi trở lên).
  3. Chọn ngôn ngữ giao diệnmật khẩu có ít nhất 12 ký tự.
  4. Đọc thông báo thỏa thuận và xác nhận. Việc tạo tài khoản có nghĩa là bạn đồng ý với Điều khoản dịch vụ, Tuyên bố về quyền riêng tư, Mô tả dịch vụ, và DPA toàn cầu.
  5. Nhấp vào Tạo tài khoản, sau đó xác minh email của bạn nếu được nhắc, và đăng nhập.
💡 Mẹo: Bạn có thể chọn gói trong quá trình đăng ký bằng cách truy cập /register?plan=basic (hoặc pro / ultimate), hoặc bắt đầu ngay bây giờ và chọn gói sau trong Thanh toán.

Đặt lại mật khẩu của bạn

  1. Trên trang đăng nhập, nhấp vào Quên mật khẩu?
  2. Nhập email của bạn và mở liên kết đặt lại được gửi đến hộp thư đến của bạn.
  3. Đặt mật khẩu mới (tối thiểu 12 ký tự).
  4. DeepCerebra Discovery — Hỏi Dữ liệu & Tài liệu của bạn

3 Tổng quan về Không gian làm việc

Sau khi đăng nhập, bạn sẽ đến giao diện làm việc, nơi hiển thị mọi bảng điều khiển trên một màn hình:

Kéo thanh chia giữa trình chỉnh sửa và trò chuyện để cân bằng lại bố cục, và kéo thanh chia ngang để thay đổi kích thước terminal. Thanh bên trái cũng điều hướng đến Không gian làm việc, Tiện ích mở rộng, Khóa API, Thanh toán, và Phản hồi.

4 Mở một dự án

4.1 Mở một thư mục cục bộ

  1. Trong Explorer, nhấp vào Mở thư mục dự án.
  2. Chọn một thư mục và cấp quyền cho trình duyệt để đọc nó.
  3. Các tệp được đọc vào không gian làm việc được mã hóa trong trình duyệt của bạn — không có gì được tải lên. Bạn sẽ thấy số lượng trực tiếp và tóm tắt cuối cùng (số lượng tệp · kích thước, cộng với bất kỳ tệp nào bị bỏ qua hoặc cắt bớt).
⚠️ Hỗ trợ trình duyệt: Nếu bạn thấy thông báo rằng việc tải thư mục cần trình duyệt Chromium, hãy chuyển sang Chrome/Edge/Brave, hoặc sử dụng Mở từ Git thay thế.

4.2 Mở từ Git (GitHub / GitLab)

  1. Nhấp vào Mở từ Git trong Explorer.
  2. Chọn tab GitHub hoặc GitLab và dán mã thông báo truy cập cá nhân. Đối với GitHub, sử dụng phạm vi repo (cổ điển) hoặc mã thông báo chi tiết với Contents + Pull requests; đối với GitLab, sử dụng phạm vi api. Mã thông báo của bạn được lưu trữ trên máy chủ — chỉ nội dung tệp được kéo vào trình duyệt.
  3. Nhập kho lưu trữ dưới dạng owner/name (lọc danh sách để tìm của bạn), sau đó chọn một nhánh.
  4. Tùy chọn đánh dấu Tạo một nhánh làm việc mới (ví dụ: dcc/my-feature) để giữ công việc của bạn tách biệt khỏi nhánh mặc định.
  5. Tùy chọn bật push webhook để Explorer làm mới ngay lập tức khi đồng đội push (cần một URL gateway công khai).
  6. Nhấp vào Mở kho lưu trữ.

4.3 Làm mới, chuyển đổi và đóng

4.4 Phiên trò chuyện theo thư mục

Lịch sử trò chuyện được gắn với dự án đang mở. Việc chuyển đổi thư mục tự động bắt đầu một phiên mới và tải các phiên trước đó của thư mục đó, mở lại phiên gần đây nhất để bạn có thể tiếp tục công việc dang dở.

4.5 Thư mục hoạt động

Các thư mục DeepCerebra sử dụng nội bộ — .deepcerebra, .sessions — xuất hiện trong cây nhưng mặc định được thu gọn để chúng không làm lộn xộn mã nguồn của bạn.

5 Làm việc với tệp

6 Trò chuyện với Agent

Viết một yêu cầu

Mô tả những gì bạn muốn bằng ngôn ngữ đơn giản — đặt câu hỏi, yêu cầu một tính năng hoặc chỉ ra một lỗi. Hãy cụ thể về các tệp, framework và ràng buộc để có kết quả tốt nhất. Đính kèm các tệp liên quan bằng cách kéo chúng vào ô nhập.

Đọc phản hồi, kiểu Cursor

Các phản hồi được tổ chức giống như Cursor: lý do của agent được tách biệt khỏi sản phẩm bàn giao. Mỗi khối phản hồi có một biểu tượng sao chép ở góc trên bên phải để bạn có thể sao chép một báo cáo, tài liệu đã hoàn thành hoặc một lệnh mà bạn được yêu cầu chạy.

Điều khiển hoặc dừng một lần chạy

💡 Mẹo (desktop): Trong ứng dụng desktop, bạn gọi agent trong trò chuyện bằng @deepcerebra, và các tiền tố như [deep] yêu cầu lý luận sâu hơn.

7 Bốn chế độ trò chuyện

Chọn một chế độ từ bộ chọn chế độ bên cạnh lời nhắc. Mỗi chế độ điều chỉnh mức độ agent lập kế hoạch và mức độ tự do chỉnh sửa:

Chế độNó làm gìSử dụng khi…
AgentLập kế hoạch và chỉnh sửa trên toàn bộ dự án của bạn một cách tự độngBạn muốn trợ lý thực hiện một thay đổi từ đầu đến cuối
AskTrả lời các câu hỏi về mã của bạn mà không chỉnh sửaBạn muốn hiểu cơ sở mã
PlanPhác thảo một cách tiếp cận trước khi chỉnh sửaNhiệm vụ lớn hoặc có những đánh đổi cần giải quyết trước
EditThực hiện các chỉnh sửa tập trung trong ngữ cảnh hiện tạiBạn muốn một thay đổi nhỏ, có mục tiêu

8 Xem xét & Áp dụng thay đổi

Khi agent đề xuất thay đổi tệp, một bảng điều khiển Thay đổi được đề xuất xuất hiện phía trên ô nhập trò chuyện, liệt kê từng tệp đã chạm đến với số lượng dòng được thêm (+) và xóa (−).

⚠️ Luôn xem xét: Mã do AI tạo ra có thể chứa lỗi hoặc các mẫu không an toàn. Hãy xem xét diff và kiểm tra trước khi tin cậy hoặc triển khai nó.

9 Terminal tích hợp

Bật/tắt terminal bên dưới trình chỉnh sửa để chạy các bản dựng, kiểm thử và script. Với sự cho phép của bạn, agent có thể thực thi các lệnh và đọc đầu ra của chúng để xác minh công việc của nó; các lệnh chạy dài sẽ truyền đầu ra để bạn có thể theo dõi tiến độ. Đóng terminal từ tiêu đề của nó khi bạn không cần.

10 Chế độ lập kế hoạch & Thực thi

Đối với các mục tiêu lớn hơn, hãy sử dụng chế độ Plan (hoặc yêu cầu agent lập kế hoạch trước). Công cụ lập kế hoạch quét dự án của bạn, phân tách mục tiêu thành các nhiệm vụ nhận biết sự phụ thuộc và gán từng nhiệm vụ cho chuyên gia phù hợp (kiến trúc sư, lập trình viên, người kiểm thử, tài liệu).

11 Chọn mô hình & Tự động

Mở bộ chọn mô hình bên cạnh lời nhắc. Các tùy chọn được nhóm như sau:

Cách hoạt động của lựa chọn tự động

Trên Auto, DeepCerebra sử dụng định tuyến phân cấp, thích ứng: các tác vụ đơn giản được chuyển đến một mô hình nhanh, tiết kiệm, trong khi công việc phức tạp hoặc nặng về lập kế hoạch (ví dụ: chế độ Plan) được định tuyến đến một mô hình mạnh hơn. Điều này cân bằng chi phí và chất lượng tự động, vì vậy bạn hiếm khi cần chọn thủ công.

12 Tự mang khóa của bạn (BYOK)

Bạn có thể định tuyến các yêu cầu thông qua tài khoản nhà cung cấp của riêng bạn thay vì sử dụng nền tảng được tính phí.

  1. Mở Khóa API từ thanh bên.
  2. Trong Tự mang khóa của bạn, chọn một nhà cung cấp (ví dụ: ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
  3. Dán giá trị khóa và nhấp vào Lưu. Các khóa được mã hóa khi lưu trữ và không bao giờ được trả về trình duyệt — chỉ hiển thị bản xem trước đã che.

Các mô hình nền tảng (DeepCerebra) không cần khóa. Xóa khóa bất cứ lúc nào bằng Xóa.

13 Máy cục bộ: Mô hình GPU & Console (DCC Bridge)

DCC Bridge kết nối máy tính của riêng bạn với ứng dụng web thông qua một trình kết nối dcc-bridge nhỏ, mở khóa hai khả năng cùng một lúc:

Trình kết nối quay số ra ngoài qua một WebSocket được xác thực — không cần cổng vào, và nó hoạt động phía sau NAT và firewalls. Nó chạy trên Windows, macOS, và Linux (Python 3.10+).

13.1 Ghép nối máy tính của bạn

  1. Nhấp vào biểu tượng máy tính xách tay trong thanh hoạt động bên trái — Máy cục bộ (GPU + Console). (Bảng điều khiển tương tự mở từ chân trang bộ chọn mô hình qua Quản lý GPU cục bộ….)
  2. Đảm bảo nút bật tắt Thực thi cục bộ được bật, đặt tên thiết bị và nhấp vào Thêm máy tính này. Sao chép mã thông báo ghép nối một lần (dcc_brg_…) và lệnh trình kết nối sẵn sàng dán — mã thông báo chỉ hiển thị chính xác một lần.

13.2 Cài đặt & chạy trình kết nối

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 Sử dụng console của bạn từ ứng dụng web

Theo mặc định, các lệnh được giới hạn trong một thư mục không gian làm việc chuyên dụng (~/DeepCerebra). Để làm việc trong các thư mục dự án thực của bạn với các CLI đã cấu hình sẵn, hãy cấp quyền rõ ràng cho chúng khi khởi động trình kết nối:

# 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

Sau đó mở bảng điều khiển Terminal, nhấp vào cửa sổ bật lên Mục tiêu thực thi (biểu tượng máy tính xách tay), chọn Máy tính của tôi, và chọn một thư mục làm việc. Cả các lệnh bạn gõ và các lệnh xây dựng/kiểm thử của agent sau đó được thực thi trên máy của bạn.

⚠️ Bảo mật: quyền truy cập máy chủ không bao giờ vượt quá các thư mục bạn đã liệt kê trên dòng lệnh trình kết nối; mã thông báo được băm khi lưu trữ và có thể thu hồi bất cứ lúc nào; --no-exec làm cho một thiết bị chỉ suy luận (mô hình GPU, không có lệnh).
💡 Mẹo: Ứng dụng desktop có thể sử dụng các mô hình cục bộ trực tiếp mà không cần trình kết nối. Tham khảo trình kết nối đầy đủ: github.com/mohammadkhair7/DeepCerebra-connector.

14 Quy trình làm việc cộng tác Git

Với một dự án được hỗ trợ bởi Git đang mở, một thanh nhánh xuất hiện trong Explorer hiển thị nhánh hiện tại của bạn và hai hành động:

Nếu push webhook được bật, Explorer tự động làm mới khi đồng đội push, giữ mọi người đồng bộ — nền tảng cho phát triển nhóm cộng tác thông qua DeepCerebra.

15 Máy chủ MCP

Mở rộng agent với các công cụ và dữ liệu bên ngoài thông qua Giao thức Ngữ cảnh Mô hình. Cấu hình máy chủ trong tệp .deepcerebra/mcp.json, ví dụ:

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

Các công cụ MCP được bật sẽ tự động có sẵn cho agent khi chúng liên quan đến yêu cầu của bạn. Máy chủ cục bộ (stdio) và từ xa (http/sse) đều được hỗ trợ.

An toàn tích hợp

Tài nguyên & lời nhắc

Nếu một máy chủ hiển thị tài nguyên MCP hoặc mẫu lời nhắc, agent tự động có được các công cụ để sử dụng chúng (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt).

Xác thực cho máy chủ từ xa

Thêm một khối auth vào một máy chủ từ xa. Bí mật hỗ trợ nội suy ${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 Tùy chỉnh Agent: Quy tắc, Kỹ năng, Hooks, Subagents & Plugins

Bạn có thể định hình cách agent suy nghĩ và hành động với một quy ước dựa trên tệp duy nhất — thư mục .deepcerebra/ — hoạt động giống hệt nhau trong ứng dụng desktop, ứng dụng web, và API. Trong ứng dụng web, quản lý tất cả những điều này dưới chế độ xem Agent; trên desktop và qua API, chúng là các tệp đơn giản mà bạn commit cùng với dự án của mình.

Phạm vi & độ ưu tiên

Cấu hình được khám phá từ một số phạm vi; khi cùng một mục tồn tại ở nhiều hơn một phạm vi, phạm vi có độ ưu tiên cao hơn sẽ thắng:

team/org  <  global (~/.deepcerebra)  <  workspace (<repo>/.deepcerebra)
(thấp nhất)                                              (cao nhất)

Quy tắc (điều hướng)

Các quy tắc là các hướng dẫn cố định — tiêu chuẩn mã hóa, quy ước kiến trúc, ngữ cảnh miền — được đưa vào lời nhắc hệ thống của agent. Chúng tồn tại dưới dạng tệp Markdown trong .deepcerebra/steering/, cộng với tiêu chuẩn AGENTS.md luôn bật. Frontmatter kiểm soát khi nào một quy tắc được tải:

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

Một AGENTS.md gốc áp dụng cho toàn bộ kho lưu trữ; một AGENTS.md lồng nhau (ví dụ: services/api/AGENTS.md) chỉ áp dụng cho các tệp trong thư mục đó. Trong ứng dụng web, chế độ xem Agent → Steering cung cấp cho mỗi quy tắc một bộ chọn Phạm vi (Toàn cầu / Dự án / Nhóm).

Kỹ năng

Kỹ năng là các playbook có thể tái sử dụng mà agent tải theo yêu cầu. Mỗi kỹ năng là một thư mục với một tệp SKILL.md trong .deepcerebra/skills/:

---
name: deploy-release
description: How to cut and publish a versioned release.
disable-model-invocation: false   # true => manual-only (/skill)
---
# Deploy a release
1. Bump the version, build, and test.
2. Tag and publish.

Agent thấy một danh mục nhẹ (tên + mô tả) và kéo toàn bộ nội dung với công cụ load_skill khi có liên quan. Bạn cũng có thể gọi một cách rõ ràng bằng /skill <name>. Đặt disable-model-invocation: true để làm cho một kỹ năng chỉ có thể gọi thủ công.

Hooks

Hooks chạy tự động hóa trên các sự kiện vòng đời. Định nghĩa chúng dưới dạng .deepcerebra/hooks/*.hook.json:

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

Các sự kiện bao gồm promptSubmit, preToolUse, postToolUse, fileCreate, fileSave, fileDelete, preTask, postTask, sessionStart, preCompact, và agentStop (cũng chấp nhận các cách viết của Cursor/Claude). Một hành động là shell (chạy một lệnh) hoặc agentPrompt (hỏi agent). Một hook preToolUse có thể allow, deny, hoặc ask cho cuộc gọi công cụ mà nó chặn.

Subagents

Subagents là các agent chuyên gia mà bạn định nghĩa và ủy quyền. Mỗi subagent là một tệp Markdown trong .deepcerebra/agents/ với frontmatter cộng với một nội dung (lời nhắc hệ thống của nó):

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

Agent chính ủy quyền với task (chặn), task_async + task_status / task_result (nền), hoặc task_parallel (phân tán).

Plugins

Một plugin gói các quy tắc, kỹ năng, hooks, subagents và máy chủ MCP vào một gói có thể cài đặt trong .deepcerebra/plugins/<name>/, được mô tả bởi một tệp kê khai plugin.json:

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

Nội dung plugin được hợp nhất ở độ ưu tiên thấp nhất, vì vậy các quy tắc và kỹ năng của riêng bạn luôn ghi đè lên của plugin. Tắt một plugin bằng "enabled": false hoặc một tệp đánh dấu .disabled.

💡 Mẹo: Một nhóm có thể xuất bản các cài đặt mặc định được chia sẻ bằng cách trỏ DCC_ORG_CONFIG_DIR vào một thư mục .deepcerebra được chia sẻ, hoặc bằng cách đặt các quy tắc vào phạm vi Team trong ứng dụng web.

17 Studio quy trình làm việc Agentic & Agent điều khiển bằng sự kiện

Workflow Studio là một công cụ thiết kế trực quan cho tự động hóa đa agent. Bạn kết hợp các giai đoạn — mỗi giai đoạn là một agent, một bước chuyên biệt hoặc một nguyên thủy điều khiển — thành một đồ thị, kết nối chúng với các phụ thuộc, và chạy toàn bộ quá trình điều phối trên engine với tiến độ trực tiếp theo từng giai đoạn, ngân sách, và cổng phê duyệt của con người. Các quy trình làm việc được lưu dưới dạng định nghĩa YAML/JSON di động mà bạn có thể xuất, nhập, phiên bản trong Git, và chạy từ API hoặc CLI.

17.1 Xây dựng một quy trình làm việc

17.2 Thư viện giai đoạn

Loại giai đoạnNó làm gì
agentMột lượt agent với các kỹ năng và công cụ bạn đính kèm.
spec.requirements / spec.design / spec.execute Phân phối ưu tiên đặc tả: phác thảo yêu cầu, thiết kế, sau đó chia thành các nhiệm vụ và thực thi — mỗi nhiệm vụ có thể được kiểm soát bằng cổng.
documents.generateTạo một tài liệu hoàn chỉnh từ các đầu ra của giai đoạn trước.
fan_outNghiên cứu rộng song song trên nhiều chủ đề phụ với tổng hợp.
map / loop / switch Các nguyên thủy điều khiển: chạy một khối cho mỗi mục, lặp lại cho đến khi một điều kiện, hoặc phân nhánh qua các trường hợp.
verify / browser_verify Chạy kiểm thử hoặc lệnh trong sandbox; xác minh giao diện người dùng đang chạy với tự động hóa trình duyệt.
orchestrateĐịnh tuyến động: một agent điều phối đọc yêu cầu và phân phối nó đến (các) agent hạ nguồn tốt nhất qua các sự kiện.
external.agentGọi một agent bên thứ ba đã đăng ký qua HTTP (A2A) như thể nó là một giai đoạn gốc.
evalChấm điểm đầu ra thượng nguồn so với các kiểm tra (chứa / regex / độ dài / LLM-judge); thất bại dưới một ngưỡng.
db.provisionTạo một lớp dữ liệu sở hữu: docker-compose cho cơ sở dữ liệu, di chuyển SQL có phiên bản, dữ liệu hạt giống, mẫu .env, và một Mermaid ERD; giàn giáo xác thực tùy chọn; có thể áp dụng di chuyển cho SQLite ngay lập tức.
ci.generateTạo một pipeline CI/CD sẵn sàng commit (GitHub Actions, GitLab CI, hoặc Azure Pipelines) với lint → test → scan → build → deploy và quảng bá môi trường.
deploy.packageTạo các tài sản triển khai sản xuất: Dockerfile đa giai đoạn, docker-compose, Kubernetes manifests, hoặc một Helm chart — các tệp bạn sở hữu và commit.
test.generateTạo các bộ unit / API / E2E cho ứng dụng đã xây dựng cộng với một ma trận truy xuất nguồn gốc yêu cầu-đến-kiểm thử.
test.verifyThực thi một bộ kiểm thử (pytest, vitest, jest, Playwright) và kiểm soát lần chạy dựa trên tỷ lệ đạt của nó.
security.auditQuét các phụ thuộc để tìm các lỗ hổng đã biết và cây để tìm các bí mật được mã hóa cứng; xuất bản các sự kiện cảnh báo và viết báo cáo phát hiện.
previewKhởi động ứng dụng đã tạo cục bộ và hiển thị URL trực tiếp của nó trong bảng điều khiển chạy (liên kết + khung nội tuyến) qua một sự kiện preview.ready.
design.importBiến một hình ảnh thiết kế UI (ảnh chụp màn hình, mockup, xuất Figma) thành một đặc tả triển khai có cấu trúc cho các giai đoạn hạ nguồn.

17.3 Agent điều khiển bằng sự kiện (lưới agent)

Mọi giai đoạn — bất kể loại nào — đều có thể xuất bảnđăng ký các sự kiện có kiểu trên bus sự kiện không gian làm việc, để các agent phối hợp như các dịch vụ trên một cấu trúc thông điệp thay vì chỉ thông qua DAG:

17.3.1 Hàng đợi sự kiện cho agent

Các agent phản ứng với các sự kiện có thể khai báo một hàng đợi có tên bền vững để các sự kiện khớp không bao giờ bị mất khi agent bận hoặc trước khi một lần chạy đang lắng nghe. Trên một đăng ký trigger, đặt queue: <name> — engine liên kết chủ đề đó với một hàng đợi FIFO trên bus sự kiện không gian làm việc (được lưu trữ dưới .deepcerebra/workflows/events/queues/). Mọi sự kiện khớp được xuất bản từ thời điểm đó được ghi vào hàng đợi; khi giai đoạn trở nên có thể chạy, engine lấy các sự kiện theo thứ tự cũ nhất trước và tiêu thụ chúng từng cái một.

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 Điều phối Semaphore (bảo vệ tài nguyên chia sẻ)

Một semaphore giới hạn số lượng tác vụ có thể đồng thời hoạt động trên một tài nguyên chia sẻ (được bảo vệ): một cơ sở dữ liệu đang được ghi, một kho biến toàn cục, một tệp hoặc một agent bên ngoài bị giới hạn tốc độ. Đính kèm một semaphore vào bất kỳ giai đoạn nào với semaphore: — trước khi công việc của giai đoạn chạy, engine sẽ lấy một quyền của semaphore không gian làm việc được đặt tên; quyền này luôn được giải phóng sau đó, ngay cả khi giai đoạn thất bại. permits: 1 biến nó thành một mutex: chỉ một tác vụ tại một thời điểm (trên tất cả các lần chạy song song trong không gian làm việc) thực thi bước quan trọng; mọi tác vụ khác chờ cho đến khi người giữ hoàn thành.

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 Điều phối Rendezvous (chờ tất cả các điều kiện)

Rendezvous chờ cho đến khi nhiều điều kiện sự kiện đều được đáp ứng trước khi bước tiếp theo được thực hiện — ngược lại với nguyên tắc "sự kiện đầu tiên thắng cuộc." Đặt join: all trong khối events: của giai đoạn: mọi đăng ký kích hoạt phải được đáp ứng trước khi giai đoạn chạy. Kết hợp với count: N cho mỗi đăng ký khi nhiều tác nhân (hoặc nhiều báo cáo từ một tác nhân) đều phải xác nhận — ví dụ, phê duyệt thiết kế, hoàn thành kiểm thử và chấp thuận bảo mật trước khi một giai đoạn phát hành được thực hiệ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 Thư viện công cụ agent

Các giai đoạn chọn công cụ từ cùng một registry mà agent trò chuyện sử dụng:

17.5 Chạy, cổng và đầu ra

💡 Mẹo: Bắt đầu với mẫu Ship-It Pipeline: nó nối chuỗi thiết kế → db.provision → triển khai → kiểm thử được tạo → kiểm toán bảo mật → đóng gói triển khai → tạo CI, với một cổng người trước khi đóng gói — một đường dẫn hoàn chỉnh từ tóm tắt đến sản xuất mà bạn có thể điều chỉnh trong vài phút.

18 Hoàn thành tab dự đoán

Hoàn thành tab dự đoán cung cấp các gợi ý mã nội tuyến, điền vào giữa khi bạn gõ trong trình chỉnh sửa — chấp nhận một gợi ý bằng Tab. Nó là tùy chọn trên cả engine và trình chỉnh sửa web.

Bật nó

Cách nó hoạt động

19 Sử dụng, Tín dụng & Thanh toán

Mở Thanh toán từ thanh bên để quản lý gói và mức sử dụng của bạn. Mức sử dụng AI được tính bằng tín dụng đô la Mỹ dựa trên số token được tiêu thụ bởi các mô hình cơ bản.

GóiGiá hàng thángMức sử dụng AI hàng tháng đi kèm
Basic$20$10
Pro$75$30
Ultimate$200$150
💡 Tiết kiệm chi phí sử dụng: Sử dụng lựa chọn mô hình Auto, tự mang khóa của bạn (BYOK), hoặc chạy các mô hình cục bộ để giảm hoặc tránh mức sử dụng được tính phí.

20 Lấy khóa API Gateway của bạn

Khóa API gateway (mã thông báo truy cập cá nhân) cho phép bạn sử dụng API công khai của DeepCerebra và CLI theo chương trình.

  1. Đăng nhập và mở Khóa API từ thanh bên.
  2. Cuộn đến Khóa API DeepCerebra.
  3. Nhập một nhãn (ví dụ: "CI pipeline" hoặc "laptop CLI").
  4. Chọn phạm viread, chat, code, agent — và một thời hạn sử dụng tùy chọn theo ngày (để trống = không bao giờ).
  5. Nhấp vào Tạo. Khóa đầy đủ chỉ hiển thị một lần duy nhất — nhấp vào Sao chép và lưu trữ nó một cách an toàn.

Sử dụng nó với CLI hoặc API tại 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/...

Bạn có thể đổi tên hoặc xóa (thu hồi) khóa bất cứ lúc nào; mỗi khóa hiển thị tiền tố, phạm vi, ngày tạo/hết hạn và ngày sử dụng cuối cùng.

⚠️ Giữ bí mật. Bất kỳ ai có khóa của bạn đều có thể sử dụng tài khoản của bạn và phát sinh chi phí sử dụng. Thu hồi và tạo lại ngay lập tức nếu nó bị lộ.

21 Bảo mật & Quyền riêng tư

22 Khắc phục sự cố

"Tải thư mục cần trình duyệt Chromium"

Chuyển sang Chrome, Edge, hoặc Brave, hoặc sử dụng Mở từ Git thay thế.

Agent lặp lại cùng một lỗi

Nhấp vào Dừng, sau đó diễn đạt lại với một gợi ý hoặc ràng buộc cụ thể.

Lỗi mô hình hoặc yêu cầu / "ngân sách cạn kiệt"

Các mô hình cục bộ không xuất hiện

Trình kết nối: "máy chủ từ chối kết nối WebSocket: HTTP 401"

Các thay đổi của tôi không có hiệu lực

Git: "Bạn đang ở trên nhánh mặc định"

Mở hoặc tạo một nhánh làm việc trước khi sử dụng Tích hợp để mở một pull request.

Vẫn gặp khó khăn? Liên hệ support@deepcerebra.ai.

23 DeepCerebra Discovery — Hỏi Dữ liệu & Tài liệu của bạn

Discovery là một chatbot điều tra dành cho các cơ sở dữ liệu và tài liệu của bạn. Thay vì trả lời bằng một truy vấn duy nhất, nó hoạt động như một nhà phân tích: nó hình thành các giả thuyết, chạy một loạt các thăm dò được bảo vệ (SQL, đồ thị, tìm kiếm tài liệu, kiểm tra lược đồ, xác nhận web), loại bỏ các giải thích mà bằng chứng bác bỏ, và tổng hợp một câu trả lời có căn cứ — kèm theo biểu đồ và một biên lai chi phí minh bạch. Mở nó từ biểu tượng la bàn trong thanh hoạt động (/app/discovery).

23.1 Không gian — phạm vi được quản lý của bạn

Một Không gian gói gọn mọi thứ mà một chuỗi câu hỏi cần: kết nối cơ sở dữ liệu, bộ sưu tập tài liệu, hướng dẫn cho nhà phân tích và ngân sách. Tạo một không gian bằng cách nhấp vào + Không gian mới, sau đó sử dụng bảng thiết lập ở bên phải để:

23.2 Đặt câu hỏi

Gõ một câu hỏi theo cách bạn hỏi một đồng nghiệp — ví dụ: "Tại sao khối lượng quét MRI giảm vào tháng 3?". Bảng điều tra hiển thị toàn bộ quá trình trực tiếp:

Các câu hỏi tiếp theo tiếp tục cùng một luồng, vì vậy nhà phân tích giữ được ngữ cảnh của nó.

23.3 Biểu đồ, báo cáo & xuất khẩu

Biểu đồ hiển thị trực tiếp trên bảng điều tra. Sử dụng Xuất khẩu để tải xuống toàn bộ yêu cầu — câu trả lời, giả thuyết, bằng chứng và biểu đồ — dưới dạng báo cáo HTML độc lập hoặc một PDF chất lượng in, được tạo kiểu với hệ thống thiết kế neon.

23.4 Ngân sách & kiểm soát chi phí

Mỗi không gian có ngân sách cho mỗi yêu cầu: số lượng thăm dò tối đa, số vòng điều tra, số giây và USD. Engine dừng lại gọn gàng khi đạt giới hạn và báo cáo những gì nó đã tìm thấy cho đến nay. Chi phí của mỗi thăm dò được liệt kê chi tiết trên biên lai, vì vậy bạn luôn biết chi tiêu đã đi đâu.

23.5 Tự động hóa: API, SDK, Workflow Studio & MCP