ADK-Rust

ADK-Rust Documentação oficial

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

Primeiros passos

Núcleo

  • Tipos principais - Tipos fundamentais: Content, Part, trait Agent, trait Tool, contextos
  • Executor - Runtime e configuração de execução de agentes
  • Plugins - Hooks de ciclo de vida para interceptação de ferramentas/modelos e middleware

Modelos

Agentes

Agente de codificação

Um agente de programação nativo: leia/edite/execute código em um espaço de trabalho isolado, modo de objetivos autônomos e fluxos de trabalho de ultra-revisão paralela.

  • Visão geral - Comece aqui: as peças, a instalação e um início rápido de 60 segundos
  • Ferramentas de desenvolvimento - adk-devtools: read/write/edit/glob/grep/bash + o Workspace isolado
  • Harness - CodingAgent (o recurso coding), o loop de planejamento, write_todos
  • CLI - adk-rust code / goal (durável, retomável) / ultracode
  • Fluxos de trabalho - Ultra-revisão em adk-graph: revisores paralelos + agregação
  • Exemplos - Os três crates de exemplo executáveis

Tempo real e multimodal

Um guia dedicado e acessível para iniciantes sobre como criar agentes de voz + multimodais — arquitetura, conceitos e exemplos executáveis.

  • Visão geral - Comece aqui: o modelo mental, a instalação e um início rápido de 60 segundos
  • Arquitetura - As quatro camadas, o loop de eventos, o pipeline de áudio e o ciclo de vida dos turnos
  • Provedores - Modelos OpenAI Realtime e Gemini Live, vozes e como escolher
  • Ferramentas - Ações no lado do servidor: handlers nativos, adk_core::Tools integrados, chamadas paralelas
  • Multimodal - Entrada de vídeo via send_video_frame e captura da câmera do navegador
  • Diálogo afetivo - Respostas sensíveis às emoções no áudio nativo do Gemini
  • Memória - Injeção de contexto, armazenamento de turnos e autocuradoria do grafo de conhecimento
  • Criação de aplicativos Web - A ponte no lado do servidor, o protocolo WS e o Web Audio
  • Exemplos - Os quatro exemplos executáveis e um caminho de aprendizagem sugerido

Ferramentas

Protocolo de cliente de agente

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

  • Arquitetura e conceitos - Funções de cliente/host e agente de programação, sessões, capacidades e fluxo do protocolo
  • Cliente e host ACP - Delegação, sessões persistentes, streaming, cancelamento, permissões, arquivos, terminais e MCP
  • Servidor de agentes ACP - Exponha o Runner, as ferramentas, as sessões e os eventos em tempo real por meio de stdio
  • Matriz de testes e suporte - Interoperabilidade verificada e recursos deliberadamente não anunciados

Sessões e estado

Memória

Memória de longo prazo que sobrevive a uma sessão — a contraparte persistente do estado da sessão. Um guia dedicado e acessível para iniciantes sobre o armazenamento semântico e o grafo de conhecimento bitemporal.

  • 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, pesquisa, escopo do projeto e apagamento conforme o GDPR
  • Backends - Os seis armazenamentos (InMemory, SQLite, Postgres+pgvector, Redis, MongoDB, Neo4j) e como escolher
  • Grafo de conhecimento - GraphMemoryService: entidades, observações, relações e por que a dimensão bitemporal é importante
  • Ferramentas e agentes - Conectando a memória aos agentes; remember/relate e as ferramentas de memória

Callbacks e eventos

  • Callbacks - Interceptação e personalização do comportamento do agente
  • Eventos - Compreensão do sistema de eventos e do histórico da conversa

Artefatos

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

Observabilidade

  • Telemetria - Registro, rastreamento e monitoramento

Implantação

Avaliação

Agentes gerenciados

Segurança

  • Controle de acesso - Permissões baseadas em funções e registro de auditoria
  • Barreiras de proteção - Redação de informações de identificação pessoal, filtragem de conteúdo e validação de esquema
  • Memória - Memória semântica de longo prazo para agentes
  • Pagamentos e comércio - Jornadas de comércio agêntico, suporte a protocolos e caminhos de validação

Conformidade

  • Implantações somente no Vertex - Garantia de que não haja tráfego do Gemini Studio (generativelanguage.googleapis.com) para cargas de trabalho de HIPAA e residência de dados

Studio

  • Studio ADK - Ambiente de desenvolvimento visual para criar agentes
  • Nós de ação - Nós programáticos não-LLM para fluxos de trabalho de automação
  • Gatilhos - Gatilhos de webhook, agendamento e eventos para fluxos de trabalho

Desenvolvimento

Status da validação

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