1 መግቢያ እና እትሞች

DeepCerebra Coder ኤጀንቲክ የኮዲንግ ረዳት ነው። እንደ ተራ አውቶማቲክ ኮፓይለት ሳይሆን፣ እሱ ሙሉ ፕሮጀክትዎን ያቅዳል፣ ይጽፋል፣ ያሻሽላል፣ ትዕዛዞችን ያካሂዳል፣ መሳሪያዎችን ይጠራል፣ እና ይደግማል — እርስዎ በሚያቀርባቸው ለውጦች ላይ ግምገማ እና ማጽደቅ ይሰጣሉ።

ለመጠቀም ሶስት መንገዶች

ይህ መመሪያ በdeepcerebra.ai ላይ ባለው ዌብ መተግበሪያ ላይ ያተኩራል፤ የዴስክቶፕ መተግበሪያው ተመሳሳይ ፓነሎችን እና የስራ ፍሰቶችን ያንፀባርቃል።

2 መጀመር እና አካውንት

የሚደገፉ አሳሾች

ሙሉ ልምዱን ለማግኘት የአሁኑን የChrome, Edge, ወይም Brave ስሪት ይጠቀሙ — አካባቢያዊ ማህደር መክፈት በChromium File System Access API ላይ የተመሰረተ ነው። Firefox እና Safari ለውይይት እና ለGit-የተደገፉ ፕሮጀክቶች ይሰራሉ፣ ነገር ግን አካባቢያዊ ማህደርን በቀጥታ መክፈት አይችሉም።

አካውንት ይፍጠሩ

1. በማረፊያ ገጹ ላይ ጀምር የሚለውን ይጫኑ።
2. አማራጭ የሆኑትን የማሳያ ስምዎን፣ ኢሜልዎን፣ ሀገርዎን እና የትውልድ ቀንዎን ይሙሉ (ቢያንስ 18 ዓመት መሆን አለብዎት)።
3. የእርስዎን የበይነገጽ ቋንቋ እና ቢያንስ 12 ቁምፊዎች ያለው የይለፍ ቃል ይምረጡ።
4. የስምምነት ማስታወቂያውን ያንብቡ እና ያረጋግጡ። አካውንት መፍጠር ማለት እርስዎ የአገልግሎት ውሎች፣ የግላዊነት መግለጫ፣ የአገልግሎቶች መግለጫ እና የአለምአቀፍ DPA ተስማምተዋል ማለት ነው።
5. አካውንት ፍጠር የሚለውን ይጫኑ፣ ከዚያ ከተጠየቁ ኢሜልዎን ያረጋግጡ እና ይግቡ።

የይለፍ ቃልዎን ዳግም ያስጀምሩ

1. በመግቢያ ገጹ ላይ የይለፍ ቃል ረሱ? የሚለውን ይጫኑ።
2. ኢሜልዎን ያስገቡ እና ወደ ገቢ መልዕክት ሳጥንዎ የተላከውን ዳግም ማስጀመሪያ አገናኝ ይክፈቱ።
3. አዲስ የይለፍ ቃል ያዘጋጁ (ቢያንስ 12 ቁምፊዎች)።

3 የስራ ቦታው በአጭሩ

ከገቡ በኋላ ወደ የስራ ቦታው ይገባሉ፣ ይህም ሁሉንም ፓነሎች በአንድ ስክሪን ላይ ያሳያል፦

• ኤክስፕሎረር (ግራ) — ለተከፈተው ፕሮጀክት የፋይል ዛፍ፣ ከማደስ እና መዝጊያ ቁልፍ ጋር።
• አርታዒ (መሃል) — የፋይል ይዘቶች ከሲንታክስ ማድመቂያ እና አነስተኛ ካርታ አጠቃላይ እይታ ጋር፤ ኤጀንቱ ለውጦችን ሲያቀርብ የውስጠ-መስመር ልዩነቶች እዚህ ይታያሉ።
• ተርሚናል (ከአርታዒው ስር፣ ማብራት/ማጥፋት) — ትዕዛዞችን ያሂዱ እና ውጤቶችን ያንብቡ።
• ውይይት (ቀኝ) — የኤጀንቱ ውይይት፤ ይህ ዋናው፣ ቦታ የሚሞላው ፓነል ነው።

አቀማመጡን ለማስተካከል በአርታዒው እና በውይይቱ መካከል ያለውን መለያያ ይጎትቱ፣ እና ተርሚናሉን ለመቀየር አግድም መለያያውን ይጎትቱ። የግራ የጎን አሞሌ ወደ የስራ ቦታ፣ ቅጥያዎች፣ API ቁልፎች፣ ክፍያ እና ግብረመልስ ያመራል።

4 ፕሮጀክት መክፈት

4.1 አካባቢያዊ ማህደር ይክፈቱ

1. በኤክስፕሎረር ውስጥ የፕሮጀክት ማህደር ክፈት የሚለውን ይጫኑ።
2. ማህደር ይምረጡ እና አሳሹ እንዲያነበው ፍቃድ ይስጡ።
3. ፋይሎች ወደ አሳሽዎ የተመሰጠረ የውስጠ-አሳሽ የስራ ቦታ ይነበባሉ — ምንም ነገር አይሰቀልም። የቀጥታ ቆጠራ እና የመጨረሻ ማጠቃለያ (የፋይል ብዛት · መጠን፣ በተጨማሪም ማንኛውም የተዘለሉ ወይም የተቆረጡ ፋይሎች) ያያሉ።

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. የቡድን አባላት ሲገፉ ኤክስፕሎረር ወዲያውኑ እንዲታደስ ፑሽ ዌብሁክን በአማራጭ ያንቁ (የህዝብ መግቢያ URL ያስፈልገዋል)።
6. ሪፖዚቶሪ ክፈት የሚለውን ይጫኑ።

4.3 አድስ፣ ቀይር እና ዝጋ

• አድስ (↻ በኤክስፕሎረር ራስጌ ውስጥ) ማህደሩን እንደገና ይቃኛል ወይም የቅርብ ጊዜውን ከGit ይጎትታል።
• ከዛፉ ስር ካሉት ቁልፎች ሌላ ማህደር ክፈት ወይም ከGit ክፈት።
• ፕሮጀክት ዝጋ (የቆሻሻ መጣያ ምልክት) በአሳሽ ውስጥ ያለውን የስራ ቦታ ያጠፋል።

4.4 በማህደር-የተገደቡ የውይይት ክፍለ ጊዜዎች

የውይይት ታሪክ ከተከፈተው ፕሮጀክት ጋር የተያያዘ ነው። ማህደሮችን መቀየር በራስ-ሰር አዲስ ክፍለ ጊዜ ይጀምራል እና የዚያን ማህደር የቀድሞ ክፍለ ጊዜዎችን ይጭናል፣ በጣም የቅርብ ጊዜውን እንደገና በመክፈት ስራዎን ካቆሙበት እንዲቀጥሉ ያስችልዎታል።

4.5 የአሰራር ማህደሮች

DeepCerebra በውስጥ የሚጠቀምባቸው ማህደሮች — .deepcerebra, .sessions — በዛፉ ውስጥ ይታያሉ ነገር ግን ምንጭዎን እንዳያጨናንቁ በነባሪነት ተዘግተዋል።

5 ከፋይሎች ጋር መስራት

• ፋይልን ጠቅ ያድርጉ በኤክስፕሎረር ውስጥ በአርታዒው ውስጥ ለመክፈት; ሚኒማፕ ረጅም ፋይሎችን ለማሰስ ይረዳዎታል።
• ፋይል ይጎትቱ ከኤክስፕሎረር ወደ ውይይት መጠየቂያው ለቀጣዩ መልእክትዎ ግልጽ አውድ አድርገው ለማያያዝ።
• ኤጀንቱ ማስተካከያዎችን ሲያቀርብ፣ አርታዒው ለተመረጠው ፋይል የውስጠ-መስመር ልዩነት ያሳያል።

6 ከኤጀንቱ ጋር መወያየት

ጥያቄ ይጻፉ

የሚፈልጉትን በቀላል ቋንቋ ይግለጹ — ጥያቄ ይጠይቁ፣ ባህሪ ይጠይቁ፣ ወይም ስህተት ያመልክቱ። ምርጡን ውጤት ለማግኘት ስለ ፋይሎች፣ ፍሬምወርኮች እና ገደቦች ግልጽ ይሁኑ። ተዛማጅ ፋይሎችን ወደ መጠየቂያው በመጎተት ያያይዙ።

ምላሾችን ያንብቡ፣ በCursor-ስታይል

ምላሾች እንደ Cursor የተደራጁ ናቸው፡ የኤጀንቱ አመክንዮ ከማድረስ የሚችለው ተለይቷል። እያንዳንዱ የምላሽ ብሎክ በላይኛው ቀኝ ጥግ ላይ የመቅዳት አዶ አለው ስለዚህ የተጠናቀቀ ሪፖርት፣ ሰነድ ወይም ሊያካሂዱት የሚገባ ትዕዛዝ መቅዳት ይችላሉ።

አሂድ የሚለውን ይምሩ ወይም ያቁሙ

• ወደ የተሳሳተ መንገድ የሚሄድ አሂድ ለማቆም አቁም የሚለውን ይጠቀሙ፣ ከዚያ መጠየቂያዎን ያሻሽሉ።
• ኤጀንቱን ከሉፕ ለማውጣት ፍንጮችን ይስጡ (ለምሳሌ "html.parserን ከመጠቀም ይልቅ lxmlን ተጠቀም")።

7 አራቱ የውይይት ሁነታዎች

ከመጠየቂያው አጠገብ ካለው ሁነታ መራጭ ሁነታ ይምረጡ። እያንዳንዱ ኤጀንቱ ምን ያህል እንደሚያቅድ እና ምን ያህል በነጻነት እንደሚያስተካክል ያስተካክላል፦

8 ለውጦችን መገምገም እና መተግበር

ወኪሉ የፋይል ለውጦችን ሲያቀርብ፣ አንድ የታቀዱ ለውጦች ፓነል ከውይይት ግብዓቱ በላይ ይታያል፣ እያንዳንዱን የተነካ ፋይል ከተጨመሩ (+) እና ከተወገዱ (−) የመስመር ብዛት ጋር ይዘረዝራል።

• በአርታዒው ውስጥ የውስጠ-መስመር ልዩነቱን ለመክፈት የፋይል ረድፍ ይጫኑ።
• አንድ ፋይል ተግብር ወይም ውድቅ አድርግ፣ ወይም ሁሉንም ተግብር / ሁሉንም ውድቅ አድርግ የሚለውን ተጠቀም።
• የተተገበሩ ለውጦች applied (እና · disk ወደ እውነተኛ ማህደር ሲጻፉ) ምልክት ይደረግባቸዋል።
• የሚጻፍ ማህደር ከሌለ፣ የስራ ቦታ ብቻ ባጅ ለውጦች በውስጠ-አሳሽ የስራ ቦታ ላይ እንደሚተገበሩ ያመለክታል።

9 የተቀናጀ ተርሚናል

ግንባታዎችን፣ ሙከራዎችን እና ስክሪፕቶችን ለማስኬድ ከአርታዒው በታች ያለውን ተርሚናል ያብሩ። በእርስዎ ፍቃድ፣ ኤጀንቱ ትዕዛዞችን ማስፈጸም እና ስራውን ለማረጋገጥ ውጤታቸውን ማንበብ ይችላል፤ ረጅም ጊዜ የሚወስዱ ትዕዛዞች ውጤቶችን ያሰራጫሉ ስለዚህ እድገቱን መከታተል ይችላሉ። በማይፈልጉበት ጊዜ ተርሚናሉን ከራስጌው ይዝጉ።

10 የእቅድ ሁነታ እና አፈፃፀም

ለትላልቅ ግቦች፣ የእቅድ ሁነታን ይጠቀሙ (ወይም ኤጀንቱ መጀመሪያ እንዲያቅድ ይጠይቁ)። እቅድ አውጪው ፕሮጀክትዎን ይቃኛል፣ ግቡን ወደ ጥገኝነት-አዋቂ ተግባራት ይከፋፍላል፣ እና እያንዳንዱን ለትክክለኛው ስፔሻሊስት (አርክቴክት፣ ኮደር፣ ሞካሪ፣ ሰነዶች) ይመድባል።

• እቅዱን ይገምግሙ እና ያርትዑ — ከማስፈጸምዎ በፊት ተግባራትን ያክሉ፣ ያስወግዱ ወይም ያሻሽሉ።
• ንብርብር በንብርብር ያስፈጽሙ — ገለልተኛ ተግባራት አብረው ይሰራሉ፤ ተግባር ከከሸፈ እቅድ አውጪው እንደገና ማቀድ ይችላል።
• በማንኛውም ጊዜ አፈፃፀምን አቁም፣ ቀጥል ወይም አቋርጥ።

11 ሞዴሎችን መምረጥ እና አውቶ

ከመጠየቂያው አጠገብ ያለውን ሞዴል መራጭ ይክፈቱ። አማራጮች እንደሚከተለው ተሰብስበዋል፦

• አውቶ — DeepCerebra ምርጡን የሚገኝ ሞዴል እንዲመርጥ ይፍቀዱ (የሚመከር)።
• አካባቢያዊ (የእርስዎ GPU) — ከራስዎ ማሽን የሚቀርቡ ሞዴሎች (ክፍል §13 ይመልከቱ)።
• የፕላትፎርም መግቢያዎች — የተስተናገዱ ሞዴሎች፣ በመግቢያ እና ከዚያም በአቅራቢ (ለምሳሌ Anthropic, OpenAI, Google) የተከፋፈሉ ናቸው።

የአውቶ ምርጫ እንዴት እንደሚሰራ

በአውቶ ላይ፣ 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 ማገናኛ በኩል ያገናኛል፣ በአንድ ጊዜ ሁለት ችሎታዎችን ይከፍታል፦

• አካባቢያዊ GPU ሞዴሎች — በOllama ወይም LM Studio በማሽንዎ ላይ የሚቀርቡ ሞዴሎች በሞዴል መራጭ ውስጥ ከአካባቢያዊ (የእርስዎ GPU) ስር ይታያሉ።
• ኮንሶል / ተርሚናል በማሽንዎ ላይ — የዌብ ተርሚናል እና ኤጀንቱ በኮምፒውተርዎ ላይ እውነተኛ ትዕዛዞችን ማስኬድ ይችላሉ፣ አስቀድመው ያዋቀሯቸውን CLI መሳሪያዎች (Railway, AWS CLI, OVH CLI, gh, docker, kubectl, WSL, …) ከነባር ምስክርነቶቻቸው ጋር ጨምሮ።

ማገናኛው በተረጋገጠ WebSocket በኩል ወደ ውጭ ይደውላል — የውስጥ ወደቦች አያስፈልጉም፣ እና ከNAT እና ፋየርዎሎች ጀርባ ይሰራል። በWindows, macOS እና Linux (Python 3.10+) ላይ ይሰራል።

13.1 ኮምፒውተርዎን ያጣምሩ

1. በግራ በኩል ባለው የእንቅስቃሴ መስመር ላይ የሚገኘውን የላፕቶፕ አዶውን ይጫኑ — አካባቢያዊ ማሽን (ጂፒዩ + ኮንሶል)። (ተመሳሳይ ፓነል ከሞዴል መራጭ ግርጌ አካባቢያዊ ጂፒዩን ያቀናብሩ… በሚለው በኩል ይከፈታል)
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

• እንደ መግቢያ በር (wss://deepcerebra.ai ወይም wss://deepcerebra.io) በአሳሹ ውስጥ የሚጠቀሙበትን ተመሳሳይ ጎራ ይጠቀሙ — ሁለቱ ጣቢያዎች የተለዩ አካውንቶች እና ቶከኖች ያላቸው የተለዩ ማሰማራቶች ናቸው።
• ለGPU ሞዴሎች፣ Ollama እንዲሰራ ያድርጉ፣ ወይም LM Studio's አካባቢያዊ ሰርቨር (ነባሪ ወደብ 1234) ሞዴል ተጭኖ እንዲነቃ ያድርጉ።
• የተጣመሩ መሳሪያዎች ኦንላይን/ኦፍላይን ሁኔታ፣ የሞዴል ብዛት እና የአፈፃፀም ስፋት ያሳያሉ፤ በማንኛውም ጊዜ መሳሪያን መሻር ይችላሉ።

13.3 ኮንሶልዎን ከዌብ መተግበሪያ ይጠቀሙ

በነባሪነት፣ ትዕዛዞች በተወሰነ የስራ ቦታ ማህደር (~/DeepCerebra) ውስጥ የተገደቡ ናቸው። አስቀድመው በተዋቀሩ CLIsዎ በእውነተኛ የፕሮጀክት ማህደሮችዎ ውስጥ ለመስራት፣ ማገናኛውን ሲጀምሩ በግልጽ ፍቃድ ይስጧቸው፦

# 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

ከዚያ ተርሚናል ፓነልን ይክፈቱ፣ የአፈፃፀም ኢላማ ብቅ-ባይ (ላፕቶፕ አዶ) የሚለውን ይጫኑ፣ የእኔ ኮምፒውተር የሚለውን ይምረጡ እና የስራ ማውጫ ይምረጡ። ሁለቱም የእርስዎ የተተየቡ ትዕዛዞች እና የኤጀንቱ ግንባታ/ሙከራ ትዕዛዞች በማሽንዎ ላይ ይፈጸማሉ።

14 Git የትብብር የስራ ፍሰት

Git-የተደገፈ ፕሮጀክት ሲከፈት፣ በኤክስፕሎረር ውስጥ የአሁኑን ቅርንጫፍዎን እና ሁለት ድርጊቶችን የሚያሳይ የቅርንጫፍ አሞሌ ይታያል፦

• አስገባ (ኮሚት) — የተለወጠውን የፋይል ብዛት ይገምግሙ፣ የኮሚት መልእክት ይጻፉ እና ወደ የስራ ቅርንጫፍዎ ኮሚት ያድርጉ።
• አዋህድ — ከስራ ቅርንጫፍዎ ወደ ነባሪው ቅርንጫፍ (ለምሳሌ main) የፑል ጥያቄ ይክፈቱ። በስራ ቅርንጫፍ ላይ መሆን አለብዎት፣ በመደበኛው ቅርንጫፍ ላይ አይደለም።

ፑሽ ዌብሁክ ከነቃ፣ የቡድን አባላት ሲገፉ ኤክስፕሎረር በራስ-ሰር ይዘምናል፣ ሁሉንም ሰው በተመሳሳይ ሁኔታ ያቆያል — በ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) ሰርቨሮች ሁለቱም ይደገፋሉ።

አብሮ የተሰራ ደህንነት

• በነባሪነት እምቢ — ሰርቨር allowlist ሲዘረዝር፣ እነዚያ መሳሪያዎች ብቻ ሊሰሩ ይችላሉ።
• ለከፍተኛ ስጋት መሳሪያዎች ማጽደቅ — የሚቀይሩ መሳሪያዎች (መጻፍ/መሰረዝ/ማሰማራት/…) በautoApprove ውስጥ አስቀድመው ካላጸደቋቸው በስተቀር ማጽደቅ ያስፈልጋቸዋል።
• የፍጥነት ገደብ፣ የክርክር እና የውጤት ንፅህና፣ እና የኦዲት ምዝግብ ማስታወሻ ለእያንዳንዱ ጥሪ ይተገበራሉ።

ሀብቶች እና መጠየቂያዎች

ሰርቨር MCP ሀብቶችን ወይም የመጠየቂያ አብነቶችን የሚያጋልጥ ከሆነ፣ ኤጀንቱ እነሱን ለመጠቀም መሳሪያዎችን በራስ-ሰር ያገኛል (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt)።

የርቀት ሰርቨሮች ማረጋገጫ

የርቀት ሰርቨር ላይ auth ብሎክ ያክሉ። ሚስጥሮች ${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 ኤጀንቱን ማበጀት፡ ህጎች፣ ክህሎቶች፣ መንጠቆዎች፣ ንዑስ-ኤጀንቶች እና ተሰኪዎች

ኤጀንቱ እንዴት እንደሚያስብ እና እንደሚሰራ በአንድ፣ በፋይል ላይ የተመሰረተ ስምምነት — የ.deepcerebra/ ማውጫ — በዴስክቶፕ መተግበሪያ፣ በዌብ መተግበሪያ እና በAPI ውስጥ ተመሳሳይ በሆነ መልኩ የሚሰራ ነው። በዌብ መተግበሪያ ውስጥ፣ እነዚህን ሁሉ በኤጀንት እይታ ስር ያስተዳድሩ፤ በዴስክቶፕ ላይ እና በAPI በኩል ከፕሮጀክትዎ ጋር የሚያስገቡዋቸው ተራ ፋይሎች ናቸው።

ስፋቶች እና ቅድሚያ

ማዋቀር ከበርካታ ስፋቶች ይገኛል፤ ተመሳሳይ ንጥል ከአንድ በላይ ሲኖር፣ ከፍተኛ ቅድሚያ ያለው ያሸንፋል፦

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

• የስራ ቦታ — <repo>/.deepcerebra/…፣ ከፕሮጀክቱ ጋር የተገባ።
• አለምአቀፍ — ~/.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.

• always — በእያንዳንዱ ተራ (ነባሪው)።
• fileMatch — በዐውድ ውስጥ ያለ ፋይል globsን ሲያሟላ ብቻ።
• auto — ጥያቄዎ የህጉን name/description ሲያሟላ።
• manual — እንደ #name ወይም /name ሲጠቅሱት ብቻ።

ዋና AGENTS.md በሪፖ-ሰፊ ይተገበራል፤ የተደራረበ AGENTS.md (ለምሳሌ services/api/AGENTS.md) በዚያ ማህደር ስር ላሉ ፋይሎች ብቻ ይተገበራል። በዌብ መተግበሪያ ውስጥ፣ የኤጀንት → መሪነት እይታ ለእያንዳንዱ ህግ የስፋት መራጭ (አለምአቀፍ / ፕሮጀክት / ቡድን) ይሰጣል።

ክህሎቶች

ክህሎቶች ኤጀንቱ በፍላጎት የሚጭናቸው እንደገና ጥቅም ላይ ሊውሉ የሚችሉ የመጫወቻ መጽሐፍት ናቸው። እያንዳንዱ ክህሎት በ.deepcerebra/skills/ ስር SKILL.md ያለው ማህደር ነው፦

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

ኤጀንቱ ቀላል ካታሎግ (ስም + መግለጫ) ያያል እና ተዛማጅ ሲሆን ሙሉውን አካል በ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 መንጠቆ የሚጠለፈውን የመሳሪያ ጥሪ መፍቀድ፣ መከልከል ወይም መጠየቅ ይችላል።

ንዑስ-ኤጀንቶች

ንዑስ-ኤጀንቶች እርስዎ የሚገልጿቸው እና የሚመድቧቸው ስፔሻሊስት ኤጀንቶች ናቸው። እያንዳንዱ በ.deepcerebra/agents/ ስር ያለ Markdown ፋይል ከፊት ለፊት መረጃ እና አካል (የእሱ ሲስተም መጠየቂያ) ጋር ነው፦

---
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 ምልክት ማድረጊያ ፋይል ያሰናክሉ።

17 ኤጀንቲክ የስራ ፍሰት ስቱዲዮ እና በክስተት የሚነዱ ኤጀንቶች

የስራ ፍሰት ስቱዲዮ ለብዙ-ኤጀንት አውቶሜሽን የእይታ ዲዛይነር ነው። ደረጃዎችን — እያንዳንዳቸው ኤጀንት፣ ስፔሻሊስት እርምጃ፣ ወይም የቁጥጥር የመጀመሪያ ደረጃ — ወደ ግራፍ ያቀናብሩ፣ በጥገኞች ያገናኙዋቸው፣ እና ሙሉውን ኦርኬስትራ በኤንጂኑ ላይ በቀጥታ በየደረጃው እድገት፣ በጀቶች እና በሰው-ማጽደቂያ በሮች ያሂዱ። የስራ ፍሰቶች እንደ ተንቀሳቃሽ YAML/JSON ፍቺ ይቀመጣሉ፣ ይህም ከAPI ወይም CLI ወደ ውጭ መላክ፣ ማስመጣት፣ በGit ውስጥ ስሪት ማድረግ እና ማስኬድ ይችላሉ።

17.1 የስራ ፍሰት መገንባት

• ፓሌት (ግራ) — የደረጃ አይነቶችን፣ ዝግጁ የሆኑ የኤጀንት አይነቶችን (ምርምር፣ ኮድ ማመንጨት፣ QA፣ ሰነድ ጸሐፊ፣ የህክምና መሳሪያ፣ የፓተንት አማካሪ፣ እና የራስዎ ብጁ አይነቶች)፣ ክህሎቶችን ከክህሎት ቤተ-መጽሐፍት፣ እና መሳሪያዎችን ወደ ሸራው ይጎትቱ።
• ሸራ (መሃል) — ደረጃዎችን ያዘጋጁ እና ጠርዞችን ይሳሉ፤ አንድ ጠርዝ "ይህ ደረጃ በዚያኛው ላይ የተመሰረተ ነው" ማለት ሲሆን የላይኛውን ውጤት በራስ-ሰር ወደ ታችኛው መጠየቂያ ይመገባል።
• ኢንስፔክተር (ቀኝ፣ ሊቀየር የሚችል) — የተመረጠውን ደረጃ ያዋቅሩ፡ መጠየቂያው፣ ክህሎቶቹ፣ መሳሪያዎቹ፣ በየደረጃው ያለው የሞዴል መሻር፣ የውጤት ቅርሶች፣ በር፣ ክስተቶች፣ እና አይነት-ተኮር መለኪያዎች።
• አብነቶች — ከአብሮ ከተሰራ ሰማያዊ ህትመት (Ship-It Pipeline, SaaS Starter, Data Pipeline with Evals, Customer Comms Hub, Design → Verified App) ይጀምሩ እና ያበጁት።
• አመንጭ — መተግበሪያውን ወይም ሂደቱን በቀላል ቋንቋ ይግለጹ እና የኤጀንት ገንቢው ሊገመግሙት፣ ሊያስተካክሉት እና ሊያካሂዱት የሚችሉትን የተሟላ፣ የተረጋገጠ የስራ ፍሰት ግራፍ ያመነጫል።

17.2 የደረጃ ቤተ-መጽሐፍት

17.3 በክስተት የሚነዱ ኤጀንቶች (የኤጀንት ሜሽ)

እያንዳንዱ ደረጃ — ምንም አይነት ቢሆን — በስራ ቦታው የክስተት አውቶቡስ ላይ ለተተየቡ ክስተቶች ማተም እና መመዝገብ ይችላል፣ ስለዚህ ኤጀንቶች በDAG በኩል ብቻ ሳይሆን በመልእክት ጨርቅ ላይ እንደ አገልግሎቶች ይተባበራሉ።

• የክስተት ክፍሎች — እያንዳንዱ ክስተት ክፍል ይይዛል፡ lifecycle, agent, business, data, system, schedule, chat, external, ወይም alert — በምዝገባዎች እና በድጋሚ ማጫወት ውስጥ ሊጣራ የሚችል።
• የምዝገባ ሁነታዎች — trigger (ተዛማጅ ክስተት ሲደርስ ደረጃው ይሰራ፤ የቆሙ ደረጃዎች ያሉት አሂድ እንደ ማዳመጥ ይቆያል)፣ gate (በሰው ጠቅታ ፋንታ በክስተት የጸደቀ የማሽን በር)፣ እና data (የመረጃው ጭነት ወደ ደረጃው አውድ ይዋሃዳል)።
• በክስተት መጀመር — ማንኛውም ኤጀንት በአርኬስትራተር ወይም በሌላ ኤጀንት ወደ አድራሻው agent.<stage-id>.request በማተም ሊጀመር ይችላል።
• አሂድ ቀስቅሴዎች — የአንድ የስራ ፍሰት triggers: ብሎክ ገቢ ዌብሁኮች፣ cron መርሐግብሮች፣ ክስተቶች፣ ወይም ውይይት ላይ እንዲጀምር ያዘጋጃል — ስቱዲዮው ተዘግቶ እያለ እንኳን።
• ቀጥታ አሂዶች — የአሂድ ፓነል የህይወት ዑደት ክስተቶችን በSSE በኩል ያሰራጫል፡ የደረጃ ጅምር/ማጠናቀቂያዎች፣ በሮች፣ ማንቂያዎች እና ቅድመ እይታዎች ወዲያውኑ ይታያሉ።
• ዘላቂ ምዝግብ ማስታወሻ እና ድጋሚ ማጫወት — ክስተቶች በየስራ ቦታው ይቆያሉ እና ለኦዲት እና ለችግር መፍታት በርዕስ ስርዓተ-ጥለት እና ክፍል እንደገና ሊጫወቱ ይችላሉ።

17.3.1 ለኤጀንቶች የክስተት ወረፋ ማሰለፍ

ለክስተቶች ምላሽ የሚሰጡ ኤጀንቶች ዘላቂ ስም ያለው ወረፋ ማወጅ ይችላሉ ስለዚህ ኤጀንቱ ስራ በዝቶበት ሳለ ወይም አንድ ሩጫ ከማዳመጡ በፊት ተዛማጅ ክስተቶች ፈጽሞ አይጠፉም። በአንድ ትሪገር ምዝገባ ላይ፣ queue: <name> ያዘጋጁ — ሞተሩ ያንን ርዕስ በስራ ቦታው የክስተት አውቶቡስ ላይ ካለ የ FIFO ወረፋ ጋር ያገናኘዋል (ከ.deepcerebra/workflows/events/queues/ ስር ተጠብቆ የሚቆይ)። ከዚያን ጊዜ ጀምሮ የሚታተም እያንዳንዱ ተዛማጅ ክስተት ወደ ወረፋው ይገባል፤ ደረጃው ሊሰራ ሲችል፣ ሞተሩ ክስተቶችን በበጣም ጥንታዊው መጀመሪያ ቅደም ተከተል ያወጣል እና አንድ በአንድ ይበላቸዋል።

• ምንም አይጠፋም — የስራ ፍሰቱ ሲዘጋ፣ ሌላ ደረጃ እየሰራ ሳለ፣ ወይም ሩጫው አሁንም ጥገኞችን እየጠበቀ ሳለ የሚታተሙ ክስተቶች ከመጣል ይልቅ ወረፋ ውስጥ ይሰለፋሉ።
• በምዝገባ count — ምዝገባው ከመሟላቱ በፊት N ወረፋ ውስጥ የገቡ (ወይም የተላኩ) ክስተቶችን ይጠይቃል (በርካታ ሰራተኞች ሪፖርት ማድረግ ሲኖርባቸው ጠቃሚ ነው።)
• ስቱዲዮ — በኢንስፔክተር የክስተቶች ፓነል ውስጥ፣ ወረፋ መስኩን በትሪገር ምዝገባ ላይ ያዘጋጁ፤ ማሰሪያውን በራስ-ሰር ለመፍጠር ትሪገሮችን ያንቁ ወይም ሩጫ ይጀምሩ።
• API እና መሳሪያዎች — GET /api/workflow/queues ጥልቀትን እና ማሰሪያዎችን ይዘረዝራል፤ GET /api/workflow/queues/{name} በመጠባበቅ ላይ ያሉ ክስተቶችን ያሳያል፤ የቻት ኤጀንቶች event_queue_status እና pop_queued_event መጥራት ይችላሉ።

events:
  subscribe:
    - topic: ticket.created
      mode: trigger
      queue: triage-inbox        # durable FIFO — events wait here for this agent
      map:
        payload.ticket_id: ticket_id

17.3.2 ሴማፎር ማስተባበር (የጋራ-ሀብት ጥበቃ)

አንድ ሴማፎር በጋራ (የተጠበቀ) ሀብት ላይ በአንድ ጊዜ ሊሰሩ የሚችሉ ተግባራትን ብዛት ይገድባል: እየተጻፈ ያለ ዳታቤዝ፣ ዓለም አቀፍ ተለዋዋጭ ማከማቻ፣ ፋይል፣ ወይም የፍጥነት ገደብ ያለው ውጫዊ ኤጀንት። semaphore: በመጠቀም ከማንኛውም ደረጃ ጋር ያያይዙት — የደረጃው ስራ ከመጀመሩ በፊት፣ ሞተሩ ስም ከተሰጠው የስራ ቦታ ሴማፎር አንድ ፍቃድ ያገኛል፤ ፍቃዱ ደረጃው ቢከሽፍም እንኳ ከዛ በኋላ ሁልጊዜ ይለቀቃል። permits: 1 mutex ያደርገዋል: በአንድ ጊዜ አንድ ተግባር ብቻ (በስራ ቦታው ውስጥ ባሉ ሁሉም ትይዩ ሩጫዎች ላይ) ወሳኙን እርምጃ ይፈጽማል፤ እያንዳንዱ ሌላ ተግባር ባለቤቱ እስኪጨርስ ይጠብቃል።

• በሩጫዎች መካከል መለያየት — ሴማፎሮች የስራ ቦታ-ተኮር እና ዘላቂ ናቸው፣ ስለዚህ ሁለት በአንድ ጊዜ የሚሰሩ የስራ ፍሰት ሩጫዎች ተመሳሳይ የተጠበቀ ሀብትን ሊያበላሹ አይችሉም።
• መጠበቅ እንጂ አለመዘግየት — ተግባራት እስከ timeout_s ፈቃድ ለማግኘት ይታገዳሉ፤ ሀብቱ በአቅሙ ከቀጠለ፣ ደረጃው ለዘላለም ከመዘግየት ይልቅ በግልጽ ይከሽፋል።
• ከብልሽት ደህንነት — እያንዳንዱ ፍቃድ ttl_s ይይዛል፤ አንድ ባለቤት ሳይለቅ ቢበላሽ፣ ፍቃዱ በራስ-ሰር ጊዜው ያልፍበታል ስለዚህ ሀብቱ ፈጽሞ አይቆለፍም።
• የመታየት ችሎታ — አውቶቡሱ semaphore.<name>.waiting፣ .acquired፣ እና .released የስርዓት ክስተቶችን ያመነጫል፤ GET /api/workflow/semaphores አቅምን፣ ባለቤቶችን፣ እና ያሉ ፍቃዶችን ያሳያል።
• የውይይት ወኪሎች — acquire_semaphore፣ release_semaphore፣ እና semaphore_status መሳሪያዎች ከስራ ፍሰት ውጭ ያሉ ጊዜያዊ ወሳኝ ክፍሎችን ያስተባብራሉ።

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 ሬንዴቩ ማስተባበር (ሁሉንም ሁኔታዎች ይጠብቁ)

ሬንዴቩ በርካታ የክስተት ሁኔታዎች በሙሉ እስኪሟሉ ድረስ ይጠብቃል ቀጣዩ እርምጃ ከመቀጠሉ በፊት — "የመጀመሪያው ክስተት ያሸንፋል" ከሚለው ተቃራኒ። በደረጃው events: ብሎክ ላይ join: all ያዘጋጁ: ደረጃው ከመጀመሩ በፊት እያንዳንዱ የማስነሻ ምዝገባ መሟላት አለበት። በርካታ ወኪሎች (ወይም ከአንድ ወኪል የሚመጡ በርካታ ሪፖርቶች) በሙሉ መመዝገብ ሲኖርባቸው ከእያንዳንዱ ምዝገባ count: N ጋር ያዋህዱ — ለምሳሌ፣ የመልቀቂያ ደረጃ ከመፈጸሙ በፊት የንድፍ ማረጋገጫ፣ የሙከራ ማጠናቀቂያ እና የደህንነት ማጽደቅ።

• join: any (ነባሪ) — ደረጃው የሚሰራው የመጀመሪያው ትሪገር ምዝገባ ሲሟላ ነው።
• join: all — ሬንዴቩ: እያንዳንዱ ትሪገር ምዝገባ (እያንዳንዱ የራሱ ርዕስ፣ የክፍል ማጣሪያ፣ እና አማራጭ count ያለው) መሟላት አለበት፤ ከዚያ በኋላ ብቻ ነው ደረጃው ሊሰራ የሚችለው።
• ፔይሎዶች — ሁሉም የተበሉ ክስተቶች በደረጃው ላይ እንደ trigger_events ይመዘገባሉ እና ለቴምፕሌቶች እንደ inputs.events (የክስተት ነገሮች ዝርዝር ከፔይሎዶች ጋር) ይጋለጣሉ።
• ስቱዲዮ — አንድ ደረጃ ሁለት ወይም ከዚያ በላይ የማስነሻ ምዝገባዎች ሲኖሩት፣ ኢንስፔክተሩ ያሳያል መቀላቀል መራጭ: ማንኛውም — የመጀመሪያው ክስተት ያሸንፋል ወይም ሁሉም — መገናኘት (ሁሉንም ይጠብቁ)፤ ሸራው በመገናኛ ደረጃዎች ላይ የማዋሃድ ባጅ ያሳያል።

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 የኤጀንት መሳሪያዎች ቤተ-መጽሐፍት

ደረጃዎች የውይይት ኤጀንቱ ከሚጠቀመው ተመሳሳይ መዝገብ መሳሪያዎችን ይመርጣሉ፦

• ዋና — ፋይሎች፣ git፣ ሼል፣ ኮድ ማስፈጸም፣ ኮድ መፈለግ፣ አሳሽ አውቶሜሽን፣ ዌብ መፈለግ፣ እይታ/ሚዲያ፣ ምስል ማመንጨት።
• የመረጃ ቋቶች — SQLite, PostgreSQL, MySQL, MongoDB, እና Redis መጠይቆች በተጨማሪም create_database, apply_migrations, እና dump_schema ለባለቤትነት ዳታ ንብርብሮች።
• ግንኙነቶች — የስልክ ጥሪዎች እና SMS (Twilio) እና ኢሜል (SendGrid)፣ ምስክርነቶች በማይኖሩበት ጊዜ ወደ ወጪ መልዕክት ሳጥን የሚመዘግብ የማስመሰል ሁነታ — ማሳያዎች በድንገት እውነተኛ መልዕክቶችን በጭራሽ አይልኩም።
• DevOps — docker_build / docker_push፣ compose up/down፣ SSH እና cloud-CLI ማሰማራቶች (Fly, Render, Railway, Vercel)፣ እንዲሁም ማስመሰል-ደህንነቱ የተጠበቀ።
• ማረጋገጫ — የስታክ ማወቂያ፣ የሙከራ ስብስብ አፈፃፀም ከተተነተኑ የማለፊያ መጠኖች ጋር፣ የጥገኝነት ኦዲቶች፣ እና ሚስጥር መቃኘት።
• SciCompute Engines — በመቶዎች የሚቆጠሩ ሳይንሳዊ እና ምህንድስና ዘዴዎች (Class.method የተሰየሙ) በሂሳብ፣ በሲግናል ማቀነባበሪያ፣ በቁጥጥር፣ በስታቲስቲክስ እና ሌሎችም ላይ።
• የባለሙያ ኤጀንሲ እና MCP — የተመሰረተ የዶሜይን ምርምር በተጨማሪም የሚያገናኙዋቸው ማንኛውም ውጫዊ MCP ሰርቨሮች።

17.5 ማስኬድ፣ በሮች እና ውጤቶች

• አረጋግጥ ግራፉን (ልዩ መለያዎች፣ አሲክሊክ ጥገኞች፣ አይነት መለኪያዎች) ከማስኬድዎ በፊት ይፈትሻል።
• የሰው በሮች ደረጃው ረቂቁን ካመረተ በኋላ አሂዱን ያቆማሉ፣ ስለዚህ እውነተኛ ስራን ያጸድቃሉ፤ የክስተት በሮች ሌላ ስርዓት በራስ-ሰር እንዲያጸድቅ ያስችላሉ።
• በጀቶች በየአሂዱ እና በየደረጃው ወጪን ይገድባሉ።
• ውጤቶችን ወደ ፕሮጀክት አስቀምጥ አንድ አሂድ ያመነጨውን እያንዳንዱን ቅርሶች ወደ ተከፈተው ፕሮጀክትዎ ይገለብጣል።
• መተግበሪያ ወደ ውጭ ላክ የስራ ፍሰቱን ወደ ገለልተኛ FastAPI አገልግሎት ይለውጠዋል፤ የህዝብ /v1 API አሂዶችን፣ ክስተቶችን፣ ቀስቅሴዎችን፣ አብነቶችን እና ለCI እና ውህደቶች ማመንጨትን ያጋልጣል።

18 ትንበያዊ ታብ ማጠናቀቂያ

ትንበያዊ ታብ ማጠናቀቂያ በአርታዒው ውስጥ ሲተይቡ የውስጠ-መስመር፣ መሃል-የሚሞሉ የኮድ ጥቆማዎችን ያቀርባል — ጥቆማን በTab ይቀበሉ። በኤንጂኑ እና በዌብ አርታዒው ላይ አማራጭ ነው።

ያንቁት

• ኢንጂን — የአካባቢውን ባንዲራ DCC_TAB_COMPLETE=1 ያዘጋጁ። አርታዒው የኢንጂኑን POST /api/complete የመጨረሻ ነጥብ ይጠራል፣ ይህም በመጠቆሚያው ላይ የሚገባውን ጽሑፍ ብቻ ይመልሳል።
• ዌብ አርታዒ — በግንባታ ጊዜ በVITE_TAB_COMPLETE=1 ያንቁ፣ ወይም በአሂድ ጊዜ በlocalStorage.setItem('dcc.tabComplete', '1') (ከዚያ እንደገና ይጫኑ)።

እንዴት እንደሚሰራ

• ጥቆማዎች እንደ የመንፈስ ጽሑፍ ይታያሉ፤ ለመቀበል Tab ይጫኑ፣ ወይም ለማሰናበት መተየብዎን ይቀጥሉ።
• ጥያቄዎች ይዘገያሉ እና ሊሰረዙ ይችላሉ፣ ስለዚህ መተየብ በጭራሽ አይታገድም።
• ባንዲራው ሲጠፋ፣ ባህሪው ሙሉ በሙሉ ይሰናከላል እና ምንም የማጠናቀቂያ ጥያቄዎች አይደረጉም።

19 አጠቃቀም፣ ክሬዲቶች እና ክፍያ

እቅድዎን እና አጠቃቀምዎን ለማስተዳደር ከጎን አሞሌው ክፍያ የሚለውን ይክፈቱ። የAI አጠቃቀም በመሰረታዊ ሞዴሎች በሚጠቀሙት ቶከኖች ላይ ተመስርቶ በዩ.ኤስ. ዶላር ክሬዲቶች ይለካል።

• የዑደት ወጪ እና ቅድመ ክፍያ ክሬዲት — በዚህ ዑደት ውስጥ ያለውን አጠቃቀም እና ማንኛውንም ቅድመ ክፍያ ቀሪ ሂሳብ ይከታተሉ።
• ተጨማሪ ክሬዲት አክል — የተካተተው አበል ከጠፋ በኋላ AIን መጠቀም ለመቀጠል ተጨማሪ መጠን (USD) ይፍቀዱ፤ በጀትዎ ካለቀ ክሬዲት እንዲያክሉ የሚጠይቅ ባነር ያያሉ።
• አሻሽል / እቅድ ቀይር — በማንኛውም ጊዜ ደረጃዎችን ይቀይሩ።
• የክፍያ ዘዴ — በፋይል ላይ ያለውን ካርድ ያክሉ ወይም ያዘምኑ (በStripe የሚሰራ)።
• ሰርዝ — ይምረጡ በጊዜ ገደቡ መጨረሻ ሰርዝ (የጊዜ ገደቡ እስኪያልቅ ድረስ መዳረሻውን ያቆዩ) ወይም አሁን ሰርዝ (ሊመለስ የሚችለውን ቀሪ ገንዘብ ይመልሱ). ይመልከቱ የመሰረዝ እና የመመለስ ፖሊሲ.

20 የእርስዎን Gateway API ቁልፍ ማግኘት

የመግቢያ በር API ቁልፍ (የግል መዳረሻ ቶከን) የDeepCerebraን የህዝብ API እና CLI በፕሮግራም እንዲጠቀሙ ያስችልዎታል።

1. ይግቡ እና ከጎን አሞሌው API ቁልፎች የሚለውን ይክፈቱ።
2. ወደ DeepCerebra API ቁልፎች ያሸብልሉ።
3. መለያ ያስገቡ (ለምሳሌ "CI pipeline" ወይም "laptop CLI")።
4. ስፋቶችን ይምረጡ — read, chat, code, agent — እና አማራጭ የሚያበቃበት ቀን በቀናት (ባዶ = በጭራሽ)።
5. አመንጭ የሚለውን ይጫኑ። ሙሉው ቁልፍ አንድ ጊዜ ብቻ ይታያል — ቅዳ የሚለውን ይጫኑ እና ደህንነቱ በተጠበቀ ሁኔታ ያከማቹት።

በdeepcerebra.ai ላይ ከCLI ወይም API ጋር ይጠቀሙበት፦

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 ደህንነት እና ግላዊነት

• ሚስጥራዊ በአሳሽ ውስጥ ማከማቻ — የፕሮጀክት ፋይሎችዎ በአሳሹ የተመሰጠረ የስራ ቦታ ውስጥ ይቆያሉ፤ ለእያንዳንዱ ጥያቄ የሚያስፈልገው አነስተኛ አውድ ብቻ ወደ ሰርቨሩ ይላካል።
• ዜሮ ዳታ ማቆየት (ZDR) — ወደ ሞዴሎች የሚመሩ መጠየቂያዎች እና ኮዶች ከጥያቄው በላይ አይቀመጡም እና የመሠረት ሞዴሎችን ለማሰልጠን በጭራሽ ጥቅም ላይ አይውሉም።
• ቁልፎች በሰርቨር-በኩል ይቆያሉ — BYOK እና SCM ቶከኖች በእረፍት ጊዜ የተመሰጠሩ ናቸው፤ የተሸፈኑ ቅድመ እይታዎች ብቻ ይታያሉ።
• ምስጠራ — TLS በመተላለፍ ላይ፤ የአካውንት ዳታ በእረፍት ጊዜ የተመሰጠረ፤ የይለፍ ቃሎች በማይቀለበስ መልኩ የተመሰጠሩ።
• ኮድዎ የእርስዎ ነው — ይዘትዎን እና የመነጨውን ውጤት ይዞታል። የግላዊነት መግለጫን ይመልከቱ።

22 ችግር መፍታት

"የማህደር ጭነት Chromium አሳሽ ያስፈልገዋል"

ወደ Chrome, Edge, ወይም Brave ይቀይሩ፣ ወይም በምትኩ ከGit ክፈት የሚለውን ይጠቀሙ።

ኤጀንቱ በተመሳሳይ ስህተት ላይ ይሽከረከራል

አቁም የሚለውን ይጫኑ፣ ከዚያ በተጨባጭ ፍንጭ ወይም ገደብ እንደገና ይግለጹ።

የሞዴል ወይም የጥያቄ ስህተቶች / "በጀት አልቋል"

• ግንኙነትዎን እና ማንኛውም BYOK ቁልፍ ትክክለኛ መሆኑን ያረጋግጡ።
• DeepCerebra ወደሚገኝ ሞዴል እንዲመራ አውቶ የሚለውን ይቀይሩ።
• የአጠቃቀም በጀትዎ ካለቀ፣ ክፍያን ይክፈቱ እና ተጨማሪ ክሬዲት ያክሉ ወይም ዕቅድዎን ያሻሽሉ።

አካባቢያዊ ሞዴሎች አይታዩም

• dcc-bridge ማገናኛ እየሰራ መሆኑን እና መሳሪያው ኦንላይን መሆኑን ያረጋግጡ።
• Ollama እየሰራ መሆኑን ያረጋግጡ፣ ወይም LM Studio's አካባቢያዊ ሰርቨር (ነባሪ ወደብ 1234) ሞዴል ተጭኖ እንዲነቃ ያድርጉ።

ማገናኛ፡ "ሰርቨር የWebSocket ግንኙነትን አልተቀበለም፡ HTTP 401"

• በአሳሽዎ ውስጥ የሚጠቀሙበትን ተመሳሳይ ጎራ እንደ --gateway ይጠቀሙ (wss://deepcerebra.ai ወይም wss://deepcerebra.io) — ሁለቱ ድረ-ገጾች የተለያዩ ማሰማራቶች ናቸው፣ እና ከአንዱ የተገኘ ቶከን በሌላኛው ላይ በጭራሽ አይሰራም።
• በትክክል ትዕዛዙን ከአካባቢያዊ ማሽን ገጽ ላይ ካለው ማጣመሪያ ካርድ ይቅዱ።

ለውጦቼ አልሰሩም

• በየታቀዱ ለውጦች ውስጥ ተግብር የሚለውን (ልዩነቱን ከማየት ብቻ ሳይሆን) መጫንዎን ያረጋግጡ።
• ማህደሩን እንደገና ለመቃኘት የኤክስፕሎረር አድስ የሚለውን ይጠቀሙ።

Git: "በነባሪው ቅርንጫፍ ላይ ነዎት"

የፑል ጥያቄ ለመክፈት አዋህድ የሚለውን ከመጠቀምዎ በፊት የስራ ቅርንጫፍ ይክፈቱ ወይም ይፍጠሩ።

አሁንም ተቸግረዋል? support@deepcerebra.aiን ያግኙ።

23 DeepCerebra Discovery — ውሂብዎን እና ሰነዶችዎን ይጠይቁ

Discovery ለ**ዳታቤዝዎ እና ለሰነዶችዎ** የምርመራ ቻትቦት ነው። በአንድ ጥያቄ ከመመለስ ይልቅ፣ እንደ ተንታኝ ይሰራል፡ **ግምቶችን** ይፈጥራል፣ ተከታታይ ጥበቃ የተደረገባቸው ምርመራዎችን (SQL፣ ግራፍ፣ የሰነድ ፍለጋ፣ የስኪማ ማረጋገጫዎች፣ የድር ማረጋገጫ) ያካሂዳል፣ ማስረጃዎች የሚሽሯቸውን ማብራሪያዎች ያስወግዳል፣ እና **መሰረታዊ መልስ** — ከገበታዎች እና ግልጽ የወጪ ደረሰኝ ጋር — ያዋህዳል። በእንቅስቃሴ መስመሩ ውስጥ ካለው **ኮምፓስ አዶ** (/app/discovery) ይክፈቱት።

23.1 ስፔሶች — የእርስዎ የተመረጠ ወሰን

አንድ **ስፔስ** አንድ የምርመራ መስመር የሚያስፈልገውን ሁሉ ያጠቃልላል፡ የዳታቤዝ ግንኙነቶች፣ የሰነድ ስብስቦች፣ ለተንታኙ መመሪያዎች፣ እና በጀቶች። **+ አዲስ ስፔስ** በመጠቀም አንዱን ይፍጠሩ፣ ከዚያ በቀኝ በኩል ያለውን የማዋቀሪያ ፓነል በመጠቀም የሚከተሉትን ያድርጉ፦

• **ዳታቤዞችን ያገናኙ** — SQLite፣ PostgreSQL፣ MySQL፣ SQL Server፣ ወይም Snowflake። ስም እና DSN ያስገቡ፣ ግንኙነቱን ለማረጋገጥ (የመዘግየት ጊዜ እና የሰርቨር ስሪት ይታያል) **Test** የሚለውን ይጫኑ፣ ወይም ያለውን የግንኙነት ውቅር እንደ JSON ያስመጡ። ግንኙነቶች **በነባሪ ለማንበብ ብቻ** ናቸው።
• **ሰነዶችን ያክሉ** — ፋይሎችን (PDF፣ DOCX፣ PPTX፣ Markdown፣ text) በቀጥታ ወደ ቻቱ ይጎትቱ እና ይጣሉ፣ URL ይለጥፉ፣ ወይም በኤንጂኑ አስተናጋጅ ላይ ወዳለ የአቃፊ መንገድ ያመልክቱ። ሰነዶች ለድብልቅ ቬክተር + የእውቀት-ግራፍ ፍለጋ ተከፋፍለው፣ ተካተው እና ተጠቁመዋል።
• **ሠንጠረዦችን ያስመጡ** — ምንም ዳታቤዝ ሳይኖር ወዲያውኑ ለመጠየቅ CSV/JSON ይለጥፉ ወይም ይስቀሉ።
• **ተንታኙን ያስተምሩ** — የመለኪያ ትርጓሜዎችን፣ የንግድ ደንቦችን እና ማስጠንቀቂያዎችን፣ በኩሬተር የተፈቀዱ የታመኑ ጥያቄዎችን፣ እና ምሳሌያዊ ጥያቄ→ጥያቄ ጥንዶችን ያክሉ ስለዚህ መልሶች የእርስዎን ትርጓሜዎች ይጠቀማሉ።

23.2 ጥያቄ መጠየቅ

ጥያቄን ባልደረባዎን እንደሚጠይቁት ይተይቡ — ለምሳሌ "በመጋቢት ወር የMRI ቅኝት መጠን ለምን ቀንሷል?"። **የምርመራ ቦርዱ** ሙሉውን ሂደት በቀጥታ ያሳያል፦

• **ግምቶች** — እየተመረመሩ ያሉ እጩ ማብራሪያዎች፣ እያንዳንዳቸው ማስረጃ ሲደርስ **የተደገፉ**፣ **የተሻሩ**፣ ወይም **ያልተወሰነ** ተብለው ምልክት ይደረግባቸዋል።
• **ምርመራዎች** — ተንታኙ የሚያካሂደው እያንዳንዱ ጥያቄ፣ ከሁኔታው ጋር፤ የተፈጠረ SQL/Cypher ለሙሉ ግልጽነት ይታያል፣ እና እያንዳንዱ መግለጫ ከመፈጸሙ በፊት ለማንበብ-ብቻ የጥበቃ ደንቦችን ያልፋል።
• **ማስረጃ** — የውጤት ሠንጠረዦች እና የሰነድ ቅንጣቢዎች፣ በመጨረሻው መልስ ውስጥ በቁጥር የተጠቀሱ።
• **መልስ + ገበታዎች** — የተሻሩትን ማብራሪያዎች የሚጠቅስ መሰረታዊ መደምደሚያ፣ በተጨማሪም ከማስረጃው የተሰሩ ዘመናዊ የኒዮን-ገጽታ ያላቸው ገበታዎች።
• **ደረሰኝ** — ቶከኖች፣ ለእያንዳንዱ ምርመራ የሚወጣ ወጪ፣ እና ዙሮች፣ እንደ ማንኛውም ሌላ ወኪል አሂድ ለAI Creditsዎ የሚከፈሉ።

ተከታይ ጥያቄዎች ተመሳሳይ ክር ይቀጥላሉ፣ ስለዚህ ተንታኙ አውዱን ይይዛል።

23.3 ገበታዎች፣ ሪፖርቶች እና ወደ ውጭ መላክ

ገበታዎች በምርመራ ቦርዱ ላይ በውስጥ መስመር ይታያሉ። ሙሉውን ጥያቄ — መልሱን፣ ግምቶችን፣ ማስረጃዎችን እና ገበታዎችን — እንደ ራሱን የቻለ **HTML ሪፖርት** ወይም የህትመት ጥራት ያለው **PDF**፣ በኒዮን ዲዛይን ሲስተም የተሰራ፣ ለማውረድ **Export** የሚለውን ይጠቀሙ።

23.4 በጀቶች እና የወጪ ቁጥጥር

እያንዳንዱ ስፔስ ለእያንዳንዱ ጥያቄ በጀቶችን ይይዛል፡ ከፍተኛው የምርመራዎች ብዛት፣ የምርመራ ዙሮች፣ ሰከንዶች፣ እና USD። ኤንጂኑ በገደቡ ላይ ንጹህ በሆነ መንገድ ይቆማል እና እስካሁን ያገኘውን ሪፖርት ያደርጋል። የእያንዳንዱ ምርመራ ወጪ በደረሰኙ ላይ በዝርዝር ተቀምጧል፣ ስለዚህ ወጪው የት እንደሄደ ሁልጊዜ ያውቃሉ።

23.5 አውቶሜሽን፡ API፣ SDK፣ Workflow Studio እና MCP

• **REST API** — UI የሚያደርገው ነገር ሁሉ በ/v1/discovery/* ስር የሚገኝ ሲሆን discovery ስኮፕ ያለው PAT (በ**Account → API Tokens** ስር ይፍጠሩት)። የዥረት ጥያቄዎች SSEን ይጠቀማሉ። ውጫዊ አስፈጻሚዎች የምርመራ እቅድን ብቻ በThinking API (/v1/think/*፣ ስኮፕ think) መበደር ይችላሉ።
• **Python SDK** — pip install deepcerebra-discovery፣ ከዚያ DiscoveryClient(base_url, token).ask(space_id, question)።
• **Workflow Studio** — **Discovery Ask** ደረጃውን (discovery.ask) ወደ ማንኛውም የስራ ፍሰት (workflow) በመጣል ምርመራን እንደ የቧንቧ መስመር ደረጃ ያካሂዱ፤ መልሱ፣ ገበታዎቹ እና ደረሰኙ ወደ ታችኛው ደረጃዎች ይፈስሳሉ።
• **MCP** — ኤንጂኑ discovery_ask እና discovery_list_spacesን እንደ MCP መሳሪያዎች ያጋልጣል፣ ስለዚህ ውጫዊ MCP ደንበኞችም ምርመራዎችን ማካሄድ ይችላሉ።