Optimizely CMS 12 の TinyMCE 向け OpenAI 主導 AI アシスタント ~ Adnan のコード ネクサス

インストール

以下のコマンドは、Optimizely プロジェクトにアドオンをインストールします。

dotnet add package A2Z.Optimizely.Tiny.AI

構成

OpenAI 構成を内部に追加します アプリ設定.json:

{
  "OpenAI": {
    "ApiKey": "YOUR_API_KEY",
    "Model": "gpt-4o-mini"
  }
}

このモジュールは、必要なサービス、API コントローラー、TinyMCE プラグインを自動的に登録します。

サービス登録

このパッケージは、初期化モジュールを通じて OpenAI サービス、サーキット ブレーカー、および認証サービスを自動的に登録します。

[ModuleDependency(typeof(InitializationModule))]
public class AiInitialization : IConfigurableModule
{
    public void ConfigureContainer(ServiceConfigurationContext context)
    {
        context.Services.AddHttpClient();
        context.Services.AddSingleton();
        context.Services.AddSingleton();
    }
}

使用法

インストールして構成すると、編集者には TinyMCE ツールバー内に新しい AI アシスタント ボタンが表示されます。

仕組み:

1. TinyMCE エディター内のコンテンツを選択します。
2. [AI アシスタント]ボタンをクリックします。
3. アクション (書き換え、改善、要約、拡張、翻訳) を選択します。
4. 必要に応じて言語を指定します。
5. 変更を適用すると、HTML が即座に置き換えられます。

AI は選択された HTML を処理し、リンクと書式を保持した有効な HTML のみを返します。

安全

Tiny.AI へのアクセスは、次の役割のユーザーに制限されています。

• Cmsエディター
• 管理者

認可はサーバー側で検証され、許可されたユーザーのみが AI 機能を呼び出せることが保証されます。

回復力とパフォーマンス

Tiny.AI は実稼働環境向けに構築されており、以下が含まれます。

• 一時的な API エラーに対する再試行ロジック
• レート制限のための指数関数的バックオフ (429 件の回答)
• 繰り返しの故障後のサーキットブレーカー保護
• モニタリングのための構造化されたロギング
• トークン使用状況の追跡
• リクエストごとの推定コストの計算

複数の連続した障害が発生した場合、サーキット ブレーカーは AI 呼び出しを一時的に無効にして、システムの安定性を保護します。

コストの透明性

各リクエストは以下を返します:

• プロンプトトークン
• 完了トークン
• 総トークン数
• 推定コスト

これにより、AI の使用状況が可視化され、チームは支出を効果的に監視できるようになります。

APIエンドポイント

POST /api/editor/ai/action

リクエストの例:

{
  "action": "rewrite",
  "html": "
Some content
",
  "language": "en"
}

応答例:

{
  "html": "
Rewritten content...
",
  "tokens": 512,
  "cost": 0.0003
}

Tiny.AI を選ぶ理由

AI はコンテンツ チームにとって不可欠な生産性ツールになりつつあります。 Tiny.AI は、セキュリティ、HTML の整合性、運用上の回復力を維持しながら、OpenAI を Optimizely CMS ワークフローに直接統合します。

外部ツールの必要性がなくなり、編集ワークフローが高速かつクリーンで完全に統合された状態が維持されます。