ADK-Rust आधिकारिक दस्तावेज़

ADK-Rust (Rust के लिए Agent Development Kit) के आधिकारिक दस्तावेज़ में आपका स्वागत है। यह दस्तावेज़ ADK फ्रेमवर्क के Rust कार्यान्वयन का उपयोग करके AI agents बनाने के लिए व्यापक मार्गदर्शिकाएँ और संदर्भ प्रदान करता है।

शुरुआत करना

• परिचय - ADK-Rust, इसकी संरचना और प्रमुख अवधारणाओं का अवलोकन
• त्वरित शुरुआत - 5 मिनट से कम समय में एम्बेडेड UI में अपना पहला agent तैयार करें, चलाएँ और परीक्षण करें
• A2UI त्वरित शुरुआत - A2UI JSONL उत्सर्जित करें और इसे React में रेंडर करें
• 1.0 → 2.0 में माइग्रेट करना - पहले/बाद के कोड सहित पूर्ण breaking-change सूची

कोर

• कोर प्रकार - मूलभूत प्रकार: Content, Part, Agent trait, Tool trait, contexts
• रनर - Agent निष्पादन रनटाइम और कॉन्फ़िगरेशन
• प्लगइन्स - tool/model interception और middleware के लिए lifecycle hooks

मॉडल

• मॉडल प्रदाता - LLM एकीकरण: Gemini, OpenAI, Anthropic, DeepSeek, Groq, Ollama
• Ollama - Ollama के साथ स्थानीय inference
• mistral.rs एकीकरण - उच्च-प्रदर्शन वाले स्थानीय inference के लिए native mistral.rs

Agents

• LlmAgent - Large Language Models का उपयोग करने वाला मूल agent प्रकार
• CodeAgent (CodeAct) - CodeRuntime के माध्यम से कोड लिखकर और चलाकर कार्य करता है
• वर्कफ़्लो Agents - नियतात्मक agents: Sequential, Parallel, Loop
• मल्टी-Agent सिस्टम - sub-agents के साथ agent पदानुक्रम बनाना
• ग्राफ़ Agents - LangGraph-शैली वर्कफ़्लो ऑर्केस्ट्रेशन
• रीयलटाइम Agents - OpenAI/Gemini के साथ आवाज़-सक्षम agents

कोडिंग Agent

एक native coding agent: sandboxed workspace में कोड पढ़ना/संपादित करना/चलाना, autonomous goal mode, और parallel ultra-review workflows।

• अवलोकन - यहाँ से शुरू करें: घटक, इंस्टॉल करना, और 60-सेकंड का त्वरित आरंभ
• डेव टूल्स - adk-devtools: read/write/edit/glob/grep/bash + sandboxed Workspace
• हार्नेस - CodingAgent (coding सुविधा), plan loop, write_todos
• CLI - adk-rust code / goal (durable, resumable) / ultracode
• वर्कफ़्लो - adk-graph पर Ultra-review: parallel reviewers + fan-in
• उदाहरण - चलाए जा सकने वाले तीन example crates

रीयलटाइम और मल्टीमॉडल

voice + multimodal agents बनाने के लिए एक समर्पित, नए उपयोगकर्ताओं के अनुकूल मार्गदर्शिका — architecture, concepts, और चलाए जा सकने वाले examples।

• अवलोकन - यहाँ से शुरू करें: mental model, इंस्टॉल करना, और 60-सेकंड का त्वरित आरंभ
• आर्किटेक्चर - चार layers, event loop, audio pipeline, और turn lifecycle
• प्रोवाइडर - OpenAI Realtime और Gemini Live models, voices, और चुनाव कैसे करें
• टूल्स - Server-side actions: native handlers, bridged adk_core::Tools, parallel calls
• मल्टीमॉडल - send_video_frame और browser camera capture के माध्यम से video input
• Affective Dialogue - Gemini native-audio पर emotion-aware responses
• मेमोरी - Context injection, turn storage, और knowledge-graph self-curation
• वेब ऐप्स बनाना - Server-side bridge, WS protocol, और Web Audio
• उदाहरण - चलाए जा सकने वाले चार examples और सुझाया गया learning path

टूल्स

• फ़ंक्शन टूल - async Rust फ़ंक्शन के साथ कस्टम टूल बनाएँ
• बिल्ट-इन टूल - पहले से बनाए गए टूल, जैसे GoogleSearchTool
• MCP का अवलोकन और आर्किटेक्चर - MCP कहाँ उपयुक्त है और किस ADK-Rust सतह का उपयोग करना है
• MCP क्लाइंट - टूल, संसाधन, प्रॉम्प्ट, पूर्णता, सदस्यताएँ, जानकारी माँगना, कार्य और HTTP
• डायनेमिक MCP सर्वर प्रबंधक - रनटाइम स्थानीय-सर्वर रजिस्ट्री, स्थायित्व, निगरानी और पुनःप्रारंभ
• MCP सर्वर लेखन - संरेखित आधिकारिक Rust SDK के साथ टूल और अन्य क्षमताएँ प्रकाशित करें
• MCP सुरक्षा - प्रमाणीकरण, दृश्यता, प्राधिकरण, अनुमोदन और गुप्त जानकारी प्रबंधन
• MCP परीक्षण - नियतात्मक गेट और परिनियोजन सत्यापन
• ब्राउज़र टूल - वेब ऑटोमेशन के लिए 46 WebDriver टूल
• UI टूल - फ़ॉर्म, कार्ड और चार्ट के साथ डायनेमिक UI निर्माण
• RAG - नॉलेज बेस खोज के लिए Retrieval-Augmented Generation
• ACP टूल - ACP कोडिंग एजेंट का टाइप किए गए ADK-Rust टूल के रूप में उपयोग करें
• पुनःप्रयास और चिंतन - चिंतन प्रॉम्प्ट के साथ टूल विफलता से पुनर्प्राप्ति
• एक्शन नोड - वर्कफ़्लो ग्राफ़ के लिए 14 नियतात्मक नोड प्रकार
• बेंचमार्किंग - cargo adk bench के साथ प्रदर्शन मापन

एजेंट क्लाइंट प्रोटोकॉल

ADK-Rust से किसी बाहरी कोडिंग एजेंट का उपयोग करें, या किसी ADK-Rust एजेंट को स्थिर ACP v1 के माध्यम से किसी संपादक के सामने उपलब्ध कराएँ।

• आर्किटेक्चर और अवधारणाएँ - क्लाइंट/होस्ट और कोडिंग-एजेंट की भूमिकाएँ, सत्र, क्षमताएँ और प्रोटोकॉल प्रवाह
• ACP क्लाइंट और होस्ट - प्रत्यायोजन, स्थायी सत्र, स्ट्रीमिंग, रद्दीकरण, अनुमतियाँ, फ़ाइलें, टर्मिनल और MCP
• ACP एजेंट सर्वर - stdio के माध्यम से Runner, टूल, सत्र और लाइव इवेंट उपलब्ध कराना
• परीक्षण और समर्थन मैट्रिक्स - सत्यापित अंतर-संचालनीयता और जानबूझकर अप्रचारित सुविधाएँ

सत्र और स्थिति

• सत्र - सत्र प्रबंधन और जीवनचक्र
• स्थिति प्रबंधन - प्रीफ़िक्स के साथ वार्तालाप स्थिति का प्रबंधन

मेमोरी

सत्र से अधिक समय तक बनी रहने वाली दीर्घकालिक मेमोरी — सत्र स्थिति का स्थायी समकक्ष। सिमेंटिक स्टोर और द्वि-कालिक ज्ञान ग्राफ़, दोनों के लिए एक समर्पित और नए उपयोगकर्ताओं के अनुकूल मार्गदर्शिका।

• अवलोकन - यहाँ से शुरू करें: मेमोरी के दो प्रकार, मानसिक मॉडल, इंस्टॉल करना और त्वरित शुरुआत
• अवधारणाएँ - MemoryEntry, MemoryService trait, खोज, प्रोजेक्ट स्कोपिंग, GDPR मिटाना
• बैकएंड - छह स्टोर (InMemory, SQLite, Postgres+pgvector, Redis, MongoDB, Neo4j) और चुनाव करने का तरीका
• ज्ञान ग्राफ़ - GraphMemoryService: इकाइयाँ, अवलोकन, संबंध और द्वि-कालिकता का महत्व
• टूल और एजेंट - एजेंट में मेमोरी को जोड़ना; remember/relate और मेमोरी टूल

कॉलबैक और इवेंट

• कॉलबैक - एजेंट के व्यवहार को रोकना और अनुकूलित करना
• इवेंट - इवेंट प्रणाली और वार्तालाप इतिहास को समझना

आर्टिफ़ैक्ट

• आर्टिफ़ैक्ट - बाइनरी डेटा का संग्रहण और पुनर्प्राप्ति

अवलोकनीयता

• टेलीमेट्री - लॉगिंग, ट्रेसिंग और मॉनिटरिंग

परिनियोजन

• लॉन्चर - कंसोल या सर्वर मोड में एजेंट चलाना
• सर्वर - REST API और वेब UI एकीकरण
• A2A प्रोटोकॉल - एजेंट-से-एजेंट संचार
• एजेंटिक वेब प्रोटोकॉल - एजेंट-नेटिव वेब सेवाओं के लिए AWP प्रोटोकॉल
• एजेंट इंजन - Gemini Enterprise Agent Platform पर परिनियोजन

मूल्यांकन

• एजेंट मूल्यांकन - एजेंट के व्यवहार का परीक्षण और सत्यापन
• बेंचमार्क परिणाम - प्रकाशित प्रदर्शन तुलना डेटा

प्रबंधित एजेंट

• प्रबंधित एजेंट रनटाइम - प्रदाता-निरपेक्ष, टिकाऊ, पुनः शुरू किए जा सकने वाला एजेंट निष्पादन इंजन (प्रयोगात्मक)

सुरक्षा

• प्रवेश नियंत्रण - भूमिका-आधारित अनुमतियाँ और ऑडिट लॉगिंग
• सुरक्षा उपाय - PII रिडैक्शन, सामग्री फ़िल्टरिंग, स्कीमा सत्यापन
• मेमोरी - एजेंट के लिए दीर्घकालिक सिमेंटिक मेमोरी
• भुगतान और वाणिज्य - एजेंटिक वाणिज्य यात्राएँ, प्रोटोकॉल समर्थन और सत्यापन पथ

अनुपालन

• केवल Vertex परिनियोजन - HIPAA और डेटा-रेज़िडेंसी वर्कलोड के लिए Gemini Studio (generativelanguage.googleapis.com) ट्रैफ़िक न होने की गारंटी

स्टूडियो

• ADK स्टूडियो - एजेंट बनाने के लिए दृश्य विकास वातावरण
• एक्शन नोड - ऑटोमेशन वर्कफ़्लो के लिए गैर-LLM प्रोग्रामेटिक नोड
• ट्रिगर - वर्कफ़्लो के लिए वेबहुक, शेड्यूल और इवेंट ट्रिगर

विकास

• विकास दिशानिर्देश - योगदान मार्गदर्शिका और सर्वोत्तम अभ्यास
• प्रदर्शन 0.8 - अनुकूलन रिलीज़ उदाहरण और अपनाने-केंद्रित सत्यापन

---

सत्यापन स्थिति

README और आधिकारिक दस्तावेज़ों में दिए गए Cargo कमांड और निर्भरता स्निपेट को scripts/check-doc-examples.sh द्वारा सत्यापित किया जाता है। CI, scripts/check-cargo-adk-templates.sh के साथ cargo-adk स्कैफ़ोल्ड की भी जाँच करता है, scripts/check-example-name-collisions.sh के साथ डुप्लिकेट उदाहरण लक्ष्य नामों को अस्वीकार करता है, और cargo check --workspace --examples के साथ वर्कस्पेस उदाहरणों को कंपाइल करता है।