ADK-Rust

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

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

शुरू करना

कोर

  • कोर प्रकार - मौलिक प्रकार: Content, Part, Agent trait, Tool trait, contexts
  • Runner - Agent निष्पादन रनटाइम और कॉन्फ़िगरेशन
  • प्लगइन्स - tool/model interception और middleware के लिए जीवनचक्र hooks

मॉडल

  • Model Providers - 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 पदानुक्रम बनाना
  • Graph Agents - LangGraph-शैली वर्कफ़्लो orchestration
  • Realtime Agents - OpenAI/Gemini के साथ आवाज़-सक्षम agents

Coding Agent

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

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

Realtime & Multimodal

voice + multimodal agents बनाने के लिए एक समर्पित, newcomer-friendly गाइड — वास्तुकला, अवधारणाएँ, और runnable examples।

  • अवलोकन - यहीं से शुरू करें: मानसिक मॉडल, स्थापना, और 60-सेकंड की त्वरित शुरुआत
  • वास्तुकला - चार स्तर, event loop, audio pipeline, और turn lifecycle
  • प्रदाता - OpenAI Realtime & Gemini Live models, voices, और कैसे चुनें
  • टूल्स - सर्वर-पक्ष क्रियाएँ: native handlers, bridged adk_core::Tools, parallel calls
  • मल्टीमॉडल - send_video_frame और browser camera capture के माध्यम से video input
  • भावात्मक संवाद - Gemini native-audio पर भावना-जागरूक प्रतिक्रियाएँ
  • स्मृति - context injection, turn storage, और knowledge-graph self-curation
  • Web Apps बनाना - server-side bridge, WS protocol, और Web Audio
  • उदाहरण - चार runnable examples और एक सुझाया गया सीखने का मार्ग

टूल्स

  • Function Tools - async Rust functions के साथ custom tools बनाएँ
  • बिल्ट-इन टूल्स - GoogleSearchTool जैसे पूर्व-निर्मित tools
  • MCP अवलोकन और वास्तुकला - MCP कहाँ फिट बैठता है और कौन-सा ADK-Rust surface उपयोग करना है
  • MCP client - Tools, resources, prompts, completion, subscriptions, elicitation, tasks, और HTTP
  • Dynamic MCP सर्वर प्रबंधक - runtime local-server registry, persistence, monitoring, और restart
  • MCP सर्वर authoring - संरेखित आधिकारिक Rust SDK के साथ tools और अन्य क्षमताएँ प्रकाशित करें
  • MCP सुरक्षा - Authentication, visibility, authorization, approval, और secret handling
  • MCP परीक्षण - नियतात्मक gates और deployment verification
  • Browser Tools - वेब automation के लिए 46 WebDriver tools
  • UI Tools - forms, cards, charts के साथ dynamic UI generation
  • RAG - knowledge base search के लिए Retrieval-Augmented Generation
  • ACP Tools - typed ADK-Rust tool के रूप में ACP coding agent का उपयोग करें
  • Retry & Reflect - reflection prompts के साथ tool failure recovery
  • Action Nodes - workflow graphs के लिए 14 नियतात्मक node प्रकार
  • Benchmarking - cargo adk bench के साथ प्रदर्शन मापन

Agent Client Protocol

ADK-Rust से एक बाहरी coding agent का उपयोग करें, या स्थिर ACP v1 के माध्यम से किसी editor के लिए एक ADK-Rust agent उपलब्ध कराएँ।

Sessions & State

  • Sessions - session प्रबंधन और lifecycle
  • State Management - prefixes के साथ conversation state का प्रबंधन

स्मृति

एक session से आगे टिकने वाली दीर्घकालिक स्मृति — session state का स्थायी समकक्ष। semantic store और bi-temporal knowledge graph, दोनों के लिए एक समर्पित, newcomer-friendly गाइड।

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

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

  • कॉलबैक्स - agent व्यवहार को बाधित करें और अनुकूलित करें
  • इवेंट्स - event system और conversation history को समझना

आर्टिफैक्ट्स

अवलोकनीयता

परिनियोजन

मूल्यांकन

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

सुरक्षा

स्टूडियो

विकास

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

README और आधिकारिक docs में दिए गए copy-paste Cargo commands और dependency snippets को scripts/check-doc-examples.sh द्वारा सत्यापित किया गया है। CI scripts/check-cargo-adk-templates.sh के साथ cargo-adk scaffolds की भी जाँच करता है, scripts/check-example-name-collisions.sh के साथ duplicate example target names को अस्वीकार करता है, और cargo check --workspace --examples के साथ workspace examples को compile करता है।