Ikhtisar Variabel

Note

Artikel ini menjelaskan fitur yang digunakan oleh agen atau alur agen yang didukung oleh standard harness.

Variabel ada pada empat tingkat, atau cakupan:

  • Variabel topik yang hanya dapat Anda gunakan dalam topik tempat Anda membuatnya. Cakupan ini adalah default untuk variabel yang Anda buat.
  • Variabel global yang dapat Anda gunakan di semua topik. Anda dapat mengubah cakupan variabel topik dengan menjadikannya variabel global.
  • Variabel sistem secara otomatis dibuat oleh Copilot Studio untuk agen. Mereka memberikan informasi yang lebih kontekstual tentang percakapan atau pengguna. Semuanya tersedia di semua topik.
  • Variabel lingkungan yang Anda buat di Power Platform. Mereka bersifat hanya-baca di Copilot Studio. Mereka menyimpan kunci dan nilai parameter, yang kemudian berfungsi sebagai input untuk berbagai objek aplikasi lain, termasuk Copilot Studio. Dengan memisahkan parameter dari objek yang mengkonsumsi, Anda dapat mengubah nilai dalam lingkungan yang sama atau saat memigrasikan solusi ke lingkungan lain. Alternatif lainnya adalah membiarkan nilai parameter dengan kode keras dalam komponen yang menggunakannya.

Jenis variabel

Setiap variabel memiliki jenis dasar. Jenis menentukan nilai apa yang dapat ditahan variabel dan operator yang dapat Anda gunakan saat membuat ekspresi logis dengannya.

Tipe Description
String Urutan karakter yang digunakan untuk mewakili teks
Boolean Nilai logis yang hanya dapat berupa true atau false
Nomor Angka riil apa pun
Tabel Daftar nilai, tetapi semua nilai harus memiliki tipe yang sama
Rekaman Kumpulan pasangan nama-nilai di mana nilai bisa dari jenis apa pun
DateTime Tanggal, waktu, hari dalam seminggu, atau bulan relatif terhadap sebuah titik waktu
Pilihan Daftar nilai string dengan sinonim terkait
Blank Tempat penyimpanan untuk "tanpa nilai" atau "nilai tidak diketahui"; pelajari lebih lanjut di Blank pada dokumentasi Power Fx

Anda mengatur jenis variabel saat pertama kali Anda menetapkan nilai untuk variabel tersebut. Setelah itu, jenisnya menjadi tetap dan Anda tidak dapat menetapkan nilai untuk jenis lain. Misalnya, jika Anda menetapkan nilai awal 1 ke variabel, Anda mengatur jenisnya ke Angka. Jika Anda kemudian mencoba menetapkan nilai String seperti "apples", Anda mendapatkan kesalahan.

Saat Anda menguji agen, variabel mungkin muncul sementara dengan jenis yang tidak diketahui. Variabel yang tidak diketahui belum memiliki nilai.

Urutan variabel ditentukan dari atas ke bawah kanvas pengeditan. Agen lebih dahulu mempertimbangkan node di bagian atas kanvas penyusunan sebelum node di bagian bawah.

Saat Anda membuat cabang dengan menggunakan node Kondisi, Copilot Studio mengurutkan cabang-cabang dari kiri ke kanan. Agen mempertimbangkan node di cabang paling kiri sebelum node di cabang paling kanan.

Entities

Copilot Studio menggunakan entitas untuk mengidentifikasi jenis informasi tertentu dari respons pengguna. Informasi yang diidentifikasi disimpan dalam variabel jenis yang sesuai untuk informasi. Tabel berikut mencantumkan jenis dasar variabel yang terkait dengan entitas bawaan.

Entitas Jenis dasar variabel
Opsi Pilihan Ganda Pilihan
Seluruh respons pengguna String
Usia Nomor
Boolean Boolean
Kota String
Color String
Continent String
Negara atau kawasan String
Tanggal dan waktu DateTime
Email String
Event String
Integer Integer
Bahasa String
Uang Nomor
Nomor Nomor
Bilangan Ordinal Nomor
Organisasi String
Persentase Nomor
Nama orang String
Nomor telepon String
Titik Menarik String
Kecepatan Nomor
State String
Alamat rumah String
Suhu Nomor
URL String
Weight Nomor
Kode pos String
Entitas khusus Pilihan

Variabel lingkungan

Variabel lingkungan merupakan konsep Power Platform. Variabel lingkungan memungkinkan skenario manajemen siklus hidup aplikasi (ALM) dasar untuk memindahkan aplikasi antar Power Platform lingkungan. Dalam skenario ini, aplikasi tetap sama kecuali beberapa referensi eksternal utama yang berbeda antara lingkungan sumber dan lingkungan tujuan.

Gunakan variabel lingkungan dengan cara yang sama seperti variabel topik, global, dan sistem. Salah satu perbedaan penting adalah bahwa variabel lingkungan bersifat baca-saja di Copilot Studio. Penulis agen tidak dapat memodifikasi variabel lingkungan di Copilot Studio. Namun, administrator dapat mengubah nilai variabel lingkungan di Power Apps. Di Copilot Studio, Anda dapat menggunakan panel Variabel untuk melihat informasi tentang variabel lingkungan. Panel properti Variabel juga memiliki tautan ke Power Apps, pengalaman pembuatan untuk variabel lingkungan.

Versi yang dipublikasikan dari agen yang menggunakan variabel lingkungan mencakup nilai yang Anda tetapkan untuk variabel tersebut saat Anda mempublikasikan agen. Setiap kali administrator memperbarui variabel lingkungan, Anda harus mempublikasikan ulang agen yang menggunakan variabel tersebut agar perubahan berlaku saat runtime. Namun, ada satu pengecualian: Anda tidak perlu memublikasikan ulang agen Anda saat nilai variabel lingkungan dari jenis rahasia berubah. Tidak seperti variabel lingkungan lain, variabel rahasia diambil saat runtime.

Jenis variabel lingkungan di Peta Copilot Studio untuk jenis data Power Apps sebagai berikut:

Jenis di Copilot Studio Ketik di Power Apps
Bilangan desimal Nomor
JSON Deteksi jenis dari nilai. Jika tidak JSON => Tidak ditentukan (kesalahan validasi)
Text String
Yes/No Boolean
Sumber data String
Rahasia String

Note

Anda melihat kesalahan variabel lingkungan dalam chat uji coba dan saat mempublikasikan. Namun, error-error ini tidak muncul di daftar Topik karena variabel lingkungan bukanlah variabel topik.

Variabel sistem

Setiap agen memiliki variabel sistem bawaan yang memberikan informasi tambahan tentang percakapan.

Tangkapan layar variabel sistem dalam sebuah topik.

Copilot Studio tidak menampilkan semua variabel sistem. Untuk mengakses variabel sistem tersembunyi, gunakan rumus Power Fx.

Untuk menggunakan variabel sistem dalam rumus Power Fx, tambahkan System. sebelum nama variabel. Misalnya, untuk menyertakan variabel sistem User.DisplayName dalam rumus, rujuk sebagai System.User.DisplayName.

Name Tipe Definition
Aktivitas.Lampiran tabel Lampiran file yang disediakan pengguna.
Aktivitas.Saluran pilihan ID saluran percakapan saat ini.
Activity.ChannelData apa pun Objek yang berisi konten khusus saluran.
Aktivitas.ChannelId string ID dari saluran percakapan saat ini, dalam bentuk string.
Activity.From.Id string ID unik khusus saluran pengirim.
Aktivitas.Dari.Nama string Nama pengirim yang mudah digunakan khusus saluran.
Activity.Name string Nama acara.
Activity.Recipient.Id string Properti Type dari aktivitas yang masuk.
Aktivitas.Penerima.Nama string Mewakili nama tampilan untuk agen dalam saluran. Dalam konteks saluran telepon, nilai variabel ini adalah nomor telepon tempat agen dilampirkan.
Aktivitas.Teks string Pesan terbaru yang dikirim oleh pengguna.
Activity.Type pilihan Jenis aktivitas.
Activity.TypeId string Jenis aktivitas, sebagai string.
Aktivitas.Nilai apa pun Nilai yang tidak terbatas.
Bot.EnvironmentId string ID lingkungan operasi agen.
Bot.Id string ID agen.
Bot.Name string Nama agen Anda.
Bot.SchemaName string Nama skema agen.
Bot.TenantId string ID penyewa untuk agen.
ClientPluginActions pilihan Kumpulan Tindakan Plugin Klien Dinamis yang perlu dipertimbangkan untuk orkestrasi generatif.
Conversation.Id string ID unik percakapan saat ini.
Percakapan.DalamModeUji Boolean Bendera Boolean yang mewakili apakah percakapan terjadi di kanvas pengujian.
Conversation.LocalTimeZone string Nama zona waktu yang akan digunakan oleh pengguna dalam format database Zona Waktu IANA.
Conversation.LocalTimeZoneOffset tanggalwaktu Offset waktu dari UTC untuk zona waktu lokal saat ini.
Error.Code string Kode kesalahan untuk kesalahan saat ini.
Pesan kesalahan untuk kesalahan saat ini.
Pesan.Kesalahan string Pesan kesalahan untuk kesalahan saat ini.
Catatan: Variabel ini hanya didukung jika pemicunya adalah On Error.
FallbackCount number Variabel ini menghitung waktu di mana topik tidak dapat dicocokkan dengan input pengguna.
Catatan: Variabel ini hanya didukung jika pemicunya adalah On Unknown Intent.
InactivityTimer.Continue Boolean Bendera Boolean yang mewakili apakah timer perlu dilanjutkan.
Catatan: Variabel ini hanya didukung jika pemicunya adalah Inactivity.
InactivityTimer.Jumlah number Frekuensi timer OnInactivity diaktifkan karena tidak aktifnya pengguna setelah waktu yang dikonfigurasi.
Catatan: Variabel ini hanya didukung jika pemicunya adalah Inactivity. Pelajari selengkapnya di Pemicu tidak aktif.
LastMessage.Id string ID pesan sebelumnya yang dikirim oleh pengguna.
PesanTerakhir.Teks string Pesan sebelumnya yang dikirim oleh pengguna.
Recognizer.ExtractedEntities pilihan Mewakili entitas yang diekstrak dari pesan pemicu.
Catatan: Variabel ini hanya didukung jika pemicunya adalah On Select Intent.
Recognizer.IntentOptions pilihan Mewakili opsi niat saat pengenal mengembalikan hasil ambigu.
Catatan: Variabel ini hanya didukung jika pemicunya adalah On Select Intent.
Recognizer.SelectedIntent pilihan Mewakili niat yang dipilih dari pengenal.
Catatan: Variabel ini hanya didukung jika pemicunya adalah On Select Intent.
Recognizer.TriggeringMessage.Id string ID pesan pengguna yang memicu topik saat ini.
Recognizer.TriggeringMessage.Text string Pesan pengguna yang memicu topik saat ini.
Recognizer.AlasanBanyakTopikCocok string Digunakan untuk menentukan mengapa beberapa topik cocok.
Catatan: Variabel ini hanya didukung jika pemicunya adalah On Select Intent.
Alasan Masuk pilihan Digunakan untuk menentukan opsi masuk yang dibutuhkan saat topik diaktifkan.
Catatan: Variabel ini hanya didukung jika pemicunya adalah On Sign In.
Pengguna.Bahasa pilihan Variabel ini digunakan untuk mengatur lokal bahasa pengguna per percakapan.

Variabel untuk agen yang diaktifkan dengan suara

Variabel berikut hanya tersedia untuk agen yang diaktifkan dengan suara. Pelajari lebih lanjut di Gunakan variabel suara.

Name Tipe Definition
Activity.InputDTMFKeys string Nilai kunci DTMF mentah dari telepon.
Activity.SpeechRecognition.Confidence number Skor kepercayaan untuk hipotesis pengenalan suara otomatis hasil keseluruhan, 0 banding 1.
Aktivitas.PengenalanUcapan.TeksBerformatMinimum string Teks hasil hipotesis pengenalan ucapan otomatis yang sedikit diformat. Misalnya, "Lima ratus dolar." Kata-kata dieja, tetapi kapitalisasi dan tanda baca dasar disertakan.
JenisMasukanPengguna.Kegiatan pilihan Jenis input terbaru dari pengguna agen. Nilainya dapat berupa pengujian, ucapan, atau DTMF.
Percakapan.OnlyAllowDTMF Boolean Parameter Boolean yang menunjukkan apakah IVR harus diatur ke mode DTMF saja pada waktu berjalan.
Conversation.SipUuiHeaderValue string String header UUI yang digunakan untuk meneruskan konteks ke IVR saat panggilan dimulai.

Variabel untuk autentikasi terintegrasi (default)

Variabel berikut tersedia untuk agen yang dikonfigurasi untuk mengautentikasi dengan Microsoft. Konfigurasi ini menggunakan autentikasi Microsoft Entra ID dan merupakan default untuk agen baru. Pelajari lebih lanjut di Variabel autentikasi.

Name Tipe Definition
User.DisplayName string Nama tampilan pengguna yang sedang berbicara dengan agen.
Email.Pengguna string Alamat email pengguna yang saat ini sedang berbicara dengan agen.
Pengguna.NamaDepan string Nama depan dari pengguna yang saat ini berkomunikasi dengan agen.
User.Id string ID unik dari pengguna yang saat ini berbicara dengan agen.
Pengguna.TelahLogin Boolean Bendera Boolean yang mewakili apakah pengguna saat ini berkomunikasi dengan agen diautentikasi atau tidak.
User.LastName string Nama belakang pengguna yang sedang berkomunikasi dengan agen.
User.PrincipalName string Nama utama pengguna dari pengguna yang sedang berkomunikasi dengan agen.

Variabel untuk autentikasi manual dengan Generic OAuth 2

Variabel berikut tersedia untuk agen yang dikonfigurasi untuk menggunakan penyedia layanan Generic OAuth 2.

Name Tipe Definition
TokenAkses.Pengguna string Token akses untuk pengguna yang mengautentikasi dengan agen.
User.DisplayName string Nama tampilan pengguna yang sedang berbicara dengan agen.
User.Id string ID unik dari pengguna yang saat ini berbicara dengan agen.
Pengguna.TelahLogin Boolean Bendera Boolean yang mewakili apakah pengguna saat ini berkomunikasi dengan agen diautentikasi atau tidak.

Variabel untuk autentikasi manual dengan Microsoft Entra ID

Variabel berikut tersedia untuk agen yang dikonfigurasi untuk menggunakan penyedia layanan Microsoft Entra ID (sebelumnya Azure Active Directory).

Name Tipe Definition
TokenAkses.Pengguna string Token akses untuk pengguna yang mengautentikasi dengan agen.
User.DisplayName string Nama tampilan pengguna yang sedang berbicara dengan agen.
Email.Pengguna string Alamat email pengguna yang saat ini sedang berbicara dengan agen.
Pengguna.NamaDepan string Nama depan dari pengguna yang saat ini berkomunikasi dengan agen.
User.Id string ID unik dari pengguna yang saat ini berbicara dengan agen.
Pengguna.TelahLogin Boolean Bendera Boolean yang mewakili apakah pengguna saat ini berkomunikasi dengan agen diautentikasi atau tidak.
User.LastName string Nama belakang pengguna yang sedang berkomunikasi dengan agen.
User.PrincipalName string Nama utama pengguna yang saat ini berkomunikasi dengan agen.
  • Last updated on