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 de ADK.

Primeros pasos

Introducción - Resumen de ADK-Rust, su arquitectura y conceptos clave
Inicio rápido - Crea tu primer agente en menos de 10 minutos
A2UI Inicio rápido - Emite JSONL de A2UI y represéntalo en React
Migrando de 1.0 → 2.0 - Lista completa de cambios incompatibles con código antes/después

Núcleo

Tipos principales - Tipos fundamentales: Content, Part, trait Agent, trait Tool, contextos
Runner - Tiempo de ejecución y configuración de la ejecución del agente
Plugins - Hooks de ciclo de vida para interceptación de herramientas/modelo y middleware

Modelos

Proveedores de modelos - Integraciones de LLM: Gemini, OpenAI, Anthropic, DeepSeek, Groq, Ollama
Ollama - Inferencia local con Ollama
Integración de mistral.rs - mistral.rs nativo para inferencia local de alto rendimiento

Agentes

LlmAgent - El tipo de agente principal que usa modelos de lenguaje grandes
CodeAgent (CodeAct) - Actúa escribiendo y ejecutando código mediante un CodeRuntime
Agentes de flujo de trabajo - Agentes deterministas: Secuencial, Paralelo, Bucle
Sistemas multiagente - Construcción de jerarquías de agentes con subagentes
Agentes de grafo - Orquestación de flujos de trabajo al estilo LangGraph
Agentes en tiempo real - Agentes con voz habilitada con OpenAI/Gemini

Agente de programación

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

Resumen - Empieza aquí: las piezas, instalación y un inicio rápido de 60 segundos
Herramientas de desarrollo - adk-devtools: read/write/edit/glob/grep/bash + el Workspace aislado
Harness - CodingAgent (la función coding), el bucle de planificación, write_todos
CLI - adk-rust code / goal (duradero, reanudable) / ultracode
Flujos de trabajo - Ultra-revisión en adk-graph: revisores en paralelo + fan-in
Ejemplos - Los tres crates de ejemplo ejecutables

Tiempo real y multimodal

Una guía dedicada y fácil para principiantes para construir agentes de voz + multimodales — arquitectura, conceptos y ejemplos ejecutables.

Resumen - Empieza 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 - OpenAI modelos Realtime y Gemini Live, voces y cómo elegir
Herramientas - Acciones del lado del servidor: handlers nativos, adk_core::Tool enlazadas, llamadas paralelas
Multimodal - Entrada de video mediante send_video_frame y captura de cámara del navegador
Diálogo afectivo - Respuestas conscientes de las emociones en audio nativo de Gemini
Memoria - Inyección de contexto, almacenamiento de turnos y autocuración del grafo de conocimiento
Creación de apps 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

Herramientas de función - Crea herramientas personalizadas con funciones async de Rust
Herramientas integradas - Herramientas preconstruidas como GoogleSearchTool
Resumen y arquitectura de MCP - Dónde encaja MCP y qué superficie de ADK-Rust usar
Cliente MCP - Herramientas, recursos, prompts, completación, suscripciones, elicitation, tareas y HTTP
Gestor de servidor dinámico de MCP - Registro de servidores locales en tiempo de ejecución, persistencia, supervisión y reinicio
Creación de servidores de MCP - Publica herramientas y otras capacidades con el SDK oficial de Rust alineado
Seguridad de MCP - Autenticación, visibilidad, autorización, aprobación y manejo de secretos
Pruebas de MCP - Compuertas deterministas y verificación de despliegue
Herramientas del navegador - 46 herramientas de WebDriver para automatización web
Herramientas de interfaz - Generación dinámica de UI con formularios, tarjetas y gráficos
RAG - Generación aumentada por recuperación para la búsqueda en la base de conocimiento
Herramientas de ACP - Usa un agente de programación ACP como herramienta tipada de ADK-Rust
Reintentar y reflexionar - Recuperación de fallos de herramientas con prompts de reflexión
Nodos de acción - 14 tipos de nodos deterministas para grafos de flujo de trabajo
Evaluación comparativa - Medición del rendimiento con cargo adk bench

Protocolo de cliente de agente

Usa un agente de programación externo desde ADK-Rust, o expón un agente ADK-Rust a un editor a través de ACP v1 estable.

Arquitectura y conceptos - Roles de cliente/anfitrión y del agente de programación, sesiones, capacidades y flujo del protocolo
Cliente y anfitrión de ACP - Delegación, sesiones persistentes, streaming, cancelación, permisos, archivos, terminales y MCP
Servidor de agente ACP - Expone el Runner, las herramientas, las sesiones y los eventos en vivo mediante stdio
Matriz de pruebas y soporte - Interoperabilidad verificada y características deliberadamente no anunciadas

Sesiones y estado

Sesiones - Gestión y ciclo de vida de las sesiones
Gestión de estado - Gestión del estado de la conversación con prefijos

Memoria

Memoria a largo plazo que sobrevive a una sesión — el equivalente persistente del estado de la sesión. Una guía dedicada y fácil para principiantes tanto del almacén semántico como del grafo de conocimiento bi-temporal.

Resumen - Empieza 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, borrado por GDPR
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 el comportamiento bitemporal
Herramientas y Agentes - Integrar la memoria en agentes; remember/relate y las herramientas de memoria

Callbacks y eventos

Callbacks - Interceptar y personalizar el comportamiento del agente
Eventos - Entender el sistema de eventos y el historial de conversaciones

Artefactos

Artefactos - Almacenamiento y recuperación de datos binarios

Observabilidad

Telemetría - Registro, trazado y monitoreo

Despliegue

Launcher - Ejecutar agentes en modo consola o servidor
Servidor - Integración de REST API y de la interfaz web
Protocolo A2A - Comunicación de agente a agente
Protocolo Web Agéntico - Protocolo AWP para servicios web nativos de agentes

Evaluación

Evaluación de Agentes - Pruebas y validación del comportamiento del agente
Resultados de Benchmark - Datos publicados de comparación de rendimiento

Agentes Gestionados

Runtime de Agente Gestionado - Motor de ejecución de agentes neutral respecto al proveedor, duradero y reanudable (Experimental)

Seguridad

Control de acceso - Permisos basados en roles y registro de auditoría
Guardrails - Redacción de PII, filtrado de contenido, validación de esquemas
Memoria - Memoria semántica a largo plazo para agentes
Pagos y comercio - Recorridos de comercio agéntico, soporte de protocolos y rutas de validación

Studio

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

Desarrollo

Guías de desarrollo - Guía de contribución y buenas prácticas
Rendimiento 0.8 - Ejemplos de la versión de optimización y validación orientada a la adopción

Estado de validación

Los comandos de Cargo para copiar y pegar y los fragmentos de dependencias en el README y 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 duplicados de destinos de ejemplo con scripts/check-example-name-collisions.sh y compila ejemplos del espacio de trabajo con cargo check --workspace --examples.