ADK-Rust

ADK-Rust Documentação Oficial

Bem-vindo à documentação oficial do ADK-Rust (Agent Development Kit for Rust). Esta documentação fornece guias e referências completos para criar agentes de IA usando a implementação em Rust do framework ADK.

Primeiros Passos

  • Introdução - Visão geral de ADK-Rust, sua arquitetura e conceitos-chave
  • Quickstart - Crie seu primeiro agente em menos de 10 minutos
  • A2UI Quickstart - Emita JSONL de A2UI e renderize-o em React
  • Migrando 1.0 → 2.0 - Lista completa de mudanças incompatíveis com código antes/depois

Núcleo

  • Tipos Centrais - Tipos fundamentais: Content, Part, trait Agent, trait Tool, contextos
  • Runner - Runtime e configuração de execução do agente
  • Plugins - Ganchos de ciclo de vida para interceptação de ferramentas/modelos e middleware

Modelos

Agentes

Agente de Codificação

Um agente de codificação nativo: ler/editar/executar código em um workspace isolado, modo autônomo de metas e fluxos de trabalho paralelos de ultra-review.

  • Visão Geral - Comece aqui: as partes, a instalação e um quick start de 60 segundos
  • Ferramentas de Dev - adk-devtools: read/write/edit/glob/grep/bash + o Workspace isolado
  • Harness - CodingAgent (o recurso coding), o loop de plano, write_todos
  • CLI - adk-rust code / goal (durável, retomável) / ultracode
  • Fluxos de Trabalho - Ultra-review em adk-graph: revisores paralelos + fan-in
  • Exemplos - Os três crates de exemplo executáveis

Tempo Real e Multimodal

Um guia dedicado, amigável para iniciantes, para construir agentes de voz + multimodais — arquitetura, conceitos e exemplos executáveis.

  • Visão Geral - Comece aqui: o modelo mental, a instalação e um quick start de 60 segundos
  • Arquitetura - As quatro camadas, o loop de eventos, o pipeline de áudio e o ciclo de vida da interação
  • Provedores - Modelos Realtime e Gemini Live de OpenAI, vozes e como escolher
  • Ferramentas - Ações do lado do servidor: handlers nativos, adk_core::Tools conectadas, chamadas paralelas
  • Multimodal - Entrada de vídeo via send_video_frame e captura de câmera do navegador
  • Diálogo Afetivo - Respostas cientes de emoção no áudio nativo do Gemini
  • Memória - Injeção de contexto, armazenamento de interações e autocuradoria de grafo de conhecimento
  • Construindo Aplicativos Web - A ponte do lado do servidor, o protocolo WS e o Web Audio
  • Exemplos - Os quatro exemplos executáveis e um caminho de aprendizado sugerido

Ferramentas

Protocolo de Cliente do Agente

Use um agente de codificação externo de ADK-Rust, ou exponha um agente ADK-Rust para um editor por meio de ACP v1 estável.

Sessões e Estado

Memória

Memória de longo prazo que sobrevive a uma sessão — o equivalente persistente do estado da sessão. Um guia dedicado, amigável para iniciantes, tanto para o armazenamento semântico quanto para o grafo de conhecimento bi-temporal.

  • Visão geral - Comece aqui: os dois tipos de memória, o modelo mental, a instalação e um início rápido
  • Conceitos - MemoryEntry, o trait MemoryService, busca, escopo de projeto, exclusão por GDPR
  • Backends - Os seis stores (InMemory, SQLite, Postgres+pgvector, Redis, MongoDB, Neo4j) e como escolher
  • Grafo de Conhecimento - GraphMemoryService: entidades, observações, relações e por que o bi-temporal importa
  • Ferramentas & Agentes - Integrando memória em agentes; remember/relate e as ferramentas de memória

Callbacks & Eventos

  • Callbacks - Intercepte e personalize o comportamento do agente
  • Eventos - Entendendo o sistema de eventos e o histórico da conversa

Artefatos

  • Artefatos - Armazenamento e recuperação de dados binários

Observabilidade

Implantação

Avaliação

Agentes Gerenciados

Segurança

  • Controle de Acesso - Permissões baseadas em função e registro de auditoria
  • Guardrails - Redação de PII, filtragem de conteúdo, validação de schema
  • Memória - Memória semântica de longo prazo para agentes
  • Pagamentos e Comércio - Jornadas de comércio agentic, suporte a protocolo e caminhos de validação

Studio

  • ADK Studio - Ambiente de desenvolvimento visual para construir agentes
  • Nós de Ação - Nós programáticos não-LLM para fluxos de automação
  • Triggers - Triggers de webhook, agendamento e evento para fluxos de trabalho

Desenvolvimento

Status de Validação

Os comandos Cargo de copiar e colar e os trechos de dependências no README e na documentação oficial são validados por scripts/check-doc-examples.sh. A CI também verifica scaffolds do cargo-adk com scripts/check-cargo-adk-templates.sh, rejeita nomes duplicados de targets de exemplo com scripts/check-example-name-collisions.sh e compila exemplos do workspace com cargo check --workspace --examples.