Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Integração com XWiki

Coloque um assistente de IA no seu wiki, e deixe-o responder a partir das suas páginas

Criar conta

Visão Geral

A extensão Asyntai para XWiki faz duas coisas. Coloca o assistente de chat em todas as páginas do seu wiki, e envia as suas páginas para a Asyntai para que o assistente responda a partir delas. A sua equipa faz então uma pergunta em palavras simples, em vez de ler centenas de páginas.

Como funciona

A maioria dos wikis está por trás de um início de sessão, por isso nenhum rastreador os consegue ler. A extensão resolve isso por dentro: uma tarefa noturna no seu wiki envia as páginas novas e alteradas para a sua base de conhecimento Asyntai. Só as páginas alteradas são enviadas de novo, e uma página que apagar é removida da Asyntai na execução seguinte.

Requisitos

  • XWiki 11.5 ou posterior, com o Scheduler do XWiki que vem incluído
  • Direitos de administração no wiki
  • Uma conta Asyntai. Criar uma é gratuito, e o plano Free chega para o widget de chat.
  • Um plano Asyntai pago para a sincronização da base de conhecimento, porque usa a API da Asyntai

Instalação

Siga estes passos para adicionar a Asyntai ao seu wiki:

1

Instale a extensão

Abra Administração, depois Extensões, e procure Asyntai. Instale-a. Também pode importar o ficheiro XAR a partir de Administração, depois Importar.

2

Copie o seu ID de widget

Abra a página Instalação no seu painel Asyntai. O seu ID de widget é o valor de data-asyntai-id no código aí mostrado.

data-asyntai-id="asyntai_xxxxxxxxxxxx"
3

Cole-o no wiki

Abra Administração, depois Outros, depois Asyntai. Cole o seu ID de widget e guarde. O assistente de chat aparece de imediato em todas as páginas.

4

Adicione a sua chave API

No mesmo ecrã, cole uma chave API da Asyntai e defina Enviar páginas do wiki para a Asyntai como Sim. Salte este passo se quiser apenas o widget de chat.

5

Inicie a sincronização

Abra a página Asyntai a partir do painel Aplicações. Prima Executar como eu a partir de agora, depois prima Executar a sincronização agora. Depois disso a sincronização corre todas as noites.

Dica: Acrescente os seus documentos, as suas perguntas e respostas e as suas instruções no painel Asyntai antes de publicar, para que o assistente responda bem logo ao primeiro visitante.

O que a sincronização envia

  • O título e o texto de cada página, como texto simples, com uma ligação de volta ao wiki
  • Mais nada. Nem nomes de utilizador, nem dados de visitantes.
  • As páginas ocultas nunca são enviadas, por isso as páginas técnicas ficam fora da base de conhecimento
  • Espaços como XWiki, Help e Sandbox estão excluídos desde o início, e pode excluir mais
  • Uma página com menos de 120 caracteres é um esboço, por isso é ignorada

Em nome de quem a sincronização corre

A tarefa corre em nome de uma pessoa concreta, e envia exatamente as páginas que essa pessoa pode ler. O botão na página Asyntai define essa pessoa como sendo você. Isto é importante, porque todos os que podem usar o assistente de chat poderão perguntar sobre tudo o que a sincronização enviou.

Como remover

Desinstale a extensão a partir de Administração, depois Extensões. O assistente de chat e a tarefa de sincronização desaparecem de imediato. As páginas já enviadas permanecem na sua base de conhecimento Asyntai até que as apague lá.

Privacidade

O seu wiki envia à Asyntai os títulos e o texto das páginas, e mais nada. A sua chave API é guardada numa página que só os administradores podem ler. Deixe a sincronização desligada para não enviar nada; o widget de chat continua a funcionar. Política de privacidade.

Planos e preços

A extensão é gratuita. O widget de chat funciona em todos os planos Asyntai, incluindo o plano Free. A sincronização da base de conhecimento precisa de um plano pago, porque usa a API da Asyntai. Ver preços.

Precisa de Ajuda?

Se você tiver alguma dúvida ou encontrar problemas, entre em contato conosco em [email protected].