ADK-Rust 2.0

Das Rust-Framework fürleistungsstark, serienreifKI-Agenten.

ADK-Rust vereint typisierte Agenten, Tools, dauerhaften Zustand, Echtzeitmedien und offene Protokolle in einer asynchronen Laufzeit – so können Sie von einem fokussierten Agenten zu einem System wechseln, das Sie sicher bedienen können.

Beginnen Sie mit der Arbeitseinheit

Was ist ein KI-Agent im Sinne von ADK-Rust?

Ein Agent ist eine asynchrone Rust-Komponente. Es empfängt einen Aufrufkontext, führt Arbeiten mit Modellen oder Werkzeugen aus und gibt im weiteren Verlauf typisierte Ereignisse aus. LLM-Agenten, Workflows, Echtzeitagenten, Codierungsagenten und benutzerdefinierte Rust-Agenten nutzen alle diesen gemeinsamen Vertrag.

Das Besondere an ADK-Rust ist, dass der Agent Teil eines Softwaresystems bleibt, das Sie verstehen und steuern können. Modellaufrufe, Werkzeugeingaben, Zustandsänderungen, Genehmigungen und gestreamte Ereignisse verfügen über explizite Rust-Verträge. Dieselbe Laufzeit kann einen fokussierten Assistenten, einen dauerhaften Multi-Agenten-Workflow, ein Echtzeit-Spracherlebnis oder einen Agenten unterstützen, der dienstübergreifend arbeitet – und gleichzeitig die Leistung, Parallelität, Portabilität und Betriebsdisziplin bewahren, die Rust-Teams erwarten.

Wenn Sie LangGraph, Google ADK, OpenAI Agents SDK oder CrewAI kennen, werden Sie Tools, Übergaben, Workflows, Speicher, Leitplanken und Ablaufverfolgung erkennen. ADK-Rust bringt diese Ideen in eine Rust-native Laufzeit ein und verbindet sie mit Echtzeitmedien, Codeausführung, RAG, Artefakten und offenen Protokollen wie MCP, A2A, ACP und AWP. Version 2 erweitert diese Grundlage um Diagramm-, Echtzeit-, Codierungs- und CodeAct-Agenten; anbieterbewusste Tool-Schemata; zusammensetzbare Projektvorlagen und Fracht-Adk-Build; stärkere Zustands- und Betriebskontrollen; und ein konsistenter typisierter Ereignispfad vom ersten Modellaufruf bis zur Produktion.

ADK-Rust v2-LaufzeitarchitekturProduktoberflächen senden Anfragen an das ADK Runner. Der Läufer koordiniert Agentenformen, Modellanbieter, Tools, Zustandsdienste, offene Protokolle und Produktionskontrollen durch typisierte Ereignisse.ADK-Rust v2 – eine Anfrage, das ganze SystemDurchgehend orange: Ausführung · gestricheltes Grau: Ereignisse, Ergebnisse, Lebenslauf · violette Grenze: offene ProtokollePRODUKTOBERFLÄCHENWeb und MobilUI / API-ClientsStimme und VideoEchtzeit-ClientsAndere AgentenA2A / ACP / AWPCLI & JobsFracht-Adk / CronADK-AUSFÜHRUNGSLAUFZEITRunnerSitzung · Aufrufkontext · Abbruch · Rückrufe · EreignisstromWÄHLEN SIE DEN AGENTEN, DER DEN JOBANFORDERUNGEN ENTSPRICHTLLM-AgentGrund + WerkzeugeArbeitsablaufseq / parallel / SchleifeGrafikKontrollpunkt + HITLCodeActCode schreiben und ausführenEchtzeitStimme + VideoBenutzerdefiniertAgent implementierenTypisierter EreignisstromModelltext · Werkzeugaufrufe · Fortschritt · Zustandsdeltas · Artefakte · Übertragungen · FehlerFÄHIGKEITEN RUND UM DEN AGENTENModellanbieterGemini · OpenAI · AnthropicOllama · Bedrock · Azure AIWerkzeuge & Spezialisten#[tool] · skills · browserMCP · ACP · code sandboxStand & Wissensessions · memory · RAGartifacts · graph checkpointsMedien & Schnittstellenaudio · video · A2UIREST · SSE · WebSocketAgentenprotokolleA2A · AWPdiscovery · task contractsHandel · entwickelt sich weiterACP commerce · AP2 alphadurable transaction journalslaufenanrufenErgebnisEreignis ausgebenPROTOKOLL & BEREITSTELLUNGSGRENZEREST / SSEA2AACPAWPMCPWebSocketProtokolle passen die Laufzeit an Systemgrenzen an; sie ersetzen es nicht.Auth · Tool-Autorisierung · Leitplanken · Sandbox · Plugins · Telemetrie · Auswertung · Wiederholung/AbbruchBegleitprodukteStudio · UI · Playground · Unternehmensplattform

Wie man die Architektur liest

Folgen Sie dem Diagramm von links nach rechts. Eine Produktoberfläche sendet eine Anfrage an den Runner. Der Runner hängt den Sitzungsstatus und den Aufrufkontext an und ruft dann den ausgewählten Agenten auf. Modelle, Tools und Status unterstützen die Arbeit, während typisierte Ereignisse Fortschritte und Ergebnisse zurücktragen.

Innerhalb der Laufzeit

Runner, Agenten, typisierte Ereignisse, Modell-/Tool-Schleifen, Sitzungen, Rückrufe, Übertragungen und Abbruch.

An der Grenze

MCP, A2A, ACP, AWP, HTTP, SSE und Echtzeittransporte verbinden separate Systeme und Vertrauenszonen.

Außerhalb des Rahmens

Studio, UI, Playground und die Steuerungsebene verbrauchen ADK-Rust; Sie laufen nicht im Runner.

Gerüstoberfläche

Die Fähigkeiten hinter der Architektur.

ADK-Rust vereint den gesamten Agentenlebenszyklus in einem Framework: Erstellen Sie das Verhalten des Agenten, stellen Sie ihm Tools zur Verfügung, bewahren Sie den Kontext auf, verbinden Sie ihn mit anderen Systemen und betreiben Sie ihn sicher in der Produktion. Die folgenden Gruppen zeigen, wie diese Fähigkeiten zusammenpassen.

Erstellen Sie LLM-, Workflow-, Diagramm-, Echtzeit- und Codierungsagenten. statten Sie sie mit typisierten Werkzeugen, MCP, RAG, Speicher, Sitzungen und Artefakten aus; verbinden Sie sie über REST, A2A, ACP und AWP; Fügen Sie dann Autorisierung, Leitplanken, Telemetrie und Auswertung für die Produktion hinzu.

Komponieren

Komponieren capability

LlmAgent

The main model-driven agent. Give it instructions, an LLM, tools, callbacks, and optional sub-agents; the Runner streams its work as typed events.

Handeln

Handeln capability

#[tool]

Turns a typed async Rust function into a model-callable tool and derives the argument schema from Rust types.

Denken Sie daran

Denken Sie daran capability

sessions

Keep conversation events and application state together so a user can continue the same interaction over multiple turns.

Verbinden

Verbinden capability

REST

Exposes familiar HTTP endpoints for clients that send a request and receive a structured response.

Betreiben

Betreiben capability

auth

Establishes who is calling the system through API keys, OAuth, OIDC, SSO, and application identity.

Bauen

Bauen capability

12 templates

Generate working starting shapes for focused agents, tools, retrieval, APIs, workflows, realtime sessions, and custom logic.

Sehen Sie, wie es funktioniert

Zeigen Sie die Arbeit, während sie stattfindet.

Der Runner löst die Sitzung auf, baut den Aufrufkontext auf, führt den Agenten aus, streamt die Modell- und Toolarbeit, wendet Zustandsänderungen an, behält dauerhafte Ereignisse bei und gibt dem Aufrufer den Fortschritt zurück, sobald dieser auftritt.

Derselbe Trail kann ein Terminal, eine Web-Benutzeroberfläche, einen API-Client, eine Auswertung oder eine Echtzeitkonversation speisen.

Folgen Sie einer echten Bitte

Ein Kunde fragt: „Warum ist meine Zahlung fehlgeschlagen?“ Der Runner öffnet die richtige Sitzung, streamt Modellausgaben und Toolaktivitäten, zeichnet Zustandsänderungen auf und gibt jedes nützliche Ereignis an die Schnittstelle zurück. Der Benutzer sieht den Fortschritt, während der Bediener eine vollständige Ausführungsaufzeichnung erhält.

Ein Aufruf über ADK-RustEine Anfrage lädt eine Sitzung, tritt in den Runner ein, durchläuft die Modell- und Toolarbeit, gibt typisierte Ereignisse aus und behält Status und Artefakte bei, bevor die Antwort zurückkehrt.Befolgen Sie eine Anforderung während der LaufzeitNichts verschwindet in einer Blackbox: Jede Stufe erzeugt typisierte Zustände oder Ereignisse.AnfrageInhalt + IdentitätSitzung ladenGeschichte + ZustandRunnerKontext + LebenszyklusAgententscheiden Sie über den nächsten SchrittModellStream-AntwortWerkzeugauf das System einwirkenVeranstaltungenBenutzeroberfläche / ServerBleiben Sie auf dem WegSitzungsereignisse · Zustandsdeltas · Speicher · Artefakte · Diagrammprüfpunkte · Auswertungsspuren

Verfassen Sie das Verhalten

Wenn der Auftrag wächst, teilen Sie die Arbeit auf, ohne den Faden zu verlieren.

Studieren Sie Multi-Agent-Muster

Ein Router identifiziert die Arbeit, die erledigt werden muss. Spezialisten kümmern sich um die Teile, die sie am besten verstehen. Sequentielle und parallele Arbeitsabläufe steuern die Ausführungsreihenfolge, während Diagrammkontrollpunkte dafür sorgen, dass Beweise, Genehmigungen und Fortschritt mit demselben Auftrag verknüpft sind.

Erweiterter ADK-Rust-Workflow für den Kundenbetrieb mit mehreren AgentenEin Kundenzugriffsvorfall wird an parallele Konto-, Zahlungs- und Plattformagenten weitergeleitet. Sie verwenden MCP- und A2A-Systeme, schreiben Beweise in einen gemeinsamen Prüfpunktstatus und konvergieren in einem Supervisor-Diagramm mit Wiederholungs-, Genehmigungs-, Aktions- und Prüfpfaden.Lösen Sie einen echten Kundenvorfall, ohne die Kontrolle zu verlierenAnwendungsfall: „Die Zahlung war erfolgreich, aber unser Teamarbeitsbereich ist immer noch gesperrt.“Der Arbeitsablauf muss den Sachverhalt ermitteln, ein sicheres Mittel auswählen, die Genehmigung für Folgemaßnahmen einholen und eine Beweisspur hinterlassen.KundeWeb · Stimme · APITriage-RouterLlmConditionalAgentKlassifizieren · Dringlichkeit festlegen · Spezialisten auswählenAnfragePARALLELUNTERSUCHUNG · ParallelAgentKontovertreterIdentität + AnspruchLiest Kunden, Team und ZugriffsstatusZahlungsagentAbrechnung + TransaktionGleicht Belastung, Rechnung und Plan abPlattformagentLaufzeit + BereitstellungÜberprüft Sperren, Jobs und DienstzustandauffächernSYSTEMGRENZENCRM + IdentitätMCP Ressourcen/ToolsERP + ZahlungenMCP + HandelsjournalBereitstellungsdienstA2A Remote-AgentGemeinsamer Vorfallstatus + Diagrammprüfpunktcustomer_id · Zahlungsnachweis · Berechtigungsstatus · Plattformzustand · Vertrauen · vorgeschlagene MaßnahmeJeder Spezialist schreibt maschinengeschriebene Beweise; Wiederholungsversuche und menschliche Unterbrechungen werden am selben Prüfpunkt fortgesetzt.SUPERVISOR-GRAFIKBeweise synthetisierenGraphAgentFakten vergleichen · Vertrauen bewertenGenug Beweise?Bedingte Kantebereit / untersuchenUntersuchen Sie es noch einmalLoopAgent + ReflexionVersuchen Sie es nur mit dem fehlenden Zweig erneutGenehmigungstorDiagrammunterbrechungZum Entsperren/Erstatten ist eine Person erforderlichHandeln Sie in der richtigen ReihenfolgeSequentialAgentfehltLebenslauf ausgewählter SpezialistfertigErgebnisstromArbeitsbereich wiederhergestellt · Kundenantwort · Beweisartefakt · Sitzungsereignis · Prüfdatensatz · Telemetrieverfolgung · AuswertungsbeispielAuth · RBAC · Tool-Bestätigung · Leitplanken · Stornierung · Sandbox · Telemetrie · Auswertung rund um den gesamten Aufruf
Die Grafik verlangt nicht von einem Agenten, alles zu improvisieren. Durch die Weiterleitung wird das Problem eingegrenzt, Spezialisten untersuchen gleichzeitig, der gemeinsame Status sorgt dafür, dass ihre Beweise kohärent sind, und Folgemaßnahmen bleiben hinter einer expliziten Genehmigungsgrenze.

LlmAgent

Konzentriertes Denken

Ein Modell, Anweisungen, Tools, Rückrufe und gestreamte Ausgaben – das kleine, nützliche Zentrum der meisten Systeme.

Sequential · Parallel · Loop

Deterministische Arbeit

Express-Bestellung, Parallelität, Wiederholung und Exit-Bedingungen direkt im Rust-Programm.

GraphAgent

Dauerhafte Orchestrierung

Verzweigen, prüfen, unterbrechen, für eine Person ausführen und fortsetzen, nachdem der Prozess oder die Konversation fortgesetzt wurde.

CodingAgent · CodeActAgent

Software als Aktion

Lassen Sie einen Agenten Code innerhalb eines von Ihnen kontrollierten Arbeitsbereichs und einer Sandbox-Grenze prüfen, bearbeiten und ausführen.

RealtimeAgent

Live-Gespräch

Übertragen Sie Audio, Transkripte, Videobilder, Unterbrechungen und serverseitige Tools über eine Live-Sitzung.

CustomAgent

Ihre eigene Laufzeitlogik

Implementieren Sie den Agentenvertrag für produktspezifisches Verhalten, der direkt in Rust geschrieben ist.

Das System rund um den Agenten

Das Modell ist ein Teil des Produkts.

Nützliche Agenten benötigen Werkzeuge, Zustände, Schnittstellen, Grenzen und Beweise. ADK-Rust macht jedes Teil über zusammensetzbare Rust-Schnittstellen verfügbar, die Sie besitzen.

Ein Produkt, mehrere Verantwortlichkeiten

In einem Kundensupportprodukt entwirft das Modell die Antwort, Tools überprüfen die Bestellung, die Sitzung überträgt den Kundenkontext, die Autorisierung steuert Rückerstattungen, ein Artefakt speichert die Quittung und die Telemetrie zeichnet das Ergebnis auf. Jede Verantwortung bleibt in der Laufzeit sichtbar.

Eine vollständige ADK-Rust-AgentenproduktarchitekturSchnittstellen gehen in eine ADK-Rust-Laufzeit ein, die die Agentenlogik, einen austauschbaren Modelladapter, Tools, Status- und Wissensdienste koordiniert. Typisierte Ereignisse erzeugen unter gemeinsamen Kontrollen sichtbare Fortschritte, Artefakte, Aktionen, Prüfaufzeichnungen und Bewertungsnachweise.Ein nützliches Agentenprodukt ist ein komplettes SystemDas Modell kann sich ändern. Die Verträge, der Status, die Werkzeuge, Kontrollen und Beweise bleiben Ihr Eigentum.MENSCHEN & SCHNITTSTELLENWebanwendungChat · Formulare · ArtefakteStimme und VideoLive-MediensitzungAPI & VeranstaltungenREST · SSE · WebSocketAndere AgentenA2A · ACP · AWPADK-RUST RUNTIMERunner + typisierter EreignisstromSitzung · Kontext · Lebenszyklus · AbbruchAgentenlogikGrund · RouteArbeitsablaufGrafik · HITLModell-/Werkzeugschleifeanrufen · beobachten · genehmigen · erneut versuchen · fortfahrenMODELL · EIN AUSTAUSCHBARER ADAPTERAnbietergehostet / lokalSchemaprovider-awareWERKZEUGE & EXTERNE SYSTEMERust Werkzeuge#[tool]MCPWerkzeuge · RessourcenBrowserWeb-AktionenSpezialistenACP · A2ASTAAT, WISSEN & DAUERHAFTE ARBEITSitzungErinnerungRAGArtefakteKontrollpunkteWAS DAS PRODUKT ZEIGEN KANNLive-FortschrittToken · Werkzeugstatus · AudioNützliche ArtefakteDateien · Berichte · Medien · BenutzeroberflächeGenehmigte Aktionenschreibt · Zahlungen · ÜbergabenDauerhafte KontinuitätSitzungen · Erinnerung · LebenslaufBeweiseEreignisse · Audit · TelemetrieQualitätssignaleBewertung · Kosten · Latenztypisierte Ereignisse kehren zu jeder Schnittstelle zurückAuthentifizierung · Identität · Tool-Autorisierung · Genehmigung · Leitplanken · Sandbox · Stornierung · Telemetrie · Auswertung
Das Modell liefert Informationen innerhalb eines vollständigen Produkts: Schnittstellen, die Menschen nutzen können, Werkzeuge, die handeln können, Zustand, der überlebt, Kontrollen, die das Risiko begrenzen, und Beweise, die erklären, was passiert ist.
Modelle

Ändern Sie das Modell, ohne den Agenten neu zu gestalten.

Gehostete Frontier-Modelle, schnelle Routing-Modelle, lokales Ollama und native mistral.rs-Inferenz stehen hinter einem gemeinsamen LLM-Vertrag.

Gemini · OpenAI · Anthropic · OpenRouter · DeepSeek · Groq · Ollama · Bedrock · Azure AI · kompatible Endpunkte

Werkzeuge

Tools verwenden explizite, überprüfbare Verträge.

Verwandeln Sie eine typisierte Rust-Funktion, einen MCP-Server, einen Skill, eine Browsersitzung, einen Coding-Agent oder einen Sandbox-Prozess in eine Funktion, die die Laufzeit prüfen und aufrufen kann.

#[tool] · FunctionTool · MCP · ACP · Fähigkeiten · Browser · Code

Staat

Behalten Sie das Gespräch bei – und die daraus resultierende Arbeit.

Sitzungen enthalten den Ereignisverlauf. Das Gedächtnis ruft nützliches Wissen ab. Artefakte bewahren Dateien. Graph-Checkpoints machen lange Arbeiten fortsetzbar.

SQLite · PostgreSQL · Redis · MongoDB · Firestore · Neo4j · verschlüsselte Sitzungen

Echtzeit

Ein Live-Agent ist mehr als ein Sprachendpunkt.

ADK-Rust speichert Audio, Transkripte, Videobilder, Toolaufrufe, Unterbrechungen und wechselnden Kontext in einer Rust-eigenen Sitzung.

OpenAI Realtime · Gemini Live · Vertex Live · LiveKit · optionales WebRTC

Wissen

Bringen Sie den Abruf in denselben Ausführungspfad.

Teilen Sie Dokumente in Blöcke auf, betten Sie sie ein, durchsuchen Sie Vektorspeicher, ordnen Sie Ergebnisse neu und isolieren Sie den Speicher nach Projekt, bevor das Modell antwortet.

RAG-Pipelines · Semantischer Speicher · Wissensgraph · Fünf Vektorspeicher-Implementierungen

Kontrolle

Platzieren Sie die Genehmigung dort, wo die Aktion stattfindet.

Autorisierung, Rückrufe, Leitplanken, Sandbox-Profile, Stornierung, Telemetrie und Auswertung bilden die Grenze der Produktionsausführung.

RBAC · OAuth/OIDC · Werkzeugbestätigung · PII-Leitplanken · OpenTelemetry · eval

Wählen Sie die Grenze

Verwenden Sie das Protokoll, das der Entfernung entspricht.

Beginnen Sie dort, wo die Funktion ausgeführt wird.

Behalten Sie Subagenten innerhalb einer ADK-Rust-Laufzeit bei, wenn sie Bereitstellung, Status und Vertrauen teilen. Führen Sie ein Protokoll ein, wenn die Funktion, der Agent, der Codierungsarbeitsbereich oder die Website über eine eigene Bereitstellung, einen eigenen Prozess, einen eigenen Besitz oder eine eigene Vertrauensgrenze verfügt.

Gleicher Rust-Prozess

Agent, Subagent oder Tool

Externe Tools oder Ressourcen

MCP

Unabhängig eingesetzter Agent

A2A

Codierungsprozess oder IDE

ACP

Für Agenten lesbare Website

AWP

MCP

Modellkontextprotokoll

Geben Sie einem Agenten Fähigkeiten, die woanders zu finden sind.

What is MCP?

Eine Standardmethode für einen externen Server zum Veröffentlichen von Tools, die ein Agent aufrufen kann, und Ressourcen, die er lesen kann.

Why use this protocol?
Sie vermeiden, für jede Datenbank, jedes SaaS-Produkt, jedes Dateisystem oder jede Wissensquelle einen maßgeschneiderten Adapter zu schreiben – und derselbe Server kann mehr als einen Agenten bedienen.
How does ADK-Rust use MCP?
McpToolset verbindet den Server mit dem Toolvertrag von ADK-Rust. Die Laufzeit erkennt ihre Schemata, normalisiert sie für den ausgewählten Modellanbieter und kann MCP-Ressourcen lesen oder lokale MCP-Serverprozesse verwalten.
When should I choose MCP?
Verwenden Sie MCP, wenn die Funktion zu einem separaten Prozess gehört, bereits über einen MCP-Server verfügt oder von mehreren Agenten und Anwendungen gemeinsam genutzt werden soll.
What connects through MCP?
The other side is an MCP server: for example a database gateway, business API, document store, developer tool, or internal service.
Explore MCP in ADK-Rust
A2A

Agent-zu-Agent-Protokoll

Lassen Sie unabhängig eingesetzte Agenten zusammenarbeiten.

What is A2A?

Ein Netzwerkprotokoll zum Erkennen eines Remote-Agenten, zum Senden seiner Arbeit, zum Verfolgen des Fortschritts und zum Empfangen von Ergebnissen über eine HTTP-Grenze hinweg.

Why use this protocol?
Ein Spezialist kann sein eigenes Modell, seine eigenen Tools, seinen eigenen Status, seinen eigenen Release-Zyklus, seine eigene Bereitstellung und seine eigenen Sicherheitsgrenzen beibehalten.
How does ADK-Rust use A2A?
ADK-Rust kann einen Agenten über seine A2A v1-Server- und Task-Operationen verfügbar machen. Ein Koordinator kann diesen Remote-Service dann als Spezialist behandeln, während gestreamte Ereignisse den Fortschritt des Auftrags dokumentieren.
When should I choose A2A?
Verwenden Sie A2A, wenn der Agent separat bereitgestellt, skaliert, im Besitz oder gesichert ist. Halten Sie gewöhnliche Subagenten im Prozess, wenn keine dieser Grenzen vorhanden ist.
What connects through A2A?
The other side is another agent service—perhaps a research specialist, finance agent, partner agent, or a system owned by another team.
Explore A2A in ADK-Rust
ACP

Agent-Client-Protokoll

Delegieren Sie Softwarearbeit an einen echten Programmieragenten.

What is ACP?

Ein Protokoll, das Sitzungen zwischen Codierungsagenten und den Clients standardisiert, die sie hosten, einschließlich Editoren, CLIs und Orchestrierungssystemen.

Why use this protocol?
Für die Codierungsarbeit sind Arbeitsbereichskontext, Streaming-Fortschritt, Abbruch und Berechtigungsentscheidungen während der gesamten Sitzung erforderlich.
How does ADK-Rust use ACP?
Mit AcpAgentTool und AcpToolset kann ein ADK-Rust-Agent einen ACP-Prozess starten oder eine Verbindung zu ihm herstellen, eine Sitzung aufbauen, seine Arbeit streamen und das Ergebnis als Tool-Aufruf zurückgeben. Die optionale Serverseite kann einen ADK-Rust-Agenten für ACP-Clients verfügbar machen.
When should I choose ACP?
Verwenden Sie ACP für die Repository-Erkundung, Implementierung, Umgestaltung, Tests oder jede andere delegierte Aufgabe, die in einem kontrollierten Entwicklungsarbeitsbereich ausgeführt werden soll.
What connects through ACP?
The other side is an ACP-compatible coding agent or client, such as Codex, Claude Code, an IDE, or your own ACP implementation.
Explore ACP in ADK-Rust
AWP

Agentisches Webprotokoll

Machen Sie eine Website verständlich, bevor ein Agent sie durchsucht.

What is AWP?

Ein Webprotokoll, über das eine Site veröffentlicht, wer sie ist, welche Agenten tun können, welche Richtlinien gelten und ob ihre agentenseitigen Dienste fehlerfrei sind.

Why use this protocol?
HTML erklärt einem Browser eine Seite, einem autonomen Agenten erklärt es jedoch selten Geschäftsfunktionen, Einwilligung, Vertrauen, Grenzen oder Ereignisse.
How does ADK-Rust use AWP?
adk-awp lädt Geschäftskontext, generiert Erkennungs- und Fähigkeitsmanifeste und fügt versionierte Axum-Routen für vertrauenswürdige Ratenlimits, Einwilligungen, Ereignisabonnements und Gesundheitsüberwachung hinzu.
When should I choose AWP?
Verwenden Sie AWP, wenn eine Website oder ein Dienst absichtlich für Agenten auffindbar und nutzbar sein soll, ohne sich allein auf die fragile Seiteninterpretation zu verlassen.
What connects through AWP?
The other side is a visiting personal agent, enterprise agent, partner system, or agent-aware client that discovers and respects the site's published contract.
Explore AWP in ADK-Rust

Schnellstart für Entwickler

Vom Terminal zum funktionierenden Agenten, eine Entscheidung nach der anderen.

Beginnen Sie mit einem kleinen, funktionierenden Rust-Projekt. Die folgenden geführten Schritte erklären, was der Generator hinzufügt, wie Sie das Projekt lokal kompilieren und wo Sie es erweitern können, wenn Ihr Produkt wächst.

Was Sie am Ende haben werden

Ein kompilierter Rust-Agent mit einem typisierten Tool, einer interaktiven Launcher-Sitzung, Telemetrie-Setup, Sitzungs- und Leitplanken-Integrationspunkten und einer echten Modellantwort im Terminal. Das generierte Projekt ist eine gewöhnliche Rust-Quelle, die Sie lesen, ändern und erweitern können.

Bevor Sie beginnen

Auf Ihrer Maschine sind zwei Dinge erforderlich

01

Rust 1.95 oder neuer.
Mit Rustup installieren oder die stabile Toolchain aktualisieren.

02

Ein Schlüssel des Modells API.
Dieser Pfad verwendet GOOGLE_API_KEY; Später kann ein anderer Anbieter ausgewählt werden.

01

Installieren Sie den ADK-Projektgenerator

„cargo-adk“ fügt die Cargo-Adk-Befehle hinzu, die zum Erstellen, Überprüfen, Erstellen und Bereitstellen von Agent-Projekten verwendet werden.

cargo install cargo-adk
02

Erstellen Sie einen nützlichen Starter-Agenten

Beginnen Sie mit einem Agenten, der typisierte Rust-Tools aufrufen kann. Fügen Sie Beobachtbarkeits-, Sitzungsstatus- und Leitplanken-Hooks hinzu, während das Projekt generiert wird.

cargo adk new support-agent --template tools \
  --addon telemetry --addon sessions --addon guardrails
03

Fügen Sie Ihre Modellberechtigung hinzu

Das generierte Beispiel verwendet standardmäßig Gemini. Kopieren Sie die sichere Beispieldatei und platzieren Sie dann Ihren Schlüssel in der nicht verfolgten .env-Datei.

cd support-agent
cp .env.example .env
# set GOOGLE_API_KEY in .env
04

Kompilieren Sie, bevor Sie es ausführen

Der Cargo Adk Build überprüft die generierten Abhängigkeiten, Funktionskombinationen, Rust-Typen und die Release-Binärdatei, ohne etwas bereitzustellen.

cargo adk build
05

Laufen Sie und sprechen Sie mit dem Agenten

Starten Sie die generierte Konsole, geben Sie eine Nachricht ein und sehen Sie sich dieselbe typisierte Laufzeit an, die später ein API, einen Workflow oder ein Echtzeitprodukt antreiben kann.

cargo run
Support-Agent – zsh

Einmal installieren

$ cargo install cargo-adk

Generieren Sie das Projekt

$ cargo adk new support-agent \
+  --template tools \
+  --addon telemetry \
+  --addon sessions \
+  --addon guardrails
erstellt support-agent/
├── Cargo.toml Abhängigkeiten + Feature-Flags
├── src/main.rs Agent + getipptes Werkzeug
├── .env.example erforderliche Konfiguration
└── README.md projektspezifische Anweisungen

Konfigurieren Sie das Modell

$ cd support-agent
  cp .env.example .env
  # Add GOOGLE_API_KEY to .env

Überprüfen und dann ausführen

$ cargo adk build
  cargo run
Tatsächlicher v2-Lauf · getippter Werkzeugaufruf
  ADK-Rust — support-agent
    Type a message to chat. Type 'exit' to quit.

  You > Greet Ada casually.

  [tool] greet({"name":"Ada","style":"casual"})
  Hey Ada! What's up?

  You > exit

  Goodbye.
✓ Projekt kompiliert · Laufzeitbereit · Lokale Verifizierung abgeschlossen

Verstehe das Gerüst

Sehen Sie, wie der Befehl zusammengestellt wird.

Die Vorlage liefert die Form des Arbeitsagenten. Jedes Add-on stellt die erforderlichen Crate-Funktionen, Importe, Konfigurationen und einen expliziten Ort zum Abschluss der Integration bereit.

Vorlage

--template Werkzeuge

Erzeugt einen LLM-Agenten mit einer typisierten #[tool]-Funktion und der Schemavernetzung, die für Modell-Tool-Aufrufe erforderlich ist.

Add-on

--addon Telemetrie

Ermöglicht die OpenTelemetry-Integration, sodass Modell-, Tool- und Laufzeitarbeit nachverfolgt werden können.

Add-on

--addon Sitzungen

Fügt eine Sitzungsdienstverkabelung hinzu, sodass der Konversationsstatus über einen Modellaufruf hinaus bestehen bleiben kann.

Add-on

--addon Leitplanken

Fügt die Funktion und klare Hooks für Eingabevalidierung, Ausgabeprüfungen und Inhaltsfilterung hinzu.

Wählen Sie eine andere Ausgangsform

Zwölf praktische Ansatzpunkte für gängige Agentenarchitekturen.

Wählen Sie die Form, die zum ersten nützlichen Werk passt. Vorlagen generieren bearbeitbare Rust-Quellen, Abhängigkeiten, Anbieterkonfigurationen und einen ausführbaren Einstiegspunkt.

Öffnen Sie den vollständigen Schnellstart
llmAgentenvorlage

Beginnen Sie mit einem Argumentationsagenten.

Erzeugt einen LlmAgentBuilder, ein Gemini-Modell-Setup, Anweisungen, ein sitzungsgestütztes Launcher und ein interaktives Terminal.

Wählen Sie dies, wenn

Wählen Sie es für Assistenten, Extraktion, Klassifizierung oder eine fokussierte Modell- und Werkzeugschleife.

Generierter Ausgangspunkt

Ein LLM-Agent · gestreamte Konsole · Anbieterkonfiguration

cargo adk new my-agent --template llm
toolsAgentenvorlage

Geben Sie einem Agenten die Aktion Rust ein.

Fügt src/tools.rs mit einer funktionierenden #[tool]-Funktion, typisierten Argumenten, JSON-Schemagenerierung und Registrierung auf dem LLM-Agenten hinzu.

Wählen Sie dies, wenn

Wählen Sie diese Option, wenn der Agent Berechnungen durchführen, Daten abrufen, Geschäftslogik aufrufen oder eine Aktion ausführen muss.

Generierter Ausgangspunkt

LlmAgent · Greet-Tool · serde · schemars · adk-tool

cargo adk new my-agent --template tools
ragAgentenvorlage

Antwort aus Dokumenten und indiziertem Wissen.

Erstellt eine RAG-Pipeline mit Dokument-Chunking, Gemini-Einbettungen, einem In-Memory-Vektorspeicher, einem Beispieldokument und RagTool.

Wählen Sie dies, wenn

Wählen Sie es für Produktdokumentationen, Richtlinien, Forschungssammlungen oder Antworten, die auf privatem Material basieren.

Generierter Ausgangspunkt

RagPipeline · Chuncher · Einbettungen · Vektorsuche · RagTool

cargo adk new my-agent --template rag
apiAgentenvorlage

Machen Sie einen Agenten über einen HTTP-Dienst verfügbar.

Erstellt einen Axum-Server mit Integritäts-, Sitzungserstellungs- und gestreamten Ausführungsendpunkten rund um einen LLM-Agenten.

Wählen Sie dies, wenn

Wählen Sie diese Option, wenn eine Webanwendung, ein mobiler Client, ein Backend-Dienst oder eine Automatisierungsplattform den Agenten anruft.

Generierter Ausgangspunkt

Axum · REST-Routen · SSE-Antworten · In-Memory-Sitzungen

cargo adk new my-agent --template api
a2aMusteralias

Setzen Sie einen Agenten als Remote-Spezialisten ein.

Löst sich nach dem a2a-Server-Muster auf und kombiniert einen LLM-Agenten mit Server- und Sitzungsfunktionen für den Agent-zu-Agent-Zugriff.

Wählen Sie dies, wenn

Wählen Sie diese Option, wenn ein anderer Agent diesen Agenten über eine Bereitstellungs- oder Besitzgrenze hinweg erkennen und anrufen muss.

Generierter Ausgangspunkt

A2A Server · Agentenidentität · Aufgabenbearbeitung · Sitzungen

cargo adk new my-agent --template a2a
graphAgentenvorlage

Bereiten Sie einen dauerhaften, verzweigten Workflow vor.

Aktiviert die Diagrammfunktion und erstellt den Import- und Agent-Startpunkt für Knoten, Kanten, Prüfpunkte, Unterbrechungen und Wiederaufnahme.

Wählen Sie dies, wenn

Wählen Sie es für lang andauernde Arbeiten mit Zweigen, Genehmigungsschritten, Wiederherstellungen oder einem dauerhaften Ausführungsstatus.

Generierter Ausgangspunkt

Diagrammfunktion · Workflow-Agent · Topologie-Startpunkt

cargo adk new my-agent --template graph
realtimeAgentenvorlage

Bereiten Sie einen Live-Sprach- oder Videoagenten vor.

Ermöglicht Echtzeitunterstützung und schafft einen übersichtlichen Ausgangspunkt für Sprachagenten mit Echtzeitimporten und Anbieterkonfiguration.

Wählen Sie dies, wenn

Wählen Sie es für natürliche Konversation, Unterbrechung, Live-Übersetzung, Audio-Tools oder eingehende Videobilder.

Generierter Ausgangspunkt

Echtzeitfunktion · Sprachanweisungen · Transportstartpunkt

cargo adk new my-agent --template realtime
sequentialWorkflow-Vorlage

Geben Sie die Arbeit in einer festen Reihenfolge an die Agenten weiter.

Erstellt Forscher- und Autorenagenten innerhalb eines SequentialAgent, sodass jede Stufe die von der vorherigen Stufe erstellte Arbeit erhält.

Wählen Sie dies, wenn

Wählen Sie diese Option, wenn der Prozess klare Phasen wie Sammeln, Analysieren, Entwurf, Überprüfen und Veröffentlichen hat.

Generierter Ausgangspunkt

Zwei LLM-Agenten · geordnete Ausführung · gemeinsamer Aufrufpfad

cargo adk new my-agent --template sequential
parallelWorkflow-Vorlage

Führen Sie gleichzeitig unabhängige Spezialisten aus.

Erzeugt zwei spezialisierte Agenten innerhalb eines ParallelAgent und sammelt ihre Arbeit über einen übergeordneten Workflow.

Wählen Sie dies, wenn

Wählen Sie diese Option, wenn mehrere Untersuchungen mit derselben Eingabe beginnen und unabhängig voneinander abgeschlossen werden können.

Generierter Ausgangspunkt

Zwei LLM-Agenten · gleichzeitige Ausführung · aggregierte Ergebnisse

cargo adk new my-agent --template parallel
loopWorkflow-Vorlage

Wiederholen Sie einen begrenzten Verfeinerungszyklus.

Erstellt einen Worker innerhalb von LoopAgent mit einem expliziten Abschlusssignal und einem Sicherheitslimit von fünf Iterationen.

Wählen Sie dies, wenn

Wählen Sie es für Entwurfs-, Kritik-, Reparatur-, Validierungs- oder Suchprozesse, die durch wiederholte Durchgänge verbessert werden.

Generierter Ausgangspunkt

LoopAgent Builder · Worker-Agent · Abschlussanweisung · maximale Iterationen

cargo adk new my-agent --template loop
conditionalWorkflow-Vorlage

Leiten Sie jede Anfrage an den richtigen Spezialisten weiter.

Erzeugt technische und allgemeine Agenten innerhalb eines ConditionalAgent, der einen Pfad aus der eingehenden Anfrage auswählt.

Wählen Sie dies, wenn

Wählen Sie diese Option, wenn für Arbeitskategorien unterschiedliche Anweisungen, Tools, Modelle oder Fachspezialisten erforderlich sind.

Generierter Ausgangspunkt

ConditionalAgent · zwei Routen · LLM-basierte Auswahl

cargo adk new my-agent --template conditional
customAgentenvorlage

Implementieren Sie den Agentenvertrag direkt.

Erstellt einen MyAgent-Typ mit den Agent-Trait-Methoden und einer Ausführungsfunktion, die für Ihre eigene Rust-Ausführungslogik und Ihren eigenen Ereignisstrom bereit ist.

Wählen Sie dies, wenn

Wählen Sie es für deterministische Orchestrierung, vorhandene Zustandsmaschinen, Domänenlaufzeiten oder Verhalten, das eine vollständige Rust-Kontrolle erfordert.

Generierter Ausgangspunkt

Agentenmerkmalsgerüst · InvocationContext · EventStream-Einstiegspunkt

cargo adk new my-agent --template custom

Die CLI-Registrierung umfasst auch die anbieterspezifische openai Vorlage, fünf Unternehmensmuster, die basic und a2a Aliase und zusammensetzbare Funktionserweiterungen.

cargo adk templatescargo adk addons

Stellen Sie zusammen, was Sie brauchen

Fangen Sie klein an. Fügen Sie das System hinzu, wenn das Produkt Sie dazu auffordert.

Wählen Sie zunächst eine Vorlage für die Ausführungsform des Projekts. Wählen Sie dann eine Funktionsebene für die in die Binärdatei kompilierten Funktionen aus.

Funktionsebenen steuern Abhängigkeiten, Kompilierzeit, Binäroberfläche und die verfügbaren Framework-APIs. Persistente Datenbanken, MCP, Cloud Secret Manager und spezifische Echtzeittransporte bleiben explizite Optionen.

01 · Beginnen Sie hier

minimal

Agenten · Gemini · Runner · Sitzungen

Ein fokussierter Agent mit der kleinsten Standardoberfläche.

02 · Erstellen Sie ein Produkt

Standard

Tools · Speicher · Diagramm · Server · Authentifizierung · Auswertung · Telemetrie

Die meisten APIs, Workflow-Systeme und internen Agentenprodukte.

03 · Erweitern Sie das System

Unternehmen

Echtzeitbasis · Browser · RAG · Zahlungen · AWP

Produkte, die eine umfassendere Interaktion und Interoperabilität benötigen.

04 · Spezialoberfläche

voll

Audio · Codeausführung · Sandbox

Entscheiden Sie sich für die umfassendsten lokalen und Ausführungsfunktionen.

adk-rust = { version = "2.0.0", features = ["standard"] }

Erstellen Sie mit ADK-Rust

Erstellen Sie einen funktionierenden Agenten, verstehen Sie seine Laufzeit und erweitern Sie ihn mit Zuversicht.

Ihr erster nützlicher Meilenstein ist eine Anfrage, ein sichtbarer Tool-Aufruf und eine Sitzung, die Sie verstehen. Der geführte Schnellstart erstellt diesen Weg. Fügen Sie von dort aus die Arbeitsabläufe, Zustände, Protokolle und Bedienelemente hinzu, die Ihr Produkt benötigt.