संयोज्य प्रोजेक्ट टेम्पलेट

cargo adk new तीन विकल्पों से एक कार्यशील Rust प्रोजेक्ट बनाता है:

एक टेम्पलेट एजेंट या वर्कफ़्लो की संरचना निर्धारित करता है;
ऐड-ऑन सत्रों, MCP या टेलीमेट्री जैसी क्षमताएँ जोड़ते हैं; और
एक एंटरप्राइज़ पैटर्न सामान्य उत्पाद संरचना के लिए एक टेम्पलेट और ऐड-ऑन के समीक्षित समूह का चयन करता है।

स्थापित CLI ही प्रामाणिक स्रोत है, क्योंकि कस्टम टेम्पलेट निर्देशिकाएँ अंतर्निहित रजिस्ट्री का विस्तार या प्रतिस्थापन कर सकती हैं।

cargo adk templates
cargo adk addons
cargo adk new --help

प्रोजेक्ट बनाएँ

# One LLM agent
cargo adk new support-agent --template llm

# A tool-using agent with operating capabilities
cargo adk new support-agent \
  --template tools \
  --addon sessions \
  --addon telemetry \
  --addon guardrails

# Preview generated files without writing them
cargo adk new support-agent --template graph --dry-run

basic, llm का उपनाम बना रहता है। नए दस्तावेज़ीकरण और स्वचालन में स्पष्ट llm नाम का उपयोग करें।

अंतर्निहित टेम्पलेट

अंतर्निहित रजिस्ट्री में वर्तमान में 13 टेम्पलेट शामिल हैं।

टेम्पलेट	यह क्या बनाता है	इसे तब चुनें जब
`llm`	एक संवादात्मक `LlmAgent`	एक एजेंट अनुरोध का स्वामित्व लेकर आवश्यकतानुसार टूल कॉल कर सकता हो
`tools`	एक LLM एजेंट और टाइप किए गए `#[tool]` उदाहरण	पहला उपयोगी मील का पत्थर एक दृश्यमान Rust टूल कॉल हो
`rag`	वेक्टर-सर्च ज्ञान पथ वाला एजेंट	उत्तरों में निजी दस्तावेज़ या ज्ञान संग्रह का उपयोग होना चाहिए
`api`	HTTP API के माध्यम से उपलब्ध एजेंट	कोई अन्य अनुप्रयोग नेटवर्क पर एजेंट को कॉल करेगा
`openai`	OpenAI के लिए कॉन्फ़िगर किया गया LLM एजेंट	OpenAI इच्छित आरंभिक प्रदाता है
`sequential`	निश्चित क्रम में निष्पादित किए गए एकाधिक एजेंट	प्रत्येक चरण पिछले चरण के कार्य पर निर्भर करता है
`parallel`	एकत्रित परिणामों वाले समवर्ती विशेषज्ञ	स्वतंत्र कार्य एक ही समय पर चल सकते हैं
`loop`	शर्त पूरी होने तक दोहराया जाने वाला निष्पादन	समीक्षक, सुधार या परिष्करण चक्र के लिए सीमित लूप आवश्यक है
`conditional`	एजेंटों के बीच निर्णय-आधारित रूटिंग	अलग-अलग अनुरोधों के लिए अलग-अलग विशेषज्ञों या मार्गों की आवश्यकता होती है
`graph`	चेकपॉइंट वाला शाखित वर्कफ़्लो	कार्य को फिर से शुरू करने, शाखित होने, जुड़ने या प्रक्रिया विफलता से बचने में सक्षम होना चाहिए
`realtime`	द्विदिशीय ऑडियो और वीडियो प्रबंधन	उत्पाद को लाइव वॉइस या मल्टीमॉडल वार्तालाप की आवश्यकता है
`custom`	`Agent` trait का मैन्युअल कार्यान्वयन	निष्पादन अनुबंध को बिल्ट-इन agent द्वारा व्यक्त नहीं किया जा सकता
`agent-engine`	`Dockerfile` और `deploy/terraform/` वाला Gemini Enterprise Agent Engine BYOC कंटेनर	agent, Agent Runtime पर प्रीबिल्ट कंटेनर के रूप में डिप्लॉय होता है

पहले निष्पादन संरचना चुनें। कार्यप्रवाह तय करने के लिए sessions, MCP, टेलीमेट्री या अन्य उत्पाद क्षमताओं का उपयोग करने के बजाय, उन्हें बाद में जोड़ें।

क्षमता विस्तार

क्षमताओं को संयोजित करने के लिए --addon दोहराएँ। जनरेटर उनके feature flags, imports, initialization fragments, environment examples और generated files को एक स्थिर प्राथमिकता क्रम में हल करता है।

ऐड-ऑन	यह क्या जोड़ता है	इसे इस्तेमाल करने का सामान्य कारण
`telemetry`	OpenTelemetry ट्रेसिंग सेटअप	मॉडल, एजेंट और टूल की सीमाओं के बीच अनुरोधों का अनुसरण करना
`auth`	API-की और JWT प्रमाणीकरण का आधारभूत ढाँचा	तैनात एजेंट एंडपॉइंट की सुरक्षा करना
`sessions`	सत्र स्थिति सेवा सेटअप	संग्रहीत स्थिति के साथ बातचीत या वर्कफ़्लो जारी रखें
`memory`	सेमैंटिक मेमोरी और RAG एकीकरण	वर्तमान बातचीत से परे प्रासंगिक ज्ञान प्राप्त करें
`mcp`	MCP सुविधा वायरिंग और क्लाइंट प्रारंभिक बिंदु	किसी अन्य प्रक्रिया या सेवा के स्वामित्व वाली क्षमताओं को कनेक्ट करें
`guardrails`	इनपुट और आउटपुट सत्यापन हुक	एजेंट निष्पादन से पहले और बाद में उत्पाद नियम लागू करें
`eval`	मूल्यांकन हार्नेस का ढाँचा	रिलीज़ से पहले दोहराए जा सकने वाले मामलों के आधार पर व्यवहार को मापें
`browser`	ब्राउज़र स्वचालन एकीकरण	अनुमोदित एजेंट को वेब इंटरफ़ेस संचालित करने दें
`server`	Axum HTTP और A2A सर्वर सेटअप	दूरस्थ कॉल करने वालों के लिए एजेंट प्रकाशित करें
`docker`	बहु-चरणीय कंटेनर बिल्ड फ़ाइलें (`Dockerfile`, `Dockerfile.static`, `.dockerignore`)	एजेंट को न्यूनतम कंटेनर इमेज के रूप में पैकेज करें

उदाहरण:

cargo adk new order-agent \
  --template tools \
  --addon mcp \
  --addon sessions \
  --addon server \
  --addon auth \
  --addon telemetry

जेनरेट किया गया क्षमता कोड एक प्रारंभिक बिंदु है। रिलीज़ से पहले प्लेसहोल्डर एंडपॉइंट, क्रेडेंशियल, नीतियों और इन-मेमोरी सेवाओं को परिनियोजन-स्वामित्व वाले विकल्पों से बदलें।

संयोजित एंटरप्राइज़ पैटर्न

पैटर्न सामान्य टेम्पलेट के समान --template नेमस्पेस में दिखाई देते हैं। कोई अलग --pattern फ़्लैग नहीं है।

पैटर्न	संरचना	उत्पाद का प्रारंभिक बिंदु
`multi-agent`	`sequential` + टेलीमेट्री	एक दृश्यमान बहु-चरणीय कार्यप्रवाह
`production`	`llm` + सर्वर + प्रमाणीकरण + सत्र + टेलीमेट्री	एक प्रमाणीकृत, अवलोकनीय एजेंट सेवा
`pipeline`	`sequential` + सत्र + टेलीमेट्री	स्थिति-सक्षम प्रसंस्करण पाइपलाइन
`chatbot`	`llm` + सत्र + मेमोरी + सर्वर	स्मरण क्षमता वाला संवादात्मक HTTP उत्पाद
`a2a-server`	`llm` + सर्वर + सत्र	स्वतंत्र रूप से परिनियोजित A2A एजेंट

a2a, a2a-server का उपनाम बना रहता है।

cargo adk new operations-agent --template production
cargo adk new research-team --template multi-agent --addon eval
cargo adk new public-specialist --template a2a-server --addon auth

प्रदाता और मॉडल का चयन

टेम्पलेट में एक डिफ़ॉल्ट प्रदाता होता है, लेकिन CLI निष्पादन संरचना बदले बिना इसे ओवरराइड कर सकता है।

cargo adk new support-agent \
  --template tools \
  --provider openai \
  --model company-approved-model

CI में --non-interactive का उपयोग करें, ताकि अनुपलब्ध विकल्प प्रॉम्प्ट खोलने के बजाय विफल हो जाएँ। जब किसी अन्य प्रोग्राम को जनरेशन परिणाम की आवश्यकता हो, तब --json-output का उपयोग करें।

कस्टम टेम्पलेट

जब किसी संगठन को अंतर्निहित रजिस्ट्री से आगे एक पुनः उपयोग योग्य शुरुआती आधार की आवश्यकता हो, तब TOML मैनिफेस्ट वाली एक निर्देशिका पास करें।

cargo adk new finance-agent \
  --template company-finance \
  --template-dir ./agent-templates

अंतर्निहित टेम्पलेट के समान नाम वाला कस्टम टेम्पलेट उस CLI आह्वान के लिए उसे प्रतिस्थापित कर देता है। मैनिफेस्ट को संस्करण नियंत्रण में रखें और जनरेट किए गए प्रोजेक्ट का CI में परीक्षण करें।

name = "company-finance"
description = "Company finance agent with approved defaults"
provider = "openai"
features = ["minimal", "tools"]
imports = ["use std::sync::Arc;"]

जनरेट किए गए प्रोजेक्ट का सत्यापन करें

cd support-agent
cargo adk build
cargo run

cargo adk build जनरेट किए गए प्रोजेक्ट को तैनात किए बिना संकलित और सत्यापित करता है। जनरेट किए गए स्रोत को कमिट करें, इसकी सक्षम सुविधाओं और पर्यावरण संबंधी आवश्यकताओं की समीक्षा करें, और उसी कमांड को CI गेट के रूप में बनाए रखें।

ऑटोमेशन को अद्यतन रखें

रजिस्ट्री की सामग्री रिलीज़ के बीच बदल सकती है। स्वचालित प्रोजेक्ट जनरेशन को अपग्रेड करने से पहले:

cargo adk templates
cargo adk addons
cargo adk new smoke-agent --template tools --addon mcp --dry-run

यह बिल्ड पर्यावरण में इंस्टॉल किए गए सटीक cargo-adk बाइनरी के आधार पर नामों और संगतता का सत्यापन करता है।