AI相談チャットのサンプルをデプロイする

WebspaceのAI応答機能をオンにし、デプロイの際に生成されるchat.htmlで、相談の流れを確認します。この構成では、Webspaceごとに新しいモデルやAgentを作成する代わりに、管理者がすでに設定しているモデルとAgent実行パイプラインを使用します。

始める前に

必要な権限：スキーマとAPIをデプロイできるユーザー
サーバー管理者がAIプロバイダーを接続し、使用するチャットモデルを登録して有効化しておく必要があります。
AI応答の使用権限を付与するメンバー、レベル、チーム、または管理者の条件を決めます。
chat.htmlを使用するメンバーは、同じSetFNサイトにログインできる必要があります。
相談に使用するデータの公開範囲と、システム指示を確認します。

管理者のAIモデルを準備する

管理者設定でAIプロバイダーを接続し、相談に使用するチャットモデルを登録して有効化します。Webspaceの優先モデルと代替モデルを空欄にしておくと、サーバーが、使用できる状態にある有効なチャットモデルを優先して自動的に選択します。画像を含むリクエストには、管理者が設定したOCR/VLモデルの優先順位も反映されます。

特定のWebspaceでモデルを固定する必要がある場合にのみ、詳細設定の優先モデルと代替モデルを指定します。Webspaceの画面やchat.htmlには、プロバイダーのキーやモデルの秘密情報を入れません。相談画面はデプロイされたAI機能接続を呼び出し、モデルの選択とAgentの実行は、既存のサーバーのパイプラインに従います。

AI応答の詳細設定を構成する

スキーマのAPIビルドでAI応答をオンにしてから、詳細設定を開きます。

AI応答機能をオンにします。
特定のモデルを指定する必要がなければ、優先モデルと代替モデルを空欄のままにします。
ツールが必要な場合は、ツール使用をオンにします。デフォルトはオフです。
相談の範囲と回答の原則を、システム指示に入力します。
使用権限を設定します。
相談チャットのサンプルを生成をオンにします。

スキーマファイルには、最後の項目が次の構造で保存されます。

{
  "apiBuild": {
    "features": {
      "ai-chat": {
        "enabled": true,
        "sampleChat": true
      }
    }
  }
}

sampleChatは、サンプル画面を生成するかどうかだけを決めます。既存の管理者モデルとAgentの設定を複製したり、上書きしたりすることはありません。

AI応答のenabledとsampleChatがどちらもtrueで、デプロイにフロントエンドのサンプルを含めると、chat.htmlが生成されます。クライアント配布パスを指定して、スキーマをデプロイします。chat.htmlは、index.htmlとtest.htmlが作成される現在のフロントエンドサンプルの生成フォルダに一緒に保存され、AI相談専用のフォルダが別に作成されることはありません。

相談サービス/
├── index.html
├── test.html
├── chat.html
├── style.css
└── README.md

同じSetFNサイトにメンバーとしてログインしてからchat.htmlを開き、次の項目を確認します。サンプルは現在のログインセッションでメンバー情報を初期化するため、匿名の公開チャットとして動作すると想定してはいけません。

AI応答の使用権限がないメンバーには、リクエストが許可されないことを確認します。
権限のあるアカウントでメッセージを送信します。
回答が、既存の管理者モデルまたはAgentパイプラインを通じて届くことを確認します。
ツール使用をオンにした場合は、許可した範囲内でのみツールが実行されることを確認します。
接続が切れたときに、エラー状態が表示され、メッセージが重複しないことを確認します。

相談画面を仕上げる

自動生成されたchat.htmlは、接続と権限を確認するための出発点です。案内文、おすすめの質問、画面のスタイルは、サービスの目的に合わせて修正できます。接続先のアドレス、認証の処理、サーバーが管理するモデル選択のロジックは、任意にクライアント側の設定へ置き換えることはしません。

確認されていない内容をAIが断定しないように、システム指示に、相談の範囲と、わからない質問への対応方法を書きます。運用を始める前に、実際の権限ごとのアカウントで、質問、ツールの呼び出し、エラー応答を確認します。

注意事項

chat.htmlはサンプルのクライアントであり、別のAIモデルやAgentを作成することはありません。
優先モデルと代替モデルを空欄にしておくと、サーバーが、管理者設定と使用可能なモデルの状態に応じてモデルを自動的に選択します。
サンプルの生成とAgentプロトコルの接続だけでは、実際のAIプロバイダーからの回答は保証されません。運用を始める前に、サーバーに設定されているプロバイダー、モデル、またはAgentに実際のメッセージを送信し、応答を確認します。
サンプルは既存のAI Agentプロトコルを使用し、ツールの実行状態、承認待ち、追加入力待ちの案内を表示します。ただし、承認や追加入力を完了するためのUIそのものは提供しません。
ツール使用は、デフォルトではオフになっています。ツールをオンにする前に、そのAgentが要求する承認や追加入力を処理する別のUIがあるかどうかを確認します。
サンプルにはメンバーのログインとセッションの初期化が必要であり、匿名での公開利用は保証されません。
ツールの使用権限と、AI応答の使用権限は、区別して確認します。
相談の入力に個人情報や秘密情報を入れないように、別途案内を用意します。
サンプルを修正した後にもう一度デプロイするときは、ファイルが上書きされる範囲を確認します。