Agent Client Protocol: a ponte entre editor de código e agente
Agent Client Protocol (ACP) padroniza a conversa entre editores de código e agentes de programação, local ou remoto. Veja como funciona e quem mantém o projeto.

O Agent Client Protocol, ou ACP, padroniza a comunicação entre editores de código e IDEs e os agentes de programação. Segundo a documentação oficial, em agentclientprotocol.com, o protocolo serve tanto para agentes que rodam na própria máquina quanto para agentes hospedados na nuvem ou em outra infraestrutura. A ideia central é que um agente que fala ACP funcione em qualquer editor compatível.
Este texto mostra por que o protocolo lembra o Language Server Protocol, como é o fluxo de um turno de conversa, quem mantém o projeto e como uma equipe começa. No fim, há uma distinção importante: nos endereços da Wortic, a sigla ACP aparece com outro sentido.
Quem mantém o Agent Client Protocol?
O repositório fica na organização agentclientprotocol, no GitHub, e informa a licença Apache-2.0. O texto de contribuição do repositório diz que o que for enviado ao projeto segue a mesma licença, a Apache License versão 2.0. O site oficial traz a Zed Industries e a JetBrains entre os seus links, ao lado do repositório.
Esse dado de governança ajuda a decidir se a equipe vai depender do protocolo. Vale ler o repositório antes de depender de uma parte específica dele.
Por que o ACP lembra o Language Server Protocol?
A introdução compara o ACP ao Language Server Protocol, que padronizou a integração entre editores e servidores de linguagem. A lógica é parecida: o editor fica do lado do usuário, e o agente pode ser trocado sem reescrever a integração do editor. A documentação afirma que essa separação permite que os dois lados evoluam de forma independente.
Para uma equipe, a consequência é prática. O editor continua o mesmo, e a escolha do agente pode mudar conforme a tarefa.
Como a conversa roda, local ou na nuvem?
No caso local, o agente roda como subprocesso do editor e troca mensagens em JSON-RPC pela entrada e saída padrão, o stdio. No caso remoto, o agente roda em outra infraestrutura e a conversa passa por HTTP ou WebSocket. A visão geral do protocolo segue o JSON-RPC 2.0 e distingue dois tipos de mensagem: métodos, que esperam resposta, e notificações, que são de mão única.
A versão atual do protocolo, segundo o menu da documentação, é a versão 1 do ACP. Quem for implementar deve checar essa versão antes de escolher bibliotecas, porque ela define os métodos disponíveis.
Quais métodos o agente precisa oferecer?
A visão geral do protocolo lista como métodos de base initialize, authenticate e session/new. O primeiro negocia a versão e troca capacidades entre cliente e agente. O segundo autentica o cliente com o agente quando isso é exigido. O terceiro cria uma nova sessão de conversa.
Cada método é um pedido que espera um resultado ou um erro. As notificações são mensagens de mão única, que não recebem resposta. A distinção importa para quem implementa, porque nem toda mensagem pode ficar sem retorno.
O fluxo de conversa usa também o session/prompt, que envia a mensagem do usuário, e o session/load, que retoma uma sessão existente quando o agente oferece esse recurso. A forma exata de cada mensagem está na página de visão geral da documentação, e este texto não a reproduz.
Qual é o fluxo de um turno de conversa?
A documentação descreve três fases. Primeiro, o cliente chama initialize para negociar a versão e trocar capacidades, e autentica se for preciso. Depois, cria uma sessão com session/new, ou retoma uma sessão existente com session/load, quando o agente suporta isso. Por fim, o cliente envia o pedido do usuário com session/prompt.
O pedido leva um identificador de sessão e uma lista de blocos de conteúdo, e cada bloco tem um tipo, como texto. O agente encerra o turno com um motivo de parada, e o caso mais comum é end_turn, que indica que a resposta terminou. O agente também pode parar o turno antes, retornando o motivo correspondente.
Qual problema o ACP resolve numa equipe?
Uma equipe de desenvolvimento costuma usar mais de um editor e, com o tempo, quer testar agentes diferentes. Sem um protocolo comum, cada troca de agente exige uma integração nova com o editor. Com o ACP, a troca de agente deixa de exigir essa integração nova, e o time pode testar um agente sem refazer a parte que já funciona.
O ganho aparece no tempo de experimento. Uma equipe que quer comparar dois agentes na mesma tarefa troca o agente e mantém o editor. Esse benefício depende de o editor e o agente implementarem o protocolo.
Como uma equipe começa com o ACP?
- Leia a introdução e a visão geral, para entender initialize, session/new e session/prompt antes de qualquer código.
- Confira no registro do ACP quais agentes e clientes já estão listados.
- Escolha um editor compatível e um agente compatível para um teste local, com o agente rodando como subprocesso e falando por stdio.
- Se o agente precisar rodar na nuvem, use o transporte remoto que o editor e o agente suportarem.
A licença Apache-2.0 vale para o código do projeto. Antes de levar algo para produção, leia também a licença do agente escolhido, porque ela pode ser outra.
Quando o ACP faz sentido para a equipe?
O ACP faz mais sentido quando o trabalho da equipe acontece no editor e ela quer ter agentes diversos à disposição. A introdução parte dessa premissa: o usuário fica principalmente no editor e quer chamar agentes a partir dele.
Quando o problema é outro, como agentes trocando tarefas entre sistemas, o assunto passa para outro protocolo. Nesse caso, o A2A, descrito na especificação oficial, é o ponto de partida.
A sigla ACP aparece em outro sentido na Wortic?
Sim, e a distinção vale a pena. O cartão de agentes da Wortic, em app.wortic.com/.well-known/agent-card.json, declara um checkout pelo ACP e um feed de produtos, com versão de API 2026-04-17. Nesse uso, ACP é outra especificação, voltada para compras, e não se confunde com o Agent Client Protocol deste texto.
Nos endereços oficiais da Wortic conferidos para este texto, o Agent Client Protocol não aparece. Por isso, o texto não apresenta a Wortic como usuária dele. O que a Wortic publica para agentes, nos endereços lidos, é um cartão A2A e um perfil UCP de checkout, e os artigos sobre o assunto estão na newsroom da Wortic.
Perguntas frequentes
O ACP é o mesmo protocolo de checkout que aparece no cartão da Wortic?
Não. O cartão da Wortic usa a sigla ACP para checkout e feed de produtos, com outra especificação. O Agent Client Protocol trata da comunicação entre um editor de código e um agente de programação.
O ACP serve para agentes conversarem entre si?
Não é esse o seu foco. O ACP cuida da conversa entre editor e agente. A troca de tarefas entre agentes é o caso do A2A, descrito na especificação oficial desse protocolo.
Qual é a licença do ACP?
O repositório oficial está sob Apache-2.0, e as contribuições seguem a mesma licença. A licença do agente que você escolher pode ser outra e precisa ser lida antes do uso.
Fontes
Quer isso funcionando na sua empresa?
Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.
Falar com um consultorEquipe editorial
Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.
- Automacao com IA
- Gestao empresarial
- CRM
- ERP
- Marketing digital
