🧑💻Assistentes inteligentes - Agentes
Crie e gerencie agentes de IA com funções e conhecimentos específicos.
🧑💻 Assistentes Inteligentes - Agentes
Os Assistentes de Inteligência Artificial permitem criar agentes inteligentes personalizados, capazes de responder usuários, consultar informações internas e executar ações externas de forma automatizada.
📍 Como acessar
No menu lateral esquerdo, clique em Agentes.
Você será direcionado para a tela de gerenciamento dos assistentes.
Nesta tela, ficam listados todos os Assistentes de IA já criados.

🔎 Como localizar um Assistente de IA
Utilize o campo Pesquisar para encontrar um assistente pelo nome.
A lista será filtrada automaticamente conforme o texto digitado.
➕ Como criar um novo Assistente de IA
🎯 Propósito
Cadastrar um novo assistente inteligente para atender conversas de forma automática.
✅ Como fazer na tela
Clique em Novo modelo de assistente.
Na janela que abrir, preencha um prompt com as informações básicas para geração do assistente.
Após isso, configure o modelo e a versão de IA que será usada para gerar as respostas.
Edite as instruções geradas, o nome sugerido, os departamentos onde o assistente vai atuar e se ele estará online ou offline.
Clique em Criar.
📌 Resultado esperado
O assistente é criado e a tela de configuração completa é aberta para ajustes.

🧩 Configuração básica do Assistente
Após criar o assistente, valide e edite as informações principais:
🏷️ Nome do Assistente
Utilize um nome claro para facilitar a identificação do agente na plataforma.
📁 Departamento
Informe um ou mais departamentos nos quais esse agente vai atuar. Se deixar vazio, o assistente atuará em todos os departamentos.
🧾 Status do Assistente
Online
Quando o assistente estiver pronto para atender
Offline
Quando precisar fazer alterações ou testes sem impactar o atendimento

🧠 Modelo de IA
Escolha o modelo de Inteligência Artificial que será utilizado. Estão disponíveis modelos do Gemini, do ChatGPT e os modelos nativos da Hyperflow.
📷 Inserir print: seletor de modelo com os grupos Hyperflow, Gemini e ChatGPT visíveis
🔷 Modelos Hyperflow (recomendados)
Os modelos Hyperflow Pro e Hyperflow Lite são gerenciados diretamente pela Hyperflow e oferecem orquestração inteligente com fallback entre múltiplos provedores: se o modelo principal ficar indisponível, a conversa continua automaticamente em outro — zero atendimentos perdidos.
Hyperflow Pro
Qualidade máxima com fallback multi-provedor
Interações que exigem maior precisão e sofisticação nas respostas
Hyperflow Lite
Alto volume e baixo custo com fallback multi-provedor
Operações com grande quantidade de atendimentos e foco em custo-benefício
Os modelos Hyperflow Pro e Hyperflow Lite não estão disponíveis quando a opção Usar chave própria está ativada. Para utilizá-los, mantenha a chave de API padrão da conta.
✍️ Prompt do Assistente
Informe o prompt com as instruções que definem:
O papel do assistente
Seu comportamento
Tom de voz e forma de resposta
O prompt é o principal responsável pela forma como o Assistente de IA irá se comportar. Quanto mais claro e detalhado, melhores serão as respostas.
⚙️ Configurações avançadas
Após a criação, é possível ajustar configurações adicionais, como:
Estilo de comunicação
Regras de comportamento
Parâmetros de desempenho
Essas configurações podem ser alteradas a qualquer momento.

📚 Base de Conhecimento (Arquivos)
A Base de Conhecimento permite que o Assistente de IA utilize conteúdos da sua empresa — documentos, políticas, FAQs e materiais internos — para responder com mais contexto e precisão.
🎯 Propósito
Dar ao assistente acesso a informações específicas do negócio para que ele responda com base nesses documentos.
✅ Como fazer na tela
Acesse a configuração do assistente desejado.
Vá até a aba Arquivos.
Faça o upload dos arquivos que o assistente deverá consultar.
Após o upload, esses arquivos passam a ser utilizados pelo assistente nas respostas.
📌 Resultado esperado
O assistente consulta o conteúdo dos arquivos ao formular as respostas, tornando-as mais precisas e contextualizadas.

📦 Limites e formatos suportados
Tamanho máximo por arquivo
50 MB
Quantidade máxima de páginas por arquivo
512 páginas
Quantidade máxima de arquivos
10 arquivos
Formatos aceitos: PDF, XLSX, DOCX, CSV, TXT, PPTX, JSON, HTML
🔗 Ferramentas (Tools)
Uma Tool permite que o Assistente de IA execute ações externas, indo além de apenas responder com texto — como consultar sistemas, buscar dados ou acionar integrações.

🔄 Como funciona uma Tool
Quando o usuário faz uma solicitação que exige uma ação externa, o processo acontece assim:
O usuário faz uma pergunta ou solicitação
O Assistente de IA identifica a intenção de executar uma ação externa
A Tool é acionada com base na descrição configurada
O assistente gera automaticamente um conjunto de dados com os parâmetros definidos
O fluxo externo é executado
O resultado retorna para o assistente, que utiliza essa informação para responder ao usuário
🌐 Como criar uma Ferramenta
Você pode criar uma ferramenta de dois lugares:
Opção 1 — Diretamente na configuração do assistente (recomendado)
Dentro da configuração do assistente, acesse a aba Ferramentas.
Clique no ícone + no canto superior da aba.
A janela Criar Ferramenta abrirá. Preencha os campos e clique em Criar Ferramenta.

Opção 2 — Pelo menu MCP Servers no Hyperflow Integrações
Acesse MCP Servers → Ferramentas no menu lateral.
Clique em + Criar Ferramenta no canto superior direito.
Preencha os campos e salve.
Importante: ao criar uma ferramenta, o sistema gera automaticamente um fluxo dedicado a ela no Hyperflow Integrações. Para que a ferramenta funcione, você precisará acessar esse fluxo e configurar a lógica de execução. Para entender como configurar o módulo Tool no fluxo, acesse a documentação do módulo Tool.

➕ Como preencher os campos de uma Ferramenta
Nome da ferramenta
Identificador interno (ex: get_weather, consulta_status). É o nome que a IA usará para chamar a função
Descrição
Explique o que a ferramenta faz e em quais situações a IA deve utilizá-la. Uma boa descrição ajuda o assistente a decidir quando usá-la
Parâmetros
Define a estrutura de dados que a ferramenta espera receber. Você pode preencher manualmente ou usar Gerar com IA para criar a definição a partir de uma descrição simples
🤖 Vinculando Ferramentas e MCPs ao Agente
Para que um assistente utilize as ferramentas criadas, acesse a aba Ferramentas dentro da configuração do agente.


🛠️ Aba Ferramentas
Nesta aba, você escolhe quais habilidades individuais o agente terá permissão para usar.
Selecionado
Ferramentas já ativas para este agente
Disponível
Ferramentas criadas na plataforma ainda não vinculadas a este agente
Busca e Filtro
Localiza ferramentas por nome ou função
Contexto de Parâmetros
Exibe quais dados cada ferramenta exige (ex: categoria, id, periodoDoDia)
🔗 Aba MCPs — Conectando Servidores Externos
Nesta aba, você integra o agente a um servidor que expõe múltiplas funcionalidades de uma só vez.
Label do servidor
Nome interno para identificar a conexão (ex: "API de Logística")
URL do servidor
Endereço do servidor MCP. Suporta transportes SSE ou HTTP
Autenticação
Tipo de autenticação exigida pelo servidor (ex: chave de API, token)
Cabeçalhos personalizados
Headers adicionais caso o servidor exija (ex: api-key, token)
Após preencher, clique em Testar Conexão para garantir que a comunicação está funcionando antes de salvar.

🧪 Playground — Testando o Agente
O Playground simula uma interface de chat real, permitindo que você interaja com o agente para verificar se ele compreende as instruções do prompt e sabe utilizar as ferramentas disponíveis.
✅ Como acessar e usar
Dentro da tela de edição do agente, clique no botão Playground no canto superior direito.
Uma janela lateral abre com o campo "Digite uma mensagem...".
Envie perguntas ou comandos para testar cenários específicos.

🔍 O que validar no Playground
Chamada de Ferramentas:
Verifique se, ao fazer uma pergunta técnica, o agente identifica e aciona a ferramenta correta.
Observe se ele extrai os parâmetros necessários da conversa para executar a ação.
Conexão com MCPs:
Teste se o agente consegue buscar dados de servidores externos configurados.
Se a resposta demorar ou falhar, clique em Testar Conexão na aba MCPs para verificar URL e autenticação.
Comportamento e Tom de Voz:
Valide se as respostas seguem as instruções definidas no prompt e se o agente mantém o contexto da conversa.
💡 Dicas para um teste eficiente
Teste de erro: peça algo que a ferramenta exige mas não forneça o dado — veja se o agente sabe solicitar a informação que falta.
Ajuste fino: se o agente não usar uma ferramenta quando deveria, volte na configuração da ferramenta e melhore a Descrição. A IA decide usar a ferramenta com base no que está escrito lá.
💡 Caso de uso
Cenário: uma empresa de crédito recebe centenas de mensagens por dia com clientes perguntando sobre o status de empréstimos, parcelas em atraso e simulações. A equipe de atendimento não consegue responder tudo com agilidade.
Configuração do assistente:
Criam um assistente chamado "Assistente Financeiro" associado ao departamento Crédito.
No Prompt, definem que o assistente deve responder dúvidas sobre empréstimos com linguagem clara e empática, sem oferecer produtos não solicitados.
Na aba Arquivos, sobem a política de crédito e o FAQ de dúvidas frequentes (PDF, máx. 50 MB).
Cria-se uma Tool chamada
consulta_status_emprestimono Hyperflow Integrações, configurada para buscar o status do contrato em um sistema externo.Vinculam a ferramenta ao assistente na aba Ferramentas.
Testam no Playground pedindo "Qual o status do meu empréstimo?" e verificam se o assistente aciona a ferramenta corretamente e solicita o dado faltante (ex: CPF ou número do contrato).
Resultado: o assistente resolve automaticamente as consultas de status sem intervenção humana. Quando o cliente tem uma solicitação que exige análise manual, o assistente informa e direciona para o atendimento humano.
📝 Resumo
O Assistente Inteligente é um agente de IA que atende conversas automaticamente no Hyperflow Conversas.
Ele é criado via Novo modelo de assistente e configurado com prompt, modelo de IA, departamentos e status.
Os modelos Hyperflow Pro e Hyperflow Lite são os mais recomendados: gerenciados pela Hyperflow, com fallback automático entre provedores e sem necessidade de chave de API própria.
A Base de Conhecimento permite carregar até 3 arquivos (máx. 50 MB cada) para que o assistente responda com base nos documentos da empresa.
Ferramentas (Tools) são criadas no Hyperflow Integrações e vinculadas ao agente para que ele execute ações externas durante a conversa.
Servidores MCP conectam o agente a sistemas externos que expõem múltiplas funcionalidades de uma só vez.
O Playground permite testar o comportamento do agente antes de colocá-lo em produção.
Last updated