Training Hub de IA: ensinando o Fynn

Antes de começar

• O Training Hub faz parte dos planos Startup, Business e Enterprise, porque ele treina o seu bot de IA.
• Crie um bot primeiro em Configurações > Bots. Sem bot, o Training Hub mostra Crie seu bot de IA primeiro.
• Num workspace novo, a configuração guiada cria o Fynn e 2 fontes para você: um Crawl de site com o nome do seu site e uma Lista de FAQ chamada Setup answers, com as respostas que você manteve ou corrigiu na configuração (até 20). A primeira leitura do site é rápida, até 25 páginas em 90 segundos, com as páginas que os clientes mais perguntam primeiro, e depois vem o crawl completo descrito abaixo.
• Administradores podem adicionar e excluir fontes, e, no Enterprise, também membros cujo perfil personalizado tem Gerenciar fontes do Training Hub.

Os 4 tipos de fonte

• Crawl de site lê até 500 páginas de um site, a partir da URL que você informar.
• Central de ajuda importa artigos de uma central de ajuda. Escolha uma das suas centrais do Deskwoot em Sua central de ajuda Deskwoot, ou escolha Inserir uma URL externa para uma central hospedada em outro lugar. Ela passa pelo crawl como um site.
• Upload de documento aceita um arquivo PDF, Word (.docx), CSV ou TXT de até 10 MB.
• Lista de FAQ guarda perguntas e respostas que você digita. Escreva cada par como Q: pergunta e A: resposta, com uma linha em branco entre os pares.

Adicione uma fonte

1. Abra Configurações > Training Hub e clique em Adicionar fonte.
2. Escolha um dos 4 tipos.
3. Dê um Nome à fonte, por exemplo "Site principal".
4. Em Atribuir ao bot, escolha um bot, ou deixe Todos os bots (compartilhado) para que todos os bots possam usá-la.
5. Informe a URL, envie o arquivo ou digite a sua lista de FAQ.
6. Clique em Adicionar fonte. O Deskwoot verifica se o conteúdo pode ser lido e depois cria a fonte.

Documentos e listas de FAQ são processados logo depois que você os adiciona e então mostram Pronto. Uma fonte de site ou de central de ajuda mostra Processando e "N páginas lidas até agora" até o primeiro crawl terminar.

Como o crawl funciona

O crawler começa na sua URL e também lê o sitemap: o que o seu robots.txt indica, ou /sitemap.xml. Depois ele segue links do mesmo site até 3 níveis de profundidade. As páginas no idioma da URL inicial vêm primeiro, as outras línguas depois. Ele fica fora dos caminhos que o seu robots.txt exclui, faz entre as páginas as pausas que o robots.txt pede e nunca acessa endereços internos ou privados. Uma fonte guarda até 500 páginas.

O crawl roda em segundo plano. Ele começa assim que você adiciona a fonte, lê por até 4 minutos e depois continua mais ou menos a cada 10 minutos até terminar. Um site grande pode levar um tempo. Um crawl que ainda não terminou depois de 24 horas é interrompido.

Novo crawl automático a cada 48 horas

Fontes de site e de central de ajuda passam por um novo crawl a cada 48 horas, para que o Fynn responda com a versão atual das suas páginas. A linha de cada fonte mostra Último crawl e quando vem o próximo, por exemplo Próximo crawl em 12 h. Durante um novo crawl ela mostra Crawleando... e as páginas lidas até agora. O Fynn mantém o conteúdo antigo até o novo crawl terminar. Aí as novas páginas substituem as antigas de uma vez. Se nada mudou, nada é substituído.

Precisa da atualização antes, por exemplo logo depois de publicar um artigo novo? Clique em Recrawlear ao lado da fonte.

Se um novo crawl falhar, por exemplo porque o site estava fora do ar, bloqueou o crawler ou trouxe muito menos conteúdo que da última vez, o Fynn mantém o conteúdo anterior e o crawl automático dessa fonte fica pausado. A linha mostra o erro e Recrawl automático pausado após um erro. Corrija a causa e clique em Recrawlear. Um crawl bem-sucedido reinicia o ciclo de 48 horas.

Quem pode gerenciar as fontes do Training Hub também vê um aviso no topo do painel. Ele mostra a fonte e o motivo, diz de que data é o conteúdo com que o Fynn continua respondendo e leva até a fonte, cuja linha no Training Hub diz o mesmo. Se mais de uma fonte estiver com falha, ele mostra quantas são e leva até o Training Hub. Se você fechar o aviso, ele não aparece mais nessa aba e volta em uma aba nova enquanto o recrawl continuar falhando. Ele some sozinho depois de um crawl bem-sucedido ou quando você exclui a fonte. Você moveu essa central de ajuda para o Deskwoot, por exemplo com a importação do Zendesk? Se o seu bot estiver com Use Help Center articles as knowledge base ativado, o Fynn lê os artigos publicados lá, e você pode excluir a fonte antiga.

Uma fonte cujo primeiro crawl ou processamento falhou mostra Falhou e o botão Tentar de novo. Documentos e listas de FAQ não passam por novo crawl. Para mudar um deles, exclua e adicione a nova versão.

Dicas para respostas melhores

• Mantenha o conteúdo atualizado. Material desatualizado gera respostas erradas.
• Seja específico. Textos curtos, cada um sobre um assunto, funcionam melhor que um documento longo sobre tudo.
• Evite duplicatas. Quando duas fontes dizem coisas diferentes, o Fynn pode dar respostas diferentes. Remova a antiga.
• Teste depois de cada mudança. Faça ao Fynn uma pergunta sobre o conteúdo novo em um chat de teste.

Perguntas frequentes

Quais arquivos posso enviar?

PDF, Word (.docx), CSV e TXT, até 10 MB por arquivo. O PDF precisa ter texto selecionável: um PDF escaneado sem camada de texto não pode ser lido. Outros formatos, como imagens, arquivos do Excel ou Markdown, não são aceitos. Salve antes em um dos 4 formatos ou cole o texto em uma lista de FAQ.

Quantas fontes posso adicionar?

Não há um limite fixo para o número de fontes. Cada fonte de site ou de central de ajuda lê até 500 páginas. Qualidade vale mais que quantidade: fontes que se contradizem pioram as respostas.

O Fynn lê a minha central de ajuda sem uma fonte no Training Hub?

Pode ler. Nas configurações do bot, em Configurações > Bots, ative Use Help Center articles as knowledge base. O Fynn passa a pesquisar direto os artigos publicados das suas centrais de ajuda ativas. Uma fonte Central de ajuda no Training Hub é o outro caminho: ela passa pelo crawl e é atualizada a cada 48 horas.

Por que a minha fonte mostra Recrawl automático pausado após um erro?

O último crawl desse site ou dessa central de ajuda falhou, então o crawl automático parou e o Fynn continua usando o conteúdo anterior. Confira se a URL está certa, se o site está no ar e se ele não bloqueia o DeskwootBot. Depois clique em Recrawlear.

O que o Fynn faz quando as minhas fontes não respondem a uma pergunta?

O Fynn é instruído a responder só com o seu conteúdo e nunca inventar nada. Quando o conteúdo não responde à pergunta, ele diz isso. Em uma caixa de entrada com o Modo do bot Bot de suporte, ele também oferece chamar alguém da equipe. Um Bot informativo não transfere a conversa.

Os meus arquivos inteiros são enviados ao modelo de IA?

Não. O Deskwoot divide cada fonte em pedaços pequenos, e o Fynn envia ao modelo de IA só pedaços, nunca arquivos inteiros.

O Training Hub custa a mais?

Não. Ele faz parte dos planos Startup, Business e Enterprise. As respostas do Fynn contam para as conversas de IA do seu plano, veja Conversas de IA e cobrança.

O que acontece com o crawl automático depois de mudar para o Hacker?

Ele para, porque o Hacker não tem bot de IA. As suas fontes são mantidas. Depois de fazer upgrade de novo, clique em Recrawlear em uma fonte de site ou de central de ajuda para reiniciar o ciclo de 48 horas.