ADK Studio

ड्रैग-एंड-ड्रॉप के साथ AI एजेंट बनाने के लिए विज़ुअल डेवलपमेंट एन्वॉयरन्मेंट।

अवलोकन

ADK Studio, ADK-Rust के साथ निर्मित AI एजेंटों को डिज़ाइन करने, उनका परीक्षण करने और उन्हें परिनियोजित करने के लिए एक लो-कोड इंटरफ़ेस प्रदान करता है। जटिल मल्टी-एजेंट वर्कफ़्लो को विज़ुअली बनाएँ, फिर उन्हें प्रोडक्शन Rust कोड में कंपाइल करें।

ADK Studio मुख्य इंटरफ़ेस

इंस्टॉलेशन

# Install from crates.io (self-contained binary)
cargo install adk-studio

# Or build from source
cargo build --release -p adk-studio

त्वरित आरंभ

# Start the studio server
adk-studio

# Open in browser
open http://localhost:3000

CLI विकल्प

विकल्पविवरणडिफ़ॉल्ट
--port, -pसर्वर पोर्ट3000
--host, -hबाइंड एड्रेस127.0.0.1
--dir, -dप्रोजेक्ट्स डायरेक्टरी~/.local/share/adk-studio/projects
--static, -sस्टैटिक फ़ाइलों की डायरेक्टरी को ओवरराइड करें(एम्बेडेड)
# Bind to all interfaces for remote access
adk-studio --host 0.0.0.0 --port 8080

# Custom projects directory
adk-studio --dir ./my-projects

चरण-दर-चरण ट्यूटोरियल

ADK Studio में अपना पहला AI Agent बनाने के लिए इस वॉकथ्रू का पालन करें।

चरण 1: एक नया प्रोजेक्ट बनाएँ

ऊपरी-दाएँ कोने में + New Project बटन पर क्लिक करें।

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

अपने प्रोजेक्ट के लिए एक नाम दर्ज करें (उदाहरण के लिए, "Demo Project") और Create पर क्लिक करें।

चरण 2: कैनवास में एक Agent जोड़ें

बाएँ साइडबार में उपलब्ध Agent प्रकारों के साथ Agent Palette है:

  • LLM Agent - एक भाषा मॉडल द्वारा संचालित सिंगल AI Agent
  • Sequential - सब-Agents को क्रम से निष्पादित करें
  • Parallel - सब-Agents को एक साथ निष्पादित करें
  • Loop - निकास शर्त पूरी होने तक पुनरावृति करें
  • Router - इनपुट के आधार पर सब-Agents को रूट करें

इसे कैनवास में जोड़ने के लिए LLM Agent पर क्लिक करें।

कैनवास पर एजेंट

चरण 3: Agent को कॉन्फ़िगर करें

जब आप एक Agent का चयन करते हैं, तो दाएँ ओर Properties Panel दिखाई देता है। यहाँ आप कॉन्फ़िगर कर सकते हैं:

  • Name - Agent के लिए पहचानकर्ता
  • Model - LLM प्रदाता और मॉडल (Gemini, OpenAI, आदि)
  • Instructions - Agent के लिए सिस्टम प्रॉम्प्ट

प्रॉपर्टीज पैनल

चरण 4: Agent में Tools जोड़ें

Tool Palette खोजने के लिए बाएँ साइडबार में नीचे स्क्रॉल करें:

  • Function - कोड एडिटर के साथ कस्टम Rust Function
  • MCP - Model Context Protocol सर्वर
  • Browser - 46 WebDriver ऑटोमेशन एक्शन्स
  • Google Search - ग्राउंडेड वेब सर्च
  • Load Artifact - संदर्भ में फ़ाइलें लोड करें

अपने Agent में जोड़ने के लिए एक Tool पर क्लिक करें।

Google Search Tool के साथ एजेंट

चरण 5: बनाएँ और परीक्षण करें

अपने Agent को कंपाइल करने के लिए Build Project पर क्लिक करें। एक बार बन जाने के बाद, वास्तविक बातचीत के साथ अपने Agent का परीक्षण करने के लिए नीचे दिए गए Chat Panel का उपयोग करें।

चैट पैनल

चैट समर्थन करता है:

  • लाइव SSE स्ट्रीमिंग रिस्पॉन्स
  • Agent निष्पादन एनिमेशन
  • डिबगिंग के लिए इवेंट ट्रेस पैनल

चरण 6: जेनरेट किया गया कोड देखें

अपने विज़ुअल डिज़ाइन से जेनरेट किए गए प्रोडक्शन-रेडी Rust कोड को देखने के लिए View Code पर क्लिक करें।

जेनरेट किया गया कोड दृश्य

आप इस कोड को कॉपी कर सकते हैं या एक पूर्ण Rust प्रोजेक्ट जेनरेट करने के लिए Compile का उपयोग कर सकते हैं।

विशेषताएँ

एजेंट प्रकार

एजेंटविवरण
LlmAgentएक LLM द्वारा संचालित एकल एजेंट
Sequentialउप-एजेंटों को क्रम में निष्पादित करें
Parallelउप-एजेंटों को एक साथ निष्पादित करें
Loopनिकास शर्त पूरी होने तक पुनरावृति करें
Routerइनपुट के आधार पर उप-एजेंटों को रूट करें

टूल प्रकार

टूलविवरण
FunctionToolकोड एडिटर के साथ कस्टम Rust फ़ंक्शन
MCPModel Context Protocol सर्वर
Browser46 WebDriver स्वचालन क्रियाएँ
Google Searchआधारित वेब खोज
Load Artifactफाइलों को संदर्भ में लोड करें

रीयल-टाइम चैट

एजेंटों का सीधे स्टूडियो में परीक्षण करें:

  • लाइव SSE स्ट्रीमिंग प्रतिक्रियाएँ
  • एजेंट निष्पादन एनिमेशन
  • डीबगिंग के लिए इवेंट ट्रेस पैनल
  • Session मेमोरी की निरंतरता

कोड जनरेशन

विज़ुअल डिज़ाइन को प्रोडक्शन कोड में बदलें:

  1. कोड देखें - सिंटैक्स हाइलाइटिंग के साथ जेनरेट किए गए Rust का पूर्वावलोकन करें
  2. संकलन करें - पूर्ण Rust प्रोजेक्ट जनरेट करें
  3. बिल्ड करें - रीयल-टाइम आउटपुट के साथ निष्पादन योग्य में संकलित करें
  4. रन करें - बनाए गए एजेंट को निष्पादित करें

वास्तुकला

┌─────────────────────────────────────────────────────────────┐
│                     ADK Studio UI                           │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐ │
│  │   Palette   │  │   Canvas    │  │   Properties        │ │
│  │  - Agents   │  │  ReactFlow  │  │  - Name             │ │
│  │  - Tools    │  │  Workflow   │  │  - Model            │ │
│  │             │  │  Designer   │  │  - Instructions     │ │
│  └─────────────┘  └─────────────┘  └─────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼ HTTP/SSE
┌─────────────────────────────────────────────────────────────┐
│                    ADK Studio Server                        │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐ │
│  │   Routes    │  │   Codegen   │  │   Storage           │ │
│  │  /api/*     │  │  Rust code  │  │  Projects           │ │
│  │  /chat      │  │  generation │  │  File-based         │ │
│  └─────────────┘  └─────────────┘  └─────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼ Build
┌─────────────────────────────────────────────────────────────┐
│                   Generated Rust Project                    │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  Cargo.toml + src/main.rs                           │   │
│  │  Uses: adk-rust, adk-agent, adk-model, etc.        │   │
│  └─────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

एपीआई एंडपॉइंट्स

प्रोजेक्ट्स

एंडपॉइंटमेथडविवरण
/api/projectsGETसभी प्रोजेक्ट्स को सूचीबद्ध करें
/api/projectsPOSTनया प्रोजेक्ट बनाएं
/api/projects/:idGETप्रोजेक्ट का विवरण प्राप्त करें
/api/projects/:idPUTप्रोजेक्ट अपडेट करें
/api/projects/:idDELETEप्रोजेक्ट डिलीट करें

कोड जनरेशन

एंडपॉइंटमेथडविवरण
/api/projects/:id/codegenPOSTRust कोड जनरेट करें
/api/projects/:id/buildPOSTप्रोजेक्ट को कंपाइल करें
/api/projects/:id/runPOSTबने हुए एग्जीक्यूटेबल को चलाएं

चैट

एंडपॉइंटमेथडविवरण
/api/chatPOSTसंदेश भेजें (SSE स्ट्रीम)

पर्यावरण चर

चरविवरणआवश्यक
GOOGLE_API_KEYGemini API कुंजीहाँ (Gemini के लिए)
OPENAI_API_KEYOpenAI API कुंजीहाँ (OpenAI के लिए)
ADK_DEV_MODEस्थानीय वर्कस्पेस डिपेन्डेंसी का उपयोग करेंनहीं
RUST_LOGलॉग स्तरनहीं (डिफ़ॉल्ट: info)

जनरेटेड कोड संरचना

my-project/
├── Cargo.toml
└── src/
    └── main.rs

उदाहरण जनरेटेड main.rs:

use adk_rust::prelude::*;
use adk_rust::Launcher;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    dotenvy::dotenv().ok();
    let api_key = std::env::var("GOOGLE_API_KEY")?;
    let model = GeminiModel::new(&api_key, "gemini-2.0-flash")?;

    let agent = LlmAgentBuilder::new("assistant")
        .description("Helpful AI assistant")
        .instruction("You are a helpful assistant.")
        .model(Arc::new(model))
        .build()?;

    Launcher::new(Arc::new(agent)).run().await?;
    Ok(())
}

टेम्पलेट्स

स्टूडियो में प्री-बिल्ट टेम्पलेट्स शामिल हैं:

  • Basic Assistant - सरल LlmAgent
  • Research Agent - Google Search के साथ Agent
  • Support Router - मल्टी-Agent राउटिंग
  • Code Assistant - कोड टूल्स के साथ Agent

सर्वोत्तम अभ्यास

अभ्यासविवरण
सरल से शुरू करेंएकल LlmAgent से शुरू करें, जटिलता जोड़ें
अक्सर परीक्षण करेंव्यवहार को सत्यापित करने के लिए चैट पैनल का उपयोग करें
कोड की समीक्षा करेंडिप्लॉय करने से पहले जनरेट किए गए कोड की जाँच करें
प्रोजेक्ट्स का संस्करण बनाएंप्रोजेक्ट JSON को एक्सपोर्ट और संस्करण कंट्रोल करें
टेम्पलेट्स का उपयोग करेंसामान्य पैटर्न के लिए टेम्पलेट्स से शुरू करें

पिछला: ← मेमोरी | अगला: डेवलपमेंट दिशानिर्देश →