ADK-Rust

ADK-Rust Offizielle Dokumentation

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

Erste Schritte

  • Einführung – Überblick über ADK-Rust, seine Architektur und zentrale Konzepte
  • Schnellstart – Erstellen, Ausführen und Testen Ihres ersten Agenten in der eingebetteten Benutzeroberfläche in weniger als 5 Minuten
  • A2UI-Schnellstart – A2UI-JSONL ausgeben und in React rendern
  • Migration 1.0 → 2.0 – Vollständige Liste der inkompatiblen Änderungen mit Code vorher/nachher

Kern

  • Kerntypen – Grundlegende Typen: Content, Part, Agent-Trait, Tool-Trait und Kontexte
  • Runner – Laufzeit und Konfiguration für die Agentenausführung
  • Plugins – Lebenszyklus-Hooks zum Abfangen von Tool- und Modellaufrufen sowie Middleware

Modelle

  • Modellanbieter – LLM-Integrationen: Gemini, OpenAI, Anthropic, DeepSeek, Groq, Ollama
  • Ollama – Lokale Inferenz mit Ollama
  • mistral.rs-Integration – Native Nutzung von mistral.rs für hochperformante lokale Inferenz

Agenten

Coding-Agent

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

  • Übersicht – Hier beginnen: die Bestandteile, Installation und ein Schnellstart in 60 Sekunden
  • Entwicklungswerkzeuge – adk-devtools: read/write/edit/glob/grep/bash sowie die isolierte Workspace
  • Harness – CodingAgent (die Funktion coding), die Planungsschleife, write_todos
  • CLI – adk-rust code / goal (dauerhaft, fortsetzbar) / ultracode
  • Workflows – Ultra-Review zu adk-graph: parallele Prüfer plus Fan-in
  • Beispiele – Die drei ausführbaren Beispiel-Crates

Echtzeit und multimodal

Ein spezieller, einsteigerfreundlicher Leitfaden zum Erstellen von Sprach- und multimodalen Agenten – Architektur, Konzepte und ausführbare Beispiele.

  • Übersicht – Hier beginnen: das mentale Modell, Installation und ein Schnellstart in 60 Sekunden
  • Architektur – Die vier Ebenen, Ereignisschleife, Audio-Pipeline und Lebenszyklus eines Turns
  • Anbieter – OpenAI Echtzeit- und Gemini-Live-Modelle, Stimmen und Entscheidungshilfen
  • Werkzeuge – Serverseitige Aktionen: native Handler, überbrückte adk_core::Tools, parallele Aufrufe
  • Multimodal – Videoeingabe über send_video_frame und Browser-Kameraaufnahme
  • Affektiver Dialog – Emotionsbewusste Antworten mit Gemini native-audio
  • Speicher – Kontextinjektion, Turn-Speicherung und Selbstkuratierung des Wissensgraphen
  • Web-Apps erstellen – Die serverseitige Bridge, WS-Protokoll und Web Audio
  • Beispiele – Die vier ausführbaren Beispiele und ein empfohlener Lernpfad

Werkzeuge

  • Funktionswerkzeuge – Benutzerdefinierte Werkzeuge mit asynchronen Rust-Funktionen erstellen
  • Integrierte Werkzeuge – Vorgefertigte Werkzeuge wie GoogleSearchTool
  • Übersicht und Architektur von MCP – Wo MCP eingesetzt wird und welche ADK-Rust-Oberfläche verwendet werden soll
  • MCP-Client – Werkzeuge, Ressourcen, Prompts, Vervollständigung, Abonnements, Anforderung von Informationen, Aufgaben und HTTP
  • Dynamischer MCP-Servermanager – Laufzeit-Registry für lokale Server, Persistenz, Überwachung und Neustart
  • Erstellung von MCP-Servern – Werkzeuge und andere Funktionen mit dem abgestimmten offiziellen Rust-SDK veröffentlichen
  • MCP-Sicherheit – Authentifizierung, Sichtbarkeit, Autorisierung, Genehmigung und Geheimnisverwaltung
  • MCP-Tests – Deterministische Prüfungen und Bereitstellungsverifizierung
  • Browserwerkzeuge – 46 WebDriver-Werkzeuge für Webautomatisierung
  • UI-Werkzeuge – Dynamische UI-Generierung mit Formularen, Karten und Diagrammen
  • RAG – Retrieval-Augmented Generation für die Suche in Wissensdatenbanken
  • ACP-Werkzeuge – Einen ACP-Coding-Agent als typisiertes ADK-Rust-Werkzeug verwenden
  • Wiederholen und reflektieren – Wiederherstellung nach Werkzeugfehlern mit Reflexions-Prompts
  • Aktionsknoten – 14 deterministische Knotentypen für Workflow-Graphen
  • Benchmarking – Leistungsmessung mit cargo adk bench

Agent-Client-Protokoll

Einen externen Coding-Agent aus ADK-Rust verwenden oder einen ADK-Rust-Agenten über stabile ACP v1 für einen Editor bereitstellen.

  • Architektur und Konzepte – Rollen von Client/Host und Coding-Agent, Sitzungen, Fähigkeiten und Protokollablauf
  • ACP Client und Host – Delegation, persistente Sitzungen, Streaming, Abbruch, Berechtigungen, Dateien, Terminals und MCP
  • ACP Agent-Server – Runner, Tools, Sitzungen und Live-Ereignisse über stdio bereitstellen
  • Test- und Support-Matrix – Verifizierte Interoperabilität und bewusst nicht beworbene Funktionen

Sitzungen und Zustand

Speicher

Langzeitgedächtnis, das eine Sitzung überdauert – das persistente Gegenstück zum Sitzungszustand. Ein spezieller, einsteigerfreundlicher Leitfaden sowohl zum semantischen Speicher als auch zum bi-temporalen Wissensgraphen.

  • Übersicht – Hier beginnen: die beiden Arten von Speicher, das mentale Modell, die Installation und ein Schnelleinstieg
  • Konzepte – MemoryEntry, das Merkmal MemoryService, Suche, Projektabgrenzung und DSGVO-Löschung
  • Backends – Die sechs Speicher (InMemory, SQLite, Postgres+pgvector, Redis, MongoDB, Neo4j) und Auswahlkriterien
  • Wissensgraph – GraphMemoryService: Entitäten, Beobachtungen, Beziehungen und die Bedeutung der Bi-Temporalität
  • Tools und Agenten – Speicher in Agenten integrieren; remember/relate und die Speicher-Tools

Rückruffunktionen und Ereignisse

Artefakte

  • Artefakte – Speichern und Abrufen binärer Daten

Beobachtbarkeit

  • Telemetrie – Protokollierung, Tracing und Überwachung

Bereitstellung

  • Startprogramm – Ausführen von Agents im Konsolen- oder Servermodus
  • Server – REST- und API-Integration sowie Integration der Weboberfläche
  • A2A-Protokoll – Agent-zu-Agent-Kommunikation
  • Agentisches Webprotokoll – AWP-Protokoll für agentenbasierte Webdienste
  • Agent Engine – Bereitstellung auf der Gemini Enterprise Agent Platform

Evaluierung

Verwaltete Agents

  • Verwaltete Agent-Laufzeit – Anbieterneutrale, dauerhafte und fortsetzbare Ausführungs-Engine für Agents (experimentell)

Sicherheit

  • Zugriffssteuerung – Rollenbasierte Berechtigungen und Audit-Protokollierung
  • Schutzmechanismen – Redaktion personenbezogener Daten, Inhaltsfilterung und Schemavalidierung
  • Speicher – Langfristiger semantischer Speicher für Agents
  • Zahlungen und Handel – Agentische Handelsabläufe, Protokollunterstützung und Validierungspfade

Compliance

Studio

  • ADK Studio – Visuelle Entwicklungsumgebung zum Erstellen von Agents
  • Aktionsknoten – Nicht-LLM-programmatische Knoten für Automatisierungsworkflows
  • Trigger – Webhook-, Zeitplan- und Ereignistrigger für Workflows

Entwicklung

Validierungsstatus

Das Kopieren von Cargo-Befehlen und Abhängigkeitsschnipseln in der README und den offiziellen Dokumentationen wird von scripts/check-doc-examples.sh validiert. CI überprüft außerdem cargo-adk-Gerüste mit scripts/check-cargo-adk-templates.sh, weist doppelte Namen von Beispielzielen mit scripts/check-example-name-collisions.sh zurück und kompiliert Workspace-Beispiele mit cargo check --workspace --examples.