Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

MediaWiki Integration

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

Criar conta

Visão Geral

The Asyntai extension for MediaWiki does two things. It puts the chat assistant on every page of your wiki, and it sends your wiki pages to Asyntai so the assistant answers from them. Your readers ask a question in plain words and get the answer with a link to the page, instead of searching through hundreds of articles.

Como funciona

Every time someone saves a page, the extension sends the new text to your Asyntai knowledge base in the background. A page that changes is sent again, and a page that is deleted is removed from Asyntai. One button sends the whole wiki at the start. This works for public wikis and for internal wikis behind a login alike, because the wiki pushes the pages out from inside.

Requisitos

  • MediaWiki 1.39 or later
  • 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

Download the extension and unpack it into the extensions folder of your wiki, so that you have extensions/AsyntaiChatbot. Then add this line to LocalSettings.php and run maintenance/update.php once:

wfLoadExtension( 'AsyntaiChatbot' );
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

Open Special:AsyntaiChatbot on your wiki as an administrator. Paste your widget ID and press Save settings. The chat assistant appears on every page at once.

4

Adicione a sua chave API

On the same page, paste an Asyntai API key, tick Send wiki pages to Asyntai, and save. Skip this step if you only want the chat widget.

5

Send the Whole Wiki

Press Send all pages now. The pages go out in the background as your visitors open pages, or at once when you run maintenance/runJobs.php. From then on, every saved page is sent on its own.

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

  • The title and the text of each page, as plain text, with a link back to the wiki, so the assistant can point readers to the page
  • Pages in the namespaces you choose. The main namespace is on from the start, and you can add Help or Project pages with their namespace numbers.
  • Redirects are skipped, and a page shorter than 120 characters is a stub, so it is skipped too
  • A page is sent again only when it changed since the last time

Sync Status

The settings page shows how many pages are in your knowledge base, how many wait in the job queue, when the last page was sent, and the last problem if there was one. If Asyntai answers that your daily upload limit is reached, the sync waits and continues the next day.

Como remover

Remove the wfLoadExtension line from LocalSettings.php. The chat assistant and the sync stop at once. Pages already sent stay in your Asyntai knowledge base until you delete them there.

Privacidade

Your API key is stored in the wiki database and is shown to nobody after you save it. Only administrators can open the settings page. 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].