Conecta-seEntrar na plataforma

A2A

Interagir com agentes externos compatíveis com o protocolo A2A.

Lógica e processamentoAPIs e operações técnicasConexão: Credencial protegida

O que faz

Use o protocolo A2A (Agent-to-Agent) para chamar agentes de IA externos. Envie mensagens, acompanhe ou cancele tarefas e descubra o que um agente sabe fazer pelo Agent Card dele. Compatível com qualquer agente que siga o padrão A2A.

Quando usar: Use quando o seu fluxo precisar interagir com agentes externos compatíveis com o protocolo A2A.

Exemplo de situação: Automatizar uma operação técnica sem executar o trabalho manualmente.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione A2A ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Enviar mensagemEnvia mensagem com o bloco A2A.
Obter tarefaObtém tarefa com o bloco A2A.
Cancelar tarefaCancela tarefa com o bloco A2A.
Buscar Agent CardBusca Agent Card com o bloco A2A.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Enviar mensagem · Obter tarefa · Cancelar tarefa · Buscar Agent Card
    Padrão:
    Enviar mensagem

  • URL do agente

    Obrigatório

    URL do endpoint A2A.

    Exemplo:
    https://api.exemplo.com/v1/recurso

  • Mensagem

    Obrigatório conforme a operação

    Mensagem a enviar ao agente.

    Aparece em:
    Enviar mensagem
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Dados

    Dados estruturados opcionais a incluir na mensagem.

    Aparece em:
    Enviar mensagem
    Exemplo:
    { "chave": "valor" }

  • Arquivos

    Arquivos opcionais a incluir na mensagem.

    Aparece em:
    Enviar mensagem
    Exemplo:
    (selecione um arquivo de teste)

  • Arquivos

    Em campos adicionais

    Arquivos opcionais a incluir na mensagem.

    Aparece em:
    Enviar mensagem

  • ID do contexto

    Em campos adicionais

    ID do contexto para dar continuidade à conversa.

    Aparece em:
    Enviar mensagem
    Exemplo:
    id-do-recurso

  • ID da tarefa

    Obrigatório conforme a operação

    Tarefa a continuar, consultar ou cancelar.

    Aparece em:
    Enviar mensagem, Obter tarefa, Cancelar tarefa
    Exemplo:
    id-do-recurso

  • Tamanho do histórico

    Número de mensagens do histórico a incluir na resposta.

    Aparece em:
    Obter tarefa
    Exemplo:
    Número de mensagens a incluir

  • Chave de API

    Dado protegido

    Enviada no cabeçalho X-API-Key para agentes que exigem autenticação.

    Padrão:
    Segredo protegido

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <a2a.content>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<a2a.content>stringTexto da resposta do agente.
<a2a.taskId>stringIdentificador da tarefa.
<a2a.contextId>stringIdentificador da conversa/contexto.
<a2a.state>stringEstado da tarefa no ciclo de vida.
<a2a.artifacts>arrayArtefatos estruturados gerados pela tarefa.
<a2a.canceled>booleanIndica se a tarefa foi cancelada.
<a2a.name>stringNome de exibição do agente.
<a2a.description>stringDescrição do agente.
<a2a.url>stringURL do endpoint do agente.
<a2a.version>stringVersão do próprio agente.
<a2a.protocolVersion>stringVersão do protocolo A2A.
<a2a.capabilities>jsonIndicadores de capacidades do agente.
<a2a.skills>arrayHabilidades do agente.
<a2a.defaultInputModes>arrayTipos de mídia de entrada padrão.
<a2a.defaultOutputModes>arrayTipos de mídia de saída padrão.

Exemplo de uso

Objetivo: Automatizar uma operação técnica sem executar o trabalho manualmente.

InícioA2Apróxima etapa
Operação
Enviar mensagem
URL do agente
https://api.exemplo.com/v1/recurso
Mensagem
Olá! Sua solicitação foi processada com sucesso.
Dados
{ "chave": "valor" }
Arquivos
(selecione um arquivo de teste)
ID da tarefa
id-do-recurso

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <a2a.content>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.

Blocos relacionados