Artigos

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.

Por Equipe Wortic 7 min de leitura

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?

  1. Leia a introdução e a visão geral, para entender initialize, session/new e session/prompt antes de qualquer código.
  2. Confira no registro do ACP quais agentes e clientes já estão listados.
  3. Escolha um editor compatível e um agente compatível para um teste local, com o agente rodando como subprocesso e falando por stdio.
  4. 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

Conheça: Use a Wortic dentro do Claude e do ChatGPT.

Quer isso funcionando na sua empresa?

Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.

Falar com um consultor

Equipe editorial

Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.

  • Automacao com IA
  • Gestao empresarial
  • CRM
  • ERP
  • Marketing digital

Isso funcionando no seu negócio.

Um consultor mostra o sistema do seu ramo, com a IA dentro.