Mengedit dan mengelola alur agen atau alur kerja Anda di perancang

Alur agen dan alur kerja dibuat dan diedit dalam perancang visual di Copilot Studio. Alur kerja baru, yang sekarang dalam pratinjau publik, menggunakan desainer visual yang didesain ulang, sementara alur agen menggunakan desainer visual asli. Kedua desainer visual menyediakan kanvas tempat Anda dapat terus membangun atau mengedit otomatisasi. Tambahkan dan hapus tindakan, periksa kesalahan, dan publikasikan alur Anda, semuanya tanpa meninggalkan perancang. Anda juga dapat menyesuaikan bagaimana alur agen atau alur kerja Anda ditampilkan untuk memungkinkan Anda fokus pada area tertentu.

Important

Artikel ini berisi dokumentasi pratinjau Microsoft Copilot Studio dan dapat berubah.

Fitur pratinjau tidak dimaksudkan untuk penggunaan produksi dan mungkin memiliki fungsionalitas terbatas. Fitur ini tersedia sebelum rilis resmi agar Anda bisa memperoleh akses awal dan memberikan tanggapan.

Jika Anda membangun agen yang siap untuk produksi, silakan lihat Gambaran Umum Microsoft Copilot Studio.

Untuk menampilkan alur agen atau alur kerja di perancang, buka Copilot Studio, pilih Flows, pilih alur, lalu pilih tab Build.

Tangkapan layar dari desainer Copilot Studio yang memperlihatkan alur kerja yang sudah diterbitkan dengan pemicu dan beberapa aksi.

Mengubah cara alur Anda ditampilkan

Bergantung pada ukuran dan kompleksitas alur agen atau alur kerja Anda, Anda mungkin ingin menyesuaikan bagaimana alur ditampilkan untuk membuatnya lebih mudah dikerjakan. Bilah alat di sudut kiri bawah kanvas mengontrol tampilan.

Cuplikan layar bilah alat opsi tampilan di desainer Copilot Studio, dengan callout bernomor dari 1 hingga 6.

Legenda:

  1. Zoom in: Memperbesar ukuran alur kerja pada kanvas.
  2. Zoom out: Memperkecil ukuran alur kerja pada kanvas.
  3. Tampilan pas: Mengubah ukuran tampilan agar pas dengan seluruh alur kerja di kanvas.
  4. Merapikan: Mengatur ulang alur kerja dan cabang untuk tampilan end-to-end yang lebih bersih.
  5. Tata letak vertikal: Beralih ke tampilan tata letak vertikal alur kerja.

Menambahkan dan menghapus tindakan

  1. Pada kartu tempat Anda ingin menambahkan tindakan, pilih Tambahkan langkah. Panel Tambahkan terbuka.

  2. Di bawah Tambahkan, mulai ketik tindakan yang Anda inginkan untuk dilakukan alur atau konektor yang ingin Anda tambahkan, lalu pilih dari daftar. Bergantung pada pilihan Anda, Anda mungkin perlu memberikan informasi tambahan untuk menyelesaikan tindakan.

Jika Anda menentukan bahwa tindakan tidak diperlukan, pilih ikon Hapus di sudut kanan atas tindakan.

Periksa parameter aliran

Untuk melihat parameter pemicu atau tindakan di alur kerja Anda, pilih kartunya. Panel konfigurasi terbuka di sisi kanan. Untuk memasukkan nilai parameter, pilih opsi dalam daftar dropdown atau masukkan ekspresi untuk mengatur nilai secara dinamis.

Lihat riwayat versi untuk alur agen

Riwayat versi direkam dalam Microsoft Dataverse saat Anda membangun atau mengubah alur agen. Untuk memahami bagaimana alur agen berkembang, tinjau riwayat versinya. Versi alur dikelompokkan berdasarkan tanggal, dengan indikator untuk versi terbaru, yang dipublikasikan, dan yang pernah dipublikasikan.

Riwayat alur didasarkan pada versi yang disimpan, jadi sebaiknya simpan draf sebelum alur selesai.

Untuk menggunakan panel riwayat versi, Anda harus menyimpan alur agen Anda setidaknya satu kali.

  1. Pada menu di bagian atas kanvas, pilih Riwayat versi.

  2. Untuk melihat versi alur yang direkam, perluas item dalam daftar.

  3. Untuk menampilkan versi di perancang, pilih versi tersebut dalam daftar.

Periksa kesalahan

Kesalahan dalam tindakan alur kerja ditunjukkan dengan warna merah. Untuk melihat detail kesalahan dalam satu tindakan, pilih kesalahan. Untuk mencantumkan semua kesalahan di seluruh alur, buka spanduk pusat kesehatan . Untuk melihat detail kesalahan secara individual, pilih kesalahan.

Important

Anda tidak dapat menerbitkan alur jika berisi error. Anda harus memperbaiki semua kesalahan sebelum dapat memublikasikan alur Anda.

Menerbitkan alur kerja Anda

Jika alur kerja Anda tidak memiliki kesalahan, Anda dapat menerbitkannya. Untuk menerbitkan alur Anda, pada menu di bagian atas kanvas, pilih Terbitkan.

Menguji alur atau alur kerja agen Anda

Uji eksekusi memungkinkan Anda memverifikasi langkah atau seluruh alur tanpa meninggalkan perancang, menggunakan data upstream nyata, nilai yang Anda tirukan sendiri, atau output dari eksekusi sebelumnya.

Ada dua cara untuk menjalankan pengujian:

Apa yang ingin Anda verifikasi Cara menguji Di mana menemukannya
Satu tindakan atau langkah AI secara terpisah Uji simpul ini Tab Uji di dalam panel samping simpul
Alur penuh, ujung-ke-ujung Jalankan pengujian alur Tombol Putar di bilah perintah atas

Kedua permukaan berbagi ide yang sama: memberikan input (nyata atau tiruan), jalankan, lalu periksa output.

Menguji satu simpul dalam alur kerja

Buka tindakan atau simpul apa pun di alur kerja Anda dan pilih tombol mainkan atau Coba. Ada tiga bagian:

  1. Jalankan / Reset pengujian: Menjalankan langkah sesuai permintaan, atau menghapus input dan output saat ini.

    Cuplikan layar panel uji simpul memperlihatkan bagian Input, Konfigurasi, dan Output dengan tombol Uji disorot.

  2. Memuat nilai dari eksekusi sebelumnya: Dropdown eksekusi terbaru dari alur ini. Memilih satu menarik output langkah upstream dari yang berjalan ke bidang input di bawah ini.

  3. Input: Satu bidang yang dapat diedit per langkah upstream menghasilkan referensi node. Lencana di sebelah kanan setiap baris menunjukkan jenis bidang yang diharapkan (string, email, tanggal-waktu, angka, dll.).

  4. Output: Hasil langsung dari pengujian terbaru, diformat untuk jenis node (JSON, hasil prompt, respons konektor, dll.).

Input tiruan

Secara default, bidang input kosong. Kamu bisa:

  • Ketik nilai apa pun langsung ke dalam kolom. Bidang menerima jenis yang diperlihatkan di lencana sebelah kanan.
  • Biarkan bidang kosong jika langkah Anda tidak bergantung padanya.

Cuplikan layar panel uji simpul memperlihatkan bidang input kosong dengan lencana jenis di sebelah kanan.

Tip

Apa yang muncul di sini? Tab Uji secara otomatis mencantumkan output langkah upstream yang disebutkan dalam ekspresi node ini. Jika Anda menambahkan token baru ke simpul, bidang terkait akan muncul saat berikutnya Anda membuka Uji.

Memuat nilai dari pengoperasian sebelumnya

Cuplikan layar dari daftar tarik turun Muat nilai dari eksekusi sebelumnya yang menampilkan eksekusi sebelumnya dengan label waktu, tanggal, dan status.

Jika alur Anda berjalan sebelumnya, Anda dapat memutar ulang data nyata alih-alih mengetikkannya di:

  1. Di menu dropdown Muat nilai dari eksekusi sebelumnya, pilih satu eksekusi. Setiap entri diberi label dengan tanggal/waktu dan status eksekusi (misalnya, 24 Apr, 09:12 — Berhasil).

  2. Perancang mengambil output dari langkah yang dijalankan tersebut dan memproyeksikannya melalui skema input simpul Anda. Nilai yang cocok ditulis ke kolom masukan.

  3. Edit bidang apa pun setelahnya jika Anda ingin mengubah skenario.

Dropdown menampilkan 10 eksekusi terbaru dari status apa pun. Jika eksekusi tidak menyertakan output untuk salah satu langkah upstream Anda (karena langkah tersebut dilewati atau jalur tidak diambil), hanya bidang yang tersedia yang diisi. Bidang lainnya tetap seperti semula.

Jika alur tidak berjalan sebelumnya, Tidak ada eksekusi sebelumnya yang tersedia yang akan ditampilkan dan dropdown disembunyikan.

Jalankan pengujian

Pilih Jalankan pengujian. Tombol menampilkan status sibuk saat panggilan sedang diproses. Bagian Output menampilkan spinner, lalu menampilkan hasil atau kesalahan.

  • Reset pengujian menghapus semua input dan keluaran terakhir.
  • Pengujian menjalankan node dalam isolasi terhadap API konektor. Pengujian tidak memicu sisa alur.

Menguji seluruh alur

Di bilah perintah atas, pilih tombol putar (Uji). Pengujian menjalankan keseluruhan alur Anda terhadap runtime yang aktif.

Sebelum pelaksanaan dimulai, perancang:

  1. Menyimpan dan menerbitkan alur jika Anda memiliki perubahan yang belum disimpan (atau jika ini pertama kalinya).
  2. Menginstal koneksi baru saat pertama kali dijalankan.
  3. Memicu eksekusi. Jalur tergantung pada jenis pemicu Anda.
Jenis pemicu Apa yang terjadi saat Anda memilih Uji
Permintaan Manual / HTTP Dialog terbuka bagi Anda untuk memasukkan input pemicu, lalu alur segera berjalan.
Pengulangan/jendela geser/pengumpulan otomatis Jadwal dimulai dan eksekusi pertama dimulai secara otomatis, atau, jika sudah diinstal, alur berjalan sekali.
Peristiwa konektor (misalnya, Saat email tiba) Alur diterbitkan dan menunggu. Anda dapat melihat Menunggu pemicu.... Lakukan tindakan dalam sistem sumber untuk mengaktifkan eksekusi.
Webhook HTTP Aliran sudah diterbitkan; memicunya dari sistem eksternal dengan cara yang biasa Anda lakukan.

Input simulasi (pemicu manual)

Untuk Pemicu manual, dialog Masukkan input pemicu manual merender satu bidang per input yang Anda tentukan pada pemicu:

  • Teks/nomor/email/tanggal: Kontrol input yang sesuai.
  • Boolean: Tombol pengalih.
  • Pilihan tunggal (enum): Dropdown.
  • Pilihan Ganda: Menu menurun dengan pilihan ganda.
  • File: Pemilih file (konten diunggah sebagai bagian dari pelaksanaan tugas).
  • Objek/array: Area teks multibaris tempat Anda dapat menempelkan JSON.

Pilih Jalankan untuk memulai alur dengan input tersebut, atau Batal untuk menutup tanpa menjalankan. Bidang yang diperlukan ditandai dengan tanda bintang. Jika nilai hilang atau tidak valid, pesan validasi sebaris muncul dan eksekusi diblokir hingga diperbaiki.

Dialog muncul setiap kali Anda memilih Uji. Nilai tidak disimpan di antara eksekusi, sehingga Anda dapat dengan cepat mencoba skenario yang berbeda.

Saksikan eksekusinya

Setelah eksekusi berjalan:

  • Bilah perintah memperlihatkan tombol Batal saat eksekusi aktif.
  • Panel Aktivitas (sisi kanan) mencantumkan eksekusi saat ini di bagian atas dengan lencana status: Berjalan, Menunggu, Berhasil, Gagal, atau Dibatalkan. Pilih eksekusi apa pun untuk membukanya di kanvas dan periksa input dan output setiap langkah.

Pilih eksekusi sebelumnya

Panel Aktivitas juga berfungsi sebagai riwayat pelaksanaan alur Anda.

  • Filter menurut Semua / Berhasil / Gagal / Sedang Berjalan menggunakan dropdown di atas.
  • Pilih Refresh untuk mengambil ulang daftar.
  • Pilih Muat Lainnya di bagian bawah ke halaman lebih lanjut.
  • Memilih eksekusi memuatnya ke kanvas, dengan setiap node menampilkan input yang diterimanya dan output yang dihasilkan untuk eksekusi tersebut. Data sama dengan yang digunakan tab Uji level node saat Anda memilih eksekusi dari menu drop-down-nya.

Kapan menggunakan setiap jenis pengujian

  • Mengulangi pada satu langkah AI atau tindakan konektor?: Uji node ini. Ini lebih cepat, tidak diterbitkan, dan memungkinkan Anda menyimulasikan hanya nilai upstream yang penting.
  • Memvalidasi perilaku end-to-end atau logika pemicu?: Jalankan pengujian alur. Ini menguji seluruh grafik terhadap runtime nyata.
  • Mereproduksi masalah produksi?: Buka eksekusi yang gagal dari panel Aktivitas, kemudian buka node yang gagal dan gunakan Muat nilai dari eksekusi sebelumnya di tab Uji untuk memutar ulang data upstream yang sesuai ke dalam tindakan.

Konten terkait

  • Last updated on