For the complete documentation index, see llms.txt. This page is also available as Markdown.

Adicionar instrução para o agente inteligente

O módulo Adicionar Instrução para o Agente Inteligente entrega uma informação pronta para o assistente de inteligência artificial que está conduzindo um atendimento no Hyperflow Conversas — como se o próprio assistente tivesse acabado de consultar essa informação. Com isso, o fluxo pode fazer um trabalho (como consultar um sistema, calcular um valor ou buscar um dado) e "entregar" o resultado ao assistente, que vai usar essa informação para responder o cliente.

Este módulo só funciona dentro de um atendimento no Hyperflow Conversas que já esteja sendo conduzido por um assistente de inteligência artificial (o módulo Agente, operando dentro do Hyperflow Conversas). Fora desse contexto, o módulo não faz nada.

🧭 Como acessar

  1. No menu lateral, clique em Gerenciamento de aplicativos.

  2. Em seguida, clique em Fluxos.

  3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.

  4. No painel de módulos, localize a categoria Atendimento (identificada pela cor laranja).

  5. Arraste o módulo Adicionar Instrução para o Agente Inteligente para a área de trabalho do fluxo.

🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

🏷️ Nome da ferramenta

Digite um nome que identifique a informação que está sendo entregue ao assistente (por exemplo: consultar_status_pedido). Esse nome é só um rótulo interno usado no histórico da conversa — não precisa corresponder a nenhuma ferramenta cadastrada em outro lugar.

🧾 Conteúdo

Escreva, em formato JSON, a informação que será entregue ao assistente. Você pode usar variáveis do fluxo para montar esse conteúdo dinamicamente.

Exemplo:

🔀 Saída do módulo

O módulo tem uma única saída, controlada pela opção Continuar automaticamente. Se essa opção estiver desativada, o módulo não terá nenhuma saída conectável, e o fluxo será interrompido nesse ponto.

💡 Caso de uso

Cenário: um cliente pergunta sobre o status do pedido, e a empresa quer que o assistente de IA responda usando um dado buscado em um sistema próprio, sem que o assistente precise "decidir" consultar nada por conta própria.

Configuração:

1

Consultar o status do pedido

No fluxo, consulte o status do pedido usando um módulo de integração (como Requisição HTTP ou Consulta em banco de dados).

2

Adicionar o módulo

Adicione o módulo Adicionar Instrução para o Agente Inteligente, com o Nome da ferramenta consultar_status_pedido.

3

Montar o JSON

No campo Conteúdo, monte o JSON com o resultado da consulta, usando as variáveis retornadas na etapa anterior.

4

Conectar a saída

Conecte a saída de volta para o atendimento no Hyperflow Conversas.

Resultado: o assistente de IA já recebe a informação pronta e responde ao cliente considerando esse dado, sem precisar realizar nenhuma consulta adicional por conta própria.

📌 Dicas úteis

  • Use este módulo quando quiser controlar exatamente qual informação o assistente de IA vai considerar em sua próxima resposta.

  • Sempre preencha o campo Conteúdo com um JSON válido, para garantir que a informação chegue ao assistente da forma esperada.

  • Como não há uma saída de erro, teste o fluxo em um ambiente controlado para confirmar que a informação está sendo entregue corretamente ao assistente.

  • Lembre-se de que o módulo só tem efeito dentro de um atendimento já em andamento com um assistente de IA — fora desse contexto, ele não faz nada.

📝 Resumo

  • O módulo Adicionar Instrução para o Agente Inteligente entrega uma informação pronta ao assistente de IA que está conduzindo um atendimento no Hyperflow Conversas.

  • Os campos de configuração são Nome da ferramenta (um rótulo) e Conteúdo (um JSON com a informação a ser entregue).

  • Só funciona dentro de um atendimento já sendo conduzido por um assistente de inteligência artificial.

  • Não possui saída de erro — recomenda-se testar o fluxo para confirmar o funcionamento esperado.