ACP agentes de codificação
Agent Client Protocol conecta uma interface de codificação a um agente de codificação. A interface pode ser um editor, aplicativo de desktop, CLI, ou outro agente ADK-Rust. O agente de codificação é um processo separado que raciocina sobre um projeto e relata seu trabalho por meio de uma sessão compartilhada.
ADK-Rust implementa ambos os lados da versão 1 estável do protocolo ACP:
- usar um agente de codificação externo ACP a partir de um aplicativo ADK-Rust;
- expor um agente ADK-Rust como um processo ACP que um editor pode iniciar.
A implementação usa o Rust agent-client-protocol oficial SDK. A versão do crate SDK
e a versão wire ACP são separadas: ADK-Rust atualmente usa SDK
1.2 enquanto negocia a versão do protocolo 1 durante initialize.
Leia esta seção
- Arquitetura e conceitos explica os dois papéis e o fluxo completo de requisição.
- Crie um cliente ou host ACP cobre delegação única, sessões persistentes, streaming, cancelamento, permissões, arquivos, terminais e servidores MCP de sessão.
- Expor um agente ADK-Rust ACP cobre construção do servidor, mapeamento do ciclo de vida, streaming de eventos, persistência de sessão e implantação.
- Testes e matriz de suporte lista o comportamento verificado e os recursos que ADK-Rust deliberadamente não anuncia.
Qual protocolo devo usar?
| Limite | Use-o para |
|---|---|
| ACP | Uma interface de codificação interativa que მუშაობa com um agente de codificação dentro de uma sessão do projeto |
| A2A | Agentes de negócios implantados de forma independente trocando tarefas remotas e artefatos |
| MCP | Ferramentas, prompts e recursos disponibilizados por trás de um agente |
ACP pode carregar a configuração do servidor MCP quando uma sessão de codificação é aberta. Isso não torna ACP e MCP intercambiáveis: ACP é o dono da conversa do agente de codificação; MCP fornece ferramentas e recursos usados durante essa conversa.
Exemplos
| Exemplo | O que ele comprova |
|---|---|
examples/acp_client_host | UI do cliente transmitida em fluxo, permissões assíncronas e um sistema de arquivos somente leitura delimitado ao workspace |
examples/acp_kiro | Delegação direta, um agente ACP como uma ferramenta ADK, sessões persistentes, configuração de ambiente e cancelamento concorrente |
examples/acp_server | Um agente ADK-Rust LLM que usa ferramentas, exposto aos editores por meio de ACP v1 |
examples/acp_full_protocol | Referência em processo, sem chave API, com suporte de Runner que exercita toda a superfície do servidor da Fase 2 (recurso incorporado + prompts de imagem/áudio, ponte de permissões, reprodução de session/load, atualizações de uso/chamadas de ferramenta) com um teste de validação |
Anterior: ← Benchmarking | Próximo: Retry & Reflect →