Como criar e integrar um assistente OpenAI com um chatbot desenvolvido pela SendPulse
Você pode criar um Assistente de IA personalizado baseado nos modelos GPT da OpenAI e integrá-lo a chatbots alimentados pela SendPulse para realizar diversas tarefas.
Seu Assistente pode processar solicitações do chatbot e responder aos usuários com base em instruções predefinidas, no contexto da conversa ou na análise de arquivos carregados. Além disso, ele pode realizar as seguintes ações:
- Atender a consultas de clientes 24 horas por dia, oferecer recomendações personalizadas e ajudar no suporte ao cliente.
- Redigir descrições de vagas, conduzir triagens iniciais de candidatos e criar materiais de treinamento, workshops ou cursos para equipes.
- Auxiliar no desenvolvimento de estratégias de marketing, analisar dados financeiros e gerar relatórios.
- Escrever textos, criar conteúdo para redes sociais e realizar outras tarefas.
Neste artigo, abordaremos como criar e integrar um Assistente de IA com um chatbot desenvolvido pela SendPulse.
Configurar um Assistente OpenAI
Para criar um Assistente, registre-se ou faça login na OpenAI.
Criar um assistente
Para criar um Assistente, registre-se ou faça login na OpenAI.
Acesse Dashboard > Assistants (Assistentes) e clique em Create (Criar).
Dê um nome ao seu Assistente e defina suas instruções. Suas instruções podem ser como este exemplo: "Um bot que responde a perguntas sobre nossos produtos, ajuda a fazer pedidos, coleta informações de contato e se comunica de maneira amigável."
Você pode usar o editor de IA integrado para modificar suas instruções, caso necessário.
Selecione um modelo GPT na lista.
Configurar as respostas do Assistente
Você pode carregar arquivos com informações que seu Assistente usará para gerar respostas, incluindo FAQs, descrições da sua empresa ou outros dados importantes. A OpenAI analisa esses documentos automaticamente e utiliza palavras-chave para criar respostas às mensagens dos usuários.
Seu Assistente também pode analisar e gerar códigos, criar gráficos e executar funções personalizadas por meio de integrações com APIs externas. É possível inserir código pré-escrito para essas funções ou permitir que o Assistente o gere.
Escolha um formato de resposta e ajuste as configurações de Temperature e Top P:
Temperature: controla a criatividade do modelo. Um valor baixo (ex.: 0.2) torna os resultados mais precisos, enquanto um valor alto (ex.: 1) os torna mais criativos.
Top P: define quantas opções de palavras o modelo considera para prever a próxima palavra. Por exemplo, 0.5 limita as opções aos 50% mais prováveis, enquanto 0.9 expande para 90%.
Recomenda-se ajustar apenas uma dessas configurações por vez.
Teste o desempenho do seu Assistente no Playground.
Gerar uma chave de API
Vá até a aba API Keys e clique em Create new secret key.
Copie e salve a chave. Após fechar a janela modal, você não poderá copiar a chave novamente. Se não copiá-la, será necessário gerar e salvar uma nova chave.
Criar e configurar o fluxo do Assistente
Faça login na sua conta da SendPulse, acesse a seção Chatbots e selecione o chatbot que deseja integrar ao Assistente. Vá até a aba Bot Variables nas configurações para adicionar variáveis globais que manterão o mesmo valor em todos os elementos do fluxo onde forem usadas.
Crie a variável global $OPENAI_KEY
do tipo string. Essa variável armazenará sua chave de API da OpenAI. Cole a chave copiada no campo de valor da variável e salve suas alterações.
Crie a variável global $OPENAI_ASSISTANT_ID
do tipo string. Essa variável identificará qual Assistente será usado para processar as solicitações.
Para encontrar o ID do Assistente, acesse a página do Assistente na OpenAI e copie a sequência de caracteres localizada acima do nome. Cole o ID no campo de valor da variável e salve suas alterações.
Criar e configurar o fluxo do Assistente
Para simplificar o processo, use o fluxo pronto do Assistente. Acesse a seção Templates na sua conta da SendPulse, localize o template OpenAI Assistants, copie-o para o seu chatbot, revise e edite o fluxo no construtor para personalizar o Assistente.
O template inclui prompts com uma lista de variáveis que você precisa criar. Você também pode criar variáveis na aba Público do bot ou diretamente nos elementos do fluxo. Após criar as variáveis, atualize todos os elementos onde elas são usadas.
request |
Armazena a solicitação do usuário. |
thread_id |
Armazena o ID da sessão de conversa entre o usuário e o Assistente, preservando o contexto. Adicione esta variável ao campo de resposta e atualize o elemento Filtro, conforme o template. |
thread_message_id |
Armazena o ID de uma mensagem específica no fluxo. |
thread_run_id |
Mantém o ID do fluxo em execução para obter respostas do Assistente, preservando o contexto atual. |
thread_run_status |
Salva o status do fluxo, como In progress (Em andamento), Completed (Concluído) ou Error (Erro). |
Salve o fluxo e teste a integração. As respostas podem levar cerca de 20 segundos, pois a API do Assistente OpenAI precisa de tempo para processar as solicitações.
Conecte o fluxo a um gatilho ou a outro fluxo usando o elemento Fluxo, para que ele seja executado com base no seu cenário.
Última Atualização: 21.01.2025
ou