18.8.4.4 AIアシスタントを表示する動的アクションの作成

AIアシスタントを表示する動的アクションを作成します。

ノート:

AIアシスタントを表示する動的アクションを追加する前に、「アプリケーションへの生成AIの組込みについて」で説明されているステップを完了しておく必要があります。生成AIサービスの作成またはアプリケーションの編集を行わないと、AI属性はエラーになります。

次の簡単な例では、AIアシスタントをダイアログに表示するボタンにフックされた動的アクションを作成します。この例では、限られた数の属性のみを示しています。この例では、アプリケーションとページがすでに作成されていることを前提としています。

AIアシスタントを表示する動的アクションを追加するには:

1. アプリケーション・ページに移動します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. ボタンを含めるリージョンを作成します:
   1. 「本文」を右クリックし、コンテキスト・メニューから「リージョンの作成」を選択します。
      ページ・デザイナで、リージョン属性を編集します。
   2. 識別、名前 - リージョン名を入力します。タイトル属性が空の場合は、リージョン名が実行時リージョン・タイトルとして使用されます。例: Display AI Assistant Dialog
3. ボタンを作成します:
   1. 作成したリージョンを右クリックし、コンテキスト・メニューから「ボタンの作成」を選択します。
      ページ・デザイナで、ボタン属性を編集します。
   2. 識別、ボタン名 - クリックされているボタンの参照に使用される名前を入力します。この名前はボタンの参照に使用されます。例: AI_ASSISTANT
   3. 「識別」、ボタン・タイトル - ボタンがテキストである場合は、そのボタンに表示されるテキストを入力します。ボタンがイメージである場合、このテキストはイメージのALTテキストになります。たとえば、AI ASSISTANTと入力します。
4. ユーザーがボタンをクリックしたときに起動する動的アクションを作成します:
   1. 左ペインで「動的アクション」タブをクリックします。
   2. 「イベント」で、「クリック」を右クリックし、「動的アクションの作成」を選択します。

      左ペインに「新規」という名前の動的アクションが表示されます。プロパティ・エディタに動的アクション属性が表示されます。

      
      

      
      図ai_create_dynamic_action_generic.pngの説明

      
      
5. プロパティ・エディタで、動的アクション属性を編集します:
   1. 指定、名前 - 動的アクションの名前を入力します。たとえば、Display AI Assistantと入力します。
   2. 時期、イベント - 動的アクションを起動するイベントを指定します。この例では、デフォルトの「クリック」を受け入れます
   3. 時期、選択タイプ - イベントのトリガーに使用するページ要素または構成体のタイプを選択します。この例では、「ボタン」を選択します。
   4. タイミング、ボタン - イベントをトリガーするページ要素または構成体のタイプを選択します。この例では、以前に作成したボタンAI_ASSISTANTを選択します。
6. Trueアクション「表示」を編集します。「動的アクション」タブで、「表示」アクションをクリックします。

   プロパティ・エディタにアクション属性が表示されます。

7. 識別、アクション - 実行するアクションを選択します。

   この例では、「AIアシスタントの表示」を選択します。

   
   

   
   図ai_edit_true_action_generic.pngの説明

   
   
8. 生成AIの属性:
   1. 生成AI、サービス - AIアシスタントで使用される生成AIサービスを選択します。「アプリケーション・デフォルト」では、「AI」ページのアプリケーション属性で指定した生成AIサービスが使用されます。「アプリケーションのAI属性の構成」を参照してください。
   2. 生成AI、システム・プロンプト - AIアシスタントで使用されるシステム・プロンプトを指定します。システム・プロンプトは、AIにコンテキストを提供します。このメッセージはフロント・エンドには表示されませんが、バックエンドのすべてのAIサービス・リクエストに送信されます。

      テキストを入力するか、この属性を「最初のプロンプト」とともに使用して、アプリケーション・アイテム、ページ・アイテムまたはシステム変数を使用して置換を使用できます。

   3. 生成AI、ようこそメッセージ - AIアシスタントで表示されるオプションのようこそメッセージを指定します。たとえば、How may I help you today?と入力します。

      この属性は、アプリケーション・アイテム、ページ・アイテムまたはシステム変数を使用した置換もサポートします

9. 外観の属性:
   1. 外観、表示形式 - AIアシスタントをページにどのように表示するかを選択します。オプションには、「ダイアログ」または「インライン」があります。

      この例では、「ダイアログ」を選択します。

      選択に応じてUIが変更されたことに注意してください。

   2. 外観、タイトル - 「表示形式」が「ダイアログ」の場合にのみ表示されます。ダイアログに表示されるタイトルを入力します。たとえば、Customer Supportと入力します。
10. クイック・アクション、メッセージ- チャット全体のクイック・アクションとして機能するメッセージを入力します。クイック・アクションは事前に定義されている語句で、クリックすると、ユーザー・メッセージとして送信されます。たとえば、I need help with an order?と入力します。
11. そのページを表示します。「ページの保存と実行」をクリックします。
    そのページが表示されます。
12. そのAIアシスタント・ボタンをクリックします。

    AIアシスタントが表示されます。

    
    

    
    図ai_assistant_generic.pngの説明