ACP — Protocolo de Comunicação entre Agentes
ACP — Protocolo de Comunicação entre Agentes — guia fácil de entender baseado na documentação oficial
Imagine dois colegas de trabalho que falam idiomas diferentes — um usa e-mails, o outro usa bilhetes adesivos. Eles nunca vão conseguir fazer nada a menos que concordem em uma forma comum de passar mensagens. É exatamente isso que o ACP faz pelos agentes de IA.
O que é ACP?
ACP significa Agent Communication Protocol (Protocolo de Comunicação entre Agentes). É um conjunto de regras que permite que dois agentes de IA (ou um agente e uma ferramenta) conversem entre si de forma clara e estruturada — como um tradutor universal para máquinas. Em vez de cada agente adivinhar o que o outro quer dizer, eles seguem uma “linguagem” compartilhada de solicitações e respostas.
Pense nisso como o aperto de mão antes de uma conversa. Um agente diz: “Preciso desses dados”, e o outro responde: “Aqui estão, neste formato exato.” Sem confusão, sem perder contexto.
Por que precisamos disso?
Sem o ACP, cada agente precisaria de código personalizado para entender qualquer outro agente. Isso é como escrever um novo dicionário para cada par de amigos. O ACP resolve isso criando um padrão único que todos podem usar.
Por exemplo, no Hermes Agent, você pode ter:
- Um agente planejador que decide o que fazer.
- Um agente trabalhador que executa a tarefa de fato.
- Um agente de memória que armazena resultados anteriores.
O ACP permite que eles troquem mensagens sem que você precise escrever código de integração para cada par.
Como funciona na prática?
Aqui vai um exemplo simples. Suponha que você peça ao Hermes para “marcar uma reunião e enviar um resumo”. O agente planejador envia uma mensagem ao agente de calendário:
{
"type": "request",
"action": "create_event",
"params": {
"title": "Project Sync",
"time": "2025-05-01T10:00:00Z"
}
}
O agente de calendário responde:
{
"type": "response",
"status": "success",
"data": {
"event_id": "12345"
}
}
Agora o planejador sabe que o evento foi criado. Ele pode então enviar outra mensagem ao agente de e-mail com o ID do evento. Ninguém fica confuso.
Regras principais do ACP
- Toda mensagem tem um tipo –
request(solicitação) ouresponse(resposta). - Toda solicitação tem uma ação – como
create_eventouget_weather. - Toda resposta tem um status –
success(sucesso) ouerror(erro). - Os dados são estruturados – usando JSON, para facilitar a leitura e o processamento.
Só isso. Simples, mas poderoso.
Uma analogia do mundo real
Pense em pedir comida em um restaurante. Você (o usuário) faz o pedido ao garçom (agente planejador). O garçom anota em um ticket (mensagem ACP) e entrega ao chef (agente trabalhador). O chef prepara o prato e coloca no balcão (resposta). O garçom pega e leva até você. Todos conhecem o formato do ticket, então a cozinha funciona sem problemas.
Resumo e dica prática
O ACP é a cola invisível que permite que agentes de IA cooperem sem caos. Tudo se resume a mensagens claras e estruturadas — nada mais, nada menos.
Dica prática: Ao criar seus próprios agentes no Hermes, sempre defina seus tipos de mensagem e ações antes de escrever a lógica. Comece com um modelo JSON simples como o acima e teste com dois agentes primeiro. Quando funcionar, adicione mais. Você vai economizar horas de depuração depois.
Agora vá conversar com seus agentes — eles vão se entender muito bem.
📖 Documentação oficial
この記事は Hermes Agent のDocumentação oficialに基づいています:Documentação oficial › user-guide/features/acp