Mengembalikan daftar hasil

Penting

Power Virtual Agents kemampuan dan fitur sekarang menjadi bagian dari Microsoft Copilot Studio mengikuti investasi signifikan dalam AI generatif dan integrasi yang ditingkatkan Microsoft Copilot.

Beberapa artikel dan tangkapan layar mungkin merujuk saat Power Virtual Agents kami memperbarui dokumentasi dan konten pelatihan.

Adalah umum untuk meminta kopilot untuk mencari data dalam sistem eksternal dan mengembalikan daftar hasil. Untuk melakukan itu, Microsoft Copilot Studio dapat memanggil aliran Power Automate ke:

• Mengautentikasi dan menyambungkan ke solusi eksternal
• Menjalankan kueri berdasarkan input pengguna
• Memformat hasil
• Kembalikan hasilnya ke kopilot

Dalam contoh ini, Anda akan menggunakan Dataverse konektor untuk Power Automate menelusuri akun. Kemudian Anda akan mengembalikan daftar hasil yang menyertakan nama akun, kota, dan nomor akun Microsoft Copilot Studio.

Prasyarat

• Memahami cara membuat alur dari Microsoft Copilot Studio kanvas penulisan
• Menambahkan variabel input dan output
• Mengonfigurasi Dataverse pencarian untuk lingkungan Anda

Menyiapkan Dataverse tabel Akun

Tabel Akun adalah tabel standar yang disertakan secara otomatis di Power Platform lingkungan. Namun, itu tidak datang dengan data akun. Sebelum kopilot dapat menelusuri akun, Anda harus mengisi tabel Akun.

Jika Anda sudah memiliki tabel Akun dengan data, lewati langkah ini dan lanjutkan ke Membuat topik. Namun, Anda harus menggunakan istilah penelusuran yang berbeda saat menguji kopilot di langkah selanjutnya.

1. Power Apps Buka portal.

2. Di panel samping, di bawah Dataverse, pilih Tabel.

3. Pilih tabel Akun , lalu pada halaman properti tabel, pilih Edit.

4. Tambahkan baris berikut ke tabel:

   Alamat 1: Kota	Nama Akun	Nomor Akun
   Seattle	Contoso Inc	AC0125
   San Francisco	Tempat Tinggal Contoso	AC0255
   Olympia	Pengiriman Makanan Contoso	AC0035

Buat topik

1. Buka halaman Topik untuk kopilot Anda.

2. Buat topik yang disebut Pencarian Akun.

3. Tambahkan frasa pemicu berikut:

   • Saya mencari pelanggan
   • Saya mencari akun
   • Cari akun
   • Cari Pelanggan

4. Tambahkan node Pesan dan masukkan pesan Kedengarannya seperti Anda sedang mencari akun. Aku bisa mencarinya untukmu ..

5. Tambahkan node Pertanyaan dan masukkan pesan Siapa nama pelanggan yang Anda cari?.

6. Untuk Identifikasi, pilih Organisasi.

   Seluruh respons pengguna juga akan berfungsi. Namun, memilih entitas Organisasi memanfaatkan kemampuan pemahaman bahasa kopilot untuk mengekstrak nama organisasi dari respons.

   

7. Untuk Simpan respons sebagai, ganti nama variabel menjadi organisasi.

Buat alur

1. Pada kanvas penulisan, pilih Tambahkan node (+). Pilih Panggil tindakan, lalu pilih Buat alur.

2. Power Automate Di portal, beri nama alur Cari Akun.

3. Tambahkan input Teks bernama Organisasi.

   

4. Pilih Sisipkan step (+) baru dan pilih Tambahkan tindakan.

5. Microsoft Dataverse Pilih konektor, lalu pilih tindakan Cari baris .

   Tindakan ini menggunakan pencocokan fuzzy untuk menemukan akun yang relevan di tabel Akun Anda Dataverse .

   

6. Untuk istilah pencarian, pilih variabel Organisasi .

7. Pilih Tampilkan opsi lanjutan dan atur item berikut seperti yang diberikan:

   • Filter tabel Item: account
   • Urutkan berdasarkan Item - 1: @search.score desc
   • Urutkan berdasarkan Item - 2: name asc

   

Memformat hasil

Tindakan Cari baris mengembalikan variabel Daftar baris , yang berisi data JSON. Sebelum Anda dapat menggunakan data, Anda harus menganalisisnya dengan tindakan Parse JSON .

1. Pilih Sisipkan step (+) baru dan pilih Tambahkan tindakan.

2. Pilih konektor Operasi Data , lalu pilih tindakan Parse JSON .

3. Dalam kotak Konten , di bawah Baris pencarian, pilih variabel Daftar baris .

4. Salin skema JSON berikut dan tempelkan di kotak Skema :

   {
       "type": "array",
       "items": {
           "type": "object",
           "properties": {
               "@@search.score": {
                   "type": "number"
               },
               "name": {
                   "type": "string"
               },
               "address1_city": {
                   "type": "string"
               },
               "accountnumber": {
                   "type": "string"
               }
           },
           "required": [
               "name"
           ]
       }
   }
   

   

5. Pilih Sisipkan step (+) baru dan pilih Tambahkan tindakan. Pilih konektor Variabel , lalu pilih tindakan Inisialisasi Variabel .

6. Untuk Nama, masukkan ListOfAccounts. Untuk Jenis, pilih String.

   

7. Pilih Sisipkan step (+) baru dan pilih Tambahkan tindakan. Pilih konektor Kontrol , lalu pilih Terapkan ke setiap tindakan.

8. Pilih kotak Pilih output dari langkah sebelumnya untuk membuka menu Konten dinamis. Cari isi, lalu di bawah Parse JSON, pilih variabel Badan .

9. Pilih Sisipkan step (+) baru dan pilih Tambahkan tindakan. Pilih konektor Variabel , lalu pilih tindakan Tambahkan ke variabel string.

10. Untuk Nama, pilih ListOfAccounts. Salin teks berikut dan tempelkan di kotak Nilai :

    - @{items('Apply_to_each')['accountnumber']}: @{items('Apply_to_each')['name']} - @{items('Apply_to_each')['address1_city']}
    

11. Tambahkan hentian baris setelah cuplikan untuk membuat setiap hasil muncul di barisnya sendiri.

    

12. Dalam tindakan Kembalikan nilai ke Microsoft Copilot Studio , tambahkan output Teks . Untuk Nama, masukkan FoundAccounts. Untuk Nilai, pilihListOfAccounts .

    

13. Pilih Simpan.

Memanggil alur dari Microsoft Copilot Studio

1. Microsoft Copilot Studio Pada kanvas penulisan, pilih Tambahkan node (+), lalu pilih Panggil tindakan.

2. Pilih alur yang Anda buat sebelumnya,Cari Akun.

3. Untuk Organisasi mendapatkan nilai dari, pilih variabel organisasi .

4. Tambahkan node Pesan dan masukkan pesan Oke, ini yang saya temukan.

5. Tambahkan node Pesan kedua . Pilih Sisipkan variabel, lalu pilih FoundAccounts.

   

6. Pilih Simpan.

7. Uji kopilot Anda di panel Uji kopilot .