1. AI Agent Studioの使用方法
  2. アプリケーションによるFusion Applicationsエージェントへのアクセスの有効化
機械翻訳について

Fusion Applicationsエージェントにアクセスするためのアプリケーションの有効化

Oracle Fusion Cloud Applicationsのエージェントには、/invokeAsync APIを使用して、他のOracle applicationsおよび外部アプリケーションからアクセスできます。

他のOracle Applicationsからのアクセス

/invokeAsync APIを使用するには、OAuth 2.0 Bearerトークンを使用してOracle Cloud Infrastructure Identity and Access Management (OCI IAM)を介して認証する必要があります。 エージェント操作を機能させるには、統合を双方向にする必要があります。 どちらのシステムも、互いのサービスに安全にアクセスする必要があります。

管理者は、Fusion Applications IAMで、他のOracleアプリケーション・サービスを表す機密アプリケーションを作成します。 次に、AI Agent Studioのサービスを表す、他のアプリケーション・サービスに一致する機密アプリケーションを作成します。 これらの2つのアプリケーションは、双方向通信の信頼できるリンクを形成します。

アプリケーション間の双方向信頼の設定

  1. Fusion Applications IAMで機密アプリケーションを作成します。
    このアプリケーションは、Fusion Applications IAMの外部Oracleアプリケーションの表現として機能します。 機密アプリケーションを作成したら、AI Agent Studioサービスへのアクセスを有効にして、このサービスによって公開される/invokeAsync APIをアプリケーションがコールできるようにします。
    • 機密アプリケーションを作成するアイデンティティ・ドメイン(認可サーバー)を識別します。
    • OAuth権限付与タイプを指定します。 たとえば、2-legged OAuthです。
    • アクセス範囲を定義します。
    • アクセス・トークンを生成し、それを使用してREST APIコールを実行します。

    詳細は、「Fusion Applicationsアイデンティティ・ドメインを使用したOAuthの構成」を参照してください。

  2. 外部OracleアプリケーションのIAMに機密アプリケーションを作成します:

    作成した以前の機密アプリケーションと同様に、外部OracleアプリケーションのIAMでFusion Applicationサービスの表現として機能する別の機密アプリケーションを作成します。 機密アプリケーションを作成したら、AI Agent Studioが適切なサービス・エンドポイントをコールできるように構成します。

    詳細は、「Fusion Applicationsアイデンティティ・ドメインを使用したOAuthの構成」を参照してください。

  3. AI Agent Studioで外部OracleアプリケーションのIAMで作成された機密アプリケーションを(ステップ2から)登録します:
    1. AI Agent Studioに移動して、「資格証明」タブを開きます。
    2. 「データ・ソース・アプリケーション」タブに移動し、外部機密アプリケーションの詳細を追加します。
      • ベースURL: 外部APIのベースURLを入力します。
      • IDCS URL: Fusion Applications IAMのURLを入力し、AI Agent StudioでOAuthトークンを取得できるようにします
      • スコープ: OAuthトークンが取得されるたびに付与する必要があるアクセスを指定します。
      • 公開鍵と秘密鍵: 認証要求に署名するための鍵を入力します。 リクエストが信頼できる認可されたソースからのものであることを確認するためにIDCSによって使用されます。
  4. 外部Oracleアプリケーションにアクセスするビジネス・オブジェクトを作成します。
    1. AI Agent Studioで、「ビジネス・オブジェクト」タブを開きます。
    2. 「リソース・タイプ」が「その他のデータ・ソース・アプリケーション」である新しいビジネス・オブジェクトを追加します。
    3. 「Oracleデータ・ソース・アプリケーション」リストから、ステップ3で登録したデータ・ソース・アプリケーションを選択します。

実行時のアクセス・フロー

実行時に、外部Oracleアプリケーションは、構成済の資格証明を使用してFusion Applicationsからアクセス・トークンを取得します。 その後、アプリケーションは、このトークンを使用してAI Agent Studioで/invokeAsync APIをコールし、エージェント・チームへのアクセスを有効にします。

この図は、Fusion Applications、Fusion Applications IAM、AI Agent StudioおよびWMS IAM以外のOracleアプリケーションであるWarehouse Management System (WMS)間の相互作用を示しています。

/invokeAsync APIを使用したWMSとFusion Applications間の相互作用

  • ユーザーはWMSアプリケーションと対話し、チャット・メッセージを送信します。
  • WMSは、構成済の資格証明を使用してFusion Applications IAMからアクセス・トークンをリクエストします。
  • WMSは、AI Agent Studioで/invokeAsync APIをコールし、ユーザーのチャット・メッセージおよびアクセス・トークンを渡します。
  • AI Agent Studioは、WMSが進捗の追跡および応答の取得に使用するジョブIDをWMSに返します。
  • WMS APIをコールするために、AI Agent StudioはWMS IAMからアクセス・トークンをリクエストします。
  • AI Agent Studioは、アクセス・トークンを使用してWMS APIをコールします。
  • WMSは、APIレスポンスとジョブ・ステータスのリクエストを返します。
  • AI Agent Studioはジョブ・ステータスを返します。
  • 最終チャット応答が処理され、ユーザーに配信されます。

外部アプリケーションからのアクセス

/invokeAsync APIを使用して、Fusion Applicationsのエージェントにアクセスします。 詳細は、エージェント・チームのRESTエンドポイントを参照してください。