Menggunakan variabel input dan output untuk meneruskan informasi

Gunakan variabel sebagai parameter input dan output untuk meneruskan informasi antara alur agen dan agen Copilot Studio.

Penting

Sebuah agen hanya dapat menerima hingga 1 MB data dari alur dalam satu tindakan. Namun, tidak ada batasan berapa banyak variabel atau jumlah data yang dapat dikirim agen.

Dalam contoh ini, Anda membuat alur dengan parameter input dan mengembalikannya ke agen sebagai parameter output.

Prasyarat

  • Memahami cara membuat alur dari kanvas penulisan Copilot Studio

Jenis parameter yang didukung

Agen Copilot Studio mendukung jenis parameter input dan output berikut untuk alur agen:

  • Angka
  • String
  • Boolean

Jenis data berikut tidak didukung:

  • Objek
  • Tanggal
  • Penanda Waktu
  • Daftar [String]
  • Daftar [Number]
  • Daftar [Boolean]
  • Daftar [Object]
  • Daftar [Date]
  • Daftar [Timestamp]

Membuat topik dan alur

  1. Pergi ke halaman Topik milik agen Anda.

  2. Buat topik baru yang disebut pesan Echo.

  3. Tambahkan echo frasa pemicu.

  4. Tambahkan node Pertanyaan dan masukkan pesan "Beri tahu saya sesuatu dan saya akan mengatakannya kembali kepada Anda."

  5. Untuk Identifikasi, pilih Respons seluruh pengguna.

  6. Untuk Simpan respons pengguna sebagai, ganti nama variabel menjadi userResponse.

    Cuplikan layar node Pertanyaan yang mengumpulkan respons pengguna.

  7. Pilih ikon Tambahkan node dalam node Pertanyaan, dan pilih Tambahkan alat.

  8. Di tab Tindakan dasar, pilih Alur Agen baru. Tab perancang alur agen terbuka dengan templat awal untuk alur agen yang dipanggil oleh agen. Alur mencakup dua tindakan: Saat agen memanggil alur dan Menanggapi agen.

  9. Pilih Publikasikan untuk menyimpan alur sebelum membuat perubahan apa pun. Pemberitahuan muncul saat alur berhasil dibuat.

  10. Pilih Kembali ke agen untuk kembali ke topik Anda. Node Tindakan baru ditambahkan ke topik Anda untuk alur.

  11. Pilih Simpan untuk menyelesaikan penambahan alur sebagai alat untuk agen Anda.

Mengedit alur secara detail

  1. Pada node Tindakan dalam alur, pilih tautan Tampilkan detail alur untuk kembali ke aliran agen.

  2. Pada tab Ikhtisar alur, mengedit rincian alur dan ganti namanya dengan Parameter Echo. Pilih Simpan.

  3. Kembali ke tab Perancang.

Menambahkan parameter input ke alur

  1. Pilih Kapan agen memanggil alur pemicu alur, dan pilih Tambahkan input.

  2. Pilih Teks dan masukkan nama String_Input.

    Cuplikan layar parameter input pemicu alur.

Tambahkan parameter output ke alur kerja

  1. Pilih tindakan respons Menanggapi agen, dan pilih Tambahkan output.

  2. Pilih Teks dan masukkan nama String_Output.

    Cuplikan layar keluaran parameter tindakan respons.

  3. Untuk nilai, masukkan garis miring (/) dalam kotak, pilih Sisipkan konten dinamis, lalu pilih variabel String_Input.

  4. Pilih Simpan draf dan Publikasikan. Copilot Studio akan memberi tahu Anda saat alur agen dipublikasikan.

  5. Pilih Kembali ke agen untuk kembali ke editor topik agen. Alur tindakan baru ditambahkan ke topik.

Memanggil alur dari topik

  1. Pilih node tindakan baru.

  2. Atur parameter input alur ke variabel output dari node Pertanyaan: String_Input (string) mendapatkan nilainya dari variabel userResponse.

    Cuplikan layar dari node Tindakan yang memanggil alur 'Echo parameter'.

  3. Tambahkan node Pesan.

  4. Pilih Sisipkan variabel, lalu pilih String_Output.

    Cuplikan layar node pesan yang menggemakan input pengguna.

  5. Pilih Simpan.

  6. Uji agen Anda.

    Cuplikan layar percakapan agen.

Konten terkait

  • Last updated on