ADK-Rust

ADK-Rust Documentación oficial

Bienvenido a la documentación oficial de ADK-Rust (Kit de desarrollo de agentes para Rust). Esta documentación proporciona guías y referencias completas para crear agentes de IA usando la implementación en Rust del marco ADK.

Primeros pasos

  • Introducción - Descripción general de ADK-Rust, su arquitectura y conceptos clave
  • Inicio rápido - Configura, ejecuta y prueba tu primer agente en la interfaz de usuario integrada en menos de 5 minutos
  • Inicio rápido de A2UI - Emite JSONL de A2UI y represéntalo en React
  • Migración de 1.0 → 2.0 - Lista completa de cambios incompatibles con código anterior y posterior

Núcleo

  • Tipos principales - Tipos fundamentales: Content, Part, el trait Agent, el trait Tool y contextos
  • Ejecutor - Entorno de ejecución y configuración de agentes
  • Complementos - Hooks del ciclo de vida para interceptar herramientas y modelos, y para middleware

Modelos

Agentes

Agente de programación

Un agente de programación nativo: leer, editar y ejecutar código en un espacio de trabajo aislado, modo de objetivos autónomo y flujos de trabajo de revisión ultra en paralelo.

  • Descripción general - Comienza aquí: las piezas, la instalación y un inicio rápido de 60 segundos
  • Herramientas de desarrollo - adk-devtools: leer/escribir/editar/glob/grep/bash + el Workspace aislado
  • Arnés - CodingAgent (la función coding), el bucle de planificación, write_todos
  • CLI - adk-rust code / goal (duradero y reanudable) / ultracode
  • Flujos de trabajo - Revisión ultra en adk-graph: revisores en paralelo + fan-in
  • Ejemplos - Los tres crates de ejemplo ejecutables

Tiempo real y multimodal

Una guía específica y accesible para principiantes sobre la creación de agentes de voz y multimodales: arquitectura, conceptos y ejemplos ejecutables.

  • Descripción general - Comienza aquí: el modelo mental, la instalación y un inicio rápido de 60 segundos
  • Arquitectura - Las cuatro capas, el bucle de eventos, la canalización de audio y el ciclo de vida del turno
  • Proveedores - Modelos de tiempo real de OpenAI y Gemini Live, voces y cómo elegir
  • Herramientas - Acciones del lado del servidor: controladores nativos, adk_core::Tools conectados mediante puente, llamadas en paralelo
  • Multimodal - Entrada de vídeo mediante send_video_frame y captura de cámara del navegador
  • Diálogo afectivo - Respuestas sensibles a las emociones en el audio nativo de Gemini
  • Memoria - Inyección de contexto, almacenamiento de turnos y autocuración del grafo de conocimiento
  • Creación de aplicaciones web - El puente del lado del servidor, el protocolo WS y Web Audio
  • Ejemplos - Los cuatro ejemplos ejecutables y una ruta de aprendizaje sugerida

Herramientas

Protocolo de cliente de agentes

Usa un agente de programación externo de ADK-Rust o expón un agente ADK-Rust a un editor mediante ACP v1 estable.

Sesiones y estado

Memoria

Memoria a largo plazo que sobrevive a una sesión: la contraparte persistente del estado de la sesión. Una guía dedicada y accesible para principiantes sobre el almacén semántico y el grafo de conocimiento bitemporal.

  • Descripción general - Comienza aquí: los dos tipos de memoria, el modelo mental, la instalación y un inicio rápido
  • Conceptos - MemoryEntry, el trait MemoryService, búsqueda, alcance del proyecto y eliminación conforme al RGPD
  • Backends - Los seis almacenes (InMemory, SQLite, Postgres+pgvector, Redis, MongoDB, Neo4j) y cómo elegir
  • Grafo de conocimiento - GraphMemoryService: entidades, observaciones, relaciones y por qué importa la bitemporalidad
  • Herramientas y agentes - Integración de la memoria en los agentes; remember/relate y las herramientas de memoria

Callbacks y eventos

  • Callbacks - Interceptar y personalizar el comportamiento del agente
  • Eventos - Comprender el sistema de eventos y el historial de la conversación

Artefactos

  • Artefactos - Almacenamiento y recuperación de datos binarios

Observabilidad

Implementación

Evaluación

Agentes administrados

Seguridad

  • Control de acceso - Permisos basados en roles y registro de auditoría
  • Protecciones - Redacción de información de identificación personal, filtrado de contenido y validación de esquemas
  • Memoria - Memoria semántica a largo plazo para agentes
  • Pagos y comercio - Recorridos de comercio agéntico, compatibilidad con protocolos y rutas de validación

Cumplimiento

  • Despliegues exclusivos de Vertex - Garantiza que no haya tráfico de Gemini Studio (generativelanguage.googleapis.com) para cargas de trabajo de HIPAA y residencia de datos

Studio

  • Studio de ADK - Entorno de desarrollo visual para crear agentes
  • Nodos de acción - Nodos programáticos que no son LLM para flujos de trabajo de automatización
  • Disparadores - Disparadores de webhook, programación y eventos para flujos de trabajo

Desarrollo

Estado de validación

Los comandos de Cargo y los fragmentos de dependencias que se pueden copiar y pegar en el README y en la documentación oficial son validados por scripts/check-doc-examples.sh. CI también comprueba los esqueletos de cargo-adk con scripts/check-cargo-adk-templates.sh, rechaza nombres de destino de ejemplo duplicados con scripts/check-example-name-collisions.sh y compila los ejemplos del espacio de trabajo con cargo check --workspace --examples.