Mengedit dan mengelola alur agen atau alur kerja Anda di perancang

Baik alur agen maupun alur kerja keduanya dibuat dan diedit di desainer visual di Copilot Studio. Alur kerja baru, sekarang dalam pratinjau umum, 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 desainer. Anda juga dapat menyesuaikan tampilan alur agen atau alur kerja agar Anda dapat fokus pada area tertentu.

Penting

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

Fitur pratinjau tidak dibuat 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 siap produksi, lihat Gambaran umum Microsoft Copilot Studio.

Untuk menampilkan alur agen atau alur kerja di desainer, buka Copilot Studio, pilih Alur, pilih alur, lalu pilih tab Buat.

Cuplikan layar desainer Copilot Studio yang menunjukkan alur kerja yang diterbitkan dengan pemicu dan beberapa tindakan.

Mengubah cara alur Anda ditampilkan

Tergantung pada ukuran dan kompleksitas alur agen atau alur kerja Anda, Anda mungkin ingin menyesuaikan tampilan alur tersebut agar lebih mudah dikelola. Bilah alat di sudut kiri bawah kanvas mengontrol tampilan.

Cuplikan layar toolbar opsi tampilan di perancang Copilot Studio, dengan keterangan 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. Sesuaikan tampilan: Ubah ukuran tampilan agar sesuai 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 Tambah langkah. Panel Tambahkan akan terbuka.

  2. Di bagian Tambahkan, mulai ketik tindakan yang ingin Anda lakukan pada alur Anda 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 memutuskan bahwa tindakan tidak diperlukan, pilih ikon Hapus di sudut kanan atas tindakan.

Memeriksa parameter alur

Untuk melihat parameter pemicu atau tindakan dalam 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.

Melihat riwayat versi alur agen

Riwayat versi dicatat di Microsoft Dataverse saat Anda membuat atau memodifikasi 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 desainer, pilih versi tersebut dalam daftar.

Memeriksa kesalahan

Kesalahan dalam tindakan alur kerja ditandai dengan warna merah. Untuk melihat detail kesalahan pada satu tindakan, pilih kesalahan tersebut. Untuk menampilkan semua kesalahan di seluruh alur, buka banner pusat kesehatan. Untuk melihat detail setiap kesalahan, pilih kesalahan tersebut.

Penting

Anda tidak dapat menerbitkan alur jika alur tersebut mengandung kesalahan. 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 coba memungkinkan Anda memverifikasi langkah atau seluruh alur tanpa meninggalkan perancang, menggunakan data hulu nyata, nilai tiruan, atau output dari eksekusi sebelumnya.

Ada dua cara untuk menjalankan pengujian:

Apa yang Anda ingin periksa Cara menguji Di mana menemukannya
Satu tindakan atau langkah AI secara terpisah Menguji node ini Tab Uji di dalam panel samping node
Alur lengkap, ujung-ke-ujung Menjalankan pengujian alur Tombol Putar di bilah perintah di bagian atas

Kedua antarmuka memiliki ide yang sama: memberikan input (nyata atau tiruan), menjalankan, lalu memeriksa output.

Menguji satu node dalam alur kerja

Buka tindakan atau node apa pun dalam alur kerja Anda dan pilih tombol Putar atau Uji. Ada tiga bagian:

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

    Cuplikan layar panel pengujian node yang menampilkan 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 tipe data yang diharapkan (string, email, tanggal-waktu, angka, dll.).

  4. Output: Hasil langsung dari pengujian terbaru, diformat sesuai tipe node (JSON, hasil perintah, respons konektor, dll.).

Input tiruan

Secara default, bidang input kosong. Anda bisa:

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

Cuplikan layar panel pengujian node yang menunjukkan bidang input kosong dengan lencana jenis di sebelah kanan.

Kiat

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

Memuat nilai dari eksekusi 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 sudah pernah dijalankan, Anda dapat menggunakan ulang data sebenarnya alih-alih mengetiknya.

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

  2. Perancang mengambil output langkah dari proses tersebut dan memasukkannya ke dalam skema input node Anda. Nilai yang cocok ditulis ke dalam bidang input.

  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.

Menjalankan pengujian

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

  • Atur ulang pengujian menghapus input dan output 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 eksekusi dimulai, perancang:

  1. Menyimpan dan menerbitkan alur jika ada perubahan yang belum disimpan (atau jika ini pertama kalinya).
  2. Menginstal koneksi baru saat pertama kali dijalankan.
  3. Memicu eksekusi. Alur tergantung pada jenis pemicu Anda.
Jenis pemicu Apa yang terjadi ketika Anda memilih Uji
Permintaan Manual / HTTP Dialog akan terbuka untuk Anda memasukkan input pemicu, kemudian alur akan segera dijalankan.
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 akan menampilkan satu bidang untuk setiap input yang telah Anda definisikan 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 eksekusi).
  • Objek/array: Area teks multi-baris tempat Anda dapat menempelkan JSON.

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

Kotak dialog akan 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 menampilkan tombol Batalkan saat eksekusi aktif.
  • Panel Aktivitas (di sisi kanan) menampilkan eksekusi yang sedang berlangsung 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 berfungsi ganda sebagai riwayat eksekusi 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 untuk melihat riwayat lebih lama.
  • 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