機械翻訳について

ワークフローを呼び出す統合の設計

Agentic AIでループ・ワークフローでヒューマンを使用するには、ワークフローをコールする統合を作成する必要があります。

前提条件:

  • プロジェクトの作成 「Oracle Integration 3での統合の使用」「プロジェクトの作成またはインポート」を参照してください。
  • ループ・ワークフローでヒューマンを作成します。 ワークフローには、関連付けられたフォームとタスクに割り当てられたユーザーが少なくとも1つ存在する必要があります。 ワークフローおよびフォームは「アクティブ」状態である必要があります。 詳細は、次の項を参照してください。
  • RESTアダプタを使用してRESTトリガー接続を作成します。

    REST接続は、トリガー・ロールで構成し、セキュリティ・ポリシーとしてOAuth 2.0または基本認証を使用する必要があります。 Oracle Integration 3でのRESTアダプタの使用接続の作成を参照してください。

統合を作成する前に、次の点に注意してください:

  • 統合は非同期タイプである必要があります。つまり、統合のエンドポイントはレスポンスを受信しません。
  • 統合は、常にRESTトリガー接続から開始する必要があります。
  • RESTトリガー接続は、次のように構成する必要があります。
    • POST動詞
    • JSONリクエスト・ペイロード

ワークフローを呼び出す統合の設計

  1. プロジェクトのオープン
    1. ナビゲーション・ペインで、「プロジェクト」を選択します。
    2. プロジェクト名を選択します。
  2. 統合の作成
    1. 左側のツールバーで、「統合」 統合アイコンを選択します。
    2. 「統合」セクションで、「追加」(統合が設計されていない場合)または「+」(1つ以上の統合が設計されている場合)をクリックします。
      「統合の追加」パネルが表示されます。
    3. 「作成」をクリックし、「アプリケーション」を選択します。
    4. 統合の名前を入力し、必要に応じてその他の説明情報を入力します。
    5. 「作成」をクリックします。

      統合キャンバスが開きます。

  3. 統合を開始するRESTトリガー接続を構成します。
    1. 「Plus」アイコンをクリックし、表示されるダイアログで、以前に作成したRESTトリガー接続を選択します。
      「基本情報の構成」ページが表示されます。
    2. 「エンドポイントに何をコールしますか。」フィールドにわかりやすい名前を入力し、「続行」をクリックします。
    3. 「リソース構成の構成」ページで、次の詳細を入力し、「続行」をクリックします。
      1. 操作名の指定: 操作名を入力します。
      2. この操作は何を行いますか。: 操作の目的の簡単な説明を指定します。
      3. エンドポイントの相対リソースURIとは何ですか。: エンドポイントの相対パスを入力します。
      4. エンドポイントに対して実行するアクション: 「POST」を選択します。
      5. このエンドポイントのパラメータの追加および確認: このオプションを選択します。
      6. このエンドポイントのリクエスト・ペイロードの構成: このオプションを選択します。
    4. 「リクエスト・パラメータの構成」ページで、リクエスト・パラメータを追加し、そのデータ型を選択します。

      ノート:

      このパラメータは、ヒューマン承認タスクの完了後にAIエージェントがレスポンス/更新を取得するために使用するコールバックURLを指定します。
    5. 「続行」をクリックします。
    6. 「リクエストの構成」ページで、次を入力して「続行」をクリックします。
      1. リクエスト・ペイロード形式をJSONとして選択します。
      2. <<inline>>をクリックしてJSONペイロードをコピー・アンド・ペーストし、完了したら「OK」をクリックします。
    7. 「サマリー」ページで「終了」をクリックします。
  4. 「Human in the loop」アクションを統合に追加して、ワークフローをコールします。
    1. 「アクション」 統合アクション・アイコンをクリックして、「アクション」パネルを開きます。
    2. パネルの「コール」セクションから、「Human in the loop」アクションをドラッグし、要素間の接続矢印の上にカーソルを置くと表示される「Plus」アイコン記号にドロップします。
      または、接続矢印の上にカーソルを置き、表示される「Plus」アイコン記号をクリックし、ダイアログ・ボックスから「Human in the loop」アクションを選択します。
    3. 表示される構成ウィザードで、ループ・アクションで人間を構成します。
      1. 「基本情報の構成」ページで、次のフィールドに一意の名前と説明を入力します。
        • エンドポイントを呼び出すにはどうすればよいですか。: 一意の名前を入力します。
        • このエンドポイントは何を行いますか。: 説明を入力します。
      2. 「続行」をクリックします。
      3. 「構成」ページで、次のように入力します。
        • 「プロセス」ドロップダウンから、統合がコールするワークフローを選択します。
        • 「バージョン」ドロップダウンから、選択したワークフローの適切なバージョンを選択します。
      4. 「続行」をクリックします。
      5. 「サマリー」ページで、データを確認し、「終了」をクリックします。
    4. 「続行」をクリックします。
    ループ要素のヒューマンが統合に追加されます。
  5. 「Human in the loop」アクションの前に「Map」アクションを追加して、統合からループ・ワークフローのヒューマンに情報を渡します。
    1. 「アクション」 統合アクション・アイコンをクリックして、「アクション」パネルを開きます。
    2. 「マップ」アクションをドラッグし、ループ・アクションで人間の前に接続矢印の上にカーソルを置くと表示される「Plus」アイコン記号にドロップします。
    3. マップ・アクションを選択し、「アクション」アイコンをクリックして「編集」を選択します。 マッパーが開きます。
    4. 左側の「ソース」リストで、ワークフローに渡す必要があるデータ要素が見つかるまでツリーを展開します。
    5. 右側の「ターゲット」リストで、データを受信する必要がある入力が見つかるまでツリーを展開します。
    6. ソース要素をターゲット要素にドラッグします。
      マッピングの詳細は、Oracle Integration 3でのOracle Mapperの使用データのマップを参照してください。
    7. マッピング要素が完了したら、マッピングをテストします。
      「Oracle Integration 3でのOracle Mapperの使用」「マッピングのテスト」を参照してください。
  6. 統合をアクティブ化します。
    統合の設計が完了したら、統合をアクティブ化して、エージェントAIツールを作成できるようにします。 「Oracle Integration 3での統合の使用」「統合のアクティブ化」を参照してください。