Hub de IA
A WiiChat lançou seu poderoso recurso de Agentes de IA, tornando mais fácil do que nunca criar chatbots com IA sem a complexidade de lidar manualmente com conclusões de chat e assistentes de IA.
Com os Agentes de IA, os usuários agora podem criar bots avançados e conversacionais com IA que se integram perfeitamente ao OpenAI e a outras plataformas populares de GenAI, executam tarefas de forma independente e oferecem interações dinâmicas e humanizadas com mínimo esforço.
Seja para suporte ao cliente, geração de leads ou automação de fluxos de trabalho, os Agentes de IA da WiiChat removem as barreiras para o desenvolvimento de chatbots com IA, simplificando o processo para empresas e desenvolvedores.
Acessando Agentes de IA e Funções de IA
Dentro do seu bot, clique em “Hub de IA” na barra lateral esquerda para acessar agentes e funções de IA.
Criando um Agente de IA
Clique em “+ Agente de IA” para criar um novo Agente de IA.
Nome e descrição
Nesta seção, informe o nome e a descrição do agente de IA. A descrição deve ser um texto breve que forneça contexto suficiente sobre a função que o Agente de IA irá desempenhar.
Exemplo de descrição: Este agente é responsável por agendar compromissos com os usuários. Primeiro, ele precisa capturar os dados do usuário: nome, sobrenome e e-mail. Em seguida, precisa buscar os horários disponíveis e permitir que o usuário escolha uma opção. Depois que a data e o horário forem escolhidos, o agente deve agendar o compromisso.
Configurações
Nesta seção, você decidirá qual modelo e plataforma deseja usar, além dos parâmetros que modificarão o comportamento do agente criado.
Observação: se o seu caso de uso exigir que o Agente de IA utilize funções, é sempre melhor usar modelos superiores, como gpt-4-turbo-preview, pois eles são mais estáveis e precisos ao usar funções.
A WiiChat atualmente oferece suporte ao OpenAI, Deepseek e Grok AI para criação de agentes. Mais modelos serão adicionados em breve, incluindo Google Gemini e Claude.
Nesta seção, você também pode ajustar parâmetros como temperatura e número de repetições para modificar ainda mais o comportamento do agente.
O recurso “Número de mensagens de chat antes do resumo automático” ajuda a gerenciar conversas longas, condensando automaticamente o histórico após um número definido de mensagens.
Quando a conversa atinge o limite especificado (por exemplo, 10, 50 ou 100 mensagens), o sistema cria um resumo conciso dessas interações e o reinsere no chat como uma única entrada.
Esse processo preserva detalhes importantes enquanto reduz significativamente o uso de caracteres, permitindo um gerenciamento de memória mais eficiente. Ao resumir interações anteriores, a IA mantém o contexto importante sem sobrecarregar o histórico do chat, garantindo interações mais fluidas.
Além disso, os usuários podem personalizar o limite máximo de tokens para os resumos: 500 tokens são suficientes para chats gerais baseados em texto, e 1.000 tokens são recomendados para tarefas complexas, como agendamento de compromissos. Esse recurso melhora o desempenho da IA, a clareza da conversa e a eficiência do engajamento de longo prazo.
Ao final, você também pode selecionar a saída preferida: texto ou JSON.
Modo Avançado do Agente de IA
Quando o Modo Avançado está ativado, o agente de IA não responde diretamente ao usuário. Em vez disso, ele armazena a resposta no campo do sistema “Última resposta do Agente de IA”. Você deve selecionar um fluxo de trabalho para processar e tratar a resposta antes de enviá-la ao usuário.
Principais recursos
Formatação de respostas: modifique respostas da IA dividindo respostas longas em várias seções para melhorar a leitura.
Integração de mídia: adicione arquivos de mídia relevantes (imagens, vídeos ou anexos) para enriquecer as respostas.
Automação de fluxos de trabalho: processe conteúdo gerado por IA por meio de fluxos personalizados para melhorar a entrega e a apresentação das mensagens.
Observação: quando o Modo Avançado está ativado, o recurso Sugestões Automáticas será desativado.
Prompt do agente
Nesta seção, você definirá a persona, ou seja, como deseja que o agente de IA se comporte, bem como o papel que ele deve seguir.
Exemplo de papel: O Agente de Agendamento de Compromissos é responsável por agendar compromissos com os usuários. Ele deve capturar dados como nome, sobrenome e e-mail, buscar horários disponíveis, permitir que o usuário selecione o horário preferido e finalizar o agendamento. O tom deve ser profissional e amigável, garantindo uma experiência fluida e positiva durante todo o processo.
Na seção de habilidades, você deve definir todos os recursos que deseja que o Agente de IA execute, desde coletar dados do usuário até obter horários para agendamento. Também serão indicadas quais funções você precisará configurar para atingir seus objetivos.
Habilidade de Exemplo:
## Habilidades
### Habilidade 1: Captura de Detalhes do Usuário
Esta habilidade precisa capturar os detalhes do usuário que são: nome, sobrenome e e-mail.
PERGUNTE APENAS pelos detalhes que estiverem vazios ou desconhecidos
Depois que todos os detalhes do usuário forem capturados com sucesso, você deve buscar os horários disponíveis e prosseguir para a próxima habilidade.
### Habilidade 2: Seleção de Horário
Esta habilidade precisa mostrar os horários disponíveis para o usuário
Você deve exibir os horários disponíveis em uma visão geral bem formatada
Primeiro exiba as datas disponíveis
Depois que a data for escolhida, você deve mostrar os horários disponíveis para essa data
### Habilidade 3: Agendamento de Consulta
Esta habilidade precisa lidar com o agendamento real da consulta
Depois que o usuário escolher a data e hora, você deve fornecer uma visão geral dos detalhes da consulta e pedir que ele confirme
Depois que o usuário confirmar os detalhes da consulta, você deve salvar a data e hora escolhidas no formato original em que foram recebidas ao buscar os horários disponíveis
Depois de salvo, você precisará agendar a consulta
Quando a consulta for agendada, você deve notificar o usuário sobre isso
O recurso Informações de produtos e serviços permite inserir descrições detalhadas dos seus produtos e serviços, incluindo especificações, opções de agendamento, preços e referências úteis.
Isso garante que os usuários acessem informações relevantes sem precisar perguntar repetidamente. Com dados estruturados, o recurso ajuda a otimizar interações, melhorar o engajamento do cliente e aprimorar a experiência geral do usuário.
Na seção de restrições, você deve definir os comportamentos que NÃO deseja que a IA execute. Isso pode incluir perguntas que você não quer que a IA faça ou palavras que não deseja que o agente use.
Exemplo de restrições: O agente deve processar solicitações apenas em uma única sessão de usuário e não deve armazenar dados pessoais além da sessão. Garanta que todos os prompts e respostas sejam claros e amigáveis. Trate erros de entrada com cuidado, orientando como corrigir problemas, como formato de e-mail inválido. Se o usuário decidir cancelar em qualquer etapa, ofereça uma opção para sair do processo educadamente. Os tempos de resposta devem ser rápidos para manter o engajamento e a satisfação.
Para facilitar, a WiiChat oferece o botão “Gerar Prompt do Agente”, que gera as seções de papel, persona, habilidades e restrições com base na descrição informada.
Há dois cenários principais em que esse recurso é especialmente útil. Primeiro, se você não tem experiência em escrita de prompts, ele ajuda a estruturar rapidamente um prompt detalhado e eficaz sem exigir habilidades avançadas.
Segundo, se você prefere não começar do zero, a ferramenta fornece uma estrutura predefinida, dando uma base sólida que você pode modificar e adaptar às suas necessidades específicas.
Criando Funções de IA
Clique em “+ Função de IA” para criar uma nova Função de IA.
Na primeira seção, defina o nome e a descrição da função.
Exemplo de descrição: esta função precisa capturar os dados do usuário: nome, sobrenome e e-mail. Para o e-mail, o agente deve validar se o formato está correto caso o usuário não o forneça adequadamente.
Na próxima seção, defina o prompt completo da função, ou seja, o que você deseja que ela faça ou execute.
Exemplo de Prompt:
### Habilidade: capture_user_details
Esta habilidade captura informações essenciais do usuário: nome, sobrenome e e-mail. Garante que o e-mail fornecido esteja em um formato válido.
#### Passos para Execução:
Solicite que o usuário insira seu nome.
Peça o sobrenome do usuário.
Solicite o endereço de e-mail do usuário.
Valide o formato do e-mail usando uma expressão regex (ex.: `^[\w\.-]+@[\w\.-]+\.\w{2,4}$`).
Se o e-mail for válido, armazene todos os detalhes; caso contrário, solicite que o usuário insira um e-mail válido novamente.
#### Restrições:
Todas as entradas (nome, sobrenome e e-mail) não podem estar vazias.
O e-mail deve obedecer às regras padrão de formatação.
#### Regras de Formatação:
Assegure que a entrada esteja sem espaços em branco no início e no fim.
#### Tratamento de Erros:
Se a validação falhar, informe ao usuário o erro específico (ex.: "Formato de e-mail inválido").
Permita um número pré-definido de tentativas para inserir o e-mail novamente.
#### Condições:
Proceda para capturar os detalhes somente se o e-mail for válido.
Solicite cada detalhe do usuário separadamente
SÓ continue com a chamada da função quando TODOS os parâmetros forem capturados
Na próxima seção, defina os valores que deseja obter da função, como nome e sobrenome, descreva cada um deles e escolha em qual CUF eles serão salvos.
Observação: marque “Obrigatório” para tornar o valor indispensável para a função. Você também pode marcar o recurso “Memória”, que verifica o histórico da conversa para identificar se o valor já existe; se existir, a função não perguntará novamente e seguirá para o próximo parâmetro.
Por fim, anexe o fluxo, apenas fluxos de trabalho são permitidos, que deve ser acionado quando a função for chamada.
Você pode usar esse recurso para enviar valores capturados a outra plataforma por integrações nativas, como Google Sheets, ou executar chamadas de API por meio de um nó de requisições externas. Ele também pode recuperar informações de uma fonte externa e retorná-las ao agente de IA, permitindo que a conversa continue normalmente.
Isso facilita automatizar tarefas, atualizar informações em tempo real e aprimorar respostas da IA com dados recentes.
Observação: agora você pode usar nós de “Enviar Mensagem” dentro de fluxos de trabalho. Isso permite que Agentes de IA enviem mídia e outros conteúdos dinâmicos conforme as informações recebidas.
Selecionando a Função de IA
Para que Agentes de IA possam usar funções de IA, você precisa selecioná-las nas configurações de modificação dos Agentes de IA.
Depois de selecionada, a função será exibida de forma semelhante a uma visão geral do prompt da função.
Observação: ao desmarcar ou marcar uma função, o prompt correspondente aparecerá ou desaparecerá da sobreposição.
Usando Funções de IA
Você só pode usar Funções de IA em fluxos de trabalho. Selecione o nó “Saída da Função de IA” na aba de Agentes de IA dentro do bloco de ação. Esses serão os dados enviados de volta ao seu Agente de IA depois que uma função for chamada e um fluxo de trabalho for processado.
Usando o Agente de IA
Crie um nó de ação e selecione “Ação de IA”.
Clique em “Editar ação” para selecionar o Agente de IA.
Selecione o Agente de IA principal, que será acionado e executará primeiro, bem como agentes secundários, se necessário. Você também pode definir o tempo limite de inatividade do usuário; se o usuário parar de responder durante a conversa com um agente de IA, esse tempo limite será acionado e você poderá fazer um follow-up para que ele volte a interagir com o bot.
Ao selecionar agentes secundários, o agente principal herdará todas as funções desses agentes. No entanto, as configurações de persona, papel e LLM do agente principal serão herdadas pelos agentes secundários.
Esse recurso é especialmente útil quando você deseja ampliar as capacidades do agente principal sem alterar sua funcionalidade central. Ao integrar agentes secundários, você expande o conjunto de tarefas que o agente principal pode executar, mantendo um fluxo de interação consistente.
Por fim, salve as informações no CUF de sua escolha. Esta etapa é opcional e foi criada apenas para depuração.
Se você não salvar a saída em nenhum campo personalizado do usuário, a resposta do bot ainda será enviada automaticamente.
Para usar esse Agente de IA, basta enviar o fluxo ao usuário, e o Agente de IA começará a conversar com ele.
Você também pode encadear vários Agentes de IA para direcionar o usuário conforme sua necessidade. Agentes adicionais receberão o título e uma breve descrição no prompt do sistema. Depois que a intenção for identificada por um agente adicional, você poderá conectar essa intenção a outra ação de Agente de IA.
Isso garante que o bot cubra o máximo de casos de uso possível, mantendo o uso de tokens do prompt otimizado.
A conversa completa com o usuário será salva no novo campo JSON do sistema chamado “Mensagens de IA”.
Tempo limite incompleto do Agente de IA
Tempo limite de entrada incompleta permite que o agente de IA aguarde um período definido em segundos para capturar todas as respostas do usuário e processá-las como uma única resposta. Isso garante que o agente processe a entrada completa antes de gerar uma resposta.
Observação: cada nova entrada reinicia o temporizador. Por exemplo, se o tempo limite estiver definido como 10 segundos e o usuário digitar “oi”, a contagem começa. Se ele enviar outra mensagem, como “como você está”, após 6 segundos, o temporizador volta para 10 segundos em vez de continuar a partir de 7.
Criando Tarefas de IA
No Hub de IA, clique em “Tarefas de IA” e depois em “+ Tarefa de IA”.
Na primeira seção, defina o nome e o prompt do que você deseja que a tarefa de IA faça. Tarefas de IA são essencialmente pequenas combinações de conclusões de chat empacotadas em um conjunto, projetadas para executar tarefas únicas.
Você pode usar uma das predefinições disponíveis para ter uma ideia de como preencher o prompt.
Na seção de configurações, defina o modelo e outros parâmetros, como temperatura e máximo de tokens.
Na seção de campo de saída, se a sua Tarefa de IA exigir uma saída, por exemplo, extrair determinada informação de um texto maior, você poderá definir um campo de saída onde o resultado será salvo em um CUF.
Um exemplo de saída será semelhante a isto:
Usando Tarefas de IA
No bloco de ação, clique em “Ações de IA” e selecione “Tarefas de IA” no menu suspenso.
Selecione a Tarefa de IA que deseja executar e, no campo de entrada, informe o conteúdo no qual deseja aplicar a Tarefa de IA.
O resultado final será parecido com isto:
Esse valor pode ser mapeado para um campo do usuário para ser usado posteriormente em outros fluxos.
Solução de problemas de IA
Há principalmente duas formas de solucionar problemas nas respostas de IA. A primeira é analisar o campo JSON do sistema “Mensagens de IA”.
Você pode acessar a visão geral do usuário do bot e clicar no JSON de Mensagens de IA para analisar em qual etapa o usuário está perguntando algo e quais respostas estão sendo geradas pela IA.
Você também pode verificar quando uma função está sendo chamada.
O segundo método é analisar diretamente a conversa completa pelo Livechat, com mensagens do sistema ativadas.
Aqui você pode ver qual Agente de IA está sendo utilizado no fluxo.
Também é possível ver quando uma função está sendo chamada.
Ao passar o mouse sobre isso, são exibidos os argumentos e as saídas processados por essa função.
Da mesma forma, você também pode ver quando campos do usuário estão sendo preenchidos.