Configurar o assistente do site de documentação

O Assistente de IA responde às perguntas dos seus leitores em linguagem simples, usando apenas as páginas que você publicou, e vincula cada resposta às páginas de onde ela veio. Este artigo aborda como ativá-lo, as configurações, as perguntas iniciais e o limite mensal de respostas.

Antes de começar#

• O assistente está disponível em todos os planos, incluindo o Gratuito. Seu plano define quantas respostas seu workspace recebe por mês (veja Respostas mensais).
• As respostas não consomem créditos. Elas são descontadas apenas das respostas mensais.
• Para alterar as configurações, você precisa ser o proprietário do workspace, um administrador ou um editor.
• As configurações, assim como o restante do site, chegam aos leitores quando você publica.

Ativar o assistente#

O assistente fica desativado em um novo site.

1. Abrir as configurações do assistente#

   Abra seu site de documentação e vá para Configurações → Assistente de IA. Você também pode abrir Insights → Assistente e clicar em Ativar.

2. Ligar o assistente#

   Ative Mostrar o assistente. Os leitores verão Perguntar à IA no cabeçalho, na página inicial e na pesquisa.

   

3. Escolher o que acontece quando ele não consegue responder#

   Em Quando não conseguir responder, escolha Página de contato, Um link ou Nada. Veja As configurações.

4. Salvar e publicar#

   Clique em Salvar e, em seguida, publique o site. O botão Perguntar à IA aparecerá no site ativo com essa publicação.

As configurações#

Todas elas estão em Configurações → Assistente de IA. Enquanto Mostrar o assistente estiver desativado, as outras linhas ficarão cinzas.

Opções de Quando não conseguir responder:

O formulário de contato em si é configurado em Configurações → Feedback e contato. Veja Coletar feedback e mensagens dos leitores.

O que os leitores veem#

• Perguntar à IA no cabeçalho, na página inicial e na pesquisa. Quando a pesquisa não encontra nada, os leitores são informados de que podem perguntar ao Assistente de IA em vez disso.
• Perguntar à IA sobre esta página em um artigo, o que abre o chat com uma pergunta sobre aquela página.
• Um painel de chat com algumas perguntas iniciais (Tente perguntar), uma caixa de pergunta (até 2.000 caracteres) e Novo chat.
• Respostas com Fontes numeradas que vinculam às suas páginas, e a linha "A IA pode cometer erros. Verifique as fontes."
• Copiar resposta, Boa resposta e Má resposta abaixo de cada resposta. As avaliações aparecem em Insights → Assistente.

Como o assistente responde:

• Ele usa apenas suas páginas publicadas. Rascunhos, alterações não publicadas e páginas que você ocultou da navegação são deixados de fora. Páginas do site, como Sobre, FAQ ou páginas legais, também são usadas.
• Ele responde no idioma em que o leitor escreve.
• Ele lembra das últimas mensagens da conversa, para que os leitores possam fazer perguntas de acompanhamento.
• Quando a documentação não cobre uma pergunta, ele diz isso em vez de adivinhar e mostra o que você escolheu em Quando não conseguir responder.

Perguntas iniciais#

As perguntas iniciais são as sugestões em um chat vazio, em Tente perguntar. Suas respostas são preparadas com antecedência, então um leitor que clica em uma recebe a resposta imediatamente e isso não conta para suas respostas mensais.

Você as gerencia em Insights → Assistente, no cartão Tente perguntar:

• Cada idioma do site tem sua própria lista de até 6 perguntas. Os leitores veem as 4 primeiras.
• A Clevera reescreve a lista uma vez por dia com base no que os leitores perguntam e pesquisam. Um novo site começa com "Sem sugestões ainda" até que os leitores comecem a perguntar; você pode adicionar as suas imediatamente.
• Adicionar uma pergunta, Editar e Remover alteram a lista. Fixar mantém uma pergunta durante a atualização diária; perguntas fixadas aparecem primeiro.
• Regenerar escreve um novo conjunto agora.
• As alterações chegam aos leitores na próxima publicação.

Perguntas mensais#

Cada workspace recebe um número de respostas do assistente por mês, compartilhado por todos os seus sites de documentação. A contagem é reiniciada no dia 1º de cada mês (UTC).

Algumas respostas não contam:

• Clicar em uma pergunta inicial.
• Respostas servidas a partir do cache de respostas: quando um leitor abre um novo chat com uma pergunta que já foi respondida recentemente, ele recebe a mesma resposta e ela não é contabilizada.
• Perguntas que o assistente não conseguiu responder devido a um erro.

Limites que protegem suas respostas de um site muito movimentado ou de um único leitor:

Você pode acompanhar a contagem em dois lugares:

• Configurações → Assistente de IA → Perguntas mensais: "Incluído no" seu plano, a data de reinicialização e quantas perguntas foram usadas.
• Insights → Assistente: o medidor de Respostas este mês, com "Quase esgotado" a partir de 90%, "Esgotado" em 100% e quantas respostas vieram do cache. Aumentar limite mostra os planos com mais respostas.

Quando o limite é atingido#

• Leitores que fazem uma pergunta veem "O assistente não está disponível no momento. Pesquise na documentação em vez disso." A pesquisa continua funcionando.
• Insights → Assistente mostra "As respostas da IA estão pausadas até" a data de reinicialização, com Fazer upgrade.
• O assistente volta no dia 1º do próximo mês, ou assim que você mudar para um plano com mais respostas. Quando um site atinge sua cota diária, o assistente naquele site volta no dia seguinte (UTC).

Notificações de uso#

O proprietário do workspace e os administradores recebem as notificações de uso; proprietários, administradores e editores recebem a notificação sobre perguntas sem resposta. Você pode alterar os canais nas suas configurações de notificação.

Você recebe cada notificação de uso uma vez por mês.

Revisar conversas#

Insights → Assistente mostra o que os leitores perguntaram, para o intervalo de datas que você escolher:

• Conversas, Respondido (a parcela respondida a partir da documentação, comparada com o período anterior) e Avaliado como útil.
• A lista de Conversas, da mais recente para a mais antiga. Filtre por Todos, Não coberto (o assistente não conseguiu responder a partir da documentação), Avaliado negativamente ou Avaliado positivamente, ou pesquise nas mensagens. Abra uma para ver a transcrição completa com cada resposta e suas fontes.
• Perguntas sem resposta: "O que a documentação não conseguiu responder — escreva sobre isso a seguir". Escrever artigo inicia um novo artigo a partir da pergunta.

Veja Ler insights do site de documentação para intervalos de datas e por quanto tempo o histórico é mantido em cada plano.

Solução de problemas#

Relacionado#