अन्य भाषाओं में: English, Español, Português, 日本語, Deutsch, Français, 한국어, 简体中文, Italiano · हिन्दी में सभी गाइड
प्रकटीकरण: Carbon Forge हम 100monkeys.ai में बनाते हैं, इसलिए इसे बनाने वाले का विवरण मानकर पढ़ें। इस गाइड का मसौदा हमारे एक AI एजेंट ने सार्वजनिक दस्तावेज़ों (अंग्रेज़ी में) से तैयार किया, ख़ासकर MCP token scopes (R#62460), MCP tokens (R#61824) और Tokens catalog page (R#62188) से, और कंपनी ने इसकी समीक्षा की; यह हिन्दी संस्करण मूल अंग्रेज़ी गाइड का अनुवाद है। प्रीसेट के नाम, आर्ग्युमेंट और उद्धृत वाक्य दस्तावेज़ों के अपने हैं, उद्धरण अंग्रेज़ी में और अनुवाद साथ में; दस्तावेज़ token बनाने की कोई पूरी कॉल नहीं देते, इसलिए नमूने के बजाय आर्ग्युमेंट की सूची दिखाई गई है। जहाँ दस्तावेज़ कोई सवाल खुला छोड़ते हैं, आख़िरी हिस्सा वह बताता है।
हर token पर दो सीमाएँ
token के साथ एक भूमिका सीमा (viewer, editor या admin) और एक टूल-स्कोप होता है, यानी "the explicit set of MCP tools the bearer is allowed to call." (उन MCP टूल का स्पष्ट सेट जिन्हें धारक कॉल कर सकता है।) भूमिका सीमा अनुमति की ऊपरी हद है; स्कोप उसे और सीमित करता है। दस्तावेज़ों का उदाहरण: admin token पर SCM reader स्कोप वही टूल कैटलॉग लौटाता है जो viewer token पर वही स्कोप।
तय करें कि एजेंट को क्या करना है
फ़ॉर्म खोलने से पहले एजेंट का काम एक पंक्ति में लिख लें: खोजना और तर्क करना, नोट रखना, कोड पढ़ना, किसी lane पर बनाना, या रिलीज़ करना। हर काम नीचे के किसी प्रीसेट से मेल खाता है। दस्तावेज़ों का नियम: "Default to the narrowest preset that still covers what the client needs." (डिफ़ॉल्ट रूप से सबसे सीमित वह प्रीसेट लें जो फिर भी क्लाइंट की ज़रूरत पूरी करे।)
भूमिका सीमा सेट करें
सेटिंग खोलें, API tokens चुनें, और वर्कस्पेस तथा भूमिका सीमा चुनें। SCM प्रीसेट बताते हैं कि वे किस भूमिका के साथ जाते हैं: SCM reader के साथ viewer, SCM agent और SCM release के साथ editor।
सबसे सीमित प्रीसेट चुनें
प्रीसेट, दस्तावेज़ों में दी गई टूल गिनती के साथ (हर एक में cortex.ground शामिल है):
- Read-only memory (
read_only_memory, 14): पेज और atom पढ़ना, खोजना, क्रॉस-लिंक फ़ॉलो करना; लिखना नहीं। - Basic LLM memory (
basic_memory, 30): पेज, atom और टैग पढ़ना-लिखना, और खोजना। - Knowledge-graph reader (
knowledge_graph_reader, 31): हर सामग्री सतह और ग्राफ़, लिखना नहीं। - SCM reader (
scm_reader, 58): कोड ट्री, lane, changeset, cut और फ़ाइल ट्री, साथ में पेज और खोज; लिखना नहीं। - SCM agent (
scm_agent, 104): SCM पढ़ना, साथ में पेज, atom, lane और ट्री लिखना, lane लैंड करना, cut बनाना और रेंडर करना। - SCM release (
scm_release, 67): SCM पढ़ना, साथ में lane लैंड और मंज़ूर करना, cut बनाना, आर्काइव पुश करना और साइट प्रकाशित करना। - Full access (
full, 177): हर टूल, भूमिका सीमा के भीतर।
lane पर बनाने वाले कोडिंग एजेंट को SCM agent मिलता है; मंज़ूरी देने वाले समीक्षक को SCM release; रिसर्च एजेंट को कोई reader। दस्तावेज़ Full access को उस क्लाइंट के लिए रखते हैं जिस पर "trusted with anything the role can do" (भूमिका जो कुछ भी कर सकती है, उस सब के लिए भरोसा) हो।
एक अतिरिक्त टूल के लिए Custom इस्तेमाल करें
जब किसी प्रीसेट में एक टूल कम पड़े, Custom चुनें और समूहों वाले चयनकर्ता से टूल चुनें। दस्तावेज़ों का उदाहरण एक प्रकाशन एजेंट है "that should be able to create comments but not pages" (जो टिप्पणियाँ बना सके पर पेज नहीं)। स्कोप टूल सूची पर, /api/mcp/manifest के मैनिफ़ेस्ट पर और हर कॉल पर लागू होता है। स्कोप के बाहर का टूल Unknown tool: <name> जवाब देता है, "exactly as a tool that does not exist" (बिल्कुल उस टूल की तरह जो मौजूद नहीं), ताकि क्लाइंट यह न जान सके कि उसके token में क्या कमी है।
token बनाएँ और सीक्रेट संभालें
token का नाम उस एजेंट या माहौल पर रखें जो उसे रखेगा, फिर सीक्रेट कॉपी करें: "it is shown once, then only the prefix." (यह एक बार दिखता है, फिर केवल उपसर्ग।) हर token अपना मौजूदा वर्कस्पेस अलग रखता है, इसलिए दो token पर चल रहे दो एजेंट एक-दूसरे का पॉइंटर नहीं हिलाते।
एक्ज़ीक्यूशन token केवल ऑर्केस्ट्रेटर के लिए चालू करें
एक्ज़ीक्यूशन token "a short-lived child of one of your tokens, minted for a single AEGIS run" (आपके किसी token का कम समय का चाइल्ड, एक AEGIS रन के लिए बनाया गया) है, जहाँ AEGIS by 100monkeys.ai, in beta, एजेंट चलाने वाला ऑर्केस्ट्रेटर है। कोई token चाइल्ड तभी बना सकता है जब उसका मालिक token फ़ॉर्म में May mint execution tokens (एक्ज़ीक्यूशन token बना सकता है) पर टिक करे। यह डिफ़ॉल्ट रूप से बंद है, कोई प्रीसेट इसे चालू नहीं करता, और दस्तावेज़ कहते हैं "leave it off unless an orchestrator holds the token." (इसे बंद रखें जब तक token किसी ऑर्केस्ट्रेटर के पास न हो।) बनाने वाला टूल केवल full प्रीसेट में है।
एक रन के लिए चाइल्ड token बनाएँ
पैरेंट इन आर्ग्युमेंट के साथ tokens.mint_execution कॉल करता है:
execution_id, instance_id, workspace_id, tree_path, lane_label, tools, role_cap, lifetime_seconds, workflowएक इंस्टेंस, एक वर्कस्पेस, एक ट्री पाथ, एक lane लेबल, पैरेंट के पास मौजूद 1 से 166 टूल, पैरेंट जितनी या viewer भूमिका सीमा, और अधिकतम 86,400 सेकंड की अवधि जो पैरेंट की समाप्ति से आगे कभी नहीं जाती। workflow वैकल्पिक है: उस लैंडिंग नियम के गेट का नाम जिसे रन चलाता है। जवाब:
{ token_id, parent_token_id, execution_id, instance_id, workspace_id, tree_path, lane_label, workflow, role_cap, tools, expires_at, secret }कोई भी विस्तार एक वाक्य के साथ अस्वीकार होता है और कुछ नहीं बनता। चाइल्ड का हर लेखन अपनी lane का नाम देता है और अपने पाथ के भीतर रहता है; lane forge/run-1 और पाथ apps/web के लिए दस्तावेज़ों के इनकार संदेश:
This execution token writes only to lane "forge/run-1", not to the trunk.
This execution token writes only under "apps/web", not to "apps/api/x.ts".चाइल्ड कभी दूसरी पहचान नहीं होता: उसका हर बदलाव आपको कर्ता के रूप में और उस रन को दर्ज करता है जिसके लिए वह बनाया गया।
रद्द करें, और ऑडिट लॉग पढ़ें
चाइल्ड ख़ुद को, या उसका पैरेंट उसे, tokens.revoke_execution से रद्द करता है; रद्द करने वाले सर्वर पर वह तुरंत और बाक़ी हर जगह 30 सेकंड के भीतर प्रमाणित होना बंद कर देता है। पैरेंट को रद्द करने, या उसका स्कोप बदलने से, हर चाइल्ड रद्द हो जाता है। हर टूल कॉल token की पहचान के साथ ऑडिट लॉग में दर्ज होती है, और हर बनाना और रद्द करना पैरेंट, चाइल्ड और रन का नाम लेने वाली एक ऑडिट पंक्ति लिखता है।
किसी रन की मंज़ूरी को संरक्षित trunk पर गिनवाने के लिए हमारी गाइड लैंडिंग नियम: रिकॉर्ड में रखे गए कोड ओनर, और गेट के रूप में एक AEGIS वर्कफ़्लो पढ़ें।
दस्तावेज़ किन सवालों का जवाब नहीं देते
- एक पूरा उदाहरण। कैटलॉग बनाने के आर्ग्युमेंट और जवाब गिनाता है पर कोई नमूना कॉल नहीं दिखाता।
- टूल की ऊपरी सीमा। चाइल्ड 1 से 166 टूल लेता है जबकि
fullप्रीसेट में 177 हैं; कौन-से टूल चाइल्ड को नहीं मिल सकते, यह सूचीबद्ध नहीं है। - ऑर्केस्ट्रेटर को पैरेंट token कैसे मिलता है। दस्तावेज़ कहते हैं कि बनाना तभी चालू करें जब token ऑर्केस्ट्रेटर के पास हो, पर यह नहीं कि वह token AEGIS को कैसे दिया जाए।
- प्रीसेट सूचियाँ कहाँ हैं। गिनती दी गई है; हर प्रीसेट के टूल के नाम केवल फ़ॉर्म के चयनकर्ता में हैं।