MediaWiki Integration

在你的 wiki 上放一个 AI 助手，让它根据 wiki 页面回答

概述

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
wiki 的管理权限
一个 Asyntai 账户。创建是免费的，Free 套餐足以使用聊天挂件。
知识库同步需要付费的 Asyntai 套餐，因为它使用 Asyntai API

安装

按以下步骤把 Asyntai 添加到你的 wiki：

安装扩展

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"

把它粘贴到 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.

添加你的 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. 隐私政策.

套餐与价格

扩展是免费的。聊天挂件在每个 Asyntai 套餐上都可用，包括 Free 套餐。知识库同步需要付费套餐，因为它使用 Asyntai API。查看定价.

需要帮助？

如果您有任何问题或遇到困难，请通过 [email protected] 联系我们。