ADK-Rust

Documentation officielle de ADK-Rust

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

Premiers pas

  • Introduction - Vue d’ensemble de ADK-Rust, de son architecture et de ses concepts clés
  • Démarrage rapide - Créez la structure, exécutez et testez votre premier agent dans l’interface utilisateur intégrée en moins de 5 minutes
  • Démarrage rapide de A2UI - Émettez du JSONL A2UI et affichez-le dans React
  • Migration de 1.0 → 2.0 - Liste complète des changements incompatibles avec le code avant/après

Cœur

  • Types fondamentaux - Types fondamentaux : Content, Part, trait Agent, trait Tool, contextes
  • Exécuteur - Environnement d’exécution et configuration des agents
  • Plugins - Hooks de cycle de vie pour l’interception des outils/modèles et les middlewares

Modèles

Agents

Agent de programmation

Un agent de programmation natif : lire/modifier/exécuter du code dans un espace de travail isolé, un mode autonome orienté objectifs et des workflows de révision ultra-approfondie parallèles.

  • Vue d’ensemble - Commencez ici : les composants, 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é
  • Harnais - CodingAgent (la fonctionnalité coding), la boucle de planification, write_todos
  • CLI - adk-rust code / goal (durable, reprenable) / ultracode
  • Workflows - Révision ultra-approfondie 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é, accessible aux débutants, pour créer des agents vocaux et 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 de parole
  • Fournisseurs - Modèles OpenAI Realtime et Gemini Live, voix et critères de choix
  • Outils - Actions côté serveur : gestionnaires natifs, adk_core::Tools interconnectés, appels parallèles
  • Multimodal - Entrée vidéo via send_video_frame et capture par caméra du navigateur
  • Dialogue affectif - Réponses sensibles aux émotions avec l’audio natif de Gemini
  • Mémoire - Injection de contexte, stockage des tours de parole 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

Protocole client d’agent

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

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é, accessible aux nouveaux utilisateurs, consacré à la fois au magasin sémantique et au graphe de connaissances bi-temporel.

  • Vue d’ensemble - 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, la portée du projet et l’effacement conforme au RGPD
  • Backends - Les six magasins (InMemory, SQLite, Postgres+pgvector, Redis, MongoDB, Neo4j) et comment choisir
  • Graphe de connaissances - GraphMemoryService : entités, observations, relations et pourquoi le bi-temporel est important
  • Outils et agents - Intégration de la mémoire aux agents ; remember/relate et les outils de mémoire

Rappels et événements

  • Rappels - Intercepter et personnaliser le comportement des agents
  • Événements - Comprendre le système d’événements et l’historique des conversations

Artefacts

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

Observabilité

Déploiement

Évaluation

Agents gérés

Sécurité

  • Contrôle des accès - Autorisations basées sur les rôles et journalisation des audits
  • Garde-fous - Masquage des informations personnelles identifiables, filtrage du contenu et 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

Conformité

  • Déploiements Vertex uniquement - Garantie qu’aucun trafic Gemini Studio (generativelanguage.googleapis.com) ne soit utilisé pour les charges de travail HIPAA et de résidence des données

Studio

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

Développement

État de la validation

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