Como Importar um Template GPT e Conectá-lo a um Chatbot na WOZTELL

Importar um Template e Configurar um Assistente GPT na WOZTELL

Importa um template e configura um assistente GPT passo a passo 

Neste artigo, você vai aprender a importar um template no construtor da WOZTELL e conectá-lo a um assistente da OpenAI e Azure Open AI. Com essa configuração, você poderá automatizar fluxos conversacionais usando inteligência artificial, sem precisar programar.

Notas
Nota:
Antes de começar, certifica-te de que tua conta da WOZTELL está ativa e que tens um assistente GPT previamente criado e conectado a uma conta da OpenAI ou Azure Open AI.


Opção A: instalar a extensão Open AI

Antes de começar, precisamos instalar a extensão de GPT:
  1. Acessa a plataforma da WOZTELL e vai ao painel "Marketplace".

  1. Busca a extensão "ChatGPT" e clica em "Learn more".

  1. Clica em "Get Extension" para iniciar a instalação.
 
  1. Seleciona a versão mais recente, define um alias identificável e clica em "Install".

  1. Abrirá uma janela de configuração. Para concluí-la, você vai precisar obter o accessToken do chatbot que vai usar.

Obter o accessToken do chatbot da Open AI

Opção 1: pelos ajustes avançados do chatbot

  1. Vá ao painel "Builder" e seleciona o chatbot que você quer atualizar.

3. Abra o "Chatbot Manager" e acesse os ajustes avançados. Depois, entre em "Config Map".


4. Procura o campo "accessToken". É a chave que conecta o assistente de IA ao construtor de chatbots.
5. Copia toda a sequência.


Opção 2: pelo chatbot no OpenAi


2. No menu lateral esquerdo, seleciona "Api Keys" 


3. No canto superior direito da tela, pressiona a opção "Create new secret key"

4. Define um nome para a chave e pressiona o botão "Create secret key"


5. Copia o código


6. Volta à janela de configuração da extensão e cola o código no campo "API Key".


Recomendamos definir o campo "Number of suggestions" como 5 e o campo "Number of previous chat history" como 6 para um desempenho ideal.


7. Clica em "Save" para salvar as alterações.
 

  1. Clique em "Get Extension" para iniciar a instalação.
 
  1. Selecione a versão mais recente, defina um alias identificador e clique em "Install".

  1. Abrirá uma janela de configuração. Para completá-la, será necessário obter o accessToken do chatbot que você vai utilizar.

Opção B: Instalar a extensão Azure Open AI

1. Acesse a plataforma da WOZTELL e vá até o painel "Marketplace".

2. Procure a extensão "Azure Open AI" e clique em "Get Extension" para iniciar a instalação.

 
3. Selecione a versão mais recente, defina um alias identificador e clique em "Install".

4. Na página de configuração, aparecerá a opção "Sugerir GPT" (Sugerir resposta na caixa de entrada). Se você não utilizar essa função, pode ignorar essa configuração.

 

Importar um template de chatbot

1.  No painel superior "Builder", clique em "Import Chatbot".


2. Na janela pop-up, selecione a aba "Chatbot Templates".
3. Escolha o template mais recente (o que aparece primeiro) e clique em "Import".
4. Adicione um nome identificador e clique novamente em "Import".


No caso do Azure, importe "Azure Chat Completion Chatbot"


5. O sistema abrirá automaticamente o construtor com o novo fluxo importado.

 Configure o novo fluxo

1. Selecione o nó geral e acesse sua configuração no painel direito.
2. Vá até a seção "Pre-actions" e clique em "Advanced".



3. Será aberta uma janela pop-up com a configuração avançada onde você pode selecionar Assistant API ou Azure Chat Completion no campo "Resource Template".




Preencha todos os campos obrigatórios: chave API, endpoint do Azure Open AI e deployment. (Você pode encontrar todos os detalhes no seu Azure AI Foundry)





4. Selecione a conexão e o agente que executará as respostas.
 

5. Clique em "Save" para salvar.

 

 Ative  o chatbot

1. Acesse o painel de "Channels" e clique em "Edit" no canal correspondente.


2. No menu lateral, entre em "Chatbot Settings".


3. Clique em "New Chatbot" e selecione o chatbot que você importou. Nota: O nome identificador foi definido na seção "Alias" do passo 4.


5. Ative os chatbots que você vai usar, desative os que não vai usar e clique em "Save".

 
Pronto! Seu chatbot já está configurado.

Verificação da conexão  (opcional)

Para confirmar que a conexão entre o assistente e o chatbot está funcionando corretamente:
  1. Acesse a seção "Platform" no menu lateral para identificar o número do WhatsApp vinculado.
  1. Envie uma mensagem de outro número para esse canal.
  2. Verifique se o chatbot responde corretamente. 

Pronto! Agora você confirmou que seu chatbot foi configurado corretamente.

Boas práticas e recomendações para o uso do OpenAI e Azure Open AI com WOZTELL

1. Segurança da API:
  • Certifique-se de manter sempre sua API Key segura e nunca compartilhá-la em locais públicos. Considere usar configurações adicionais de segurança, como autenticação de dois fatores, para proteger sua conta na OpenAI ou Azure OpenAI.

2. Otimização do modelo:

  • Revise e ajuste regularmente as configurações do seu assistente GPT para melhorar seu desempenho. Isso inclui personalizar o modelo de acordo com as necessidades e o tipo de conversas que deseja automatizar.

3. Monitoramento constante:

  • Supervisionar o desempenho do chatbot após cada implementação é fundamental. Avalie o número de interações e o nível de satisfação dos usuários para ajustar as respostas e otimizar o fluxo conversacional.

4. Uso de tokens com moderação:

  • Evite usar um número excessivo de tokens em cada interação, pois isso pode impactar o custo e a eficiência do serviço. Defina um limite adequado para cada sessão de interação.

5. Supervisão do comportamento da IA:

  • Revise as respostas geradas pelo chatbot para garantir que as informações fornecidas sejam precisas e relevantes para seus usuários. Embora a IA seja poderosa, é sempre recomendável manter uma supervisão constante.

6. Atualizações regulares do modelo:

  • As tecnologias da OpenAI e Azure Open AI estão em constante evolução. Certifique-se de utilizar sempre a versão mais atualizada da extensão e ajuste as configurações quando necessário.

7. Uso de templates inteligentes:

  • Utilize templates de chatbot que já foram testados e otimizados para um fluxo de trabalho mais eficiente. Importe os templates mais relevantes de acordo com as interações comuns do seu negócio para reduzir a necessidade de configurações personalizadas extensas.

8. Respostas claras e concisas:

  • Configure as respostas do chatbot para que sejam claras e fáceis de entender. A IA deve fornecer respostas diretas que resolvam as dúvidas dos usuários sem complicações desnecessárias.

9. Implementação de fluxos de fallback:

  • Sempre que possível, implemente fluxos de fallback que direcionem o usuário a um agente humano caso a IA não consiga lidar corretamente com a solicitação.


10. Feedback constante:

  • Solicite feedback dos usuários para saber o quão bem as interações do chatbot estão funcionando. Esse retorno será inestimável para realizar ajustes finos e melhorar a experiência geral.


Perguntas frequentes  

Onde o payload do assistente deve ser adicionado, no mesmo nó ou em um novo?
Você pode adicioná-lo no mesmo nó ou em um novo. Ambas as opções são válidas, desde que a lógica do fluxo seja respeitada.

Quais entradas o chatbot pode interpretar?
Texto, imagens e áudio. As mensagens de áudio são compatíveis através da opção de transcrição na pré-ação do primeiro nó.

O que ativa o nó global?
O nó global responde a qualquer mensagem de texto ou imagem. Se houver outros triggers com prioridade superior, eles serão executados primeiro.

Posso usar outro fluxo para diferentes triggers? 
Sim. Você pode trabalhar com um fluxo separado ou integrar tudo em uma única árvore, dependendo da sua necessidade.

O que acontece se os usuários me enviarem uma mensagem de áudio em vez de texto?

Se os usuários enviarem uma mensagem de voz, você pode ativar a opção de transcrição automática. Essa função converte o áudio em texto para depois enviá-lo ao assistente de IA e processar a resposta como se fosse uma mensagem escrita.

Para usar essa função, é necessário criar um recurso adicional de transcrição no seu Azure AI Foundry. Isso implica configurar um novo:

  • conjunto de chaves API

  • endpoint do Azure OpenAI

  • e um deployment específico para transcrição

Uma vez configurado, você poderá oferecer uma experiência mais completa e acessível aos seus usuários, mesmo quando preferirem se comunicar por voz.