機械翻訳について

プロンプト・テンプレートを使用したAIエージェントへの動的データの送信

プロンプト テンプレートを使用して、変数データを含むプロンプトを定義します。 AIエージェントを実行するときに、プロンプト・テンプレートを選択し、JSONペイロードを指定します。 プロンプト・テンプレートはペイロードと結合され、Large Language Model (LLM)に送信されます。 プロンプト・テンプレートではLiquid構文を使用します。

例:

  • プロンプト・テンプレートを次のように構成します: レートは{{rateValue}}です
  • 次のJSONペイロードを指定します: {"rateValue":500}
  • LLMに送信されるプロンプトは、「レートは500です」です。

AIエージェントへの動的データの送信

  1. ナビゲーション・ペインで、「プロジェクト」を選択します。
  2. AIエージェントを含むプロジェクトを選択します。
  3. 左側のナビゲーション・ペインで、「AIエージェント」「AIエージェント」アイコンを選択します。
  4. プロンプト・テンプレートを作成します。
    1. 「プロンプト・テンプレート」ボックスで、「追加」をクリックします。

      「プロンプト・テンプレートの作成」パネルが表示されます。

    2. 必須フィールドを構成します。
      • 名前:プロンプト・テンプレートの名前。 テンプレートを使用するタイミングがわかるように、わかりやすい名前を指定します。 たとえば、気象AIエージェントがある場合は、フランスの都市など、様々な国の都市に対してプロンプト・テンプレートを作成できます。
      • 識別子: Oracle Integrationは、名前の値を使用してこの値を生成します。
      • 説明:プロンプト・テンプレートに関する追加情報を提供して、ユーザーがいつ使用するかを把握できるようにします。
    3. 「作成」をクリックします。
      プロンプト・テンプレートの詳細ページが表示されます。
    4. 「プロンプト」で、任意の変数をデータのプレースホルダとして使用してLLMに送信するプロンプトを指定し、「保存」をクリックします。

      Liquid構文を使用します。 たとえば:

      Get the weather for {{ city }}, France
    5. 「戻る」 「戻る」アイコンをクリックして、「AIエージェント」ページに戻ります。
      プロンプト・テンプレートをAIエージェントに関連付けることができるようになりました。
  5. プロンプトテンプレートをAIエージェントに関連付けます。
    1. プロンプト・テンプレートを関連付けるAIエージェントを検索します。
    2. AIエージェントがアクティブの場合は非アクティブ化します。
    3. AIエージェントを選択します。
      エージェントの詳細ページが表示されます。
    4. 「プロンプト・テンプレート」セクションで、「+」をクリックし、作成したプロンプト・テンプレートを選択して、「追加」をクリックします。
    5. 「保存」をクリックして、変更をAIエージェントに保存します。
    6. 「戻る」 「戻る」アイコンをクリックして、「AIエージェント」ページに戻ります。
      新しいプロンプトテンプレートを使用してAIエージェントを実行できるようになりました。
  6. AIエージェントを実行し、プロンプトテンプレートを指定します。
    1. 「エージェント」ボックスで、実行するAIエージェントを見つけます。
    2. 「アクション」 「アクション」アイコンをクリックし、「実行」を選択します。
    3. プロンプト・テンプレートを使用してエージェントをテストするには、「新規実行」をクリックします。
    4. 「プロンプト」フィールド内をクリックしてプロンプト・テンプレートのリストを表示し、作成したプロンプト・テンプレートを選択します。

      「ペイロードの定義」ダイアログが表示されます。

    5. 「ペイロードの定義」で、変数の値を入力し、「送信」をクリックします。

      左側に「新規実行」が選択されたテスト・エージェント画面。 中央の「ペイロードの定義」というポップアップ・ウィンドウに、ペイロード・オブジェクトに市区町村キー・セットが「パリ」に設定されているJSONエディタが表示されます。 「取消」および「発行」ボタンがエディタの下に表示されます。 メインインターフェイスはバックグラウンドで淡色表示されます。

      入力した値は、プロンプト・テンプレートから作成されたプロンプトに追加されます。


      左側に「新規実行」が選択されたテスト・エージェント画面。 中央のプロンプト入力ボックスには、「Get the weather for Paris、 France」というテキストが含まれています。 プロンプトの横には、テキストをクリアしたり、問合せを送信したり、ペイロードを編集するためのボタンがあります。

    6. 「プロンプト」で、「実行」「Run」アイコンをクリックします。