Bagikan melalui

Output JSON

Secara default, perintah menghasilkan teks sebagai respons. Teks dapat nyaman untuk banyak kasus penggunaan; namun, jika respons memiliki beberapa elemen yang perlu diidentifikasi secara individual, opsi teks dapat dibatasi.

Manfaat menggunakan output JSON

Output JSON memungkinkan Anda menghasilkan struktur JSON untuk respons prompt Anda alih-alih teks. JSON memudahkan proses respons dengan beberapa elemen dalam agen, alur cloud, atau aplikasi.

Berikut ini adalah contoh kasus penggunaan yang dimungkinkan dengan output JSON:

  • Tampilkan konten terstruktur seperti jadwal proyek atau informasi produk.
  • Ekstrak data dari teks seperti faktur, pesanan pembelian, formulir pengiriman, dan banyak lagi.
  • Identifikasi atribut objek dari sumber teks seperti email atau data Dataverse.
  • Dapatkan beberapa kategori atau sentimen dari teks.

Membuat prompt dengan output JSON

Bagian ini menjelaskan cara memilih JSON sebagai output dan mengedit format JSON.

Pilih JSON sebagai output

Untuk mengubah bagaimana respons perintah dirender, pilih JSON sebagai output di sudut kanan atas.

Cuplikan layar pilihan di halaman 'Prompt with JSON'.

Edit format JSON

Untuk melihat atau mengedit format JSON, pilih ikon pengaturan di sebelah kiri Output: JSON.

Cuplikan layar pengaturan output.

Secara default, formatnya adalah Terdeteksi otomatis. Format ini berarti setiap kali Anda menguji prompt Anda, format yang terkait dengan prompt diperbarui agar sesuai dengan yang terdeteksi pada saat pengujian. Format ini nyaman ketika Anda melakukan iterasi pada instruksi prompt Anda dan ingin tahu bagaimana format respons berkembang.

Cuplikan layar 'Format yang terdeteksi secara otomatis'.

Jika Anda memperbarui contoh JSON, formatnya menjadi Kustom dan tidak pernah diperbarui jika Anda menguji permintaan Anda lagi. Format ini nyaman ketika Anda tidak ingin perubahan perintah mempengaruhi format, atau jika Anda perlu mengikuti format tertentu.

Anda dapat kembali ke mode deteksi otomatis dengan memilih ikon Kembali ke deteksi otomatis .

Cuplikan layar ikon 'Kembali ke terdeteksi otomatis'.

Untuk menguji dan menyimpan perintah Anda, ikuti langkah-langkah berikut:

  1. Untuk mengonfirmasi contoh yang baru diubah, pilih Terapkan.
  2. Untuk memeriksa bagaimana respons perintah Anda dirender dengan format baru, pilih Uji.
  3. Saat Anda menyelesaikan modifikasi, pilih Simpan kustom. Jika Anda melewati langkah ini, perubahan Anda akan hilang.

Saat menyimpan perintah, Anda mengunci format terdeteksi otomatis terbaru atau format Kustom yang ditentukan. Ini berarti saat Anda menggunakan perintah Anda di dalam agen, alur cloud, atau aplikasi, format yang disimpan digunakan—tidak akan berubah.

Kapan saja, Anda dapat memeriksa skema JSON yang dihasilkan dari contoh JSON dengan memilih </>. Saat ini Anda tidak dapat mengubah skema ini.

Menggunakan perintah dengan output JSON di Power Automate

Bagian ini memandu Anda untuk membuat alur cloud berikut:

Cuplikan layar aliran cloud dengan perintah

  1. Buat perintah untuk memproses faktur menggunakan Gambar atau dokumen sebagai input.

    Pelajari selengkapnya di Menambahkan input teks, gambar, atau dokumen ke perintah.

    Cuplikan layar permintaan pemrosesan faktur.

  2. Perbarui format JSON dengan memberikan contoh JSON berikut:

    Cuplikan layar format JSON kustom.

  3. Buat alur cloud dengan pemicu Saat email baru tiba . Untuk memproses email tertentu, pastikan untuk mengatur filter.

    Pelajari selengkapnya di Mulai menggunakan pemicu.

  4. Tambahkan tindakan Jalankan perintah , dan pilih perintah yang Anda buat di langkah pertama.

  5. Dalam input faktur , tambahkan lampiran email dari tindakan pemicu.

    Cuplikan layar parameter pemicu dalam alur cloud.

  6. Tambahkan tindakan Kirim email .

  7. Edit isi email untuk menyertakan elemen yang diekstrak oleh perintah dengan output JSON.

    Cuplikan layar isi email yang memperlihatkan bidang JSON.

FAQ

JSON tidak dapat dihasilkan

Anda mungkin mengalami kesalahan berikut saat menguji perintah: JSON tidak dapat dihasilkan. Edit instruksi perintah Anda, lalu coba lagi.

Kesalahan ini mungkin karena model mengapit output JSON dengan informasi metadata yang mencegah keberhasilan verifikasi format JSON yang diperlukan. Untuk mengatasi masalah ini, coba tambahkan instruksi berikut ke perintah Anda: Jangan sertakan markdown JSON dalam jawaban Anda.

Tidak ada JSON yang dikembalikan dalam mode deteksi otomatis

Ada kemungkinan bahwa tidak ada JSON yang dikembalikan setelah memilih Perintah pengujian dengan mode deteksi otomatis diaktifkan. Mungkin karena instruksi prompt bertentangan dengan instruksi sistem untuk mengembalikan JSON. Ini dapat diselesaikan dengan mengubah instruksi prompt dan menguji lagi.

Format JSON tidak mengalami pembaruan selama eksekusi perintah

Format JSON terbaru yang terdeteksi dalam mode deteksi otomatis atau format JSON terbaru yang ditentukan dalam mode kustom direkam pada waktu penghematan perintah. Format JSON yang direkam ini diterapkan pada runtime perintah, memastikan konsistensi format respons bahkan ketika input dinamis ke prompt berubah.

Keterbatasan

  • Anda tidak dapat mengubah skema JSON.
  • Kami tidak mendukung penentuan format JSON tanpa kunci bidang.
    Contoh: ["abc", "def"] tidak didukung tetapi [{"Field1": "abc"}, {"Field1": "def"}] didukung.

Video: pembuat prompt: Output JSON di pembuat prompt

  • Last updated on