Bagikan melalui


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

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 oleh agen.

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

Prasyarat

  • Memahami cara membuat alur dari Copilot Studio kanvas penulisan

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
  • Date
  • Tanda Waktu
  • Daftar [String]
  • Daftar [Number]
  • Daftar [Boolean]
  • Daftar [Object]
  • Daftar [Date]
  • Daftar [Timestamp]

Membuat topik dan alur

  1. Buka halaman Topik untuk agen Anda.

  2. Buat topik baru yang disebut pesan Echo.

  3. Tambahkan gema frasapemicu.

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

  5. Untuk Mengidentifikasi, pilih Seluruh respons pengguna.

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

    Tangkapan layar simpul Pertanyaan yang mengumpulkan respons pengguna.

  7. Pilih ikon Tambahkan simpul di bawah node Pertanyaan, dan pilih Tambahkan alat.

  8. Pada 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 Merespons agen.

  9. Pilih Simpan draf.

  10. Pada tab Gambaran Umum alur, edit detail untuk alur, ganti nama dengan parameter Echo. Pilih Simpan.

  11. Kembali ke tab Perancang .

Menambahkan parameter input ke alur

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

  2. Pilih Teks dan masukkan nama String_Input.

    Tangkapan layar parameter input pemicu aliran.

Menambahkan parameter output ke alur

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

  2. Pilih Teks dan masukkan nama String_Output.

    Tangkapan layar parameter output tindakan respons.

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

  4. Pilih Simpan draf dan Terbitkan. Copilot Studio memberi tahu Anda saat alur agen diterbitkan.

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

Memanggil alur dari topik

  1. Pilih simpul tindakan baru.

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

    Tangkapan layar simpul Tindakan yang memanggil alur 'Parameter Echo'.

  3. Tambahkan simpul Pesan .

  4. Pilih Sisipkan variabel, lalu pilih String_Output.

    Tangkapan layar simpul pesan yang menggemakan input pengguna.

  5. Pilih Simpan.

  6. Uji agen Anda.

    Tangkapan layar percakapan agen.