Optimizely CMS 用に AI Chat をインストールおよび構成する方法 – 完全ガイド

AI Assistant Chat は、Epicweb.Optimizely.AIAssistant のバージョン 3.0 で導入された革新的な機能で、Optimizely CMS 編集エクスペリエンスに会話型 AI を直接導入します。手動でフィールドに入力したり、最適なコンテンツを推測したりする代わりに、ページ、ブロック、メディアを操作しながら AI と自然な会話ができるようになりました。

これは、専門のコンテンツ ストラテジスト、SEO スペシャリスト、テクニカル ライターが 1 つにまとめられ、CMS ツールバー上で 24 時間年中無休で利用できるものと考えてください。

会話型コンテンツ管理の力 – パート 1

この従来のワークフローの代わりに、次のようにします。

1. Open page editor
2. Think about SEO title
3. Write title
4. Check character count
5. Revise
6. Repeat for meta description
7. Manually check accessibility
8. Review content structure

これで次のことができるようになります。

You: "Analyze this page's SEO and suggest improvements"
AI: [Analyzes current page, identifies 3 issues]
You: "Apply those suggestions"
AI: [Updates SEO title, meta description, and heading structure] "Done! Review the changes?"

---

見る: AI チャットの動作

主な利点

生産性の向上

• 10 倍高速なコンテンツ作成 – SEO に最適化されたコンテンツを数秒で生成
• 自動化されたワークフロー – AI に反復的なタスクを処理させます
• 賢い提案 – コンテンツに基づいたインテリジェントな推奨事項を取得します
• 即時操作 – 自然な会話を通じてコンテンツを更新します

コンテンツの品質を向上させる

• SEOの最適化 – AI が検索しやすいタイトル、説明、構造を提案します
• 一貫性 – すべてのコンテンツにわたってブランドの声を維持する
• アクセシビリティ – 自動代替テキストと WCAG 準拠チェック
• 多言語対応 – コンテキスト認識によるシームレスな翻訳

インテリジェントな支援

• コンテキスト認識型 – 自分が取り組んでいることを理解している
• 学習能力 – コンテンツガイドラインに適応します
• リアルタイムヘルプ – CMS を離れることなく回答を得る
• コンテンツ分析 – 読みやすさ、トーン、構造に関する即時フィードバック

強力なツールの統合

• コンテンツの操作 – 会話を通じて作成、読み取り、更新、公開する
• 画像処理 – 代替テキストの生成と画像の分析
• 外部システム – API、データベース、サービスとの統合
• カスタムツール – 独自のビジネス ロジックで拡張します

チームのエンパワーメント

• 参入障壁が低い – 新しい編集者は初日から生産性が高くなります
• 組み込みのベストプラクティス – AI が編集者を高品質なコンテンツに導きます
• 役割ベースのアクセス – AI 機能を使用できるユーザーを制御 (オプション)
• 監査証跡 – AI を利用したすべての変更を追跡

---

前提条件

AI Chat をインストールする前に、次のものが揃っていることを確認してください。

• Optimizely CMS 12.18 以降または Optimizely Commerce 14 以降
• Epicweb.Optimizely.AIAssistant 3.0+ がインストールされている
• OpenAI API キーまたは互換性のある AI プロバイダー (Azure OpenAI、Google Gemini) – これはローカルホストでは必要ありません
• 開発者によるソリューションのソース コードへのアクセス
• .NET 6.0+ (または CMS バージョンと互換性のあるもの)

---

段階的なインストール

ステップ 1: 基本パッケージをインストールする

AI アシスタントをまだインストールしていない場合は、ここから始めてください。

NuGet パッケージ マネージャー コンソール経由:

Install-Package Epicweb.Optimizely.AIAssistant

または .NET CLI 経由:

dotnet add package Epicweb.Optimizely.AIAssistant

NuGet URL:
https://nuget.optimizely.com/package/?id=Epicweb.Optimizely.AIAssistant

---

ステップ 2: 組み込みツール パッケージをインストールする

AI チャットが機能するにはツールが必要です。組み込みツール パッケージは、次のような重要な機能を提供します。

NuGet パッケージ マネージャー コンソール経由:

Install-Package Epicweb.Optimizely.AIAssistant.Tools

または .NET CLI 経由:

dotnet add package Epicweb.Optimizely.AIAssistant.Tools

NuGet URL:
https://nuget.optimizely.com/package/?id=Epicweb.Optimizely.AIAssistant.Tools

なぜツールが重要なのでしょうか? AI はツールを使用して、テキストを生成するだけでなく、コンテンツの取得、プロパティの更新、ページの公開といった実際の操作を実行できるようになります。ツールがなければ、AI は変更を提案することしかできません。ツールを使用すると、実際にそれらを実行できます。

---

ステップ 3: Startup.cs でサービスを構成する

を開きます Startup.cs ファイルを作成し、AI アシスタントを必要なすべてのツール パックに登録します。

using Epicweb.Optimizely.AIAssistant;
using Epicweb.Optimizely.AIAssistant.Tools;
using Epicweb.Optimizely.AIAssistant.Hub;

public void ConfigureServices(IServiceCollection services)
{
    // ... your existing services ...

    services
        .AddAIAssistant()
        // Register built-in tool types for AI Chat functionality
        .RegisterMcpToolType(typeof(BuiltinTools))            // Core helper tools
        .RegisterMcpToolType(typeof(BuiltinChatTools))        // Content reading
        .RegisterMcpToolType(typeof(BuiltinPublishChatTools)) // Publishing operations
        .RegisterMcpToolType(typeof(BuiltinUpdateChatTools))  // Content updates
        .RegisterMcpToolType(typeof(BuiltinChatImageTools))   // Image analysis
        .RegisterMcpToolType(typeof(BuiltinChatCreateImageTools)); // Image generation

    // ... other registrations ...
}

ツールパックの内訳:

ツールパック	目的	操作例
BuiltinTools	コアヘルパーユーティリティ	日付の書式設定、文字列の操作
BuiltinChatTools	コンテンツの読み取り	ページコンテンツの取得、検索、子の一覧表示
BuiltinPublishChatTools	出版	公開、非公開、スケジュール
BuiltinUpdateChatTools	コンテンツ編集	プロパティの更新、下書きの作成
BuiltinChatImageTools	画像操作	画像を分析し、代替テキストを生成する
BuiltinChatCreateImageTools	画像作成	画像の作成方法の説明

---

ステップ 4: SignalR ハブを登録する

AI Chat はリアルタイム通信に SignalR を使用します。ハブエンドポイントを Configure 方法：

using Epicweb.Optimizely.AIAssistant.Hub;

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // ... existing middleware ...

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
        endpoints.MapContent();
        endpoints.MapAIAssistantHub(); // Required for AI Chat
    });
}

重要： それなし MapAIAssistantHub()の場合、チャット ウィンドウは接続に失敗し、エラーが表示されます。

---

ステップ 5: appsettings.json で構成する

AI Chat 設定を appsettings.json:

{
  "Epicweb": {
    "AIAssistant": {
      "ApiKey": "sk-proj-your-openai-api-key-here",
      "Provider": "AzureOpenAI",
      "Model": "gpt-5.2",
      "EnableChat": true,
      "ChatRoles": [
        "AIEditors",
        "WebEditors",
        "WebAdmins",
        "CmsAdmins",
        "CmsEditors"
      ],
      "MaxToolIterations": 8
    }
  }
}

構成オプションの説明:

設定	タイプ	説明	デフォルト
ApiKey	弦	https://platform.openai.com/account/api-keys からの OpenAI API キー	必須
Provider	弦	AIプロバイダー: OpenAI、 AzureOpenAI、 Gemini	OpenAI
Model	弦	使用する AI モデル (以下の推奨事項を参照)	gpt-5.2
EnableChat	ブール	CMS ツールバーで AI チャット ウィンドウを有効にします	false
ChatRoles	弦[]	AI Chat にアクセスできるユーザーの役割 (オプション、指定しない場合は、認証されたすべてのユーザーがアクセスできます)	すべてのユーザー
MaxToolIterations	整数	無限のツール呼び出しループを防止します	8

API キーの取得

1. https://platform.openai.com/account/api-keys に移動します
2. サインアップまたはログイン
3. 「新しい秘密キーを作成」をクリックします。
4. キーをコピーします（で始まります） sk-)
5. に追加 appsettings.json

セキュリティに関するヒント: API キーをソース管理に決してコミットしないでください。使用：

• Azure Key Vault
• 環境変数
• ユーザーの秘密 (dotnet user-secrets set "Epicweb:AIAssistant:ApiKey" "sk-...")

---

ステップ 6: 適切な AI モデルを選択する

致命的： AI Chat には、堅牢なツール呼び出し機能を備えた高度なモデルが必要です。

推奨モデル

オープンAI:

• gpt-5.2 – 最新かつ最高の総合パフォーマンス (推奨)
• gpt-5.1 – 優れたツール調整と推論
• gpt-5 – ツール呼び出しによる安定したパフォーマンス
• gpt-5.5-mini – 優れたツールサポートを備えた予算に優しいオプション

Azure OpenAI:

• gpt-5.2 – OpenAI と同じですが、Azure でホストされます
• gpt-5.1 – 堅牢なエンタープライズ オプション

Googleジェミニ:

• gemini-2.5-pro – 最新の安定バージョン (推奨)
• gemini-2.5-flash – より高速でコスト効率の高いオプション

AIチャット非対応機種

• gpt-4o、 gpt-4-turbo、 gpt-4 – 古い世代、互換性のないツール呼び出し
• gpt-3.5-turbo – 高度なツール調整はありません
• gemini-1.5-pro、 gemini-1.5-flash – 古い Gemini バージョンはサポートされていません

モデルの選択が重要な理由: AI Chat は、高度な関数呼び出しを使用して、複数のツールを複雑なシーケンスで実行します。 GPT-5+ および Gemini 2.5+ モデルのみが、以下に必要な機能を備えています。

• 複数のツール呼び出しを連鎖的に実行する
• エラーを処理し、さまざまなアプローチで再試行します
• 長い会話でもコンテキストを維持する
• 特定のツールをいつ使用するかを理解する

---

ステップ 7: ロールベースのアクセスを構成する (オプション)

デフォルトでは、認証されたすべての CMS ユーザーが AI Chat にアクセスできます。特定のロールへのアクセスを制限するには:

例: 管理者のみに制限する

"ChatRoles": ["CmsAdmins", "WebAdmins"]

例: 特定の編集者の役割を許可する

"ChatRoles": ["CmsEditors", "WebEditors", "AIEditors", "CmsAdmins"]

例: カスタムロール

"ChatRoles": ["ContentCreators", "SEOSpecialists"]

すべてのユーザーに許可するには: 単に省略してください ChatRoles 設定するか、空の配列に設定します。

"ChatRoles": []

Optimizely の管理インターフェイスで次のロールがユーザーに割り当てられていることを確認してください。
管理者 -> グループの管理

---

ステップ 8: インストールの確認

セットアップが完了したら、次のようにします。

1. ソリューションを構築する

   dotnet build
   

2. アプリケーションを実行する

   dotnet run
   

3. Optimizely CMS にログインします
4. AIチャットボタンを探してください CMS ツールバー (通常は右上)
5. クリックしてチャットウィンドウを開きます
6. 簡単なコマンドでテストします。

   "What tools are available?"
   

ツールのリストが表示されたら、おめでとうございます。 AIチャットが動作しています。

次は

これで、AI Assistant Chat がインストールおよび接続され、適切なツール パックが登録され、SignalR が有効になり、プロバイダー設定が適切になりました。ここから、チャットの使用を開始して、ページの分析、SEO の改善、アクセシビリティのチェック、安全でレビュー可能な更新を Optimizely 編集 UI から直接行うことができます。

これはパート 1 であり、インストールとベースライン構成に焦点を当てていました。パート 2 では、構成、カスタム手順、カスタム ツールについて詳しく説明します。

ドキュメントへのリンク: https://github.com/Epicweb-Optimizely/Epicweb.Optimizely.AIAssistant/

スクリーンショットの例