invokeAsync REST APIを使用したOracle Fusion AIエージェント・チームの統合 (2026/02/20)

2月 19, 2026

invokeAsync REST APIを使用したOracle Fusion AIエージェント・チームの統合 (2026/02/20)

https://www.ateam-oracle.com/integrate-oracle-fusion-ai-agent-team-using-invokeasync-rest-api

投稿者：Rekha Mathew | Cloud Solution Architect | A-Team

Oracle Fusion AI Agent Studioの/invokeAsync APIは、他のアプリケーションからAIエージェントとの非同期通信機能を追加します。外部アプリケーションはこのAPIを使用してOracle Fusion AI Agentチームを呼び出すことができます。

InvokeAysnc APIは、AIエージェントチームにユーザークエリを処理するための非同期リクエストを送信します。最初のAPIレスポンスにはジョブIDが含まれており、クライアントは進行状況を追跡し、準備ができたら結果を取得できます。

手順

Fusion AI Agent Studioでエージェントチームを作成する

AI Agent Studioは、AIエージェントを作成、設定、検証、導入するための設計環境です。エージェントチームは、単一のエージェントまたは複数のエージェントが特定のビジネスタスクを実行したり、ユーザーからの問い合わせに回答したりするために実行する、構造化された一連のステップまたはアクションで構成されます。Fusion AI Agent Studioを使用してエージェントチームを作成する手順については、こちらをご覧ください。

エージェントチームコード、バージョン番号、ステータスをメモしてください。これらは、後でInvokeAsync APIを呼び出す際に使用されます。

機密アプリケーションを作成する

Fusion Applications IAM で、機密アプリケーションを作成するアイデンティティドメインを特定します。
機密アプリケーションを作成します。アプリケーションURLとしてFAホストを入力します。

このアプリケーションをクライアントとして設定し、付与タイプをクライアント資格情報として有効にします

リソースの追加を有効にし、スコープとしてFusion AI Cloud(Spectra)を選択します。

アプリケーションをアクティブ化します。
クライアントIDとクライアントシークレットをメモしてください。これらは次のステップでアクセストークンを生成する際に使用されます。

PostmanでAPIをテストする

Postmanで「New Request」を選択し、メソッドをPOSTに設定します。リクエストAPIでは、IDCSトークンURL <IDCS_host>/oauth2/v1/token を使用します。
[認証]タブを選択し、[タイプ]を[基本認証]に設定します。
最初の手順で作成したIDCSクライアントアプリケーションからクライアントIDとクライアントシークレットを取得します。
ユーザー名をクライアントID、パスワードをクライアントシークレットに設定します。
Bodyタブでx-www-form-urlencodedを選択し、次の2行を追加します:
grant_type = client_credentials
scope = urn:opc:resource:fusion:<your pod>:fusion-ai/
リクエストを送信し、JSON 応答からアクセストークンをコピーします。

FAで新しいユーザーを作成する

セキュリティコンソールに移動して、新しいユーザーを作成します。
IDCS Confidential アプリケーションから取得したクライアント ID をユーザー名として設定します。
ここで説明したように、ユーザーに適切なロールを追加します。

invokeAysnc apiを実行する

認証トークンをベアラートークンとして使用し、API（https://<fusion hostname>/api/fusion-ai/orchestrator/agent/v2/<YourAgentTeamCode>/invokeAsync）にPOSTリクエストを送信します。invokeAysnc APIの詳細については、こちらをご覧ください。

たとえば、リクエストで以下のような JSON 本文を渡します。

バージョンはエージェントチームのバージョンであり、ステータスはエージェントチームのステータスです。

クリップボードにコピーされました

エラー: コピーできませんでした

クリップボードにコピーされました

エラー: コピーできませんでした

{
    "conversational": "true",
    "version": 6,
    "status": "PUBLISHED",
    "message": "how many leaves are pending?"
   
}

サンプル応答は以下のようになります。

クリップボードにコピーされました

エラー: コピーできませんでした

クリップボードにコピーされました

エラー: コピーできませんでした

{
    "input": "{\"workflowCode\":\"TESTAGENTTEAM\",\"message\":\"how many leaves are pending?\",\"conversational\":true,\"conversationId\":\"db55a3dd-4503-4857-b892-c4437253c953\",\"jobId\":\"45af666a-f347-47ad-8d8c-a9de6e4bf58e\",\"invocationMode\":\"END_USER\",\"version\":6,\"status\":\"PUBLISHED\",\"parameters\":{},\"refreshCache\":false,\"useInternalConfig\":false,\"workflowId\":\"300100654452806\"}",
    "output": null,
    "error": null,
    "followUpQuestions": [],
    "jobId": "45af666a-f347-47ad-8d8c-a9de6e4bf58e",
    "conversationId": "db55a3dd-4503-4857-b892-c4437253c953",
    "traceId": "000000000000000042723f56bcb887eb",
    "status": "RUNNING",
    "supportingChunks": [],
    "citations": [],
    "nodes": [],
    "waitingToolCode": null,
    "workflowCode": "TESTAGENTTEAM",
    "workflowVersion": 6,
    "workflowStatus": "PUBLISHED",
    "startDate": 1771373193271,
    "endTime": 0,
    "createDate": "2026-02-18T00:06:33.271+0000",
    "endDate": "1970-01-01T00:00:00.000+0000",
    "timeTaken": 0,
    "inputTokenCount": 0,
    "outputTokenCount": 0
}

JSON 応答のjobIdとconversationIdに注意してください。

Get Status APIは、エージェントチームから返された指定されたジョブIDのステータスを取得します。ステータスがCOMPLETEになるまでこのAPIを呼び出し続けます。以下に示すように、GETリクエストでjobIdを渡します。

認証トークンをベアラートークンとして使用して、ステータスAPI ( https://<fusion ホスト名>/api/fusion-ai/orchestrator/agent/v2/<エージェントコード>/status/<非同期 API リクエストから取得したジョブ ID>)に GET リクエストを実行します。

応答のステータスがCOMPLETEの場合、出力ノードにはエージェントチームからの回答が含まれます。

クリップボードにコピーされました

エラー: コピーできませんでした

クリップボードにコピーされました

エラー: コピーできませんでした

{
    "input": "{\"workflowCode\":\"TESTAGENTTEAM\",\"message\":\"how many leaves are pending?\",\"conversational\":true,\"conversationId\":\"db55a3dd-4503-4857-b892-c4437253c953\",\"jobId\":\"45af666a-f347-47ad-8d8c-a9de6e4bf58e\",\"invocationMode\":\"END_USER\",\"version\":6,\"status\":\"PUBLISHED\",\"parameters\":{},\"refreshCache\":false,\"useInternalConfig\":false,\"workflowId\":\"300100654452806\"}",
    "output": "You currently have 10 leaves pending. If you need any further assistance with your leave balance or requests, feel free to ask!",
    "error": null,
    "followUpQuestions": [],
    "jobId": "45af666a-f347-47ad-8d8c-a9de6e4bf58e",
    "conversationId": "db55a3dd-4503-4857-b892-c4437253c953",
    "traceId": "000000000000000042723f56bcb887eb",
    "status": "COMPLETE",
    "supportingChunks": [],
    "citations": [],
    "nodes": [],
    "waitingToolCode": null,
    "workflowCode": "TESTAGENTTEAM",
    "workflowVersion": 6,
    "workflowStatus": "PUBLISHED",
    "startDate": 1771373193315,
    "endTime": 1771373197119,
    "createDate": "2026-02-18T00:06:33.315+0000",
    "endDate": "2026-02-18T00:06:37.119+0000",
    "timeTaken": 0,
    "inputTokenCount": 0,
    "outputTokenCount": 0
}

エージェントとの会話を続行するには、リクエスト本文にconversationIdも追加して、 invokeAsync API を再度呼び出します。

Fusion アプリケーションを超えてエージェントチームのアクセスを拡張

Postman でテストした後、ここに記載されている手順を使用して、Oracle Fusion Cloud Applications の外部のアプリケーションからエージェントチームにアクセスできるようになります。

このブログを検索

Oracle Cloud Infrastructure Blog(翻訳)