MediaWiki Integration

ウィキに AI アシスタントを置き、ウィキのページから回答させます

概要

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.

仕組み

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.

要件

MediaWiki 1.39 or later
ウィキの管理者権限
Asyntai アカウント。作成は無料で、チャットウィジェットには Free プランで十分です。
ナレッジベース同期には有料の Asyntai プラン。Asyntai API を使用するためです

インストール

次の手順でウィキに Asyntai を追加します:

拡張機能をインストールする

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' );

ウィジェット ID をコピーする

Asyntai のダッシュボードで「設置」ページを開きます。ウィジェット ID は、そこに表示されるコードの data-asyntai-id の値です。

data-asyntai-id="asyntai_xxxxxxxxxxxx"

ウィキに貼り付ける

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.

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.

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.

ヒント: 公開する前に、Asyntai のダッシュボードで自社の文書、質問と回答、指示を追加しておくと、最初の訪問者から正しく答えられます。

同期が送信する内容

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.

取り外し方

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.

プライバシー

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. プライバシーポリシー.

プランと料金

拡張機能は無料です。チャットウィジェットは Free プランを含むすべての Asyntai プランで動作します。ナレッジベース同期は Asyntai API を使用するため、有料プランが必要です。料金を見る.

お困りですか？

ご質問や問題がございましたら、[email protected]までお問い合わせください。

ドキュメント