Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

MediaWiki Integration

Metti un assistente IA sul tuo wiki, e lascia che risponda dalle tue pagine

Crea account

Panoramica

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.

Come funziona

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.

Requisiti

  • MediaWiki 1.39 or later
  • Diritti di amministrazione sul wiki
  • Un account Asyntai. Crearlo è gratis, e il piano Free basta per il widget di chat.
  • Un piano Asyntai a pagamento per la sincronizzazione della base di conoscenza, perché usa l'API Asyntai

Installazione

Segui questi passaggi per aggiungere Asyntai al tuo wiki:

1

Installa l'estensione

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

Copia il tuo ID widget

Apri la pagina Installazione nella tua dashboard Asyntai. Il tuo ID widget è il valore di data-asyntai-id nel codice mostrato lì.

data-asyntai-id="asyntai_xxxxxxxxxxxx"
3

Incollalo nel 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

Aggiungi la tua chiave 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.

Suggerimento: Aggiungi i tuoi documenti, le tue domande e risposte e le tue istruzioni nella dashboard Asyntai prima di pubblicare, così l'assistente risponde bene già al primo visitatore.

Cosa invia la sincronizzazione

  • 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.

Come rimuoverlo

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.

Privacy

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. Informativa sulla privacy.

Piani e prezzi

L'estensione è gratuita. Il widget di chat funziona con ogni piano Asyntai, incluso il piano Free. La sincronizzazione della base di conoscenza richiede un piano a pagamento, perché usa l'API Asyntai. Visualizza i prezzi.

Hai bisogno di aiuto?

Se hai domande o riscontri problemi, contattaci a [email protected].