Mengembangkan sebuah alur prompt (klasik)

Hanya berlaku untuk:Portal Foundry (klasik). Artikel ini tidak tersedia untuk portal Foundry baru. Pelajari selengkapnya tentang portal baru.

Catatan

Tautan dalam artikel ini mungkin membuka konten dalam dokumentasi Microsoft Foundry baru alih-alih dokumentasi Foundry (klasik) yang Anda lihat sekarang.

Peringatan

Pengembangan fitur Prompt Flow berakhir pada 20 April 2026. Fitur ini akan sepenuhnya dihentikan pada 20 April 2027. Pada tanggal penghentian, Prompt Flow memasuki mode baca-saja. Alur Anda yang ada akan terus beroperasi hingga tanggal tersebut.

Tindakan yang direkomendasikan: Migrasikan beban kerja Prompt Flow Anda ke Microsoft Agent Framework sebelum 20 April 2027.

Alur Prompt adalah alat pengembangan yang dirancang untuk menyederhanakan seluruh siklus pengembangan aplikasi AI yang didukung oleh Model Bahasa Berskala Besar (LLM). Alur kerja prompt menyediakan solusi komprehensif yang menyederhanakan proses membuat prototipe, bereksperimen, melakukan iterasi, dan menyebarkan aplikasi AI Anda.

Dengan alur cepat, Anda dapat:

• Mengatur alur yang dapat dieksekusi dengan LLM, perintah, dan alat Python melalui grafik yang divisualisasikan.
• Uji, debug, dan iterasi alur Anda dengan mudah.
• Buat varian prompt dan bandingkan performanya.

Dalam artikel ini, Anda mempelajari cara membuat dan mengembangkan alur prompt pertama Anda di portal Microsoft Foundry.

Prasyarat

Penting

Artikel ini menyediakan dukungan warisan untuk proyek berbasis hub. Ini tidak akan berfungsi untuk proyek Foundry. Lihat Bagaimana cara mengetahui jenis proyek mana yang saya miliki?

catatan kompatibilitas SDK: Contoh kode memerlukan versi SDK Foundry Microsoft tertentu. Jika Anda mengalami masalah kompatibilitas, pertimbangkan untuk bermigrasi dari proyek berbasis hub ke Foundry.

• Akun Azure dengan langganan aktif. Jika Anda tidak memilikinya, buat akun Azure free, yang menyertakan langganan uji coba gratis.
• Jika Anda tidak memilikinya, buat proyek berbasis hub.

• Alur prompt memerlukan sesi komputasi komputer. Jika Anda tidak memiliki runtime, Anda dapat membuatnya di portal Foundry.
• Anda memerlukan model yang disebarkan.
• Dalam proyek Anda, konfigurasikan kontrol akses untuk akun penyimpanan blob. Berikan peran Storage Blob Data Contributor ke akun pengguna Anda.
  • Di kiri bawah portal Foundry, pilih Pusat manajemen.
  • Di sumber daya Koneksi untuk hub Anda, pilih tautan yang sesuai dengan jenis Azure Blob Storage.
  • Pilih Tampilkan di portal Azure
  • Di portal Azure, pilih Kontrol akses (IAM).
  • Pilih Tambahkan>penetapan peran.
  • Cari Kontributor Data Blob Penyimpanan, lalu pilih.
  • Gunakan halaman Tambahkan penetapan peran untuk menambahkan diri Anda sebagai anggota.
  • Pilih Tinjau + tetapkan untuk meninjau tugas.
  • Pilih Tinjau + tetapkan untuk menetapkan peran.

Ciptakan dan kembangkan aliran Prompt Anda

Anda dapat membuat alur dengan mengkloning sampel yang tersedia di galeri atau membuat alur dari awal. Jika Anda sudah memiliki file alur di penyimpanan lokal atau berbagi file, Anda juga dapat mengimpor file untuk membuat alur.

Untuk membuat alur cepat dari galeri di portal Foundry:

Tips

Karena Anda dapat kustomisasi panel kiri di portal Microsoft Foundry, Anda mungkin melihat item yang berbeda dari yang diperlihatkan dalam langkah-langkah ini. Jika Anda tidak melihat apa yang Anda cari, pilih ... Lainnya di bagian bawah panel kiri.

Masuk ke Microsoft Foundry. Pastikan tombol New Foundry nonaktif. Langkah-langkah ini mengacu pada Foundry (klasik).

1. Pilih proyek Anda.

2. Jika Anda berada di pusat Manajemen, pilih Buka proyek untuk kembali ke proyek Anda.

3. Dari menu kiri yang dapat diciutkan, pilih Alur perintah.

4. Pilih + Buat.

5. Di petak alur Standar , pilih Buat.

6. Pada halaman Buat alur baru , masukkan nama folder lalu pilih Buat.

   

7. Halaman penulisan alur perintah terbuka. Pilih Mulai sesi komputasi agar sesi komputasi berjalan untuk alur.

8. Anda dapat mulai menulis alur Anda sekarang. Secara default Anda melihat alur sampel. Contoh alur ini memiliki simpul untuk LLM dan alat Python.

   

   Catatan

   Tampilan grafik hanya untuk visualisasi. Ini menunjukkan struktur alur yang sedang Anda kembangkan. Anda tidak dapat mengedit tampilan grafik secara langsung, tetapi Anda dapat memperbesar, memperkecil, dan menggulir. Anda dapat memilih simpul dalam tampilan grafik untuk menyoroti dan menavigasi ke simpul dalam tampilan edit alat.

9. Secara opsional, Anda dapat menambahkan lebih banyak alat ke alur. Opsi alat yang terlihat adalah LLM, Prompt, dan Python. Untuk melihat alat lainnya, pilih + Alat lainnya.

   

10. Pilih koneksi dan penyebaran di editor alat LLM.

    

11. Di bagian Input , tambahkan nilai untuk topik tersebut. Misalnya, "atom."

12. Pilih Jalankan untuk menjalankan alur.

    

13. Status menjalankan alur ditampilkan sebagai Berjalan.

    

14. Setelah eksekusi alur selesai, pilih Tampilkan output untuk melihat hasil alur.

    

15. Anda dapat melihat status dan output eksekusi alur di bagian Output .

    

Penulisan alur

Setiap alur diwakili oleh folder yang berisi file 'flow.dag.yaml'', file kode sumber, dan folder sistem. Anda dapat menambahkan file baru, mengedit file yang sudah ada, dan menghapus file. Anda juga dapat mengekspor file ke lokal, atau mengimpor file dari lokal.

Selain mengedit simpul sebaris dalam tampilan default, Anda juga dapat mengaktifkan saklar Mode file mentah dan memilih nama file untuk mengedit file di tab file yang terbuka.

Input dan output aliran

Input alur adalah data yang diteruskan ke alur secara keseluruhan. Tentukan skema input dengan menentukan nama dan jenis. Atur nilai input dari setiap input untuk menguji alur. Anda dapat merujuk input alur di kemudian waktu pada simpul alur dengan menggunakan sintaks ${inputs.[input name]}.

Output alur adalah data yang dihasilkan oleh alur secara keseluruhan, yang merangkum atau menyajikan hasil dari pelaksanaan alur. Anda dapat melihat dan mengekspor tabel output setelah eksekusi alur atau eksekusi batch selesai. Tentukan nilai output alur dengan mereferensikan output simpul tunggal alur menggunakan sintaks ${[node name].output} atau ${[node name].output.[field name]}.

Menghubungkan simpul

Dengan mereferensikan output simpul, Anda dapat menautkan simpul bersama-sama. Misalnya, Anda dapat mereferensikan output simpul LLM di input simpul Python, sehingga simpul Python dapat menggunakan output simpul LLM, dan dalam tampilan grafik Anda dapat melihat bahwa dua simpul ditautkan bersama-sama.

Mengaktifkan pengendalian bersyarat pada alur

Prompt Flow tidak hanya menawarkan cara yang disederhanakan untuk menjalankan alur, tetapi juga menghadirkan fitur yang kuat untuk pengembang - kontrol kondisional, yang memungkinkan pengguna untuk mengatur kondisi untuk eksekusi simpul apa pun dalam alur.

Pada intinya, kontrol kondisional menyediakan kemampuan untuk mengaitkan setiap simpul dalam alur dengan konfigurasi aktifkan. Konfigurasi ini pada dasarnya adalah pernyataan "kapan" yang menentukan kapan simpul harus dijalankan. Kekuatan fitur ini diwujudkan ketika Anda memiliki alur kompleks di mana eksekusi tugas tertentu tergantung pada hasil tugas sebelumnya. Dengan menggunakan kontrol kondisional, Anda dapat mengonfigurasi simpul tertentu untuk dijalankan hanya saat kondisi yang ditentukan terpenuhi.

Secara khusus, Anda dapat mengatur konfigurasi aktifkan untuk simpul dengan memilih tombol Aktifkan konfigurasi di kartu simpul. Anda dapat menambahkan pernyataan "kapan" dan mengatur kondisi. Anda dapat mengatur kondisi dengan mereferensikan input alur, atau output simpul. Misalnya, Anda dapat mengatur kondisi ${inputs.[input name]} sebagai nilai tertentu atau ${[node name].output} sebagai nilai tertentu.

Jika kondisi tidak terpenuhi, simpul akan dilewati. Status simpul ditampilkan sebagai "Dilewati".

Menguji alur

Anda dapat menguji alur dengan dua cara:

• Jalankan nodus tunggal:

  • Untuk menjalankan satu simpul, pilih ikon Jalankan pada simpul dalam tampilan default. Setelah pemrosesan selesai, Anda dapat dengan cepat memeriksa hasil di bagian node Outputs. n

• Jalankan seluruh alur:

  • Untuk menjalankan seluruh alur, pilih tombol Jalankan di bagian kanan atas.

Lihat hasil pengujian dan penelusuran (pratinjau)

Pelacakan dinonaktifkan secara default, untuk mengaktifkan pelacakan, Anda perlu mengatur variabel PF_DISABLE_TRACING lingkungan ke false. Salah satu cara Anda dapat melakukan ini adalah dengan menambahkan yang berikut ini ke simpul python:

import os
os.environ["PF_DISABLE_TRACING"] = "false"

Untuk seluruh pelaksanaan alur, setelah Anda menjalankan alur, Anda dapat melihat status pelaksanaannya di banner pelaksanaan. Untuk melihat jejak untuk memeriksa hasil dan mengamati eksekusi alur, Anda dapat memilih Tampilkan output lalu pilih tab pelacakan . Anda dapat melihat input dan output dari seluruh alur dan setiap simpul, bersama dengan informasi yang lebih rinci untuk penelusuran kesalahan. Ini tersedia selama penjalankan dan setelah proses selesai.

Memahami tampilan jejak

Pilih tab Lacak pada layar Output untuk melihat grafik yang menyediakan informasi tentang durasi dan biaya token terkait alur. Pilih alur di bawah nama simpul untuk melihat informasi gambaran umum alur terperinci di panel kanan.

Catatan

Dalam SDK alur perintah, kami menentukan beberapa jenis rentang, termasuk LLM, Function, Embedding, Retrieval, dan Flow. Dan sistem secara otomatis membuat rentang dengan informasi eksekusi dalam atribut dan peristiwa yang ditunjuk.

Untuk mempelajari selengkapnya tentang jenis rentang, lihat Rentang pelacakan.

Mengembangkan alur obrolan

Alur obrolan dirancang untuk pengembangan aplikasi percakapan, membangun kemampuan alur standar dan memberikan dukungan yang ditingkatkan untuk input/output obrolan dan manajemen riwayat obrolan. Dengan alur obrolan, Anda dapat dengan mudah membuat chatbot yang menangani input dan output obrolan.

Di halaman penulisan alur obrolan, alur obrolan ditandai dengan label "obrolan" untuk membedakannya dari alur standar dan alur evaluasi. Untuk menguji alur obrolan, pilih tombol "Obrolan" untuk memicu kotak obrolan untuk percakapan.

Input/output obrolan dan riwayatnya

Elemen terpenting yang membedakan alur obrolan dari alur standar adalah input Obrolan, Riwayat obrolan, dan output Obrolan.

• Input obrolan: Input obrolan mengacu pada pesan atau kueri yang dikirimkan oleh pengguna ke chatbot. Menangani input obrolan secara efektif sangat penting untuk percakapan yang sukses, karena melibatkan pemahaman niat pengguna, mengekstrak informasi yang relevan, dan memicu respons yang sesuai.
• Riwayat obrolan: Riwayat obrolan adalah catatan semua interaksi antara pengguna dan chatbot, termasuk input pengguna dan output yang dihasilkan AI. Mempertahankan riwayat obrolan sangat penting untuk melacak konteks percakapan dan memastikan AI dapat menghasilkan respons yang relevan secara kontekstual.
• Output obrolan: Output obrolan mengacu pada pesan yang dihasilkan AI yang dikirim ke pengguna sebagai respons terhadap input mereka. Menghasilkan output obrolan yang sesuai secara kontekstual dan menarik sangat penting untuk pengalaman pengguna yang positif.

Alur obrolan dapat memiliki beberapa input, riwayat obrolan, dan input obrolan diperlukan dalam alur obrolan.

• Di bagian alur masuk obrolan, input alur bisa diatur sebagai input obrolan. Kemudian Anda dapat mengisi nilai input obrolan dengan mengetik di kotak obrolan.

• Alur perintah dapat membantu pengguna mengelola riwayat obrolan. chat_history Bagian Input dicadangkan untuk mewakili riwayat Obrolan. Semua interaksi dalam kotak obrolan, termasuk input obrolan pengguna, output obrolan yang dihasilkan, dan input dan output alur lainnya, secara otomatis disimpan dalam riwayat obrolan. Pengguna tidak dapat mengatur nilai chat_history secara manual di bagian Input. Ini disusun sebagai daftar input dan output:

  [
  {
      "inputs": {
      "<flow input 1>": "xxxxxxxxxxxxxxx",
      "<flow input 2>": "xxxxxxxxxxxxxxx",
      "<flow input N>""xxxxxxxxxxxxxxx"
      },
      "outputs": {
      "<flow output 1>": "xxxxxxxxxxxx",
      "<flow output 2>": "xxxxxxxxxxxxx",
      "<flow output M>": "xxxxxxxxxxxxx"
      }
  },
  {
      "inputs": {
      "<flow input 1>": "xxxxxxxxxxxxxxx",
      "<flow input 2>": "xxxxxxxxxxxxxxx",
      "<flow input N>""xxxxxxxxxxxxxxx"
      },
      "outputs": {
      "<flow output 1>": "xxxxxxxxxxxx",
      "<flow output 2>": "xxxxxxxxxxxxx",
      "<flow output M>": "xxxxxxxxxxxxx"
      }
  }
  ]
  

Catatan

Kemampuan untuk menyimpan atau mengelola riwayat obrolan secara otomatis adalah fitur di halaman penulisan saat melakukan pengujian di kotak obrolan. Untuk eksekusi batch, pengguna perlu menyertakan riwayat obrolan dalam himpunan data eksekusi batch. Jika tidak ada riwayat obrolan yang tersedia untuk pengujian, atur chat_history ke daftar [] kosong dalam himpunan data eksekusi batch.

Prompt penulis dengan riwayat obrolan

Memasukkan riwayat Obrolan ke dalam perintah Anda sangat penting untuk membuat respons chatbot yang sadar konteks dan menarik. Dalam perintah, Anda dapat mereferensikan chat_history untuk mengambil interaksi sebelumnya. Ini memungkinkan Anda mereferensikan input dan output sebelumnya untuk membuat respons yang relevan secara kontekstual.

Gunakan tata bahasa Jinja for-loop untuk menampilkan daftar input dan output dari chat_history.

{% for item in chat_history %}
user:
{{item.inputs.question}}
assistant:
{{item.outputs.answer}}
{% endfor %}

Uji dengan kotak obrolan

Kotak obrolan menyediakan cara interaktif untuk menguji alur obrolan Anda dengan mensimulasikan percakapan dengan chatbot Anda. Untuk menguji alur obrolan Anda menggunakan kotak obrolan, ikuti langkah-langkah berikut:

1. Pilih tombol "Obrolan" untuk membuka kotak obrolan.
2. Ketik input pengujian Anda ke dalam kotak obrolan dan tekan Enter untuk mengirimnya ke chatbot.
3. Tinjau respons chatbot untuk memastikan respons tersebut sesuai dan akurat secara kontekstual.
4. Lihat lacak di tempat untuk pengamatan dan debugging cepat.

Langkah berikutnya

• Pelaksanaan batch menggunakan lebih banyak data dan mengevaluasi kinerja aliran
• Menyetel perintah menggunakan varian
• Menyebarkan alur