# Release 17/12/25 As principais funcionalidades, estão destacadas com ⭐️ ## Hyperflow Integrações **Integrações - Novo módulo 'Tools'.** * São blocos de funcionalidade externa que estendem as capacidades do seu Agente de IA. Elas permitem que o modelo de linguagem: 1. Reconheça a Intenção: Identifique, a partir da entrada em linguagem natural do usuário, que precisa de uma funcionalidade específica (ex: verificar o clima, enviar um e-mail, buscar em um banco de dados). 2. Determine Parâmetros: Gere o JSON de entrada com os parâmetros necessários para executar essa funcionalidade. 3. Execução Externa: Entregue esse JSON ao seu fluxo para executar a ação. 4. Processamento do Resultado: Receba o resultado da execução externa e o utilize para formular uma resposta final coerente ao usuário. 5. Deve ser utilizado com o add-on de 'Assistente inteligente' da Hyperflow. 1. A contratação é feita em: [Integracoes ](https://integracoes.hyperflow.global/)→ Cobranças e Assinaturas → Visualizar detalhes de consumo e contratar a nova funcionalidade em Add-Ons disponíveis. * Os campos presentes no módulo de 'Tools' é: * Nome da ferramenta: * Um identificador único para esta ferramenta. Use apenas letras minúsculas, números e sublinhados. Espaços e caracteres especiais são removidos automaticamente. * Exemplos de nome: * `get_weather, send_email, search_database;` * Descrição: * É crucial. A descrição é o texto que o modelo de IA lê para decidir quando e como usar a ferramenta. * Parâmetros (JSONSchema): * Define a estrutura de dados (JSON) que o modelo de IA deve gerar como entrada para sua função externa.

Imagem 1 - Novo módulo disponível.

{% hint style="danger" %} **Observações importantes:** * **Os nomes das ferramentas devem ser descritivos e seguir uma convenção de nomenclatura consistente (ex: snake\_case).** * **A descrição é crucial—os assistentes de IA a usam para decidir quando chamar sua ferramenta.** * **Use o gerador de IA para criar rapidamente definições de JSON Schema a partir de descrições em linguagem natural.** * **Certifique-se de que seu JSON Schema é válido; schemas inválidos impedirão o registro da ferramenta.** * **Inclua o array "required" para especificar quais parâmetros são obrigatórios.** {% endhint %} **Integrações - Módulo Instagram** * Adicionamos o m**ódulo do** [**Instagram**](https://help.hyperflow.global/docs/builder-de-chatbots/gatilho/instagram), permitindo iniciar fluxos automáticos a partir de interações dos usuários em **Stories, Posts, Reels e Lives**. Agora é possível: * Acionar fluxos automaticamente quando usuários **respondem Stories**, **comentam em Posts/Reels** ou **interagem em Lives** * Definir **palavras-chave** para iniciar automações e **palavras restritas** para bloquear acionamentos indevidos * Configurar automações para **conteúdos específicos** ou para **qualquer publicação** * Utilizar **Respostas Rápidas** em comentários de Posts e Reels para direcionar usuários ao privado ou à próxima etapa do fluxo * Gerenciar todas as automações do Instagram em uma **tela centralizada**, com edição feita diretamente no fluxo vinculado * Essa funcionalidade amplia as possibilidades de **automação de atendimento, qualificação de leads e conversão**, diretamente a partir do engajamento no Instagram.

Imagem 2 - Ao selecionar canal do Instagram. podemos usar ações acima listadas.

**Integrações - Módulo 'Google Gemini'** * Agora é possível utilizar o [**Google Gemini**](https://help.hyperflow.global/docs/builder-de-chatbots/gatilho/google-gemini) **com Busca de Arquivos (RAG)** nos fluxos de automação.\ O recurso permite que o Gemini consulte **documentos e pastas configuradas** antes de gerar respostas, entregando resultados mais **precisos, contextualizados e baseados em conteúdo próprio**. A funcionalidade inclui: * Integração direta com o **Google Gemini;** * Ativação da **Busca de Arquivos (RAG)** por nó; * Seleção de **pastas e documentos específicos** para consulta; * Opções avançadas de controle de resposta, como **tokens máximos** e **temperatura;** * Essa novidade amplia o uso de IA nos fluxos, permitindo respostas fundamentadas em arquivos internos e regras do negócio. **Integrações - Geral** * Nesta atualização, também foram feitas correções menores e otimizações visando manter a plataforma Hyperflow Builder sempre atualizada, segura, e o mais robusta possível. ## Hyperflow **Conversas** **Conversas - Novo modelo de assistente inteligente** * Nesta atualização, lançamos uma nova feature de assistentes inteligentes. * Após a contratação do add-on, acesse o [conversas](https://conversas.hyperflow.global), navegue até a aba **Agentes de IA** e clique em **Novo modelo de assistente** para iniciar a configuração.

Imagem 2 - Botão 'Novo modelo de assistente'.

* Na tela de criação, preencha os campos obrigatórios, selecione o modelo desejado (há múltiplas opções do **Gemini** e do **ChatGPT**) e, em seguida, informe o **prompt** que definirá o comportamento do assistente.

Imagem 3 - Criação do assistente inteligente.

{% hint style="info" %} **Observações importantes:** * **As configurações acima foram básicas, simples e objetivas.** * **Após a inserção do assistente, é possível editar alguns pontos como:** * **Tamanho que as mensagens serão divididas** * **Delay de mensagens** * **Temperatura** * **Tom de voz do assistente** * **Alteração do modelo usado** * **Alteração da versão do modelo também.** {% endhint %} **Conversas - Novo filtro do 'Histórico de chats'** * Nesta atualização, aprimoramos o filtro do histórico de chats, tornando as consultas mais precisas, rápidas e eficientes.

Imagem 4 - Novo filtro

* Ao clicar no filtro, uma modal será aberta exibindo as opções de segmentação: **Gerais**, **Departamento**, **Agentes** e **Contatos**.

Imagem 5 - Opções de filtragem geral, por agentes, departamentos ou contatos específicos

{% hint style="info" %} * Observações importantes sobre o uso dos filtros: * A busca específica por **contatos** estará disponível apenas dentro do filtro. A busca externa permanece funcionando por proximidade às palavras digitadas, quando realizada pelo nome do contato. * Ao selecionar filtros de forma combinada, será necessário clicar em **Aplicar** para efetivar a busca. * Após aplicar os filtros e preencher os campos corretamente, será possível remover filtros individualmente, mantendo os demais ativos. {% endhint %}

Imagem 6 – Exemplo de pesquisa por contatos específicos e remoção individual dos filtros aplicados.

**Conversas - Geral** * Nesta atualização, também foram feitas correções menores e otimizações visando manter a plataforma Hyperflow Desk sempre atualizada, segura, e o mais robusta possível. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.hyperflow.global/docs/novidades-release-notes/release-17-12-25.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.