REST API を使用して ServiceNow AI エージェントを呼び出す方法

[JunshuO]

ServiceNow の AI エージェントの最も強力な機能の 1 つは、単独で作業する必要がないことです。問題を検出してインシデント作成エージェントに自動的に渡す監視エージェントや、複雑なケースを専門のハンドラーに転送するトリアージエージェントを想像してみてください。これはエージェント間 (A2A) コミュニケーションの実践であり、サイロを取り除き、真に自律的なエンタープライズワークフローを構築するための最もエレガントな方法の 1 つです。

しかし、実際には内部でどのように機能するのでしょうか。その仕組みを掘り下げていきましょう。

エージェントを検出可能にする

エージェントが互いに通信できるようにするには、事前に明示的に許可する必要があります。これは次の 2 か所で発生します。

まず、AI エージェント自体で、切り替えを有効にします。 「サードパーティにこのエージェントへのアクセスを許可します。」 これはドアを開けると考えてください。

次に、AI エージェントスタジオ > 設定 に移動し、 「サードパーティに AI エージェントへのアクセスを許可する (非同期)」 これにより、ServiceNow インスタンスに対し「外部エージェントからのアクセスを許可します」と通知されます。

両方が設定されると、インスタンスは A2A 通信の準備が整います。これらのトグルがないと、エージェントはロックされたままになります。これはセキュリティ上の適切なデフォルト設定です。

2 つの重要な API

ServiceNow には、すぐに利用可能な 2 つの REST API が用意されています。それらはペアとして機能します。

1. エージェントカード API (エージェントカード - ダイレクトディスカバリー)：これはディスカバリーです。あるエージェントが別のエージェントと話したい場合、最初に「何ができますか?」と尋ねます。エージェントカード API は、次のような詳細な応答を返します。
• エージェント名と説明
• プロトコル情報
• 利用可能なツールとスキル (以下「機能」といいます)
• エージェントを実際に呼び出すために使用する URL

これはエージェントの履歴書と考えてください。エージェントが処理できるタスクを他のエージェントに正確に伝えます。

2. 呼び出し API (AI エージェント A2A V2)：エージェントができることがわかったら、この API を使用して実際にエージェントを呼び出します。メッセージを送信すると、エージェントがそれを処理し、結果が返されます。

JSON-RPC と入力メッセージの構造を理解する

呼び出し API は、このユースケースに最適な軽量プロトコルである JSON-RPC 2.0 を使用します。一般的な要求は次のようになります。

• メソッド：通常は「message」（エージェントにメッセージを送信するため）
• ID：この特定のメッセージの一意の識別子です。これは、複数のメッセージを送信する場合に非常に重要であり、応答を要求に一致させることができます。
• パラメーター：実際のペイロードです。次の 2 つのセクションに分かれています。

戻ってくるもの

応答は同じ JSON-RPC 構造に従います。重要な点は次のとおりです。

• ID：要求 ID と一致するため、正しい応答が表示されていることを確認できます。
• 結果：
• state：「completed」（エージェントがタスクを完了）または「input-required」（エージェントが監視対象として設定されている場合、詳細情報や承認を待機）のいずれか
• context_id、message_id、reference_task_id：フォローアップメッセージを送信する場合に再利用する ID
• 実際のタスク結果
• provider：外部エージェントであることを示します

これが重要な理由

従来のワークフローでは、人間がシステム間でタスクをルーティングしていました。A2A API を使用すると、エージェントがルーティングを実行できます。1 つのエージェントが複数のダウンストリームエージェントを生成し、調整し、インテリジェントにエスカレートできます。次のものが得られます。

• 応答時間の短縮：人間がルーティングするのを待つ遅延はありません。
• 複雑なオーケストレーション：複数のエージェントをシームレスにチェーンします。
• エラー処理：エージェントは応答を処理し、再試行またはエスカレートできます。
• 監査記録：すべてのメッセージは ID とコンテキストで追跡されます。

エージェントを構築している場合、これは必須のナレッジです。エンタープライズ自動化の次の波は、エージェント間のコミュニケーションに基づいて実行され、これでそれを構築する方法がわかりました。

---

この記事は機械翻訳されております。最新は元となる記事をご覧ください: https://www.servicenow.com/community/developer-advocate-blog/how-to-call-a-servicenow-ai-agent-using...。

免責事項: 一部の日本語は、翻訳ソフトウェアを使用してお客様の便宜のために翻訳されています。正確な翻訳をご提供できるよう相当な努力を払っておりますが、いかなる自動翻訳も人間の翻訳者に代わすることはなく、そのようなことは意図されておりません。翻訳は「現状のまま」提供されています。他言語への翻訳の的確性、信頼性または正確性については、明示または黙示を問わず、いかなる保証も行われません。翻訳ソフトには限界があるため、一部のコンテンツが正確に翻訳されていない場合があります。これらの資料の公用言語は英語です。翻訳の際に生じる相違または不一致は、コンプライアンスまたは履行の目的に関しては拘束力を有さず、法的効力はないものとします。

This article was machine translated and replicated from the original source: https://www.servicenow.com/community/developer-advocate-blog/how-to-call-a-servicenow-ai-agent-using...。

[JunshuO]

ServiceNow の AI エージェントの最も強力な機能の 1 つは、単独で作業する必要がないことです。問題を検出してインシデント作成エージェントに自動的に渡す監視エージェントや、複雑なケースを専門のハンドラーに転送するトリアージエージェントを想像してみてください。これはエージェント間 (A2A) コミュニケーションの実践であり、サイロを取り除き、真に自律的なエンタープライズワークフローを構築するための最もエレガントな方法の 1 つです。

しかし、実際には内部でどのように機能するのでしょうか。その仕組みを掘り下げていきましょう。

エージェントを検出可能にする

エージェントが互いに通信できるようにするには、事前に明示的に許可する必要があります。これは次の 2 か所で発生します。

まず、AI エージェント自体で、切り替えを有効にします。 「サードパーティにこのエージェントへのアクセスを許可します。」 これはドアを開けると考えてください。

次に、AI エージェントスタジオ > 設定 に移動し、 「サードパーティに AI エージェントへのアクセスを許可する (非同期)」 これにより、ServiceNow インスタンスに対し「外部エージェントからのアクセスを許可します」と通知されます。

両方が設定されると、インスタンスは A2A 通信の準備が整います。これらのトグルがないと、エージェントはロックされたままになります。これはセキュリティ上の適切なデフォルト設定です。

2 つの重要な API

ServiceNow には、すぐに利用可能な 2 つの REST API が用意されています。それらはペアとして機能します。

1. エージェントカード API (エージェントカード - ダイレクトディスカバリー)：これはディスカバリーです。あるエージェントが別のエージェントと話したい場合、最初に「何ができますか?」と尋ねます。エージェントカード API は、次のような詳細な応答を返します。
• エージェント名と説明
• プロトコル情報
• 利用可能なツールとスキル (以下「機能」といいます)
• エージェントを実際に呼び出すために使用する URL

これはエージェントの履歴書と考えてください。エージェントが処理できるタスクを他のエージェントに正確に伝えます。

2. 呼び出し API (AI エージェント A2A V2)：エージェントができることがわかったら、この API を使用して実際にエージェントを呼び出します。メッセージを送信すると、エージェントがそれを処理し、結果が返されます。

JSON-RPC と入力メッセージの構造を理解する

呼び出し API は、このユースケースに最適な軽量プロトコルである JSON-RPC 2.0 を使用します。一般的な要求は次のようになります。

• メソッド：通常は「message」（エージェントにメッセージを送信するため）
• ID：この特定のメッセージの一意の識別子です。これは、複数のメッセージを送信する場合に非常に重要であり、応答を要求に一致させることができます。
• パラメーター：実際のペイロードです。次の 2 つのセクションに分かれています。

戻ってくるもの

応答は同じ JSON-RPC 構造に従います。重要な点は次のとおりです。

• ID：要求 ID と一致するため、正しい応答が表示されていることを確認できます。
• 結果：
• state：「completed」（エージェントがタスクを完了）または「input-required」（エージェントが監視対象として設定されている場合、詳細情報や承認を待機）のいずれか
• context_id、message_id、reference_task_id：フォローアップメッセージを送信する場合に再利用する ID
• 実際のタスク結果
• provider：外部エージェントであることを示します

これが重要な理由

従来のワークフローでは、人間がシステム間でタスクをルーティングしていました。A2A API を使用すると、エージェントがルーティングを実行できます。1 つのエージェントが複数のダウンストリームエージェントを生成し、調整し、インテリジェントにエスカレートできます。次のものが得られます。

• 応答時間の短縮：人間がルーティングするのを待つ遅延はありません。
• 複雑なオーケストレーション：複数のエージェントをシームレスにチェーンします。
• エラー処理：エージェントは応答を処理し、再試行またはエスカレートできます。
• 監査記録：すべてのメッセージは ID とコンテキストで追跡されます。

エージェントを構築している場合、これは必須のナレッジです。エンタープライズ自動化の次の波は、エージェント間のコミュニケーションに基づいて実行され、これでそれを構築する方法がわかりました。