ドキュメント - 月牙AIカスタマーサービス

動作環境

Node.js

18.0 以上

MySQL

5.7 以上

Alibaba Cloudアカウント

百炼 + 機械翻訳

インストール手順

1

ステップ1：依存関係をインストール

安装全部依赖.bat をダブルクリックして実行し、すべての依存関係のインストールが完了するまで待ちます。

安装全部依赖.bat

2

ステップ2：プロジェクトを起動

启动项目.bat をダブルクリックして実行し、開発サーバーを起動します。

启动项目.bat
# http://127.0.0.1:3000

3

ステップ3：セットアップウィザードを完了

ブラウザで http://127.0.0.1:3000 を開くと、データベース設定と管理者アカウント作成がガイドされます。

セットアップウィザードがSQLテーブル作成、管理者作成、設定ファイル書き込みを自動で行います。手動でのデータベース操作は不要です。

データベース構造

システムは7つのテーブルを使用し、セットアップウィザードが自動作成します：

Table	Description
`users`	管理者とエージェントのアカウント。admin / agent の2つのロールをサポート
`clients`	サイト設定。統合サイトごとに1レコード。Alibaba Cloud Agent IDなどを格納
`chat_sessions`	訪問者セッション。IP、デバイス、リファラー、現在のサービスモードを記録
`chat_messages`	チャットメッセージ。すべてのメッセージ内容と送信者タイプ（訪問者/エージェント/AI）
`knowledge_base`	ナレッジベースQ&Aペア。カテゴリ・キーワード・優先度をサポート
`knowledge_files`	Alibaba Cloudナレッジベースにアップロードされたファイルと同期状態
`system_config`	APIキーや翻訳キーなどのグローバルシステム設定

Alibaba Cloud設定

システムはAlibaba Cloudの2つのサービスを使用します：百炼（AI返信）と機械翻訳（メッセージ翻訳）。管理パネルにログインし「システム設定」で以下を入力してください：

ali_api_key 百炼 APIキー

Alibaba Cloud百炼コンソールで作成。Q&Aエージェントの呼び出しに使用。

ali_workspace_id ワークスペースID

百炼コンソール右上で確認可能。ws-xxxxxxxxのような形式。

ali_translate_key_id 翻訳 AccessKey ID

Alibaba Cloud RAMコンソールで作成。機械翻訳サービスの有効化後に取得。

ali_translate_key 翻訳 AccessKey Secret

AccessKey IDとセットです。作成時に保存してください。後から確認できません。

Agent IDについて：統合する各サイトに対して、Alibaba Cloud百炼でナレッジベースとエージェントを個別に作成する必要があります。作成後、管理パネルの「サイト管理」でAgent IDとナレッジベースIDを入力してください。

ウェブサイト統合

インストール後、チャットウィンドウをウェブサイトに埋め込むことで、訪問者がページを離れずに会話を開始できます。

ステップ1：サイトを作成

管理パネルにログインし、「サイト管理」で新しいサイトを作成してウェブサイトのドメインを入力します。システムが一意のクライアントコードを生成します。

ステップ2：コードを埋め込む

ウェブサイトHTMLのタグの前に以下のスニペットを貼り付けます。YOUR_LOCALEを言語コード（例：ja）に、YOUR_CLIENT_CODEをサイトのクライアントコードに置き換えてください：

<script>
  (function() {
    var btn = document.createElement('a');
    btn.href = 'https://your-domain.com/YOUR_LOCALE/chat?client=YOUR_CLIENT_CODE';
    btn.target = '_blank';
    btn.rel = 'noopener noreferrer';
    btn.title = '联系客服';
    btn.style.cssText = 'position:fixed;bottom:24px;right:24px;width:56px;height:56px;border-radius:50%;background:#2563eb;display:flex;align-items:center;justify-content:center;box-shadow:0 4px 16px rgba(37,99,235,.45);z-index:9999;transition:transform .15s';
    btn.innerHTML = '<svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="#fff" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/></svg>';
    btn.onmouseover = function(){ btn.style.transform = 'scale(1.1)'; };
    btn.onmouseout  = function(){ btn.style.transform = 'scale(1)'; };
    document.body.appendChild(btn);
  })();
</script>

ステップ3：ナレッジベースを設定

Alibaba Cloud百炼でナレッジベースを作成し、業務文書をアップロードしてQ&Aエージェントを作成します。その後、管理パネルの「サイト管理」でAgent IDを入力すると、AIが訪問者の質問に自動返信します。