> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/atendimento/adicionar-instrucao-para-o-agente-inteligente.md). # Adicionar instrução para o agente inteligente ## 🛠️ 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. {% hint style="info" %} Este módulo só funciona dentro de um **atendimento no Hyperflow Conversas** que já esteja sendo conduzido por um **Assistente Inteligente** (o agente de inteligência artificial configurado em Configurações > Agentes de IA > Assistente Inteligente, dentro do Hyperflow Conversas). Fora desse contexto, o módulo não faz nada. {% endhint %} **📷 Inserir print:** visão geral do módulo Adicionar Instrução para o Agente Inteligente na área de trabalho do fluxo *** ### 🧭 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. **📷 Inserir print:** painel de módulos com a categoria Atendimento expandida e o módulo Adicionar Instrução para o Agente Inteligente visível {% hint style="warning" %} **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. {% endhint %} *** ### 🔍 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. **📷 Inserir print:** painel de configuração do módulo Adicionar Instrução para o Agente Inteligente aberto *** #### 🏷️ 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. **📷 Inserir print:** campo Nome da ferramenta preenchido com um exemplo *** #### 🧾 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: ```json {"pedido": "{{input.numeroPedido}}", "status": "entregue"} ``` {% hint style="warning" %} 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. {% endhint %} **📷 Inserir print:** campo Conteúdo preenchido com um exemplo de JSON *** #### 🔀 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. {% hint style="warning" %} 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. {% endhint %} **📷 Inserir print:** módulo com a saída conectada ao próximo módulo *** ### 💡 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. 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. Adicione o módulo **Adicionar Instrução para o Agente Inteligente**, com o **Nome da ferramenta** `consultar_status_pedido`. 3. No campo **Conteúdo**, monte o JSON com o resultado da consulta, usando as variáveis retornadas na etapa anterior. 4. 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.