Como criar um assistente de IA


Como criar um assistente de IA


🤖📚 Criação e Treinamento de um Assistente de IA no Chat-Bot

Este recurso orienta, em nível profissional, o processo completo de criação, configuração, treinamento e ativação de um Assistente de IA dentro do Chat-Bot — utilizando sua base de conhecimento composta por arquivos enviados manualmente.

Após preparar sua integração com a OpenAI, você estará apto a criar assistentes inteligentes capazes de analisar documentos 📄 (PDF, DOC, DOCX, TXT, MD) e responder de forma contextual às perguntas dos usuários via WhatsApp.


🧭 Introdução

Com a integração OpenAI concluída, você pode criar um Assistente de IA que interpreta, compreende e utiliza diretamente os arquivos enviados para construir uma base de conhecimento estruturada.
Esse assistente poderá:

✔ Responder perguntas baseadas em documentos
✔ Interpretar políticas internas, guias, manuais, tabelas e FAQs
✔ Realizar atendimento automatizado contextualizado
✔ Ser integrado ao Fluxo de Bots do Chat-Bot
✔ Operar totalmente dentro do WhatsApp via Meta Business API


🔹 Passo 1 — Acessar a Seção do Assistente de IA

Como acessar:

  1. Faça login no Painel Administrativo do Chat-Bot.

  2. No menu lateral, clique em Assistente de IA.

  3. Selecione + Criar novo assistente para iniciar a configuração.

🖥️ Painel de Controle do Assistente de IA
Aqui você visualiza todos os assistentes já criados, seu status, progresso de sincronização, utilização e condições gerais de operação.


🔹 Passo 2 — Configurar as Definições Básicas do Assistente

Ao criar um novo assistente, você será apresentado ao formulário de configuração inicial contendo os seguintes campos:

📝 Parâmetros do Assistente

CampoDescriçãoExemploObrigatório
Nome do AssistenteIdentificador único do assistenteSmartFlow AI✅ Sim
DescriçãoFinalidade e comportamento geralAssistente virtual inteligente para otimização de processos.✅ Sim
Modelo de IAModelo da OpenAI utilizadoGPT-4o Mini, GPT-4, GPT-3.5 Turbo✅ Sim
Instruções do SistemaPersonalidade, comportamento, tom e diretrizes“Você é a SmartFlow AI, uma assistente proativa...”✅ Sim

🚀 Opções de Modelos de IA

ModeloDesempenhoCustoIdeal Para
GPT-4o MiniMuito rápidoBaixoRespostas rápidas e interações curtas
Turbo GPT-3.5EquilibradoMédioUso geral, chat contínuo
GPT-4AvançadoAltoAnálises profundas e raciocínio complexo

🧩 Modelo Sugerido para Instruções do Sistema

Use esta estrutura para garantir um comportamento profissional, eficiente e consistente:

You are [Assistant Name], a proactive and helpful assistant. Always provide clear, concise, and context-aware responses. Anticipate user needs, suggest relevant actions, and ensure user interactions are productive and pleasant.

🔹 Passo 3 — Enviar Documentos para a Base de Conhecimento

📂 Área de Upload do Chat-Bot
O Chat-Bot oferece uma interface moderna com arrastar e soltar, além de upload manual.

🎯 Como enviar arquivos:

  • Arraste arquivos para a área destacada

  • Ou clique para selecionar os documentos

✔ Formatos suportados:

TipoExtensãoTamanhoUso
PDF.pdf10 MBManuais, guias, contratos
Word.doc / .docx10 MBDocumentações internas
Texto.txt10 MBFAQs, listas, respostas rápidas
Markdown.md10 MBDocumentos técnicos

📌 Recomendações antes do upload

  • Organize o conteúdo com títulos claros

  • Remova informações sensíveis

  • Mantenha linguagem objetiva

  • Agrupe documentos por contexto


⚙️ Processamento e Indexação dos Documentos

Assim que os arquivos forem enviados:

  1. O sistema extrai todo o conteúdo

  2. Os textos são convertidos em vetores

  3. O Chat-Bot cria uma estrutura de consulta contextual

  4. O Assistente de IA começa a compreender seus dados

Tempo estimado:
Entre 2 a 10 minutos por arquivo, dependendo de:

  • Quantidade de texto

  • Tamanho dos documentos

  • Fila de processamento do servidor

Acompanhe tudo no painel através do indicador:

📌 Status de Sincronização


🔹 Passo 4 — Monitorar o Status do Assistente

O painel exibe informações críticas de processamento:

StatusDescriçãoAção
ProcessandoDocumentos em indexaçãoAguardar
100% SincronizadoTodos os documentos processadosPronto
Assistente ProntoIA ativa e funcionalPode testar
Base SincronizadaVetores indexadosOperacional

🔹 Passo 5 — Testar o Assistente de IA

A interface de teste permite validar:

🧪 Funcionalidades:

  • Respostas em tempo real

  • Histórico de mensagens

  • Acesso aos documentos sincronizados

  • Visualização da base de conhecimento

  • Comportamento do modelo

🔍 Exemplos de Testes

TipoPerguntaResultado Esperado
FAQ“Quais são os horários de atendimento?”Retorno baseado nos seus arquivos
Produto“Explique o plano Premium”Detalhes completos
Processo“Como ativo minha conta?”Passo a passo
Suporte“Como emitir uma fatura?”Orientação contextual

🔹 Passo 6 — Integrar o Assistente ao Bot Flow Builder

O Chat-Bot permite integrar o assistente com fluxos automáticos:

🔧 Elementos disponíveis:

  • Mensagem de texto

  • Botões interativos

  • Listas estruturadas

  • Assistente de IA (nó especial)

🧠 Configurações de Fluxo:

ConfiguraçãoOpções
Tipo de ContatoLead, Cliente, Potencial
Tipo de Gatilho"correspondência exata"
Palavras-chaveDefinidas pelo usuário
Seleção do AssistenteQualquer IA criada

💡 Melhores Práticas

🗂 Preparação dos Documentos

  • Estruture com títulos e subtítulos

  • Use linguagem simples

  • Mantenha tudo atualizado

  • Evite excesso de jargões

📈 Qualidade das Respostas

  • Mantenha consistência

  • Verifique a precisão

  • Seja direto

  • Envie informações completas


🛠 Solução de Problemas

ProblemaSintomaSolução
Documentos travadosSincronização não avançaVerifique o formato/tamanho
Respostas irrelevantesIA não entendeAjuste as Instruções do Sistema
IA não respondeSem retornoVerifique a chave OpenAI
Acesso vazioIA não encontra documentosReenvie arquivos

⚠️ Mensagens de Erro Comuns

ErroSignificadoAção
“Base de conhecimento pendente”Processamento não terminouAguarde
“Chave de API inválida”Key incorretaInsira novamente
“Modelo indisponível”Modelo não habilitado no projetoTroque o modelo
“Falha no upload”Arquivo inválidoRefaça o envio

🎯 Próximos Passos

Após criar e testar seu Assistente de IA:

  • Integre aos fluxos automatizados

  • Avalie o desempenho

  • Atualize constantemente os documentos

  • Amplie sua base de conhecimento

  • Escale para novos setores da empresa


📘 Pager

Página anterior: Configurar OpenAI
Próxima página: Vídeo Online



** O tempo é base no fuso horário America/New_York