ADK-Rust 2.0

A estrutura Rust paraalto desempenho, pronto para produçãoAgentes de IA.

ADK-Rust reúne agentes tipados, ferramentas, estado durável, mídia em tempo real e protocolos abertos em um tempo de execução assíncrono — para que você possa passar de um agente focado para um sistema que pode operar com confiança.

Comece com a unidade de trabalho

O que é um agente de IA em termos de ADK-Rust?

Um agente é um componente assíncrono Rust. Ele recebe um contexto de invocação, executa trabalhos com modelos ou ferramentas e emite eventos tipados à medida que avança. Agentes LLM, fluxos de trabalho, agentes em tempo real, agentes de codificação e agentes Rust personalizados usam esse contrato compartilhado.

O que torna ADK-Rust atraente é que o agente continua sendo parte de um sistema de software que você pode compreender e controlar. Chamadas de modelo, entradas de ferramentas, alterações de estado, aprovações e eventos transmitidos têm contratos Rust explícitos. O mesmo tempo de execução pode oferecer suporte a um assistente focado, um fluxo de trabalho multiagente durável, uma experiência de voz em tempo real ou um agente que trabalha em vários serviços, preservando ao mesmo tempo o desempenho, a simultaneidade, a portabilidade e a disciplina operacional que as equipes Rust esperam.

Se você conhece LangGraph, Google ADK, OpenAI Agents SDK ou CrewAI, reconhecerá ferramentas, transferências, fluxos de trabalho, memória, proteções e rastreamento. ADK-Rust traz essas ideias para um tempo de execução nativo do Rust e as conecta com mídia em tempo real, execução de código, RAG, artefatos e protocolos abertos como MCP, A2A, ACP e AWP. A versão 2 expande essa base com agentes gráficos, em tempo real, codificação e CodeAct; esquemas de ferramentas com reconhecimento de provedor; modelos de projeto combináveis e compilação de carga adk; controles de estado e operacionais mais fortes; e uma trilha de eventos tipada consistente desde a primeira chamada de modelo até a produção.

Arquitetura de tempo de execução ADK-Rust v2As superfícies do produto enviam solicitações para o ADK Runner. O executor coordena formas de agentes, provedores de modelos, ferramentas, serviços de estado, protocolos abertos e controles de produção por meio de eventos tipados.ADK-Rust v2 — uma solicitação, todo o sistemaLaranja sólido: execução · cinza tracejado: eventos, resultados, currículo · limite roxo: protocolos abertosSUPERFÍCIES DO PRODUTOWeb e dispositivos móveisClientes UI/APIVoz e vídeoClientes em tempo realOutros agentesA2A/ACP/AWPCLI e empregoscarga-adk / cronTEMPO DE EXECUÇÃO DO ADKRunnersessão · contexto de invocação · cancelamento · retornos de chamada · fluxo de eventosESCOLHA O AGENTE QUE O TRABALHO NECESSITAAgente LLMrazão + ferramentasFluxo de trabalhosequência/paralelo/loopGráficoponto de verificação + HITLCodeActescrever + executar códigoTempo realvoz + vídeoPersonalizadoimplementar agenteFluxo de eventos tipadostexto do modelo · chamadas de ferramentas · progresso · deltas de estado · artefatos · transferências · errosCAPACIDADES EM TORNO DO AGENTEProvedores de modelosGemini · OpenAI · AnthropicOllama · Bedrock · Azure AIFerramentas e especialistas#[tool] · skills · browserMCP · ACP · code sandboxEstado e conhecimentosessions · memory · RAGartifacts · graph checkpointsMídia e interfacesaudio · video · A2UIREST · SSE · WebSocketProtocolos de agenteA2A · AWPdiscovery · task contractsComércio · evoluindoACP commerce · AP2 alphadurable transaction journalscorrerligarresultadoemitir EventoPROTOCOLO E LIMITE DE IMPLANTAÇÃOREST/SSEA2AACPAWPMCPWebSocketOs protocolos adaptam o tempo de execução nos limites do sistema; eles não o substituem.Autenticação · autorização de ferramenta · guarda-corpos · sandbox · plugins · telemetria · avaliação · nova tentativa/cancelamentoPRODUTOS ACOMPANHANTESStudio · UI · Playground · Plataforma empresarial

Como ler a arquitetura

Siga o diagrama da esquerda para a direita. Uma superfície de produto envia uma solicitação para Runner. O Runner anexa o estado da sessão e o contexto de invocação e, em seguida, chama o agente selecionado. Modelos, ferramentas e estado apoiam o trabalho enquanto eventos tipados trazem progresso e resultados.

Dentro do tempo de execução

Runner, agentes, eventos tipados, loops de modelo/ferramenta, sessões, retornos de chamada, transferências e cancelamento.

Na fronteira

MCP, A2A, ACP, AWP, HTTP, SSE e transportes em tempo real conectam sistemas separados e zonas de confiança.

Fora da estrutura

Studio, UI, Playground e o plano de controle consomem ADK-Rust; eles não funcionam dentro do Runner.

Superfície da estrutura

Os recursos por trás da arquitetura.

ADK-Rust reúne todo o ciclo de vida do agente em uma única estrutura: compor o comportamento do agente, fornecer ferramentas, preservar o contexto, conectá-lo a outros sistemas e operá-lo com segurança na produção. Os grupos abaixo mostram como essas capacidades se encaixam.

Construir LLM, fluxo de trabalho, gráfico, tempo real e agentes de codificação; equipá-los com ferramentas tipadas, MCP, RAG, memória, sessões e artefatos; conecte-os por meio de REST, A2A, ACP e AWP; em seguida, adicione autorização, proteções, telemetria e avaliação para produção.

Compor

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

Agir

Agir capability

#[tool]

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

Lembre-se

Lembre-se 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.

Veja como funciona

Mostre o trabalho enquanto ele está acontecendo.

O Runner resolve a sessão, cria o contexto de invocação, executa o agente, transmite o modelo e o trabalho da ferramenta, aplica mudanças de estado, persiste eventos duráveis e retorna o progresso ao chamador conforme ele acontece.

Essa mesma trilha pode alimentar um terminal, uma UI web, um cliente API, avaliação ou uma conversa em tempo real.

Siga um pedido real

Um cliente pergunta: “Por que meu pagamento falhou?” O Runner abre a sessão correta, transmite a saída do modelo e a atividade da ferramenta, registra alterações de estado e retorna cada evento útil para a interface. O usuário vê o progresso enquanto o operador obtém um registro completo da execução.

Uma invocação por meio de ADK-RustUma solicitação carrega uma sessão, entra no executor, percorre o modelo e o trabalho da ferramenta, emite eventos tipados e persiste o estado e os artefatos antes que a resposta retorne.Siga uma solicitação durante o tempo de execuçãoNada desaparece em uma caixa preta: cada estágio produz estados ou eventos tipados.SolicitaçãoConteúdo + identidadeCarregar sessãohistória + estadoRunnercontexto + ciclo de vidaAgentedecidir o próximo passoModeloresposta de fluxoFerramentaagir no sistemaEventosIU/servidorPersista na trilhaeventos de sessão · deltas de estado · memória · artefatos · pontos de verificação de gráfico · rastreamentos de avaliação

Componha o comportamento

Quando o trabalho crescer, divida o trabalho sem perder o fio da meada.

Estude padrões multiagentes

Um roteador identifica o trabalho que deve ser feito. Os especialistas lidam com as partes que entendem melhor. Fluxos de trabalho sequenciais e paralelos controlam a ordem de execução, enquanto os pontos de verificação gráfica mantêm evidências, aprovações e progresso anexados ao mesmo trabalho.

Fluxo de trabalho avançado de operações de clientes multiagentes ADK-RustUm incidente de acesso do cliente é roteado para agentes paralelos de conta, pagamento e plataforma. Eles usam sistemas MCP e A2A, gravam evidências em estado de ponto de verificação compartilhado e convergem em um gráfico supervisor com caminhos de repetição, aprovação, ação e auditoria.Resolva um incidente real do cliente sem perder o controleCaso de uso: “Pagamento bem-sucedido, mas o espaço de trabalho de nossa equipe ainda está bloqueado.”O fluxo de trabalho deve estabelecer os fatos, escolher uma solução segura, solicitar aprovação para ações consequentes e deixar um rastro de evidências.ClienteWeb · voz · APIRoteador de triagemLlmConditionalAgentClassificar · definir urgência · escolher especialistassolicitaçãoINVESTIGAÇÃO PARALELA · ParallelAgentAgente de contaIdentidade + direitoLê o cliente, a equipe e o estado de acessoAgente de pagamentoFaturamento + transaçãoReconcilia cobrança, fatura e planoAgente de plataformaTempo de execução + provisionamentoVerifica bloqueios, trabalhos e integridade do serviçoespalharLIMITES DO SISTEMACRM + identidadeRecursos/ferramentas MCPERP + pagamentosMCP + diário de comércioServiço de provisionamentoAgente remoto A2AEstado do incidente compartilhado + ponto de verificação do gráficocustomer_id · evidência de pagamento · estado de direito · integridade da plataforma · confiança · ação propostaTodo especialista escreve provas tipadas; novas tentativas e interrupções humanas são retomadas a partir do mesmo ponto de verificação.GRÁFICO DO SUPERVISORSintetizar evidênciasGraphAgentCompare fatos · marque confiançaProvas suficientes?Borda condicionalpreparar / investigarInvestigue novamenteLoopAgent + reflexãoTente novamente apenas o branch ausentePortão de aprovaçãoInterrupção do gráficoO desbloqueio/reembolso precisa de uma pessoaAja em ordemSequentialAgentfaltandoretomar especialista selecionadoprontoFluxo de resultadosespaço de trabalho restaurado · resposta do cliente · artefato de evidência · evento de sessão · registro de auditoria · rastreamento de telemetria · amostra de avaliaçãoAutenticação · RBAC · confirmação de ferramenta · grades de proteção · cancelamento · sandbox · telemetria · avaliação cercam toda a invocação
O gráfico não pede a um agente que improvise tudo. O roteamento restringe o problema, os especialistas investigam simultaneamente, o estado compartilhado mantém suas evidências coerentes e as ações consequentes permanecem atrás de um limite de aprovação explícito.

LlmAgent

Raciocínio focado

Um modelo, instruções, ferramentas, retornos de chamada e saída transmitida — o pequeno e útil centro da maioria dos sistemas.

Sequential · Parallel · Loop

Trabalho determinístico

Expresse ordem, simultaneidade, repetição e condições de saída diretamente no programa Rust.

GraphAgent

Orquestração durável

Ramificação, ponto de verificação, interrupção para uma pessoa e retomada após o andamento do processo ou conversa.

CodingAgent · CodeActAgent

Software como ação

Deixe um agente inspecionar, editar e executar código dentro de um espaço de trabalho e limite de sandbox que você controla.

RealtimeAgent

Conversa ao vivo

Transporte áudio, transcrições, quadros de vídeo, interrupções e ferramentas do lado do servidor em uma sessão ao vivo.

CustomAgent

Sua própria lógica de tempo de execução

Implemente o contrato do Agente para comportamento específico do produto escrito diretamente em Rust.

O sistema em torno do agente

O modelo é uma parte do produto.

Agentes úteis precisam de ferramentas, estado, interfaces, limites e evidências. ADK-Rust expõe cada peça por meio de interfaces Rust combináveis ​​que você possui.

Um produto, várias responsabilidades

Em um produto de suporte ao cliente, o modelo elabora a resposta, as ferramentas inspecionam o pedido, a sessão transporta o contexto do cliente, a autorização controla os reembolsos, um artefato armazena o recibo e a telemetria registra o resultado. Cada responsabilidade permanece visível no tempo de execução.

Uma arquitetura completa de produto de agente ADK-RustAs interfaces entram em um tempo de execução ADK-Rust que coordena a lógica do agente, um adaptador de modelo substituível, ferramentas, serviços de estado e de conhecimento. Os eventos tipados produzem progresso visível, artefatos, ações, registros de auditoria e evidências de avaliação sob controles compartilhados.Um produto agente útil é um sistema completoO modelo pode mudar. Os contratos, estado, ferramentas, controles e evidências permanecem seus.PESSOAS E INTERFACESAplicativo webbate-papo · formulários · artefatosVoz e vídeosessão de mídia ao vivoAPI e eventosREST · SSE · WebSocketOutros agentesA2A · ACP · AWPTEMPO DE EXECUÇÃO ADK-RUSTRunner + fluxo de evento tipadosessão · contexto · ciclo de vida · cancelamentoLógica do agenterazão · rotaFluxo de trabalhográfico · HITLModelo/loop de ferramentaligar · observar · aprovar · tentar novamente · continuarMODELO · UM ADAPTADOR SUBSTITUÍVELProvedorhospedado / localEsquemaprovider-awareFERRAMENTAS E SISTEMAS EXTERNOSFerramentas Rust#[tool]MCPferramentas · recursosNavegadorações da webEspecialistasACP · A2AESTADO, CONHECIMENTO E TRABALHO DURÁVELSessãoMemóriaRAGArtefatosPontos de verificaçãoO QUE O PRODUTO PODE MOSTRARProgresso ao vivotokens · status da ferramenta · áudioArtefatos úteisarquivos · relatórios · mídia · UIAções aprovadasescreve · pagamentos · transferênciasContinuidade durávelsessões · memória · currículoEvidênciaeventos · auditoria · telemetriaSinais de qualidadeavaliação · custo · latênciaeventos tipados retornam para todas as interfacesAutenticação · identidade · autorização de ferramenta · aprovação · guarda-corpos · sandbox · cancelamento · telemetria · avaliação
O modelo fornece inteligência dentro de um produto completo: interfaces que as pessoas podem usar, ferramentas que podem agir, estado que sobrevive, controles que restringem o risco e evidências que explicam o que aconteceu.
Modelos

Mude o modelo sem redesenhar o agente.

Modelos de fronteira hospedados, modelos de roteamento rápido, Ollama local e inferência nativa de mistral.rs estão por trás de um contrato Llm comum.

Gemini · OpenAI · Anthropic · OpenRouter · DeepSeek · Groq · Ollama · Bedrock · Azure AI · endpoints compatíveis

Ferramentas

As ferramentas usam contratos explícitos e inspecionáveis.

Transforme uma função Rust tipada, servidor MCP, habilidade, sessão de navegador, agente de codificação ou processo em área restrita em um recurso que o tempo de execução pode inspecionar e chamar.

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

Estado

Mantenha a conversa – e o trabalho que ela produziu.

As sessões contêm o histórico de eventos. A memória recupera conhecimento útil. Artefatos preservam arquivos. Os pontos de verificação do gráfico tornam o trabalho longo retomável.

SQLite · PostgreSQL · Redis · MongoDB · Firestore · Neo4j · sessões criptografadas

Tempo real

Um agente ao vivo é mais do que um terminal de fala.

ADK-Rust mantém áudio, transcrições, quadros de vídeo, chamadas de ferramentas, interrupções e alterações de contexto dentro de uma sessão de propriedade de Rust.

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

Conhecimento

Traga a recuperação para a mesma trilha de execução.

Agrupe documentos, incorpore-os, pesquise armazenamentos de vetores, reclassifique resultados e isole a memória por projeto antes que o modelo responda.

Pipelines RAG · memória semântica · gráfico de conhecimento · cinco implementações de armazenamento de vetores

Controle

Coloque a aprovação onde a ação acontece.

Autorização, retornos de chamada, proteções, perfis de sandbox, cancelamento, telemetria e avaliação formam o limite de execução da produção.

RBAC · OAuth/OIDC · confirmação de ferramenta · guarda-corpos PII · OpenTelemetry · avaliação

Escolha o limite

Use o protocolo que corresponda à distância.

Comece com onde o recurso é executado.

Mantenha os subagentes dentro de um tempo de execução ADK-Rust quando eles compartilham implantação, estado e confiança. Introduza um protocolo quando o recurso, o agente, o espaço de trabalho de codificação ou o site tiver uma implantação, um processo, uma propriedade ou um limite de confiança próprio.

Mesmo processo Rust

Agente, subagente ou ferramenta

Ferramentas ou recursos externos

MCP

Agente implantado de forma independente

A2A

Processo de codificação ou IDE

ACP

Site legível pelo agente

AWP

MCP

Protocolo de Contexto do Modelo

Dê a um agente recursos que residam em outro lugar.

What is MCP?

Uma maneira padrão de um servidor externo publicar ferramentas que um agente pode chamar e recursos que ele pode ler.

Why use this protocol?
Você evita escrever um adaptador personalizado para cada banco de dados, produto SaaS, sistema de arquivos ou fonte de conhecimento — e o mesmo servidor pode atender mais de um agente.
How does ADK-Rust use MCP?
McpToolset conecta o servidor ao contrato de ferramenta do ADK-Rust. O tempo de execução descobre seus esquemas, normaliza-os para o provedor de modelo selecionado e pode ler recursos MCP ou gerenciar processos locais do servidor MCP.
When should I choose MCP?
Use MCP quando o recurso pertence a um processo separado, já possui um servidor MCP ou deve ser compartilhado entre vários agentes e aplicativos.
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 agente para agente

Deixe que agentes implantados de forma independente trabalhem juntos.

What is A2A?

Um protocolo de rede para descobrir um agente remoto, enviar-lhe trabalho, acompanhar o progresso e receber resultados através de um limite HTTP.

Why use this protocol?
Um especialista pode manter seu próprio modelo, ferramentas, estado, ciclo de lançamento, implantação e limite de segurança.
How does ADK-Rust use A2A?
ADK-Rust pode expor um agente por meio de seu servidor A2A v1 e operações de tarefa. Um coordenador pode então tratar esse serviço remoto como um especialista, enquanto os eventos transmitidos preservam o andamento do trabalho.
When should I choose A2A?
Use A2A quando o agente for implementado, dimensionado, de propriedade ou protegido separadamente. Mantenha os subagentes comuns em processo quando nenhum desses limites existir.
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 Agente Cliente

Delegue o trabalho de software a um agente de codificação real.

What is ACP?

Um protocolo que padroniza sessões entre agentes de codificação e os clientes que os hospedam, incluindo editores, CLIs e sistemas de orquestração.

Why use this protocol?
O trabalho de codificação precisa de contexto de espaço de trabalho, progresso de streaming, cancelamento e decisões de permissão durante toda a sessão.
How does ADK-Rust use ACP?
AcpAgentTool e AcpToolset permitem que um agente ADK-Rust inicie ou se conecte a um processo ACP, estabeleça uma sessão, transmita seu trabalho e retorne o resultado como uma chamada de ferramenta. O lado do servidor opcional pode expor um agente ADK-Rust a clientes ACP.
When should I choose ACP?
Use ACP para exploração de repositório, implementação, refatoração, teste ou qualquer tarefa delegada que deva acontecer dentro de um espaço de trabalho de desenvolvimento 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

Torne um site compreensível antes que um agente o limpe.

What is AWP?

Um protocolo da web por meio do qual um site publica quem é, o que os agentes podem fazer, quais políticas se aplicam e se seus serviços voltados para os agentes estão íntegros.

Why use this protocol?
O HTML explica uma página para um navegador, mas raramente explica capacidades de negócios, consentimento, confiança, limites ou eventos para um agente autônomo.
How does ADK-Rust use AWP?
adk-awp carrega o contexto de negócios, gera manifestos de descoberta e capacidade e adiciona rotas Axum versionadas para limites de taxa com reconhecimento de confiança, consentimento, assinaturas de eventos e monitoramento de integridade.
When should I choose AWP?
Use AWP quando um site ou serviço for intencionalmente detectável e utilizável por agentes, sem depender apenas da interpretação de páginas frágeis.
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

Início rápido do desenvolvedor

De um terminal a um agente de trabalho, uma decisão de cada vez.

Comece com um projeto Rust pequeno e funcional. As etapas guiadas abaixo explicam o que o gerador adiciona, como compilar o projeto localmente e onde estendê-lo à medida que seu produto cresce.

O que você terá no final

Um agente Rust compilado com uma ferramenta tipada, uma sessão Launcher interativa, configuração de telemetria, pontos de integração de sessão e guardrail e uma resposta real do modelo no terminal. O projeto gerado é uma fonte Rust comum que você pode ler, alterar e estender.

Antes de começar

Duas coisas são necessárias em sua máquina

01

Rust 1.95 ou mais recente.
Instale com ferrugem ou atualize o conjunto de ferramentas estável.

02

Uma chave modelo API.
Este caminho usa GOOGLE_API_KEY; outro provedor pode ser selecionado posteriormente.

01

Instale o gerador de projeto ADK

cargo-adk adiciona os comandos cargo adk usados para criar, inspecionar, construir e implantar projetos de agentes.

cargo install cargo-adk
02

Crie um agente inicial útil

Comece com um agente que possa chamar ferramentas Rust tipadas. Adicione observabilidade, estado de sessão e ganchos de proteção enquanto o projeto é gerado.

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

Adicione sua credencial de modelo

O exemplo gerado usa Gemini por padrão. Copie o arquivo de exemplo seguro e coloque sua chave no arquivo .env não rastreado.

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

Compile antes de executar

cargo adk build verifica as dependências geradas, combinação de recursos, tipos Rust e lançamento binário sem implantar nada.

cargo adk build
05

Corra e fale com o agente

Inicie o console gerado, insira uma mensagem e observe o mesmo tempo de execução tipado que pode posteriormente alimentar um API, fluxo de trabalho ou produto em tempo real.

cargo run
agente de suporte - zsh

Instale uma vez

$ cargo install cargo-adk

Gerar o projeto

$ cargo adk new support-agent \
+  --template tools \
+  --addon telemetry \
+  --addon sessions \
+  --addon guardrails
criado support-agent/
├── Cargo.toml dependências + sinalizadores de recursos
├── src/main.rs agente + ferramenta tipada
├── .env.exemplo configuração necessária
└── README.md instruções específicas do projeto

Configurar o modelo

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

Verifique e execute

$ cargo adk build
  cargo run
Execução real da v2 · chamada de ferramenta 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.
✓ projeto compilado · tempo de execução pronto · verificação local concluída

Entenda o andaime

Veja como o comando é montado.

O modelo fornece a forma do agente de trabalho. Cada complemento contribui com os recursos de caixa necessários, importações, configuração e um local explícito para finalizar a integração.

Modelo

--template ferramentas

Gera um agente LLM com uma função #[tool] tipada e a conexão de esquema necessária para chamadas de ferramenta de modelo.

Add-on

--addon telemetria

Permite a integração do OpenTelemetry para que o trabalho do modelo, da ferramenta e do tempo de execução possa ser rastreado.

Add-on

--addon sessões

Adiciona conexão de serviço de sessão para que o estado da conversa possa sobreviver além de uma chamada de modelo.

Add-on

--addon guarda-corpos

Adiciona o recurso e limpa ganchos para validação de entrada, verificações de saída e filtragem de conteúdo.

Escolha uma forma inicial diferente

Doze pontos de partida práticos para arquiteturas de agentes comuns.

Escolha a forma que corresponda ao primeiro trabalho útil. Os modelos geram fonte Rust editável, dependências, configuração de provedor e um ponto de entrada executável.

Abra o início rápido completo
llmModelo de agente

Comece com um agente de raciocínio.

Gera um LlmAgentBuilder, configuração do modelo Gemini, instruções, Launcher com suporte de sessão e um terminal interativo.

Escolha isto quando

Escolha-o para assistentes, extração, classificação ou um loop focado de modelo e ferramenta.

Ponto de partida gerado

Um agente LLM · console transmitido · configuração do provedor

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

Dê a um agente ações tipadas Rust.

Adiciona src/tools.rs com uma função #[tool] funcional, argumentos tipados, geração de esquema JSON e registro no agente LLM.

Escolha isto quando

Escolha-o quando o agente precisar calcular, recuperar dados, chamar a lógica de negócios ou executar uma ação.

Ponto de partida gerado

LlmAgent · Ferramenta de saudação · serde · esquemas · ferramenta adk

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

Resposta a partir de documentos e conhecimentos indexados.

Cria um pipeline RAG com agrupamento de documentos, embeddings Gemini, um armazenamento de vetores na memória, um documento de amostra e RagTool.

Escolha isto quando

Escolha-o para documentação de produtos, políticas, coleções de pesquisas ou respostas baseadas em material privado.

Ponto de partida gerado

RagPipeline · chunker · embeddings · pesquisa vetorial · RagTool

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

Expor um agente por meio de um serviço HTTP.

Gera um servidor Axum com integridade, criação de sessão e endpoints de execução transmitidos em torno de um agente LLM.

Escolha isto quando

Escolha quando um aplicativo web, cliente móvel, serviço de back-end ou plataforma de automação ligará para o agente.

Ponto de partida gerado

Axum · Rotas REST · Respostas SSE · sessões na memória

cargo adk new my-agent --template api
a2aAlias de padrão

Implante um agente como especialista remoto.

Resolve o padrão a2a-server e combina um agente LLM com recursos de servidor e sessão para acesso de agente para agente.

Escolha isto quando

Escolha-o quando outro agente precisar descobrir e chamar esse agente através de um limite de implantação ou propriedade.

Ponto de partida gerado

Servidor A2A · identidade do agente · manipulação de tarefas · sessões

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

Prepare um fluxo de trabalho ramificado e durável.

Ativa o recurso gráfico e cria as importações e o ponto de partida do agente para nós, bordas, pontos de verificação, interrupção e retomada.

Escolha isto quando

Escolha-o para trabalhos de longa duração com ramificações, etapas de aprovação, recuperação ou estado de execução durável.

Ponto de partida gerado

Recurso gráfico · agente de fluxo de trabalho · ponto de partida da topologia

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

Prepare um agente de voz ou vídeo ao vivo.

Permite suporte em tempo real e cria um ponto de partida conciso para o agente de voz com importações em tempo real e configuração do provedor.

Escolha isto quando

Escolha-o para conversa natural, interrupção, tradução ao vivo, ferramentas de áudio ou quadros de vídeo recebidos.

Ponto de partida gerado

Recurso em tempo real · instruções de voz · ponto de partida do transporte

cargo adk new my-agent --template realtime
sequentialModelo de fluxo de trabalho

Passe o trabalho pelos agentes em uma ordem fixa.

Gera agentes pesquisadores e escritores dentro de um SequentialAgent para que cada etapa receba o trabalho produzido pela etapa anterior.

Escolha isto quando

Escolha quando o processo tiver fases claras, como coletar, analisar, redigir, revisar e publicar.

Ponto de partida gerado

Dois agentes LLM · execução ordenada · trilha de invocação compartilhada

cargo adk new my-agent --template sequential
parallelModelo de fluxo de trabalho

Execute especialistas independentes simultaneamente.

Gera dois agentes especialistas dentro de um ParallelAgent e reúne seu trabalho por meio de um fluxo de trabalho pai.

Escolha isto quando

Escolha-o quando várias investigações puderem começar a partir da mesma entrada e serem concluídas de forma independente.

Ponto de partida gerado

Dois agentes LLM · execução simultânea · resultados agregados

cargo adk new my-agent --template parallel
loopModelo de fluxo de trabalho

Repita um ciclo de refinamento limitado.

Cria um trabalhador dentro de LoopAgent com um sinal de conclusão explícito e um limite de segurança de cinco iterações.

Escolha isto quando

Escolha-o para processos de elaboração, crítica, reparo, validação ou pesquisa que melhoram através de passagens repetidas.

Ponto de partida gerado

Construtor LoopAgent · agente de trabalho · instrução de conclusão · máximo de iterações

cargo adk new my-agent --template loop
conditionalModelo de fluxo de trabalho

Encaminhe cada solicitação para o especialista certo.

Gera agentes técnicos e gerais dentro de um ConditionalAgent que seleciona um caminho da solicitação recebida.

Escolha isto quando

Escolha-o quando as categorias de trabalho precisarem de instruções, ferramentas, modelos ou especialistas de domínio diferentes.

Ponto de partida gerado

ConditionalAgent · duas rotas · Seleção baseada em LLM

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

Implemente o contrato do Agente diretamente.

Cria um tipo MyAgent com os métodos de característica do Agente e uma função de execução pronta para sua própria lógica de execução e fluxo de eventos Rust.

Escolha isto quando

Escolha-o para orquestração determinística, máquinas de estado existentes, tempos de execução de domínio ou comportamento que precisa de controle Rust total.

Ponto de partida gerado

Esqueleto de características do agente · InvocationContext · Ponto de entrada do EventStream

cargo adk new my-agent --template custom

O registro CLI também inclui os dados específicos do provedor openai modelo, cinco padrões empresariais, o basic e a2a aliases e complementos de capacidade de composição.

cargo adk templatescargo adk addons

Compile o que você precisa

Comece pequeno. Adicione o sistema quando o produto solicitar.

Primeiro escolha um modelo para a forma de execução do projeto. Em seguida, selecione uma camada de recursos para os recursos compilados no binário.

As camadas de recursos controlam dependências, tempo de compilação, superfície binária e a estrutura APIs disponível. Bancos de dados persistentes, MCP, gerenciadores de segredos de nuvem e transportes específicos em tempo real permanecem escolhas explícitas.

01 · Comece aqui

mínimo

Agentes · Gemini · Runner · sessões

Um agente focado com a menor superfície padrão.

02 · Construa um produto

padrão

Ferramentas · memória · gráfico · servidor · autenticação · avaliação · telemetria

A maioria dos APIs, sistemas de fluxo de trabalho e produtos de agentes internos.

03 · Ampliar o sistema

empresa

Base em tempo real · navegador · RAG · pagamentos · AWP

Produtos que precisam de interação e interoperabilidade mais ricas.

04 · Superfície especializada

cheio

Áudio · execução de código · sandbox

Opte pelos recursos locais e de execução mais pesados.

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

Construir com ADK-Rust

Crie um agente funcional, entenda seu tempo de execução e desenvolva-o com confiança.

Seu primeiro marco útil é uma solicitação, uma chamada de ferramenta visível e uma sessão que você entende. O início rápido guiado cria esse caminho. A partir daí, adicione os fluxos de trabalho, o estado, os protocolos e os controles operacionais que seu produto exige.