次の方法で共有

JSON 出力

既定では、プロンプトは応答としてテキストを生成します。 テキストは、多くのユースケースに便利です。ただし、応答に個別に識別する必要がある複数の要素がある場合は、テキスト オプションを制限できます。

JSON 出力を使用する利点

JSON 出力を使用すると、テキストではなくプロンプト応答の JSON 構造を生成できます。 JSON を使用すると、エージェント、クラウド フロー、またはアプリ内の複数の要素で応答を簡単に処理できます。

JSON 出力で可能になるユース ケースの例を次に示します。

  • プロジェクトスケジュールや製品情報などの構造化されたコンテンツを表示します。
  • 請求書、発注書、配送フォームなどのテキストからデータを抽出します。
  • メールや Dataverse データなどのテキスト ソースからオブジェクト属性を識別します。
  • テキストから複数のカテゴリまたはセンチメントを取得します。

JSON 出力でプロンプトを作成する

このセクションでは、出力として JSON を選択し、JSON 形式を編集する方法について説明します。

出力として JSON を選択する

プロンプト応答のレンダリング方法を変更するには、右上隅の出力として JSON を選択します。

[PROMPT with JSON]\(JSON を使用してプロンプト\) ページの選択のスクリーンショット。

JSON 形式の編集

JSON 形式を表示または編集するには、[ 出力: JSON] の左側にある設定アイコンを選択します。

出力設定のスクリーンショット。

既定では、形式は [自動検出] です。 この形式は、プロンプトをテストするたびに、プロンプトに関連付けられている形式が、テスト時に検出された形式で更新されます。 この形式は、プロンプトの指示を繰り返し実行していて、応答形式がどのように進化するかを知りたい場合に便利です。

JSON の例を更新すると、形式は Custom になり、プロンプトをもう一度テストしても更新されません。 この形式は、形式に影響を与えるプロンプトの調整が不要な場合や、特定の形式に従う必要がある場合に便利です。

自動検出モードに戻すには、[自動検出 に戻る ] アイコンを選択します。

[自動検出に戻る] アイコンのスクリーンショット。

プロンプトをテストして保存するには、次の手順に従います。

  1. 新しく変更した例を確認するには、[ 適用] を選択します。
  2. プロンプト応答が新しい形式でレンダリングされる方法を確認するには、[ テスト] を選択します。
  3. 変更が完了したら、[ カスタムの保存] を選択します。 この手順をスキップすると、変更は失われます。

プロンプトを保存すると、最新の 自動検出 形式または定義された カスタム 形式がロックされます。 つまり、エージェント、クラウド フロー、またはアプリでプロンプトを使用すると、保存された形式が使用されます。これは変わりません。

/を選択することで、JSON の例から生成される JSON スキーマをいつでも確認できます。 現在、このスキーマを変更することはできません。

Power Automate で JSON 出力でプロンプトを使用する

このセクションでは、次のクラウド フローを作成する方法について説明します。

プロンプトが表示されたクラウド フローのスクリーンショット

  1. イメージまたはドキュメントを入力として使用して請求書を処理するプロンプトを作成します。

    詳細については、「 プロンプトにテキスト、画像、またはドキュメント入力を追加する」を参照してください。

    請求書処理プロンプトのスクリーンショット。

  2. 次の JSON 例を指定して、JSON 形式を更新します。

    カスタム JSON 形式のスクリーンショット。

  3. [新しい電子メールが届いたとき] トリガーを使用してクラウド フローを作成します。 特定のメールを処理するには、フィルターを設定してください。

    詳細については、トリガーの使い方を学ぶを参照してください。

  4. [ プロンプトの実行 ] アクションを追加し、最初の手順で作成したプロンプトを選択します。

  5. 請求書入力で、トリガー アクションから電子メールの添付ファイルを追加します。

    クラウド フローのプロンプト パラメーターのスクリーンショット。

  6. [ 電子メールの送信] アクションを 追加します。

  7. 電子メールの本文を編集して、JSON 出力を含むプロンプトによって抽出された要素を含めます。

    JSON フィールドを示す電子メール本文のスクリーンショット。

FAQ

JSON を生成できませんでした

プロンプトのテスト中に次のエラーが発生する可能性があります。 JSON を生成できませんでした。プロンプトの指示を編集して、もう一度やり直してください。

このエラーは、モデルが JSON 出力をメタデータ情報で囲み、必要な JSON 形式の検証が成功しない可能性があります。 この問題を解決するには、次の指示をプロンプトに追加してみてください。 回答に JSON マークダウンを含めないでください。

自動検出モードで JSON が返されない

自動検出モードがアクティブ化された 状態でテスト プロンプト を選択した後、JSON が返されない可能性があります。 これは、プロンプト命令が JSON を返すシステム命令と矛盾している可能性があります。 プロンプト命令を変更してもう一度テストすることで解決できます。

プロンプト実行時に JSON 形式が更新されない

自動検出モードで検出された最新の JSON 形式またはカスタム モードで定義された最新の JSON 形式は、プロンプトの保存時間に記録されます。 この記録された JSON 形式はプロンプト実行時に適用され、プロンプトへの動的な入力が変更されている場合でも、応答形式の一貫性が確保されます。

制限事項

  • JSON スキーマを変更することはできません。
  • フィールド キーのない JSON 形式の定義はサポートされていません。
    例: ["abc", "def"] はサポートされていませんが、 [{"Field1": "abc"}, {"Field1": "def"}] はサポートされています。

ビデオ: AI Builder: プロンプト ビルダーでの JSON 出力

  • Last updated on