Agente de IA

Enviar uma mensagem a um agente publicado do workspace e aproveitar sua resposta nas próximas etapas.

Lógica e processamentoInteligência artificialConexão: Agente publicado do workspace

O que faz

Envie dados a um agente publicado do workspace e use a resposta nos próximos blocos.

Quando usar: Use quando o seu fluxo precisar enviar uma mensagem a um agente publicado do workspace e aproveitar sua resposta nas próximas etapas.

Exemplo de situação: Interpretar uma solicitação e produzir uma resposta adequada ao contexto.

Antes de começar

Conexão necessária: Agente publicado do workspace.

Publique o agente em Agentes e escolha-o neste bloco. O teste usa IA real e ferramentas simuladas; pode consumir créditos.

Passo a passo

Adicione Agente de IA ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
Publique o agente em Agentes e escolha-o neste bloco. O teste usa IA real e ferramentas simuladas; pode consumir créditos.
Revise a ação principal descrita no cartão do bloco.
Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
Só publique depois de conferir o resultado da execução de teste.

Campos

Agente do workspace
Obrigatório
Usa as instruções, o modelo e as ferramentas da versão publicada. Edite a configuração na página Agentes.
Exemplo:
(escolha na lista do campo)
Mensagem para o agente
Obrigatório
No teste, a IA responde de verdade, mas suas ferramentas são simuladas. O uso do modelo pode consumir créditos.
Exemplo:
Olá! Sua solicitação foi processada com sucesso.

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 <agentedeia.content>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Referência	Tipo	O que contém
`<agentedeia.content>`	string	Resposta do agente, pronta para usar no próximo bloco.
`<agentedeia.result>`	json	Resultado estruturado retornado pelo agente, quando disponível.
`<agentedeia.agentId>`	string	Agente selecionado.
`<agentedeia.agentName>`	string	Nome do agente selecionado.
`<agentedeia.versionId>`	string	Versão publicada utilizada nesta execução.
`<agentedeia.usage>`	json	Consumo registrado pelo modelo.
`<agentedeia.mode>`	string	Preview no teste; production na execução publicada.

Exemplo de uso

Objetivo: Interpretar uma solicitação e produzir uma resposta adequada ao contexto.

InícioAgente de IApróxima etapa

Agente do workspace: (escolha na lista do campo)
Mensagem para o agente: Olá! Sua solicitação foi processada com sucesso.

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 <agentedeia.content>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.