ADK-Rust 2.0

El marco Rust paraalto rendimiento, listo para producciónAgentes de IA.

ADK-Rust reúne agentes tipificados, herramientas, estado duradero, medios en tiempo real y protocolos abiertos en un tiempo de ejecución asíncrono, para que pueda pasar de un agente enfocado a un sistema que pueda operar con confianza.

Comience con la unidad de trabajo.

¿Qué es un agente de IA en términos de ADK-Rust?

Un agente es un componente asíncrono Rust. Recibe un contexto de invocación, realiza trabajo con modelos o herramientas y emite eventos tipados a medida que avanza. Los agentes LLM, flujos de trabajo, agentes en tiempo real, agentes de codificación y agentes Rust personalizados utilizan este contrato compartido.

Lo que hace que ADK-Rust sea atractivo es que el agente sigue siendo parte de un sistema de software que puede comprender y controlar. Las llamadas de modelos, las entradas de herramientas, los cambios de estado, las aprobaciones y los eventos transmitidos tienen contratos Rust explícitos. El mismo tiempo de ejecución puede admitir un asistente enfocado, un flujo de trabajo duradero de múltiples agentes, una experiencia de voz en tiempo real o un agente que trabaja en todos los servicios, preservando al mismo tiempo el rendimiento, la simultaneidad, la portabilidad y la disciplina operativa que esperan los equipos de Rust.

Si conoce LangGraph, Google ADK, OpenAI Agents SDK o CrewAI, reconocerá herramientas, transferencias, flujos de trabajo, memoria, barreras de seguridad y rastreo. ADK-Rust incorpora esas ideas a un tiempo de ejecución nativo de Rust y las conecta con medios en tiempo real, ejecución de código, RAG, artefactos y protocolos abiertos como MCP, A2A, ACP y AWP. La versión 2 amplía esa base con agentes gráficos, en tiempo real, de codificación y CodeAct; esquemas de herramientas conscientes del proveedor; plantillas de proyectos componibles y construcción de carga adk; controles de estado y operación más estrictos; y un seguimiento de eventos escrito consistente desde la primera llamada del modelo hasta la producción.

Arquitectura de runtime de ADK-Rust v2Las superficies de productos envían solicitudes al ADK Runner. El corredor coordina formas de agentes, proveedores de modelos, herramientas, servicios estatales, protocolos abiertos y controles de producción a través de eventos tipificados.ADK-Rust v2: una solicitud, todo el sistemaNaranja fijo: ejecución · gris discontinuo: eventos, resultados, currículum · límite morado: protocolos abiertosSUPERFICIES DEL PRODUCTOWeb y móvilClientes UI/APIVoz y vídeoClientes en tiempo realOtros agentesA2A / ACP / AWPCLI y trabajoscarga-adk / cronTIEMPO DE EJECUCIÓN DE ADKRunnersesión · contexto de invocación · cancelación · devoluciones de llamada · flujo de eventosELIJA EL AGENTE FORMA LAS NECESIDADES DEL TRABAJOAgente LLMrazón + herramientasFlujo de trabajosecuencia/paralelo/bucleGráficopunto de control + HITLCodeActescribir + ejecutar códigoEn tiempo realvoz + vídeopersonalizadoimplementar agenteFlujo de eventos tipadostexto del modelo · llamadas a herramientas · progreso · deltas de estado · artefactos · transferencias · erroresCAPACIDADES ALREDEDOR DEL AGENTEProveedores de modelosGemini · OpenAI · AnthropicOllama · Bedrock · Azure AIHerramientas y especialistas#[tool] · skills · browserMCP · ACP · code sandboxEstado y conocimientosessions · memory · RAGartifacts · graph checkpointsMedios e interfacesaudio · video · A2UIREST · SSE · WebSocketProtocolos de agentesA2A · AWPdiscovery · task contractsComercio · evolucionandoACP commerce · AP2 alphadurable transaction journalsEjecutarllamarresultadoemitir eventoPROTOCOLO Y LÍMITE DE IMPLEMENTACIÓNREST / SSEA2AACPAWPMCPWebSocketLos protocolos adaptan el tiempo de ejecución en los límites del sistema; no lo reemplazan.Autenticación · autorización de herramientas · barreras de seguridad · sandbox · complementos · telemetría · evaluación · reintento/cancelaciónPRODUCTOS COMPAÑEROSStudio · UI · Área de juegos · Plataforma empresarial

Cómo leer la arquitectura.

Siga el diagrama de izquierda a derecha. La superficie de un producto envía una solicitud al Runner. El Runner adjunta el estado de la sesión y el contexto de invocación y luego llama al agente seleccionado. Los modelos, las herramientas y el estado respaldan el trabajo, mientras que los eventos tipados transmiten el progreso y los resultados.

Dentro del tiempo de ejecución

Runner, agentes, eventos tipados, bucles de modelo/herramienta, sesiones, devoluciones de llamada, transferencias y cancelación.

en el limite

MCP, A2A, ACP, AWP, HTTP, SSE y los transportes en tiempo real conectan sistemas separados y zonas de confianza.

Fuera del marco

Studio, UI, Playground y el plano de control consumen ADK-Rust; no funcionan dentro del Runner.

Superficie del marco

Las capacidades detrás de la arquitectura.

ADK-Rust reúne el ciclo de vida completo del agente en un marco: componer el comportamiento del agente, proporcionarle herramientas, preservar el contexto, conectarlo a otros sistemas y operarlo de forma segura en producción. Los grupos siguientes muestran cómo encajan esas capacidades.

Cree agentes LLM, de flujo de trabajo, gráficos, en tiempo real y de codificación; equípelos con herramientas mecanografiadas, MCP, RAG, memoria, sesiones y artefactos; conéctelos a través de REST, A2A, ACP y AWP; luego agregue autorización, barreras de seguridad, telemetría y evaluación para producción.

componer

componer 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.

actuar

actuar capability

#[tool]

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

recuerda

recuerda capability

sessions

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

Conectar

Conectar capability

REST

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

Operar

Operar capability

auth

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

construir

construir capability

12 templates

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

Mira como funciona

Muestre el trabajo mientras está sucediendo.

El Runner resuelve la sesión, crea el contexto de invocación, ejecuta el agente, transmite el trabajo del modelo y la herramienta, aplica cambios de estado, persiste eventos duraderos y devuelve el progreso a la persona que llama a medida que sucede.

Ese mismo rastro puede alimentar una terminal, una interfaz de usuario web, un cliente API, una evaluación o una conversación en tiempo real.

Sigue una petición real

Un cliente pregunta: "¿Por qué falló mi pago?" El Runner abre la sesión correcta, transmite la salida del modelo y la actividad de la herramienta, registra los cambios de estado y devuelve cada evento útil a la interfaz. El usuario ve el progreso mientras el operador obtiene un registro de ejecución completo.

Una invocación a través de ADK-RustUna solicitud carga una sesión, ingresa al ejecutor, recorre el trabajo del modelo y la herramienta, emite eventos tipados y persiste el estado y los artefactos antes de que regrese la respuesta.Seguir una solicitud durante el tiempo de ejecuciónNada desaparece en una caja negra: cada etapa produce estados o eventos tipados.SolicitudContenido + identidadCargar sesiónhistoria + estadoRunnercontexto + ciclo de vidaAgentedecidir el siguiente pasomodelorespuesta de flujoHerramientaactuar sobre el sistemaEventosinterfaz de usuario/servidorpersistir el rastroeventos de sesión · deltas de estado · memoria · artefactos · puntos de control de gráficos · seguimientos de evaluación

componer el comportamiento

Cuando el trabajo crezca, divida el trabajo sin perder el hilo.

Estudiar patrones de múltiples agentes

Un enrutador identifica el trabajo que se debe realizar. Los especialistas manejan las piezas que mejor entienden. Los flujos de trabajo secuenciales y paralelos controlan el orden de ejecución, mientras que los puntos de control de gráficos mantienen las pruebas, las aprobaciones y el progreso adjuntos al mismo trabajo.

Flujo de trabajo avanzado de operaciones de clientes multiagente ADK-RustUn incidente de acceso de cliente se dirige a agentes paralelos de cuentas, pagos y plataformas. Utilizan sistemas MCP y A2A, escriben pruebas en estados de puntos de control compartidos y convergen en un gráfico de supervisor con rutas de reintento, aprobación, acción y auditoría.Resolver una incidencia real de un cliente sin perder el controlCaso de uso: "El pago se realizó correctamente, pero el espacio de trabajo de nuestro equipo aún está bloqueado".El flujo de trabajo debe establecer los hechos, elegir un remedio seguro, solicitar aprobación para acciones consecuentes y dejar un rastro de evidencia.ClienteWeb · voz · APIenrutador de clasificaciónLlmConditionalAgentClasificar · establecer urgencia · elegir especialistassolicitudINVESTIGACIÓN PARALELA · ParallelAgentagente de cuentaIdentidad + derechoLee el estado del cliente, del equipo y del acceso.agente de pagoFacturación + transacciónConcilia cargo, factura y planAgente de plataformaTiempo de ejecución + aprovisionamientoComprueba cerraduras, trabajos y estado del servicio.desplegarseLÍMITES DEL SISTEMACRM + identidadRecursos / herramientas MCPERP + pagosMCP + diario de comercioServicio de aprovisionamientoAgente remoto A2AEstado de incidente compartido + punto de control gráficocustomer_id · evidencia de pago · estado del derecho · estado de la plataforma · confianza · acción propuestaCada especialista escribe pruebas mecanografiadas; Los reintentos y las interrupciones humanas se reanudan desde el mismo punto de control.GRÁFICO DEL SUPERVISORSintetizar evidenciaGraphAgentComparar hechos · calificar la confianza¿Suficientes pruebas?Borde condicionallisto / investigarinvestigar de nuevoLoopAgent + reflejoReintentar solo la rama que faltaPuerta de aprobacióninterrupción del gráficoDesbloqueo/reembolso necesita una personaactuar en ordenSequentialAgentdesaparecidocurrículum especialista seleccionadolistoFlujo de resultadosespacio de trabajo restaurado · respuesta del cliente · artefacto de evidencia · evento de sesión · registro de auditoría · seguimiento de telemetría · muestra de evaluaciónAutenticación · RBAC · confirmación de herramienta · barandillas · cancelación · sandbox · telemetría · evaluación rodean toda la invocación
El gráfico no pide a un agente que lo improvise todo. El enrutamiento reduce el problema, los especialistas investigan simultáneamente, el estado compartido mantiene su evidencia coherente y la acción consecuente permanece detrás de un límite de aprobación explícito.

LlmAgent

Razonamiento enfocado

Un modelo, instrucciones, herramientas, devoluciones de llamadas y resultados transmitidos: el centro pequeño y útil de la mayoría de los sistemas.

Sequential · Parallel · Loop

Trabajo determinista

Condiciones expresas de orden, concurrencia, repetición y salida directamente en el programa Rust.

GraphAgent

Orquestación duradera

Ramificar, controlar, interrumpir a una persona y reanudar después de que el proceso o la conversación haya avanzado.

CodingAgent · CodeActAgent

Software como acción

Deje que un agente inspeccione, edite y ejecute código dentro de un espacio de trabajo y un límite de espacio aislado que usted controle.

RealtimeAgent

Conversación en vivo

Transmita audio, transcripciones, cuadros de video, interrupciones y herramientas del lado del servidor a través de una sesión en vivo.

CustomAgent

Tu propia lógica de ejecución

Implemente el contrato de Agente para el comportamiento específico del producto escrito directamente en Rust.

El sistema alrededor del agente.

El modelo es una parte del producto.

Los agentes útiles necesitan herramientas, estado, interfaces, límites y evidencia. ADK-Rust expone cada pieza a través de interfaces componibles Rust de su propiedad.

Un producto, varias responsabilidades

En un producto de atención al cliente, el modelo redacta la respuesta, las herramientas inspeccionan el pedido, la sesión transmite el contexto del cliente, la autorización controla los reembolsos, un artefacto almacena el recibo y la telemetría registra el resultado. Cada responsabilidad permanece visible en el tiempo de ejecución.

Una arquitectura completa de producto de agente ADK-RustLas interfaces ingresan a un runtime de ADK-Rust que coordina la lógica del agente, un adaptador de modelo reemplazable, herramientas, estado y servicios de conocimiento. Los eventos tipificados producen progreso visible, artefactos, acciones, registros de auditoría y evidencia de evaluación bajo controles compartidos.Un producto agente útil es un sistema completo.El modelo puede cambiar. Los contratos, el estado, las herramientas, los controles y las pruebas siguen siendo suyos.PERSONAS E INTERFACESaplicación webchat · formularios · artefactosVoz y vídeosesión de medios en vivoAPI y eventosREST · SSE · WebSocketOtros agentesA2A · ACP · AWPTIEMPO DE EJECUCIÓN DE ADK-RUSTRunner + flujo de eventos escritosesión · contexto · ciclo de vida · cancelaciónLógica del agentemotivo · rutaFlujo de trabajográfico · HITLBucle de modelo/herramientallamar · observar · aprobar · reintentar · continuarMODELO · UN ADAPTADOR REEMPLAZABLEProveedoralojado / localesquemaprovider-awareHERRAMIENTAS Y SISTEMAS EXTERNOSHerramientas Rust#[tool]MCPherramientas · recursosNavegadoracciones webEspecialistasACP · A2AESTADO, CONOCIMIENTO Y TRABAJO DURADEROSesiónMemoriaRAGArtefactosPuntos de controlLO QUE EL PRODUCTO PUEDE MOSTRARProgreso en vivotokens · estado de la herramienta · audioArtefactos útilesarchivos · informes · medios · UIAcciones aprobadasescribe · pagos · traspasosContinuidad duraderasesiones · memoria · currículumevidenciaeventos · auditoría · telemetríaSeñales de calidadevaluación · costo · latencialos eventos tipados regresan a cada interfazAutenticación · identidad · autorización de herramienta · aprobación · barandillas · sandbox · cancelación · telemetría · evaluación
El modelo proporciona inteligencia dentro de un producto completo: interfaces que las personas pueden usar, herramientas que pueden actuar, estados que sobreviven, controles que limitan el riesgo y evidencia que explica lo que sucedió.
Modelos

Cambiar el modelo sin rediseñar el agente.

Los modelos de frontera alojados, los modelos de enrutamiento rápido, el Ollama local y la inferencia de mistral.rs nativos se encuentran detrás de un contrato Llm común.

Gemini · OpenAI · Anthropic · OpenRouter · DeepSeek · Groq · Ollama · Bedrock · Azure AI · puntos finales compatibles

Herramientas

Las herramientas utilizan contratos explícitos e inspeccionables.

Convierta una función Rust escrita, un servidor MCP, una habilidad, una sesión de navegador, un agente de codificación o un proceso de espacio aislado en una capacidad que el tiempo de ejecución pueda inspeccionar y llamar.

#[tool] · FunctionTool · MCP · ACP · habilidades · navegador · código

Estado

Mantenga la conversación y el trabajo que produjo.

Las sesiones contienen el historial de eventos. La memoria recupera conocimientos útiles. Los artefactos conservan archivos. Los puntos de control del gráfico permiten reanudar el trabajo prolongado.

SQLite · PostgreSQL · Redis · MongoDB · Firestore · Neo4j · sesiones cifradas

En tiempo real

Un agente en vivo es más que un punto final del habla.

ADK-Rust mantiene audio, transcripciones, fotogramas de vídeo, llamadas de herramientas, interrupciones y cambios de contexto dentro de una sesión propiedad de Rust.

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

conocimiento

Lleve la recuperación al mismo camino de ejecución.

Divida documentos, incrústelos, busque almacenes de vectores, reordene los resultados y aísle la memoria por proyecto antes de que responda el modelo.

Canalizaciones RAG · memoria semántica · gráfico de conocimiento · cinco implementaciones de almacén de vectores

controlar

Ponga aprobación donde ocurre la acción.

La autorización, las devoluciones de llamadas, las barreras de seguridad, los perfiles de la zona de pruebas, la cancelación, la telemetría y la evaluación forman el límite de ejecución de la producción.

RBAC · OAuth/OIDC · confirmación de herramienta · barandillas de PII · OpenTelemetry · evaluación

Elige el límite

Utilice el protocolo que coincida con la distancia.

Comience por dónde se ejecuta la capacidad.

Mantenga a los subagentes dentro de un runtime de ADK-Rust cuando compartan implementación, estado y confianza. Introducir un protocolo cuando la capacidad, el agente, el espacio de trabajo de codificación o el sitio web tengan un límite de implementación, proceso, propiedad o confianza propio.

Mismo proceso Rust

Agente, subagente o herramienta

Herramientas o recursos externos

MCP

Agente desplegado de forma independiente

A2A

Proceso de codificación o IDE

ACP

Sitio web legible por agentes

AWP

MCP

Protocolo de contexto modelo

Darle a un agente capacidades que viven en otro lugar.

What is MCP?

Una forma estándar para que un servidor externo publique herramientas a las que un agente puede llamar y recursos que puede leer.

Why use this protocol?
Evita escribir un adaptador personalizado para cada base de datos, producto SaaS, sistema de archivos o fuente de conocimiento, y el mismo servidor puede servir a más de un agente.
How does ADK-Rust use MCP?
McpToolset conecta el servidor al contrato de herramientas de ADK-Rust. El tiempo de ejecución descubre sus esquemas, los normaliza para el proveedor de modelo seleccionado y puede leer recursos MCP o administrar procesos del servidor MCP local.
When should I choose MCP?
Utilice MCP cuando la capacidad pertenezca a un proceso independiente, ya tenga un servidor MCP o deba compartirse entre varios agentes y aplicaciones.
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

Protocolo de agente a agente

Deje que los agentes implementados de forma independiente trabajen juntos.

What is A2A?

Un protocolo de red para descubrir un agente remoto, enviarle trabajo, seguir el progreso y recibir resultados a través de un límite HTTP.

Why use this protocol?
Un especialista puede mantener su propio modelo, herramientas, estado, ciclo de lanzamiento, implementación y límites de seguridad.
How does ADK-Rust use A2A?
ADK-Rust puede exponer un agente a través de su servidor A2A v1 y operaciones de tareas. Luego, un coordinador puede tratar ese servicio remoto como un especialista mientras los eventos transmitidos preservan el progreso del trabajo.
When should I choose A2A?
Utilice A2A cuando el agente se implemente, escale, posea o proteja por separado. Mantenga a los subagentes ordinarios en proceso cuando ninguno de esos límites exista.
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

Protocolo de cliente agente

Delegue el trabajo del software a un agente de codificación real.

What is ACP?

Un protocolo que estandariza las sesiones entre los agentes de codificación y los clientes que los alojan, incluidos editores, CLI y sistemas de orquestación.

Why use this protocol?
El trabajo de codificación necesita el contexto del espacio de trabajo, el progreso de la transmisión, la cancelación y las decisiones de permisos a lo largo de la sesión.
How does ADK-Rust use ACP?
AcpAgentTool y AcpToolset permiten que un agente ADK-Rust inicie o se conecte a un proceso ACP, establezca una sesión, transmita su trabajo y devuelva el resultado como una llamada de herramienta. El lado del servidor opcional puede exponer un agente ADK-Rust a clientes ACP.
When should I choose ACP?
Utilice ACP para la exploración, implementación, refactorización, pruebas o cualquier tarea delegada del repositorio que deba realizarse dentro de un espacio de trabajo de desarrollo controlado.
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

Protocolo web agente

Haga que un sitio web sea comprensible antes de que un agente lo elimine.

What is AWP?

Un protocolo web a través del cual un sitio publica quién es, qué pueden hacer los agentes, qué políticas se aplican y si sus servicios de cara a los agentes están en buen estado.

Why use this protocol?
HTML explica una página a un navegador, pero rara vez explica las capacidades comerciales, el consentimiento, la confianza, los límites o los eventos a un agente autónomo.
How does ADK-Rust use AWP?
adk-awp carga el contexto empresarial, genera manifiestos de capacidad y descubrimiento, y agrega rutas Axum versionadas para límites de tasas, consentimiento, suscripciones a eventos y monitoreo del estado basados en la confianza.
When should I choose AWP?
Utilice AWP cuando los agentes deban poder descubrir y utilizar intencionalmente un sitio web o servicio sin depender únicamente de la interpretación de páginas frágiles.
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

Inicio rápido para desarrolladores

De terminal a agente de trabajo, una decisión a la vez.

Comience con un proyecto Rust pequeño y funcional. Los pasos guiados a continuación explican qué agrega el generador, cómo compilar el proyecto localmente y dónde ampliarlo a medida que crece su producto.

lo que tendrás al final

Un agente Rust compilado con una herramienta tipada, una sesión interactiva Launcher, configuración de telemetría, puntos de integración de sesión y guardarraíl y una respuesta de modelo real en la terminal. El proyecto generado es una fuente Rust normal que puede leer, cambiar y ampliar.

Antes de comenzar

Se requieren dos cosas en su máquina

01

Rust 1.95 o más reciente.
Instale con Rustup o actualice la cadena de herramientas estable.

02

Una llave modelo API.
Este camino utiliza GOOGLE_API_KEY; Se puede seleccionar otro proveedor más tarde.

01

Instalar el generador de proyectos ADK

cargo-adk agrega los comandos cargo adk utilizados para crear, inspeccionar, construir e implementar proyectos de agentes.

cargo install cargo-adk
02

Crea un agente inicial útil

Comience con un agente que pueda llamar a herramientas Rust escritas. Agregue observabilidad, estado de sesión y ganchos de barandilla mientras se genera el proyecto.

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

Añade tu credencial de modelo

El ejemplo generado utiliza Gemini de forma predeterminada. Copie el archivo de ejemplo seguro y luego coloque su clave en el archivo .env sin seguimiento.

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

Compila antes de ejecutar

cargo adk build verifica las dependencias generadas, la combinación de funciones, los tipos Rust y el binario de lanzamiento sin implementar nada.

cargo adk build
05

Corre y habla con el agente.

Inicie la consola generada, ingrese un mensaje y observe el mismo runtime tipado que luego puede impulsar un API, un flujo de trabajo o un producto en tiempo real.

cargo run
agente de soporte - zsh

Instalar una vez

$ cargo install cargo-adk

Generar el proyecto

$ cargo adk new support-agent \
+  --template tools \
+  --addon telemetry \
+  --addon sessions \
+  --addon guardrails
creado support-agent/
├── Cargo.toml dependencias + indicadores de características
├── src/main.rs agente + herramienta tipada
├── .env.ejemplo configuración requerida
└── LÉAME.md instrucciones específicas del proyecto

Configurar el modelo

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

Verificar, luego ejecutar

$ cargo adk build
  cargo run
Ejecución real v2 · llamada a herramienta tipada
  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.
✓ proyecto compilado · tiempo de ejecución listo · verificación local completa

entender el andamio

Vea cómo se ensambla el comando.

La plantilla proporciona la forma del agente de trabajo. Cada complemento aporta las características de caja requeridas, las importaciones, la configuración y un lugar explícito para finalizar la integración.

Plantilla

--template herramientas

Genera un agente LLM con una función #[tool] escrita y el cableado de esquema necesario para las llamadas a herramientas de modelo.

Add-on

--addon telemetria

Habilita la integración de OpenTelemetry para poder rastrear el trabajo del modelo, la herramienta y el tiempo de ejecución.

Add-on

--addon sesiones

Agrega cableado de servicio de sesión para que el estado de la conversación pueda sobrevivir más allá de una llamada de modelo.

Add-on

--addon barandillas

Agrega la función y enlaces claros para la validación de entradas, comprobaciones de salida y filtrado de contenido.

Elige una forma inicial diferente

Doce puntos de partida prácticos para arquitecturas de agentes comunes.

Elija la forma que coincida con la primera pieza de trabajo útil. Las plantillas generan fuente Rust editable, dependencias, configuración del proveedor y un punto de entrada ejecutable.

Abra el inicio rápido completo
llmPlantilla de agente

Comience con un agente de razonamiento.

Genera un LlmAgentBuilder, configuración del modelo Gemini, instrucciones, Launcher respaldado por sesión y un terminal interactivo.

Elige esto cuando

Elíjalo para asistentes, extracción, clasificación o un bucle enfocado de modelo y herramientas.

Punto de partida generado

Un agente LLM · consola transmitida · configuración del proveedor

cargo adk new my-agent --template llm
toolsPlantilla de agente

Proporcione a un agente acciones escritas Rust.

Agrega src/tools.rs con una función #[tool] funcional, argumentos escritos, generación de esquemas JSON y registro en el agente LLM.

Elige esto cuando

Elíjalo cuando el agente necesite calcular, recuperar datos, llamar a la lógica empresarial o realizar una acción.

Punto de partida generado

LlmAgent · Herramienta de bienvenida · serde · esquemars · adk-tool

cargo adk new my-agent --template tools
ragPlantilla de agente

Respuesta a partir de documentos y conocimientos indexados.

Crea una canalización RAG con fragmentación de documentos, incrustaciones de Gemini, un almacén de vectores en memoria, un documento de muestra y RagTool.

Elige esto cuando

Elíjalo para documentación de productos, políticas, colecciones de investigaciones o respuestas basadas en material privado.

Punto de partida generado

RagPipeline · fragmentador · incrustaciones · búsqueda vectorial · RagTool

cargo adk new my-agent --template rag
apiPlantilla de agente

Exponer un agente a través de un servicio HTTP.

Genera un servidor Axum con puntos finales de salud, creación de sesiones y ejecución transmitida alrededor de un agente LLM.

Elige esto cuando

Elíjalo cuando una aplicación web, un cliente móvil, un servicio backend o una plataforma de automatización llamen al agente.

Punto de partida generado

Axum · Rutas REST · Respuestas SSE · sesiones en memoria

cargo adk new my-agent --template api
a2aAlias de patrón

Implemente un agente como especialista remoto.

Resuelve el patrón de servidor a2a y combina un agente LLM con capacidades de servidor y sesión para acceso de agente a agente.

Elige esto cuando

Elíjalo cuando otro agente deba descubrir y llamar a este agente a través de un límite de implementación o propiedad.

Punto de partida generado

Servidor A2A · identidad del agente · manejo de tareas · sesiones

cargo adk new my-agent --template a2a
graphPlantilla de agente

Prepare un flujo de trabajo ramificado y duradero.

Habilita la capacidad de gráficos y crea las importaciones y el punto de inicio del agente para nodos, bordes, puntos de control, interrupción y reanudación.

Elige esto cuando

Elíjalo para trabajos de larga duración con sucursales, pasos de aprobación, recuperación o estado de ejecución duradero.

Punto de partida generado

Característica gráfica · agente de flujo de trabajo · punto de partida de topología

cargo adk new my-agent --template graph
realtimePlantilla de agente

Prepare un agente de voz o video en vivo.

Permite soporte en tiempo real y crea un punto de partida conciso para el agente de voz con importaciones en tiempo real y configuración de proveedores.

Elige esto cuando

Elíjalo para conversaciones naturales, interrupciones, traducción en vivo, herramientas de audio o cuadros de video entrantes.

Punto de partida generado

Función en tiempo real · instrucciones de voz · punto de partida del transporte

cargo adk new my-agent --template realtime
sequentialPlantilla de flujo de trabajo

Pasar el trabajo a través de agentes en un orden fijo.

Genera agentes investigadores y escritores dentro de un SequentialAgent para que cada etapa reciba el trabajo producido por la etapa anterior.

Elige esto cuando

Elíjalo cuando el proceso tenga fases claras como recopilar, analizar, redactar, revisar y publicar.

Punto de partida generado

Dos agentes LLM · ejecución ordenada · rastro de invocación compartido

cargo adk new my-agent --template sequential
parallelPlantilla de flujo de trabajo

Ejecute especialistas independientes al mismo tiempo.

Genera dos agentes especializados dentro de un ParallelAgent y reúne su trabajo a través de un flujo de trabajo principal.

Elige esto cuando

Elíjalo cuando varias investigaciones puedan comenzar a partir de la misma entrada y completarse de forma independiente.

Punto de partida generado

Dos agentes LLM · ejecución simultánea · resultados agregados

cargo adk new my-agent --template parallel
loopPlantilla de flujo de trabajo

Repita un ciclo de refinamiento limitado.

Crea un trabajador dentro de LoopAgent con una señal de finalización explícita y un límite de seguridad de cinco iteraciones.

Elige esto cuando

Elíjalo para procesos de redacción, crítica, reparación, validación o búsqueda que mejoren mediante pasadas repetidas.

Punto de partida generado

Constructor LoopAgent · agente trabajador · instrucción de finalización · iteraciones máximas

cargo adk new my-agent --template loop
conditionalPlantilla de flujo de trabajo

Dirija cada solicitud al especialista adecuado.

Genera agentes técnicos y generales dentro de un ConditionalAgent que selecciona una ruta a partir de la solicitud entrante.

Elige esto cuando

Elíjalo cuando las categorías de trabajo necesiten diferentes instrucciones, herramientas, modelos o especialistas en el dominio.

Punto de partida generado

ConditionalAgent · dos rutas · Selección basada en LLM

cargo adk new my-agent --template conditional
customPlantilla de agente

Implementar el contrato de Agente directamente.

Crea un tipo MyAgent con los métodos de rasgo del Agente y una función de ejecución lista para su propia lógica de ejecución Rust y flujo de eventos.

Elige esto cuando

Elíjalo para orquestación determinista, máquinas de estado existentes, tiempos de ejecución de dominio o comportamiento que necesita control total de Rust.

Punto de partida generado

Esqueleto de rasgo del agente · InvocationContext · Punto de entrada EventStream

cargo adk new my-agent --template custom

El registro CLI también incluye la información específica del proveedor. openai plantilla, cinco patrones empresariales, el basic y a2a alias y complementos de capacidad componibles.

cargo adk templatescargo adk addons

Compila lo que necesitas

Empiece poco a poco. Añade el sistema cuando el producto lo solicite.

Primero elija una plantilla para la forma de ejecución del proyecto. Luego seleccione un nivel de característica para las capacidades compiladas en el binario.

Los niveles de funciones controlan las dependencias, el tiempo de compilación, la superficie binaria y el marco API disponible. Las bases de datos persistentes, MCP, los administradores de secretos en la nube y los transportes específicos en tiempo real siguen siendo opciones explícitas.

01 · Empieza aquí

mínimo

Agentes · Gemini · Runner · sesiones

Un agente enfocado con la superficie de incumplimiento más pequeña.

02 · construir un producto

estándar

Herramientas · memoria · gráfico · servidor · autenticación · evaluación · telemetría

La mayoría de los API, sistemas de flujo de trabajo y productos de agentes internos.

03 · Ampliar el sistema

empresa

Base en tiempo real · navegador · RAG · pagos · AWP

Productos que necesitan una interacción e interoperabilidad más ricas.

04 · Superficie especializada

lleno

Audio · ejecución de código · sandbox

Opte por las capacidades locales y de ejecución más completas.

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

Construir con ADK-Rust

Cree un agente funcional, comprenda su tiempo de ejecución y hágalo crecer con confianza.

Su primer hito útil es una solicitud, una llamada de herramienta visible y una sesión que comprenda. El inicio rápido guiado construye ese camino. A partir de ahí, agregue los flujos de trabajo, el estado, los protocolos y los controles operativos que requiere su producto.