既定では、プロンプトは応答としてテキストを生成します。 テキストは多くのユースケースで便利です。 ただし、応答に個別に識別する必要がある複数の要素がある場合、テキスト オプションが制限される可能性があります。
JSON 出力を使用するメリット
JSON 出力を使用すると、テキストの代わりにプロンプト応答の JSON 構造を生成できます。 JSON を使用すると、エージェント、フロー、またはアプリの複数の要素を含む応答を簡単に処理できます。
以下は、JSON 出力で可能になるユースケースの例です:
- プロジェクト スケジュールや製品情報などの構造化されたコンテンツを表示します。
- 請求書、注文書、配送フォームなどのテキストからデータを抽出します。
- 電子メールや Dataverse データなどのテキストソースからオブジェクト属性を特定します。
- テキストから複数のカテゴリまたは感情を取得します。
JSON 出力によるプロンプトの作成
このセクションでは、出力として JSON を選択し、JSON 形式を編集する方法について説明します。
出力として JSON を選択する
プロンプト応答のレンダリング方法を変更するには、右上隅の出力として JSON を選択します。
JSON 形式を編集する
JSON 形式を表示または編集するには、出力: JSON の左側にある設定アイコンを選択します。
既定では、形式は 自動検出です。 この形式では、プロンプトをテストするたびに、プロンプトに関連付けられた形式がテスト時に検出された形式で更新されます。 この形式は、プロンプトの指示を繰り返し実行し、応答形式がどのように変化するかを知りたい場合に便利です。
JSON の例を更新すると、形式は カスタム になり、プロンプトを再度テストしても更新されません。 この形式は、プロンプトの調整によって形式が影響を受けないようにしたい場合や、特定の形式に従う必要がある場合に便利です。
自動検出モードに戻すには、自動検出に戻る アイコンを選択します。
プロンプトをテストして保存するには、次の手順に従います:
- 新しく変更した例を確認するには、適用する を選択します。
- プロンプト応答が新しい形式でどのように表示されるかを確認するには、テストを選択します。
- 変更が完了したら、カスタムを保存を選択します。 この手順をスキップすると、変更内容は失われます。
プロンプトを保存すると、最新の 自動検出された 形式または定義された カスタム 形式がロックされます。 つまり、エージェント、フロー、またはアプリでプロンプトを使用する場合、保存された形式が使用され、変更されません。
いつでも、</> を選択して、JSON の例から生成された JSON スキーマを確認できます。 現在、このスキーマを変更することはできません。
Power Automate で JSON 出力のプロンプトを使用します
このセクションでは、次のフローを作成する方法について説明します。
入力として 画像またはドキュメント を使用して請求書を処理するためのプロンプトを作成します。
詳細については、プロンプトにテキスト、画像、またはドキュメント入力を追加するを参照してください。
次の JSON の例を指定して、JSON 形式を更新します。
新しいメールが届いたとき トリガーでフローを作成します。 特定のメールを処理するには、必ずフィルターを設定してください。
詳細については、トリガーを開始するを参照してください。
プロンプトの実行 アクションを追加し、最初のステップで作成したプロンプトを選択します。
請求書 入力で、トリガー アクションからメールの添付ファイルを追加します。
メールの送信 アクションを追加します。
メール本文を編集して、プロンプトによって抽出された要素を JSON 出力に含めます。
よくあるご質問
JSON を生成できませんでした
プロンプトのテスト中に次のエラーが発生する場合があります: JSON を生成できませんでした。プロンプトの指示を編集して、もう一度お試しください。
このエラーは、モデルが JSON 出力をメタデータ情報で囲んでいるために、必要な JSON 形式の検証が正常に行われないことが原因である可能性があります。 この問題を解決するには、プロンプトに次の指示を追加します: 回答に JSON マークダウンを含めない。
自動検出モードでは JSON は返されません
自動検出モードを有効にして テスト プロンプト を選択した後は、JSON が返されない可能性があります。 プロンプトの指示が、JSON を返すシステム指示と矛盾している可能性があります。 プロンプトの指示を変更して再度テストすることで解決できる可能性があります。
プロンプト実行時に JSON 形式が更新されない
自動検出モードで検出された最新の JSON 形式、またはカスタム モードで定義された最新の JSON 形式が、プロンプト保存時に記録されます。 この記録された JSON フォーマットは、プロンプトの実行時に適用され、プロンプトへの動的入力が変更されている場合でも、応答フォーマットの一貫性を保証します。
制限
- JSON スキーマを変更することはできません。
- フィールド キーのない JSON 形式の定義はサポートされていません。
例:["abc", "def"]はサポートされていませんが、[{"Field1": "abc"}, {"Field1": "def"}]はサポートされています。