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.
🧭 Como acessar
No menu lateral, clique em Gerenciamento de aplicativos.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
No painel de módulos, localize a categoria Atendimento (identificada pela cor laranja).
Arraste o módulo Adicionar Instrução para o Agente Inteligente para a área de trabalho do fluxo.
Antes de usar este módulo: é necessário ter uma conta do Hyperflow Conversas conectada a este aplicativo, com pelo menos um Assistente Inteligente já criado e ativo, e o atendimento precisa já estar sendo conduzido por ele.
O Assistente Inteligente é criado e configurado diretamente no Hyperflow Conversas, em Configurações > Agentes de IA > Assistente Inteligente. Depois de criar e ativar o assistente, volte para a área de trabalho do fluxo para continuar configurando este módulo.
🔍 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:
Preencha sempre este campo com um JSON válido. Se o conteúdo não for um JSON válido, ele é enviado ao assistente de uma forma diferente da esperada, o que pode confundir a resposta gerada.
🔀 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.
Este módulo não possui uma saída de erro. Se não for possível entregar a informação ao assistente (por exemplo, se o atendimento não estiver mais sendo conduzido por um assistente de IA), o fluxo segue normalmente sem nenhum aviso. Teste o fluxo para confirmar que a informação está chegando como esperado.
💡 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:
No fluxo, consulte o status do pedido usando um módulo de integração (como Requisição HTTP ou Consulta em banco de dados).
Adicione o módulo Adicionar Instrução para o Agente Inteligente, com o Nome da ferramenta
consultar_status_pedido.No campo Conteúdo, monte o JSON com o resultado da consulta, usando as variáveis retornadas na etapa anterior.
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.
Last updated
Was this helpful?