Agent2Agent プロトコルを使用した外部 AI エージェントの作成

AI エージェントスタジオ で外部 AI エージェントを作成して、ServiceNow AI Platform をサードパーティのエージェント AI プロバイダーに接続します。

始める前に

外部エージェントを作成するオプションが表示されない場合は、アドミニストレーターが [ServiceNow に外部 AI エージェントへのアクセスを許可する] を選択していることを確認してください。このオプションは、AI エージェントスタジオ の [設定] ページの 外部 AI エージェント > 検出可能性.

インスタンスには、Zurich パッチ 4 以上が適用されている必要があります。

必要なロール:sn_aia.admin

このタスクについて

AI エージェントスタジオ で外部 AI エージェントを作成することで、サードパーティの AI プロバイダーをServiceNow AI Platformに統合できます。

手順

1. 移動先 すべて > AI エージェントスタジオ > 作成と管理 > AI エージェント.
2. 選択 新規 > 外部.
3. [検出してアクティブ化] ステップで、外部エージェントの AI エージェントプロバイダーを選択し、エージェントを検出します。
   [ 保存して続行 ] を選択して、次の手順に進みます。
   1. 既存のプロバイダーを選択するか、新しいプロバイダーを追加します。

      [新しいプロバイダーの追加] を選択した場合は、フィールドに入力して [保存] を選択する必要があります。

      表 : 1. 新しいプロバイダーフォームのフィールドを追加

      名前	説明
      名前	エージェント AI プロバイダーの名前。
      エージェントカード URL	外部 AI エージェントのエージェントカードを指す URL。URL には well_known/agent_json を含める必要があります。
      [ 詳細設定] の [接続と資格情報エイリアス]	外部 AI エージェントのエージェントカードにアクセスするための認証情報。既存のエイリアスを選択することも、作成することもできます。
      [詳細設定] で、サブフローを選択します	Agent2Agent プロトコルを確立するサブフロー。デフォルトのサブフローで大半のケースが処理されますが、独自のケースを作成することもできます。

   2. [ 外部 AI エージェントを検出 ] を選択して、外部エージェントへの接続を検証します。

      検出が成功すると、エージェントの名前とバージョン番号が [外部 AI エージェントを検出] ボタンの下のページに追加されます。

      

   3. エージェントの名前を選択して、[ Name]、[ Version]、[ Description]、および [ Skills ] フィールドが正しく入力されていることを確認し、[ アクティブ化] を選択します。

      [エージェントカード] タブには、エージェントの JSON 全体が表示されます。

      
4. [スキルとケイパビリティのレビュー (Review skills and capabilities)] ステップで、スキル名が正しいことを確認します。
5. [ 専門分野を定義] ステップで、外部エージェントが ServiceNow エージェント型システムにどのように適合するかの詳細を追加します。
   1. AI エージェントの説明を確認します。

      AI エージェントの説明はそのままにしておくことも、長い説明を追加して他の AI エージェントと区別することもできます。これにより、AI エージェントオーケストレーターが外部 AI エージェントをより効果的に使用できるようになります。AI エージェントの説明を記述するための提案については、「 AI エージェントとエージェントワークフローを作成するための一般的なガイドライン」を参照してください。

   2. 通信モードを [同期] または [非同期] に設定します。

      一部のエージェントは非同期通信をサポートしていません。

      [詳細設定] では、デフォルトのサブフロー、既存のサブフローの使用、またはサブフローの作成を行うことができます。デフォルトのサブフローは、ほとんどの場合に機能します。

   3. AI エージェントの実行、認証用の接続と認証情報エイリアスを選択します。

      外部 AI エージェントの実行エンドポイントにアクセスする認証情報を選択します。既存のエイリアスを選択することも、作成することもできます。作成すると、OAuth または API キー認証を構成するためのオプションを含むモーダルが表示されます。

      

   4. AI エージェントのアクセス制御リスト (ACL) を構成します。
      注:

      ACL は、AI エージェントを検出して実行するためのアクセス権を持つユーザーを決定します。AI エージェントスタジオで作成できる ACL の詳細と、より高度なセキュリティ構成を追加する方法については、「Now Assist AI エージェントでのアクセス制御の実装」を参照してください。

      これは必須の手順です。以前に ACL を作成せずに AI エージェントを構成したことがある場合は、他の変更を加える前に ACL を生成する必要があります。

      表 : 2. AI エージェントにアクセスできるユーザーを定義します

      フィールド	説明
      ユーザーアクセス	AI エージェントへのアクセスが次のオプションによって定義されるユーザーのタイプ: 任意の認証済みユーザー:ログインしているすべてのユーザーが AI エージェントにアクセスできます。 特定のロールを持つユーザー:少なくとも 1 つのロールがアサインされているユーザーは、AI エージェントにアクセスできます。このオプションがデフォルトです。 注: ユーザーが AI エージェントにアクセスできない場合、またはユーザーがそれぞれのエージェントワークフロー実行で少なくとも 1 つの AI エージェントにアクセスできない場合は、最初の AI エージェントが開始される前に実行全体が中止されます。 公開:ログインしなくても、すべてのユーザーが AI エージェントにアクセスできます。このオプションは、ゲストが AI エージェントにアクセスできるようにする場合にのみ使用します。
      ロール	ドロップダウンメニューから 1 つ以上の特定のロールをアサインします。 注: ロールの選択は、[ 特定のロールを持つユーザー (Users with specific roles user access)] を選択した場合にのみ可能です。

6. [表示を選択] ステップで、AI エージェントを表示する場所と、AI エージェントの実行時にユーザーに表示するメッセージを選択します。
   1. AI エージェントの可用性を選択します。
      正しいロールを持つユーザーが AI エージェントを利用できるようにするには、 Status をアクティブに設定します。
   2. 表示チャネルを選択します。

      仮想エージェントの使用を選択し、AI エージェントにアクセスするアシスタントを指定できます。最初に AI エージェントをテストする場合は、表示チャネルをまだ選択する必要はありません。

   3. AI エージェントの実行中にユーザーに表示する処理中のメッセージを選択します。

      たとえば、 Initiating AI agent 、 Processing record details、 An AI agent is looking into the requestなどです。

   4. AI エージェントをアクティブ化します。

      AI エージェントを検出可能にする場合は、切り替えを選択して AI エージェントをアクティブ化します。最初に AI エージェントをテストする場合は、テストが完了するまで待ってからアクティブ化します。

      このオプションが表示されない場合は、スクロールする必要があります。

   

7. [保存してテスト] を選択して AI エージェントの詳細を保存し、AI エージェントスタジオ の [テスト] ページに移動します。

タスクの結果

外部 AI エージェントが ServiceNow に接続されています。

次のタスク

AI エージェントの実行またはそのデータアクセスをテストできます。新規または既存のエージェント型ワークフローに追加することもできます。エージェント型ワークフローを作成または構成する手順については、「 エージェント型ワークフローの作成 」を参照してください。