ADK-Rust

ADK-Rust Documentation officielle

Bienvenue dans la documentation officielle de ADK-Rust (Agent Development Kit for Rust). Cette documentation fournit des guides complets et des références pour créer des agents IA à l’aide de l’implémentation Rust du framework ADK.

Pour commencer

Noyau

  • Types de base - Types fondamentaux : Content, Part, trait Agent, trait Tool, contextes
  • Runner - Runtime d’exécution des agents et configuration
  • Plugins - Hooks de cycle de vie pour l’interception outil/modèle et le middleware

Modèles

Agents

Agent de codage

Un agent de codage natif : lire/éditer/exécuter du code dans un espace de travail isolé, mode objectif autonome et workflows parallèles d’ultra-review.

  • Vue d’ensemble - Commencez ici : les éléments, l’installation et un démarrage rapide en 60 secondes
  • Outils de développement - adk-devtools : read/write/edit/glob/grep/bash + le Workspace isolé
  • Harness - CodingAgent (la fonctionnalité coding), la boucle de planification, write_todos
  • CLI - adk-rust code / goal (durable, reprenable) / ultracode
  • Workflows - Ultra-review sur adk-graph : réviseurs parallèles + fan-in
  • Exemples - Les trois crates d’exemple exécutables

Temps réel et multimodal

Un guide dédié et convivial pour les débutants pour créer des agents voix + multimodaux — architecture, concepts et exemples exécutables.

  • Vue d’ensemble - Commencez ici : le modèle mental, l’installation et un démarrage rapide en 60 secondes
  • Architecture - Les quatre couches, la boucle d’événements, le pipeline audio et le cycle de vie des tours
  • Fournisseurs - Modèles temps réel OpenAI et Gemini Live, voix, et comment choisir
  • Outils - Actions côté serveur : gestionnaires natifs, adk_core::Tools bridgés, appels parallèles
  • Multimodal - Entrée vidéo via send_video_frame et capture de caméra du navigateur
  • Dialogue affectif - Réponses sensibles aux émotions sur l’audio natif Gemini
  • Mémoire - Injection de contexte, stockage des tours et auto-curation du graphe de connaissances
  • Création d’applications web - Le pont côté serveur, le protocole WS et Web Audio
  • Exemples - Les quatre exemples exécutables et un parcours d’apprentissage suggéré

Outils

  • Outils de fonction - Créez des outils personnalisés avec des fonctions Rust async
  • Outils intégrés - Outils préconstruits comme GoogleSearchTool
  • Vue d’ensemble et architecture de MCP - Où s’intègre MCP et quelle surface ADK-Rust utiliser
  • Client MCP - Outils, ressources, prompts, completion, subscriptions, elicitation, tâches et HTTP
  • Gestionnaire dynamique de serveur MCP - Registre local de serveurs à l’exécution, persistance, surveillance et redémarrage
  • Création de serveur MCP - Publiez des outils et d’autres capacités avec le SDK officiel Rust aligné
  • Sécurité de MCP - Authentification, visibilité, autorisation, approbation et gestion des secrets
  • Tests de MCP - Garde-fous déterministes et vérification du déploiement
  • Outils de navigateur - 46 outils WebDriver pour l’automatisation web
  • Outils UI - Génération dynamique d’UI avec formulaires, cartes, graphiques
  • RAG - Génération augmentée par récupération pour la recherche dans la base de connaissances
  • Outils ACP - Utilisez un agent de codage ACP comme outil typé ADK-Rust
  • Retry & Reflect - Récupération des échecs d’outil avec des prompts de réflexion
  • Nœuds d’action - 14 types de nœuds déterministes pour les graphes de workflow
  • Benchmarking - Mesure des performances avec cargo adk bench

Protocole client agent

Utilisez un agent de codage externe depuis ADK-Rust, ou exposez un agent ADK-Rust à un éditeur via ACP v1 stable.

  • Architecture et concepts - Rôles client/hôte et agent de codage, sessions, capacités et flux du protocole
  • Client et hôte ACP - Délégation, sessions persistantes, streaming, annulation, permissions, fichiers, terminaux et MCP
  • Serveur agent ACP - Exposez le Runner, les outils, les sessions et les événements en direct via stdio
  • Matrice de tests et de support - Interopérabilité vérifiée et fonctionnalités délibérément non annoncées

Sessions et état

Mémoire

Mémoire à long terme qui survit à une session — le pendant persistant de l’état de session. Un guide dédié et convivial pour les débutants sur le magasin sémantique et le graphe de connaissances bi-temporel.

  • Aperçu - Commencez ici : les deux types de mémoire, le modèle mental, l’installation et un démarrage rapide
  • Concepts - MemoryEntry, le trait MemoryService, la recherche, le périmètre du projet, l’effacement GDPR
  • Backends - Les six stockages (InMemory, SQLite, Postgres+pgvector, Redis, MongoDB, Neo4j) et comment choisir
  • Graphe de connaissance - GraphMemoryService : entités, observations, relations, et pourquoi le bi-temporel est important
  • Outils et agents - Intégrer la mémoire dans les agents ; remember/relate et les outils de mémoire

Rappels et événements

  • Rappels - Intercepter et personnaliser le comportement de l’agent
  • Événements - Comprendre le système d’événements et l’historique de conversation

Artefacts

  • Artefacts - Stockage et récupération de données binaires

Observabilité

Déploiement

Évaluation

Agents gérés

  • Runtime d’agent géré - Moteur d’exécution d’agent neutre vis-à-vis des fournisseurs, durable et reprenable (Expérimental)

Sécurité

  • Contrôle d’accès - Permissions basées sur les rôles et journalisation d’audit
  • Garde-fous - Masquage des données PII, filtrage du contenu, validation du schéma
  • Mémoire - Mémoire sémantique à long terme pour les agents
  • Paiements et commerce - Parcours de commerce agentique, prise en charge des protocoles et chemins de validation

Studio

  • Studio ADK - Environnement de développement visuel pour créer des agents
  • Nœuds d’action - Nœuds programmatiques non-LLM pour les workflows d’automatisation
  • Déclencheurs - Déclencheurs webhook, planifiés et d’événements pour les workflows

Développement

État de validation

Les commandes Cargo à copier-coller et les extraits de dépendances dans le README et la documentation officielle sont validés par scripts/check-doc-examples.sh. La CI vérifie également les squelettes cargo-adk avec scripts/check-cargo-adk-templates.sh, rejette les noms de cibles d’exemple dupliqués avec scripts/check-example-name-collisions.sh, et compile les exemples de l’espace de travail avec cargo check --workspace --examples.