ADK-Rust Offizielle Dokumentation

Willkommen zur offiziellen Dokumentation für ADK-Rust (Agent Development Kit für Rust). Diese Dokumentation bietet umfassende Anleitungen und Referenzen zum Erstellen von KI-Agenten mit der Rust-Implementierung des ADK-Frameworks.

Erste Schritte

Einführung - Überblick über ADK-Rust, seine Architektur und die wichtigsten Konzepte
Schnellstart - Erstelle deinen ersten Agenten in unter 10 Minuten
A2UI Schnellstart - Gib A2UI JSONL aus und rendere es in React
Migration 1.0 → 2.0 - Vollständige Liste der Breaking Changes mit Vorher-/Nachher-Code

Kern

Kern-Typen - Grundlegende Typen: Content, Part, Agent trait, Tool trait, Kontexte
Runner - Laufzeit und Konfiguration für die Ausführung von Agenten
Plugins - Lifecycle-Hooks für Tool-/Model-Interception und Middleware

Modelle

Model-Anbieter - LLM-Integrationen: Gemini, OpenAI, Anthropic, DeepSeek, Groq, Ollama
Ollama - Lokale Inferenz mit Ollama
mistral.rs-Integration - Native mistral.rs für performante lokale Inferenz

Agenten

LlmAgent - Der zentrale Agententyp, der Large Language Models verwendet
CodeAgent (CodeAct) - Handelt, indem Code über ein CodeRuntime geschrieben und ausgeführt wird
Workflow-Agenten - Deterministische Agenten: Sequential, Parallel, Loop
Multi-Agenten-Systeme - Erstellen von Agenten-Hierarchien mit Sub-Agenten
Graph-Agenten - LangGraph-artige Workflow-Orchestrierung
Realtime-Agenten - Sprachfähige Agenten mit OpenAI/Gemini

Coding-Agent

Ein nativer Coding-Agent: Code in einem isolierten Workspace lesen/bearbeiten/ausführen, autonomer Zielmodus und parallele Ultra-Review-Workflows.

Übersicht - Hier anfangen: die Bestandteile, Installation und ein 60-Sekunden-Schnellstart
Dev-Tools - adk-devtools: read/write/edit/glob/grep/bash + das isolierte Workspace
Harness - CodingAgent (das Feature coding), die Plan-Schleife, write_todos
CLI - adk-rust code / goal (dauerhaft, fortsetzbar) / ultracode
Workflows - Ultra-Review auf adk-graph: parallele Reviewer + Fan-in
Beispiele - Die drei ausführbaren Beispiel-Crates

Realtime & Multimodal

Ein dedizierter, einsteigerfreundlicher Leitfaden zum Erstellen von Sprach- + multimodalen Agents — Architektur, Konzepte und lauffähige Beispiele.

Überblick - Hier anfangen: das mentale Modell, Installation und ein 60-Sekunden-Schnellstart
Architektur - Die vier Schichten, Ereignisschleife, Audio-Pipeline und Turn-Lebenszyklus
Anbieter - OpenAI Realtime- & Gemini Live-Modelle, Stimmen und wie man auswählt
Tools - Aktionen auf der Serverseite: native Handler, überbrückte adk_core::Tools, parallele Aufrufe
Multimodal - Videoeingabe über send_video_frame und Browser-Kameraerfassung
Affektiver Dialog - Emotionsbewusste Antworten auf Gemini Native-Audio
Speicher - Kontextinjektion, Turn-Speicherung und Selbstkuratierung des Wissensgraphen
Web-Apps erstellen - Die serverseitige Brücke, das WS-Protokoll und Web Audio
Beispiele - Die vier lauffähigen Beispiele und ein empfohlener Lernpfad

Werkzeuge

Funktions-Tools - Benutzerdefinierte Tools mit asynchronen Rust-Funktionen erstellen
Integrierte Tools - Vorgefertigte Tools wie GoogleSearchTool
Überblick und Architektur von MCP - Wo MCP einzuordnen ist und welche ADK-Rust-Oberfläche verwendet werden soll
MCP-Client - Tools, Ressourcen, Prompts, Completion, Subscriptions, Elicitation, Tasks und HTTP
Dynamischer MCP-Server-Manager - Laufzeit-Lokalserver-Registry, Persistenz, Monitoring und Neustart
MCP-Server-Authoring - Tools und andere Fähigkeiten mit dem abgestimmten offiziellen Rust-SDK veröffentlichen
MCP-Sicherheit - Authentifizierung, Sichtbarkeit, Autorisierung, Freigabe und Secret-Handling
MCP-Tests - Deterministische Gates und Bereitstellungsprüfung
Browser Tools - 46 WebDriver-Tools für Web-Automatisierung
UI Tools - Dynamische UI-Generierung mit Formularen, Karten, Diagrammen
RAG - Retrieval-Augmented Generation für die Wissensbasissuche
ACP Tools - Verwende einen ACP-Coding-Agent als typisiertes ADK-Rust-Tool
Retry & Reflect - Wiederherstellung bei Tool-Fehlern mit Reflexions-Prompts
Action Nodes - 14 deterministische Knotentypen für Workflow-Graphen
Benchmarking - Leistungsmessung mit cargo adk bench

Agent Client Protocol

Nutze einen externen Coding-Agenten von ADK-Rust oder stelle einen ADK-Rust-Agenten einem Editor über stabiles ACP v1 zur Verfügung.

Architektur und Konzepte - Rollen von Client/Host und Coding-Agent, Sessions, Fähigkeiten und Protokollablauf
ACP Client und Host - Delegierung, persistente Sessions, Streaming, Abbruch, Berechtigungen, Dateien, Terminals und MCP
ACP-Agent-Server - Den Runner, Tools, Sessions und Live-Events über stdio bereitstellen
Testing and support matrix - Verifizierte Interoperabilität und absichtlich nicht beworbene Funktionen

Sessions & State

Sessions - Session-Verwaltung und Lebenszyklus
State Management - Konversationszustand mit Präfixen verwalten

Memory

Langzeitgedächtnis, das eine Session überdauert — das persistente Gegenstück zum Session-Zustand. Ein eigenständiger, einsteigerfreundlicher Leitfaden sowohl für den semantischen Speicher als auch für den bi-temporalen Wissensgraphen.

Überblick - Hier beginnen: die zwei Arten von Memory, das mentale Modell, Installation und ein Schnellstart
Konzepte - MemoryEntry, das MemoryService-Trait, Suche, Projektrahmung, GDPR-Löschung
Backends - Die sechs Speicher (InMemory, SQLite, Postgres+pgvector, Redis, MongoDB, Neo4j) und wie man wählt
Wissensgraph - GraphMemoryService: Entitäten, Beobachtungen, Relationen und warum Bi-Temporalität wichtig ist
Tools & Agenten - Memory in Agenten einbinden; remember/relate und die Memory-Tools

Callbacks & Events

Callbacks - Agentenverhalten abfangen und anpassen
Events - Das Event-System und den Gesprächsverlauf verstehen

Artifacts

Artifacts - Speicherung und Abruf binärer Daten

Observability

Telemetry - Logging, Tracing und Monitoring

Deployment

Launcher - Agenten im Konsolen- oder Servermodus ausführen
Server - REST API und Web-UI-Integration
A2A Protokoll - Agent-zu-Agent-Kommunikation
Agentic Web Protocol - AWP-Protokoll für agenten-native Webdienste

Evaluation

Agent Evaluation - Agentenverhalten testen und validieren
Benchmark-Ergebnisse - Veröffentliche Daten zum Leistungsvergleich

Managed Agents

Managed Agent Runtime - Anbieterneutrale, dauerhafte und fortsetzbare Ausführungs-Engine für Agenten (Experimentell)

Sicherheit

Access Control - Rollenbasierte Berechtigungen und Audit-Logging
Guardrails - PII-Redaktion, Inhaltsfilterung, Schema-Validierung
Memory - Langfristiges semantisches Gedächtnis für Agenten
Payments and Commerce - Agentische Commerce-Journeys, Protokollunterstützung und Validierungspfade

Studio

ADK Studio - Visuelle Entwicklungsumgebung zum Erstellen von Agenten
Action Nodes - Nicht-LLM-programmatische Nodes für Automatisierungs-Workflows
Triggers - Webhook-, Zeitplan- und Ereignis-Trigger für Workflows

Entwicklung

Development Guidelines - Mitwirkungsleitfaden und Best Practices
Performance 0.8 - Beispiele für die Optimierungsfreigabe und auf Akzeptanz ausgerichtete Validierung

Validierungsstatus

Cargo-Befehle und Abhängigkeitsausschnitte, die direkt aus der README und der offiziellen Dokumentation kopiert werden können, prüft scripts/check-doc-examples.sh. Die CI prüft außerdem mit scripts/check-cargo-adk-templates.sh die von cargo-adk erzeugten Projektgerüste, weist doppelte Namen für Beispielziele mit scripts/check-example-name-collisions.sh zurück und kompiliert Workspace-Beispiele mit cargo check --workspace --examples.