მომხმარებლის სახელმძღვანელო
სრული, პრაქტიკული სახელმძღვანელო 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. თქვენი Gateway API გასაღების მიღება
  21. უსაფრთხოება და კონფიდენციალურობა
  22. პრობლემების მოგვარება
  23. DeepCerebra Discovery — ჰკითხეთ თქვენს მონაცემებს & დოკუმენტებს

1 შესავალი და გამოცემები

DeepCerebra Coder არის აგენტური კოდირების ასისტენტი. ჩვეულებრივი ავტომატური შევსების კოპილოტისგან განსხვავებით, ის გეგმავს, წერს, რეფაქტორინგს უკეთებს, ასრულებს ბრძანებებს, იძახებს ხელსაწყოებს და იმეორებს მოქმედებებს თქვენს მთელ პროექტზე — თქვენ განიხილავთ და ამტკიცებთ მის მიერ შემოთავაზებულ ცვლილებებს.

გამოყენების სამი გზა

გამოცემასაუკეთესოაფაილზე წვდომა
ვებ აპლიკაციაინსტალაციის გარეშე, იმუშავეთ ნებისმიერი მანქანიდანკონფიდენციალური ბრაუზერში შენახვა (და Git რეპოზიტორები)
დესკტოპი (Windows / Linux / macOS)ლოკალური განვითარება, ლოკალური მოდელებიპირდაპირი ლოკალური ფაილური სისტემა
CLI & APIსკრიპტინგი, CI/CD, ავტომატიზაციალოკალური ფაილები / პროგრამული

ეს სახელმძღვანელო ფოკუსირებულია ვებ აპლიკაციაზე deepcerebra.ai; დესკტოპის აპლიკაცია ასახავს იგივე პანელებსა და სამუშაო პროცესებს.

2 დაწყება და ანგარიში

მხარდაჭერილი ბრაუზერები

გამოიყენეთ მიმდინარე ვერსია Chrome, Edge, or 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. Explorer-ში დააწკაპუნეთ პროექტის საქაღალდის გახსნა.
  2. აირჩიეთ საქაღალდე და მიანიჭეთ ბრაუზერს მისი წაკითხვის ნებართვა.
  3. ფაილები იკითხება თქვენი ბრაუზერის დაშიფრულ ბრაუზერში არსებულ სამუშაო სივრცეში — არაფერი იტვირთება. თქვენ ნახავთ ცოცხალ რაოდენობას და საბოლოო შეჯამებას (ფაილების რაოდენობა · ზომა, პლუს ნებისმიერი გამოტოვებული ან დამოკლებული ფაილი).
⚠️ ბრაუზერის მხარდაჭერა: თუ ხედავთ შენიშვნას, რომ საქაღალდის ჩატვირთვას სჭირდება Chromium ბრაუზერი, გადადით Chrome/Edge/Brave-ზე, ან გამოიყენეთ გახსნა Git-დან.

4.2 გახსნა Git-დან (GitHub / GitLab)

  1. Explorer-ში დააწკაპუნეთ გახსნა Git-დან.
  2. აირჩიეთ GitHub ან GitLab ჩანართი და ჩასვით პირადი წვდომის ნიშანი. GitHub-ისთვის გამოიყენეთ repo არე (კლასიკური) ან დეტალური ნიშანი Contents + Pull requests-ით; GitLab-ისთვის გამოიყენეთ api არე. თქვენი ნიშანი ინახება სერვერზე — ბრაუზერში მხოლოდ ფაილის შიგთავსი იტვირთება.
  3. ჩაწერეთ რეპოზიტორიუმი როგორც owner/name (გაფილტრეთ სია თქვენის საპოვნელად), შემდეგ აირჩიეთ ფილიალი.
  4. სურვილისამებრ მონიშნეთ ახალი სამუშაო ფილიალის შექმნა (მაგ. dcc/my-feature) თქვენი სამუშაოს ნაგულისხმევი ფილიალისგან იზოლირებულად შესანარჩუნებლად.
  5. სურვილისამებრ ჩართეთ push webhook, რათა Explorer მყისიერად განახლდეს, როდესაც თანაგუნდელები push-ს გააკეთებენ (საჭიროა საჯარო gateway URL).
  6. დააწკაპუნეთ რეპოზიტორიუმის გახსნა.

4.3 განახლება, გადართვა და დახურვა

4.4 საქაღალდეზე მიბმული ჩეთის სესიები

ჩეთის ისტორია დაკავშირებულია ღია პროექტთან. საქაღალდეების შეცვლა ავტომატურად იწყებს ახალ სესიას და ტვირთავს ამ საქაღალდის წინა სესიებს, ხელახლა ხსნის უახლესს, რათა შეძლოთ გაგრძელება იქიდან, სადაც შეჩერდით.

4.5 ოპერაციული საქაღალდეები

DeepCerebra-ს მიერ შიდა გამოყენებისთვის განკუთვნილი საქაღალდეები — .deepcerebra, .sessions — გამოჩნდება ხეში, მაგრამ ნაგულისხმევად ჩაკეცილია, რათა არ დააბინძუროს თქვენი წყარო.

5 ფაილებთან მუშაობა

6 აგენტთან ჩეთი

მოთხოვნის დაწერა

აღწერეთ, რა გსურთ მარტივი ენით — დასვით შეკითხვა, მოითხოვეთ ფუნქცია, ან მიუთითეთ შეცდომაზე. იყავით კონკრეტული ფაილების, ფრეიმვორკების და შეზღუდვების შესახებ საუკეთესო შედეგის მისაღებად. დაურთეთ შესაბამისი ფაილები მათი მოთხოვნაში გადათრევით.

პასუხების წაკითხვა, Cursor-ის სტილში

პასუხები ორგანიზებულია Cursor-ის მსგავსად: აგენტის მსჯელობა გამოყოფილია შესრულებადი ნაწილისგან. თითოეულ საპასუხო ბლოკს აქვს კოპირების ხატულა ზედა მარჯვენა კუთხეში, რათა შეძლოთ დასრულებული ანგარიშის, დოკუმენტის ან ბრძანების კოპირება, რომელიც უნდა გაუშვათ.

გაშვების მართვა ან შეჩერება

💡 რჩევა (დესკტოპი): დესკტოპის აპლიკაციაში აგენტს ჩატში გამოიძახებთ @deepcerebra-ით, და პრეფიქსები, როგორიცაა [deep], ითხოვენ უფრო ღრმა მსჯელობას.

7 ჩეთის ოთხი რეჟიმი

აირჩიეთ რეჟიმი რეჟიმის ამომრჩევიდან მოთხოვნის გვერდით. თითოეული არეგულირებს, თუ რამდენად გეგმავს აგენტი და რამდენად თავისუფლად რედაქტირებს:

რეჟიმირას აკეთებსგამოიყენეთ როდესაც…
აგენტიგეგმავს და რედაქტირებს თქვენს პროექტში ავტონომიურადგსურთ, რომ ასისტენტმა განახორციელოს ცვლილება ბოლოდან ბოლომდე
კითხვაპასუხობს შეკითხვებს თქვენი კოდის შესახებ რედაქტირების გარეშეგსურთ კოდის ბაზის გაგება
დაგეგმვაქმნის მიდგომას ნებისმიერი რედაქტირებამდეამოცანა დიდია ან აქვს კომპრომისები, რომლებიც ჯერ უნდა გადაწყდეს
რედაქტირებაახორციელებს მიზანმიმართულ რედაქტირებას მიმდინარე კონტექსტშიგსურთ მცირე, მიზანმიმართული ცვლილება

8 ცვლილებების განხილვა და გამოყენება

როდესაც აგენტი ფაილის ცვლილებებს გვთავაზობს, ჩეთის შეყვანის ზემოთ ჩნდება პანელი შემოთავაზებული ცვლილებები, რომელიც ჩამოთვლის თითოეულ შეცვლილ ფაილს დამატებული (+) და წაშლილი (−) ხაზების რაოდენობით.

⚠️ ყოველთვის გადაამოწმეთ: AI-ის მიერ გენერირებულ კოდს შეიძლება ჰქონდეს შეცდომები ან არაუსაფრთხო შაბლონები. გადახედეთ diff-ს და შეამოწმეთ, სანამ დაეყრდნობით ან განათავსებთ მას.

9 ინტეგრირებული ტერმინალი

გადართეთ ტერმინალი რედაქტორის ქვემოთ, რათა გაუშვათ build-ები, ტესტები და სკრიპტები. თქვენი ავტორიზაციით, აგენტს შეუძლია ბრძანებების შესრულება და მათი გამოსავლის წაკითხვა თავისი მუშაობის გადასამოწმებლად; ხანგრძლივი ბრძანებები გამოსავალს ნაკადად აჩვენებენ, რათა თვალყური ადევნოთ პროგრესს. დახურეთ ტერმინალი მისი სათაურიდან, როცა აღარ გჭირდებათ.

10 დაგეგმვის რეჟიმი და შესრულება

უფრო დიდი მიზნებისთვის გამოიყენეთ დაგეგმვის რეჟიმი (ან სთხოვეთ აგენტს, ჯერ დაგეგმოს). დამგეგმავი სკანირებს თქვენს პროექტს, მიზანს ყოფს დამოკიდებულებების გათვალისწინებით ამოცანებად და თითოეულს შესაბამის სპეციალისტს (არქიტექტორს, პროგრამისტს, ტესტერს, დოკუმენტაციის სპეციალისტს) უნიშნავს.

11 მოდელების არჩევა და ავტომატური რეჟიმი

გახსენით მოდელის ამომრჩევი მოთხოვნის გვერდით. პარამეტრები დაჯგუფებულია შემდეგნაირად:

როგორ მუშაობს ავტომატური შერჩევა

ავტომატურ რეჟიმში, DeepCerebra იყენებს მრავალდონიან, ადაპტირებულ მარშრუტიზაციას: მარტივი ამოცანები მიდის სწრაფ, ეკონომიურ მოდელზე, ხოლო რთული ან დაგეგმვაზე ორიენტირებული სამუშაო (მაგალითად, დაგეგმვის რეჟიმი) მიმართულია უფრო ძლიერ მოდელზე. ეს ავტომატურად აბალანსებს ღირებულებასა და ხარისხს, ასე რომ იშვიათად გჭირდებათ ხელით არჩევა.

12 მოიტანეთ საკუთარი გასაღები (BYOK)

თქვენ შეგიძლიათ მოთხოვნების მარშრუტიზაცია თქვენი საკუთარი პროვაიდერის ანგარიშის მეშვეობით, პლატფორმის გაზომილი გამოყენების ნაცვლად.

  1. გახსენით API გასაღებები გვერდითი ზოლიდან.
  2. მოიტანეთ საკუთარი გასაღები განყოფილებაში, აირჩიეთ პროვაიდერი (მაგ. ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
  3. ჩასვით გასაღების მნიშვნელობა და დააწკაპუნეთ შენახვა. გასაღებები დაშიფრულია შენახვისას და არასოდეს უბრუნდება ბრაუზერს — ნაჩვენებია მხოლოდ ნიღბიანი გადახედვა.

პლატფორმის (DeepCerebra) მოდელებს გასაღები არ სჭირდებათ. გასაღების წაშლა ნებისმიერ დროს შეგიძლიათ ღილაკით წაშლა.

13 ლოკალური მანქანა: GPU მოდელები და კონსოლი (DCC Bridge)

DCC Bridge აკავშირებს თქვენს საკუთარ კომპიუტერს ვებ აპლიკაციასთან მცირე dcc-bridge კონექტორის მეშვეობით, რაც ერთდროულად ხსნის ორ შესაძლებლობას:

კონექტორი უკავშირდება გარედან ავთენტიფიცირებული WebSocket-ის მეშვეობით — შემომავალი პორტები არ არის საჭირო, და ის მუშაობს NAT-ისა და ფაირვოლების მიღმა. ის მუშაობს Windows-ზე, macOS-ზე და Linux-ზე (Python 3.10+).

13.1 თქვენი კომპიუტერის დაწყვილება

  1. დააწკაპუნეთ ლეპტოპის ხატულაზე მარცხენა აქტივობის ზოლში — ლოკალური მანქანა (GPU + კონსოლი). (იგივე პანელი იხსნება მოდელის ამომრჩევლის ქვედა ნაწილიდან ლოკალური GPU-ის მართვა…-ის მეშვეობით.)
  2. დარწმუნდით, რომ ლოკალური შესრულება გადამრთველი ჩართულია, დაასახელეთ მოწყობილობა და დააწკაპუნეთ ამ კომპიუტერის დამატება. დააკოპირეთ ერთჯერადი დაწყვილების ტოკენი (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

შემდეგ გახსენით ტერმინალის პანელი, დააწკაპუნეთ შესრულების სამიზნე popover-ზე (ლეპტოპის ხატულა), აირჩიეთ ჩემი კომპიუტერი და აირჩიეთ სამუშაო დირექტორია. ამის შემდეგ თქვენი აკრეფილი ბრძანებები და აგენტის build/test ბრძანებები შესრულდება თქვენს მანქანაზე.

⚠️ უსაფრთხოება: ჰოსტზე წვდომა არასოდეს აღემატება საქაღალდეებს, რომლებიც თქვენ ჩამოთვალეთ კონექტორის ბრძანების ხაზზე; ტოკენები დაშიფრულია შენახვისას და მათი გაუქმება შესაძლებელია ნებისმიერ დროს; --no-exec ხდის მოწყობილობას მხოლოდ ინფერენციულს (GPU მოდელები, ბრძანებების გარეშე).
💡 რჩევა: დესკტოპის აპს შეუძლია ადგილობრივი მოდელების პირდაპირ გამოყენება კონექტორის გარეშე. კონექტორის სრული მითითება: github.com/mohammadkhair7/DeepCerebra-connector.

14 Git თანამშრომლობის სამუშაო პროცესი

Git-ზე დაფუძნებული პროექტის გახსნისას, Explorer-ში ჩნდება ფილიალის ზოლი, რომელიც აჩვენებს თქვენს მიმდინარე ფილიალს და ორ მოქმედებას:

თუ push webhook ჩართულია, Explorer ავტომატურად განახლდება, როდესაც თანაგუნდელები 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 რესურსებს ან მოთხოვნის შაბლონებს, აგენტი ავტომატურად იძენს ხელსაწყოებს მათ გამოსაყენებლად (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt).

ავთენტიფიკაცია დისტანციური სერვერებისთვის

დაამატეთ auth ბლოკი დისტანციურ სერვერს. საიდუმლოებები მხარს უჭერს ${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 აგენტის მორგება: წესები, უნარები, ჰუკები, სუბაგენტები და დანამატები

შეგიძლიათ განსაზღვროთ, თუ როგორ ფიქრობს და მოქმედებს აგენტი ერთი, ფაილზე დაფუძნებული კონვენციით — .deepcerebra/ დირექტორია — რომელიც იდენტურად მუშაობს დესკტოპის აპლიკაციაში, ვებ აპლიკაციაში და API-ში. ვებ აპლიკაციაში, მართეთ ეს ყველაფერი აგენტის ხედში; დესკტოპზე და API-ის მეშვეობით ისინი ჩვეულებრივი ფაილებია, რომლებსაც თქვენ აკომიტებთ თქვენს პროექტთან ერთად.

სკოპები და პრეცედენტი

კონფიგურაცია აღმოჩენილია რამდენიმე სკოპიდან; როდესაც ერთი და იგივე ელემენტი არსებობს ერთზე მეტში, უფრო მაღალი პრეცედენტის მქონე იმარჯვებს:

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

წესები (steering)

წესები არის მუდმივი ინსტრუქციები — კოდირების სტანდარტები, არქიტექტურული კონვენციები, დომენის კონტექსტი — რომლებიც შეყვანილია აგენტის სისტემურ მოთხოვნაში. ისინი ცხოვრობენ 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) ვრცელდება მხოლოდ ამ საქაღალდის ქვეშ არსებულ ფაილებზე. ვებ აპლიკაციაში, აგენტი → Steering ხედი თითოეულ წესს აძლევს სკოპის ამომრჩეველს (გლობალური / პროექტი / გუნდი).

უნარები

უნარები არის მრავალჯერადი გამოყენების playbooks, რომლებსაც აგენტი ტვირთავს მოთხოვნისამებრ. თითოეული უნარი არის საქაღალდე 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 ჰუკს შეუძლია allow, deny, ან ask ინტეგრირებული ხელსაწყოს გამოძახებისთვის.

სუბაგენტები

სუბაგენტები არიან სპეციალისტი აგენტები, რომლებსაც თქვენ განსაზღვრავთ და დელეგირებთ. თითოეული არის 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 (fan-out) გამოყენებით.

დანამატები

დანამატი აერთიანებს წესებს, უნარებს, ჰუკებს, სუბაგენტებს და 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 დირექტორიაზე მითითებით, ან ვებ აპლიკაციაში წესების გუნდის სკოპზე დაყენებით.

17 აგენტური სამუშაო პროცესის სტუდია და მოვლენებზე ორიენტირებული აგენტები

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 ტესტების ან ბრძანებების გაშვება sandbox-ში; გაშვებული UI-ის გადამოწმება ბრაუზერის ავტომატიზაციით.
orchestrateდინამიური მარშრუტიზაცია: ორკესტრატორის აგენტი კითხულობს მოთხოვნას და აგზავნის მას საუკეთესო ქვედა დინების აგენტ(ებ)თან მოვლენების მეშვეობით.
external.agentდარეგისტრირებული მესამე მხარის აგენტის გამოძახება HTTP-ის (A2A) მეშვეობით, თითქოს ის მშობლიური სტადია იყოს.
evalზედა დინების გამომავალი ინფორმაციის შეფასება შემოწმებების მიხედვით (შეიცავს / regex / სიგრძე / LLM-judge); ჩავარდნა ზღვარს ქვემოთ.
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 chart — ფაილები, რომლებიც თქვენ გეკუთვნით და აკომიტებთ.
test.generateერთეულის / API / E2E კომპლექტების გენერაცია აგებული აპლიკაციისთვის პლუს მოთხოვნა-ტესტზე მიკვლევადობის მატრიცა.
test.verifyტესტების კომპლექტის შესრულება (pytest, vitest, jest, Playwright) და გაშვების შეზღუდვა მისი გავლის სიჩქარით.
security.auditდაასკანირეთ დამოკიდებულებები ცნობილი მოწყვლადობებისთვის და ხეში ჩამონტაჟებული საიდუმლოებებისთვის; გამოაქვეყნებს გაფრთხილების მოვლენებს და წერს აღმოჩენების ანგარიშს.
previewგენერირებული აპლიკაციის ლოკალურად გაშვება და მისი ცოცხალი URL-ის ჩვენება გაშვების პანელში (ბმული + inline frame) preview.ready მოვლენის მეშვეობით.
design.importUI დიზაინის სურათის (ეკრანის ანაბეჭდი, მაკეტი, 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 სემაფორის ორკესტრაცია (გაზიარებული რესურსის დაცვა)

A სემაფორი ზღუდავს, თუ რამდენი დავალება შეიძლება ერთდროულად მუშაობდეს საერთო (დაცულ) რესურსზე: მონაცემთა ბაზა, რომელშიც ხდება ჩაწერა, გლობალური ცვლადების საცავი, ფაილი ან სიჩქარით შეზღუდული გარე აგენტი. მიამაგრეთ ის ნებისმიერ ეტაპზე 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 გაშვება, კარიბჭეები და გამომავალი ინფორმაცია

💡 რჩევა: დაიწყეთ Ship-It Pipeline შაბლონით: ის აერთიანებს დიზაინს → db.provision → იმპლემენტაციას → გენერირებულ ტესტებს → უსაფრთხოების აუდიტს → განლაგების შეფუთვას → CI გენერაციას, ადამიანის კარიბჭით შეფუთვამდე — სრული გზა მოკლე აღწერიდან წარმოებამდე, რომლის ადაპტირებაც წუთებში შეგიძლიათ.

18 პროგნოზირებადი Tab შევსება

პროგნოზირებადი Tab შევსება გთავაზობთ inline, შუა ნაწილის შევსების კოდის შემოთავაზებებს რედაქტორში აკრეფისას — მიიღეთ შემოთავაზება Tab-ით. ის არის opt-in როგორც ძრავზე, ასევე ვებ რედაქტორზე.

მისი ჩართვა

როგორ იქცევა

19 გამოყენება, კრედიტები და ბილინგი

გახსენით ბილინგი გვერდითი ზოლიდან თქვენი გეგმისა და გამოყენების სამართავად. AI გამოყენება იზომება აშშ დოლარის კრედიტებში, რომელიც ეფუძნება ძირითადი მოდელების მიერ მოხმარებულ ტოკენებს.

გეგმაყოველთვიური ფასიჩართული ყოველთვიური AI გამოყენება
Basic$20$10
Pro$75$30
Ultimate$200$150
💡 დაზოგეთ გამოყენებაზე: გამოიყენეთ ავტომატური მოდელის შერჩევა, მოიტანეთ საკუთარი გასაღები (BYOK), ან გაუშვით ლოკალური მოდელები გაზომილი გამოყენების შესამცირებლად ან თავიდან ასაცილებლად.

20 თქვენი Gateway API გასაღების მიღება

gateway API გასაღები (პირადი წვდომის ტოკენი) საშუალებას გაძლევთ გამოიყენოთ DeepCerebra საჯარო API და CLI პროგრამულად.

  1. შედით სისტემაში და გახსენით API გასაღებები გვერდითი ზოლიდან.
  2. გადადით DeepCerebra API გასაღებები-ზე.
  3. შეიყვანეთ ლეიბლი (მაგ. "CI pipeline" ან "laptop CLI").
  4. აირჩიეთ სკოპებიread, chat, code, agent — და არჩევითი ვადის გასვლის თარიღი დღეებში (ცარიელი = არასოდეს).
  5. დააჭირეთ გენერირება. სრული გასაღები ნაჩვენებია მხოლოდ ერთხელ — დააჭირეთ კოპირება და შეინახეთ უსაფრთხოდ.

გამოიყენეთ ის 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/...

შეგიძლიათ გადაარქვათ ან წაშალოთ (გააუქმოთ) გასაღები ნებისმიერ დროს; თითოეული გასაღები აჩვენებს მის პრეფიქსს, სკოპებს, შექმნის/ვადის გასვლის თარიღს და ბოლო გამოყენების თარიღს.

⚠️ შეინახეთ საიდუმლოდ. ნებისმიერს, ვისაც თქვენი გასაღები აქვს, შეუძლია გამოიყენოს თქვენი ანგარიში და დააგროვოს გამოყენება. დაუყოვნებლივ გააუქმეთ და ხელახლა შექმენით ის, თუ ოდესმე გამჟღავნდება.

21 უსაფრთხოება და კონფიდენციალურობა

22 პრობლემების მოგვარება

"Folder loading needs a Chromium browser"

გადადით Chrome-ზე, Edge-ზე ან Brave-ზე, ან გამოიყენეთ გახსნა Git-დან.

აგენტი იმეორებს ერთსა და იმავე შეცდომას

დააწკაპუნეთ შეჩერება, შემდეგ გადააფორმულირეთ კონკრეტული მინიშნებით ან შეზღუდვით.

მოდელის ან მოთხოვნის შეცდომები / "ბიუჯეტი ამოწურულია"

ლოკალური მოდელები არ ჩანს

კონექტორი: "server rejected WebSocket connection: HTTP 401"

ჩემმა ცვლილებებმა არ იმუშავა

Git: "You are on the default branch"

გახსენით ან შექმენით სამუშაო ფილიალი ინტეგრირების გამოყენებამდე pull request-ის გასახსნელად.

კვლავ გაჭედილი ხართ? დაუკავშირდით support@deepcerebra.ai.

23 DeepCerebra Discovery — ჰკითხეთ თქვენს მონაცემებსა და დოკუმენტებს

Discovery არის საგამოძიებო ჩატბოტი თქვენი მონაცემთა ბაზებისა და დოკუმენტებისთვის. ერთი მოთხოვნით პასუხის გაცემის ნაცვლად, ის მუშაობს ანალიტიკოსივით: აყალიბებს ჰიპოთეზებს, ატარებს დაცული გამოკვლევების სერიას (SQL, გრაფიკი, დოკუმენტების ძიება, სქემის შემოწმება, ვებ-დადასტურება), ჭრის ახსნა-განმარტებებს, რომლებსაც მტკიცებულებები უარყოფს, და აყალიბებს დასაბუთებულ პასუხს — დიაგრამებითა და გამჭვირვალე ხარჯების ქვითრით. გახსენით ის აქტივობის პანელზე არსებული კომპასის ხატულიდან (/app/discovery).

23.1 სივრცეები — თქვენი კურირებული არეალი

სივრცე აერთიანებს ყველაფერს, რაც საჭიროა ერთი კითხვისთვის: მონაცემთა ბაზის კავშირები, დოკუმენტების კოლექციები, ინსტრუქციები ანალიტიკოსისთვის და ბიუჯეტები. შექმენით ერთი + ახალი სივრცე-ს გამოყენებით, შემდეგ გამოიყენეთ მარჯვენა მხარეს არსებული დაყენების პანელი, რათა:

23.2 კითხვის დასმა

აკრიფეთ შეკითხვა ისე, როგორც კოლეგას ჰკითხავდით — მაგალითად „რატომ შემცირდა MRI სკანირების მოცულობა მარტში?“. გამოძიების დაფა მთელ პროცესს პირდაპირ ეთერში აჩვენებს:

შემდგომი კითხვები აგრძელებს იმავე თემას, ასე რომ ანალიტიკოსი ინარჩუნებს კონტექსტს.

23.3 დიაგრამები, ანგარიშები & ექსპორტი

დიაგრამები გამოისახება პირდაპირ გამოძიების დაფაზე. გამოიყენეთ ექსპორტი სრული მოთხოვნის — პასუხის, ჰიპოთეზების, მტკიცებულებების და დიაგრამების — ჩამოსატვირთად, როგორც დამოუკიდებელი HTML ანგარიში ან ბეჭდვის ხარისხის PDF, ნეონის დიზაინის სისტემით სტილიზებული.

23.4 ბიუჯეტები & ხარჯების კონტროლი

თითოეულ სივრცეს აქვს თითოეული მოთხოვნის ბიუჯეტი: გამოკვლევების მაქსიმალური რაოდენობა, გამოძიების რაუნდები, წამები და USD. ძრავა სუფთად ჩერდება ზღვარზე და აცნობებს, თუ რა იპოვა აქამდე. თითოეული გამოკვლევის ღირებულება დეტალურად არის მითითებული ქვითარზე, ასე რომ თქვენ ყოველთვის იცით, სად წავიდა დანახარჯი.

23.5 ავტომატიზაცია: API, SDK, Workflow Studio & MCP