AIエージェント: B2B Message Converter - ワークフロー機能のエンリッチとアップロードおよびダウンロード機能

B2Bメッセージ・コンバータAIエージェントを使用して、Fusion Application RESTリソースからの購買オーダーや出荷などのB2Bメッセージの、OAG 7.2.1、OAGIS 10.1、cXML 1.2.007などの業界標準の形式への変換を合理化できます。 ユーザーは、柔軟性とカスタマイズ性を高めるために、マッピング・ファイルのアップロードとダウンロードなど、エージェント内で一連のメッセージング変換ステップを実行できるようになりました。

指示の入力やマッピング・ファイルのアップロードから変換の開始、出力のダウンロードに至るまでのすべてのアクションは、ユーザーフレンドリなAI Agent Studioチャット・インタフェースを介して実行されます。

サンプル・プロンプト

  • 発注書番号12345をOAGに変換
  • 発注書番号12345をOAGISに変換
  • 発注書番号12345をcXMLに変換
  • 出荷番号67891をOAGISに変換
  • アップロードされたマッピング・ファイルを使用した発注番号PSR-240897のOAGへの変換

リクエストが正常に完了したら、ドキュメントをダウンロードし、メッセージ定義およびメッセージ・ログにアクセスして詳細を確認できます。

ダウンロードおよび表示オプション

ダウンロードおよび表示オプション

入力ドキュメント(InputDocument): ファイルのコンテンツは、Oracle Fusion REST APIレスポンスから特別にソーシングされた標準のJSON形式で提供されます。
アウトバウンド・ドキュメント(OutputDocument): このファイルには、変換の選択に応じて、変換されたメッセージがcXML、OAGまたはOAGIS形式で含まれます。
マッピング・ファイル(EventPayload): このファイルは、発注または出荷をJSON形式からcXML、OAG、OAGISなどの標準XML形式に変換するためのデータ変換ルールを定義します。
メッセージ定義: これは、交換されたメッセージの変換ロジックを指定して、Oracle applicationsと取引パートナ間のメッセージの変換方法を定義する構成アーティファクトです。

コラボレーション・メッセージ定義詳細

コラボレーション・メッセージ定義詳細

メッセージ・ログ: ログには、変換の結果がB2Bメッセージ・ページに表示されます。 メッセージIDが関連付けられている間は、実際のメッセージは処理されません。 かわりに、ログは、コンバータ・エージェントによって実行される変換の記録としてのみ、cXML、OAGまたはOAGIS形式として機能します。

メッセージの詳細

メッセージの詳細

エージェントでカスタマイズされたマッピング・ファイルを使用する場合は、下のアイコンをクリックしてJSONマッピング・ファイルをアップロードします:

ファイルをアップロード

ファイルのアップロード

エージェントは、アップロードしたファイルを使用して、発注番号または出荷番号をcXML、OAGまたはOAGIS形式に変換します。

B2Bメッセージ・コンバータ・エージェントは、次のノードおよびノード・タイプを使用します。

ノード名 ノード・タイプ 説明
プロセス・ユーザー入力 LLM このLLMは、ユーザーのプロンプトを解析して、関連するドキュメントの詳細を抽出し、入力を検証し、必要なフォーマットを特定し、エラーを管理しています。 ユーザーが問題を迅速に修正し、文書変換ワークフローを進めることができるように、構造化されたフィードバックで応答します。
ユーザー入力の検証 IF条件 この条件は、入力エラーをチェックします。
追加詳細の要求 人的承認 このノードは、一部の必須入力が指定されていないことを示します。 ユーザーは、欠落している情報を入力するように求められます。

ファイル・アップロードが必要

IF条件

このノードは、ユーザー入力の処理中にマッピング・ファイルが検出されたか、存在として示されたかを確認するために使用されます。

ファイル・プロセッサ

エージェント

ファイルが存在する場合、エージェントはマルチファイル・プロセッサ・ツールを使用してファイルをアップロードし、ファイル・コンテンツを「ファイル・コンテンツの設定」ノードに戻します。

ファイル・コンテンツの設定

コード

 このコードは、マッピング・ファイルが正常に検出されて読み取られたかどうかをチェックします。 ファイル・コンテンツが見つかった場合は、ファイル・コンテンツをクリーンアップし(存在する場合は余分な引用符を削除)、メッセージ・オプション文字列に新しいオプションとして含めます。 更新された文字列は、さらに処理したり、ダウンストリーム・システムに送信したりするために使用できます。

文書の変換

ビジネス・オブジェクト機能

このノードには、変換を実行するためのRESTコールが含まれています。

変換要約応答

LLM

 このノードは、ドキュメント変換が機能したかどうかをチェックし、ドキュメントまたはダウンロード・リンクのリストと成功メッセージ、または詳細を含むエラー・メッセージを表示します。

エージェントはメッセージ定義を利用して、メッセージ変換を自動化および標準化します。一方、B2Bメッセージ・ページでは、各変換の結果が記録されます。 PO番号または出荷番号を指定する場合でも、ファイルをアップロードする場合でも、エージェントは取引パートナの要件を満たすようにデータを効率的に変換およびフォーマットします。

有効化および構成ステップ

AI Agent Studioを使用して、事前構成済エージェント・テンプレートを使用またはコピーし、ビジネス・プロセスのエージェントを作成できます。 エージェント・チームのすべてのアーティファクトに接尾辞を自動的に追加するには、「テンプレートの使用」ではなく「テンプレートのコピー」を使用できます。 テンプレートをコピーすると、エージェント・チーム・キャンバスに直接移動し、エージェント・チームの設定、エージェント、ツールおよびトピックを編集できます。 「テンプレートの使用」オプションを使用すると、エージェント・チームの各アーティファクトを構成するためのステップバイステップのプロセスを実行できます。

エージェント・テンプレート: B2Bメッセージ・コンバータ

B2Bメッセージ・コンバータ・テンプレート

B2Bメッセージ・コンバータ・テンプレート

AI Agent Studioの使用の詳細は、AI Agent Studioの使用方法を参照してください

ヒントと考慮事項

  • この更新では、B2Bメッセージ・コンバータAIエージェントは、事前出荷通知と購買オーダー・アウトバウンドの2つの文書タイプをサポートしています。
  • プロンプトで指定する発注番号または出荷番号がコラボレーション・メッセージングにメッセージとして存在しない可能性があります。 プロンプトが実行される環境にのみ存在する必要があります。
  • プロンプトには、ドキュメント タイプと対応するドキュメント番号の両方を含める必要があります。
  • エージェントは、新しい接続を確立したり、追加の設定を実行したり、取引パートナにメッセージを送信したりしません。 メッセージ定義は必要な出力形式を決定するためにのみ使用されますが、B2Bメッセージ・ページは、エージェントによって実行されるすべての変換を記録するために使用されます。
  • エージェントは、選択した変換形式(cXML、OAGまたはOAGIS)に基づいて、次のJSONベースのマッピング・メッセージ定義を使用します。
    • JSON_TO_cXML-1-2-007_OrderRequest_Out 
    • JSON_TO_OBN-OAG_PROCESS_PO_007_Out 
    • JSON_TO_OAGIS_10.1_PROCESS_PO_OUT 
    • JSON_TO_OAGIS_10.1_PROCESS_SHIPMENT_OUT 

ノート:これらのマッピング・ファイルのいずれかをカスタマイズし、変更をアップロードするために重複メッセージ定義を作成した場合、エージェントは変換中に最新の重複メッセージ定義を使用します。

アクセス要件

Fusion ApplicationsのOracle AI Agent StudioにアクセスしてSCM AIエージェントを管理するには、次の職務ロールを含む構成済ジョブ・ロールがユーザーに割り当てられている必要があります:

  • SCM Intelligent Agent Management Duty (ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTYおよびORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY_HCM - 両方の職務ロール・コードが必要)

  • Fai GenaiエージェントSCM管理者職務(ORA_DR_FAI_GENERATIVE_AI_AGENT_SCM_ADMINISTRATOR_DUTY)

セキュリティ・コンソールで、ロールおよび権限でフィルタして「SCMインテリジェント・エージェント管理職務」ロールを見つけます。 ロールおよび権限グループでフィルタして、「Fai GenaiエージェントSCM管理者職務」ロールを検索します。

製品ページでAIエージェントと対話するには、次の職務ロールを含む構成済ジョブ・ロールがユーザーに割り当てられている必要があります:

  • Fai Genaiエージェント・ランタイム職務(ORA_DR_FAI_GENERATIVE_AI_AGENT_RUNTIME_DUTY)

セキュリティ・コンソールで、ロールおよび権限グループでフィルタしてこの職務ロールを見つけます。

ユーザーがエージェントと対話できるようにするには、セキュリティ・コンソールで、「Fai Genaiエージェント・ランタイム職務」ロールを含むユーザーの構成済ジョブ・ロールに対して権限グループを有効にする必要もあります。 構成したジョブ・ロールの基本情報を管理するときに、権限グループを有効にできます。

ユーザーの構成済ジョブ・ロールには、AIエージェントが有効になっているページへのアクセスを許可する権限も含まれている必要があります。