AI Chat Agent

Google Gemini と Function Calling を使った汎用 AI コンシェルジュ プラグイン for WordPress。

サイトに登録された投稿タイプ（カスタム投稿タイプ含む）・固定ページを RAG ソースとして利用し、ユーザーの質問に応じて最適なコンテンツを検索 → カード形式で提示 → お問い合わせフォームへ誘導します。

主な機能

• 管理画面で 公開する投稿タイプを選択 するだけで、対応する検索 / 詳細取得ツールが自動生成されます
• 各投稿タイプに対し 検索対象 ACF メタキー・詳細取得時の追加メタキー・絞り込みタクソノミー を設定可能
• お問い合わせフォーム一覧 を複数登録可能。LLM が会話文脈から最適な窓口を選択
• 対象固定ページ を複数登録するとエージェントがそれらも参照対象に含めます
• ユーザー区分（audience） を任意で定義し、チャット開始時に立場を選んでもらえます（例: 法人 / 個人）
• 本文中のタイトル言及位置に自動でリッチカード挿入 （サムネイル / 抜粋 / メタ情報付き）
• AI 自動初期設定エージェント — Gemini がサイトを調査して初期設定 JSON を提案
• フロントエンド / 管理画面 / 両方 から表示先を選択可能
• システムプロンプトは プレースホルダ対応 ({{site_name}} {{label}} {{content_types}} {{audiences}})

必要なもの

• Google AI Studio で発行した Gemini API キー (https://aistudio.google.com/apikey)
• WordPress 5.5 以上 / PHP 7.4 以上
• （任意）Advanced Custom Fields プラグイン（ACF メタを検索対象に含めたい場合）

インストール

1. このリポジトリを ZIP でダウンロードまたは git clone し、wp-content/plugins/ai-chat-agent/ として配置
2. WordPress 管理画面 → プラグイン → 「AI Chat Agent」を有効化
3. 設定 → AI Chat Agent を開く
4. Gemini API キーを入力し「接続テスト」で疎通確認
5. 対象投稿タイプ セクションで公開する投稿タイプにチェック → ラベル・検索対象メタキー・絞り込みタクソノミーを設定
6. お問い合わせフォーム一覧 で問い合わせ窓口を追加
7. 必要に応じて 対象固定ページ・ユーザー区分 を設定
8. 「チャットボットを有効化」をオンにして保存

または、API キー入力後にトップの 「AI で自動セットアップ」 を押すと、Gemini がサイトを自動調査して初期設定案を提示します（プレビュー → 適用の 2 ステップで完了）。

ディレクトリ構成

ai-chat-agent/
├── ai-chat-agent.php        # プラグインヘッダ + bootstrap
├── readme.txt               # WordPress.org 形式 readme
├── uninstall.php            # アンインストール時の cleanup
├── includes/
│   ├── class-plugin.php     # オプション管理、共通アクセサ
│   ├── class-settings.php   # 設定 API 登録 + sanitize
│   ├── class-ui.php         # フロント / 管理画面のレンダリング
│   ├── class-ajax.php       # チャット AJAX エンドポイント
│   ├── class-gemini-client.php # Gemini API クライアント
│   ├── class-tools.php      # 動的ツール生成（投稿タイプごと）
│   ├── class-agent.php      # エージェントループ
│   └── class-autoconfig.php # 自動初期設定エージェント
├── assets/
│   ├── chat.js / chat.css           # フロントエンド ウィジェット
│   ├── admin-settings.js / .css     # 設定画面
│   └── admin-pickers.js / .css      # 固定ページ / 投稿 ピッカー
└── templates/
    ├── widget.php           # チャットウィジェット HTML
    └── settings-page.php    # 設定画面 HTML

GitHub からの自動アップデート

このプラグインは soderlind/wordpress-github-updater（内部で yahnis-elsts/plugin-update-checker を利用）を組み込んでおり、GitHub Releases に新バージョンが公開されると WordPress 管理画面に更新通知が表示されます。

仕組み

• WordPress が 6 時間ごとに GitHub Releases API をチェック
• このリポジトリの最新タグ（例: v1.0.2）がプラグインヘッダの Version: より新しい場合、管理画面 →「更新」に表示される
• 更新ボタンを押すと、GitHub Release に添付された ai-chat-agent.zip をダウンロードして自動置換

Private リポジトリ運用の場合

GitHub Personal Access Token を wp-config.php で定義してください。

define( 'AICA_GITHUB_TOKEN', 'ghp_xxxxxxxxxxxxxxxxxx' );

Public リポジトリの場合は不要です。

リリース手順（メンテナ向け）

1. プラグインヘッダの Version: と AICA_VERSION 定数を上げる（例: 1.0.0 → 1.0.1）
2. 変更をコミット → push
3. タグを切る:

   git tag v1.0.1
   git push origin v1.0.1

4. GitHub Actions (.github/workflows/release.yml) が自動で:
   • Composer 依存をインストール
   • ai-chat-agent.zip（vendor/ 同梱）を生成
   • 同名タグの GitHub Release を作成し zip を添付
5. WordPress 側は 6 時間以内に更新通知が出ます（手動チェックは「ダッシュボード → 更新 → 再度確認」）

ローカル開発

git clone https://github.com/growgroup/ai-chat-agent.git
cd ai-chat-agent
composer install --no-dev --optimize-autoloader

vendor/ が無くてもプラグイン本体は動作します（自動アップデート機能のみ無効になります）。

ライセンス

GPL-2.0-or-later — 詳細は LICENSE を参照してください。