グループアクションフレームワークの構成

  • リリースバージョン: Australia
  • 更新日 2025年07月31日
  • 所要時間：6分

    • グループアクションフレームワーク (GAF) を設定して、AI エージェントの応答品質、再現率速度、および一貫性を向上させます。

    始める前に

    GAF を構成するには、ml_platform読み取り ACL が必要です。読み取り ACL が存在しない場合は、読み取り ACL を作成し、admin、ml_admin、sn_aia.admin などの適切なロールアクセス権を付与する必要があります。これは、GAF が機械学習のテーブルとサービスにアクセスするために必要です。ACL が正しく構成されていない場合、「パイプラインの初期化に失敗しました:message_contentデータセットのロードに失敗しました。ファイルから解析する列がありません。(No columns to parse from file.)」

    GAF の最適化された予測機能にアクセスするには、AI 検索 でNow Assistを有効にします。詳細については、「 グループアクションフレームワークの AI 検索の設定」を参照してください。

    必要なロール:sn_aia.admin

    このタスクについて

    GAF をアクティブ化して、すべてのレコードではなく、代表的なレコードに対して LLM を実行するインデックス付きクラスターを AI エージェントに使用させることができます。GAF は、一部の AI エージェントとエージェントワークフローによって最適に機能するために使用されます。GAF とその仕組みの詳細については、「 グループアクションフレームワーク」を参照してください。

    異なるエージェントワークフローおよび Now Assist アプリケーションに対して異なるGAF構成を持つことができます。各エージェントワークフローまたはアプリケーションを個別に設定する必要があります。

    重要:
    GAF の設定には、グループ内のレコード数に応じて、10 分から 1 時間かかる場合があります。スクリプトはバックグラウンドで実行されます。

    手順

    1. 移動先 すべて > システム定義 > スクリプト - バックグラウンド.
    2. 次のコードをテキストエリアに貼り付けます。

      groupSkillID 変数と actionSkillID 変数に値が入力されるまで、スクリプトを実行しないでください。値は次の手順で取得されます。

      var groupSkillId = ""; 
var actionSkillId = ""; 
var topicSkillId = "43bce9e477e012103f075cea5b5a998f"; 
new sn_gaf.GAFUtils().activate(groupSkillId, topicSkillId, actionSkillId, "run_once");

      topicSkillId は、すべての GAF セットアップで同じです。

    3. 新しいブラウザータブで、フィルターナビゲーターに「sn_nowassist_skill_config.list」と入力してNow Assistスキル構成 [sn_nowassist_skill_config] テーブルに移動します。
    4. [名前] フィールドに「*grouping」と入力して検索し、エージェントワークフローとNow Assistアプリケーションに関連付けられているグループ化レコードを表示します。

      Now Assist [名前] フィールドの *grouping でフィルタリングされたスキル構成テーブル

    5. 構成するエージェントワークフローまたはアプリケーションのグループ化レコードを開きます。
    6. [ Now Assist 構成変数セット] 関連リストで、[入力のグループ化] レコードを開きます。
    7. グループ化のフィルターに、インデックスを作成するすべてのレコードが含まれていることを確認します。
      GAF セットアップに含まれるレコードを変更するためのフィルターを追加する場合は、ここで行います。含めるレコードが多いほど、セットアップ時間は長くなりますが、結果の品質を向上させるのに役立ちます。クラスタリングを成功させるには、少なくとも 2000 件のレコードが必要です。
      注:
      変更を行うには、現在のスコープをグループアクションフレームワークにする必要があります。

      Now Assist スキル構成変数 変数がインシデントテーブルに設定され、簡単な説明フィールドとフィルターが設定されたレコード ステータスはクローズ済み

    8. Now Assistスキル構成グループ化レコードに戻り、sys_idをコピーします。
      このsys_idと他の 2 つのsys_idsをバックグラウンドスクリプト関数呼び出しで使用します。
    9. バックグラウンドスクリプトのブラウザタブで、groupSkillId 変数の引用符で囲んで、スクリプト内のsys_idを貼り付けます。

      groupSkillId 変数は topicSkillId 変数と同じ形式にする必要があります。

    10. Now Assistスキル構成レコードがあるタブで、[Now Assistスキル構成] テーブルに戻り、「*action strategy」を検索して、アプリケーションのアクション戦略スキル構成を見つけます。
      レコードが同じアプリケーション用であることを確認してください。GAF ITSM グループ化のsys_idを貼り付けた場合は、GAF ITSM アクション戦略を開く必要があります。
    11. 構成しているアプリケーションのアクション戦略レコードを開きます。
    12. アクション戦略レコードのsys_idをコピーします。
    13. バックグラウンドスクリプトのブラウザタブで、actionSkillId 変数の引用符で囲んでスクリプト内のsys_idを貼り付けます。

      actionSkillId 変数は、groupSkillId 変数および topickillId 変数と同じ形式にする必要があります。

      3 つの値がすべて入力された GAF スクリプトが完了しました

    14. [ スクリプトを実行] を選択して、バックグラウンドスクリプトを実行します。

      このバックグラウンドスクリプトを実行すると、「GAF - オフラインフローを実行」というスケジュール済みジョブが作成されます。スケジュール済みジョブは、[スケジュール済みスクリプト実行 [sysauto_script] テーブルで表示できます。

    タスクの結果

    GAF は、その Now Assist アプリケーションのインスタンスで構成されており、AI エージェントが関連レコードを検索するために使用できます。

    次のタスク

    グループ化とアクションの出力が生成されたことを確認するには、ML ソリューション [ml_solution] テーブルに移動して、クラスタリングソリューションが実行中か完了しているかを確認します。完了したら、次のテーブルをチェックして、グループのレコード、クラスター化されたレコード、およびグループごとのダウンサンプリングされたレコードが存在することを確認します。

    • GAF レコードグループ [sn_gaf_record_group]
    • GAF レコードグループの詳細 [sn_gaf_record_group_detail]
    • GAF アクション戦略結果 [sn_gaf_action_strategy_result]

    この手順は、追加のエージェントワークフローおよび Now Assist アプリケーションに対して繰り返すことができます。

    「パイプラインの初期化に失敗しました:message_contentデータセットのロードに失敗しました。No columns to parse from file (ファイルから解析する列がありません)」というエラーが表示されます。これは、インスタンスにテーブルのデータがないか、テーブルから除外されたレコードを設定したフィルターが不足していることが原因である可能性があります。このエラーを解決できない場合は、 Now Support に連絡して追加のサポートを受けることができます。