Mengembalikan daftar hasil

Artikel
03/04/2025

Biasanya meminta agen untuk mencari data di sistem eksternal dan mengembalikan daftar hasil. Untuk melakukannya, agen dapat memanggil Power Automate alur untuk:

Autentikasi dan sambungkan ke solusi eksternal.
Jalankan kueri berdasarkan input pengguna.
Format hasilnya.
Kembalikan hasilnya ke agen.

Contoh ini menggunakan Dataverse konektor untuk Power Automate mencari akun. Konektor mengembalikan daftar hasil yang menyertakan nama akun, kota, dan nomor akun ke agen Anda.

Prasyarat

Memahami cara membuat alur dari Copilot Studio kanvas penulisan
Gunakan variabel input dan output untuk meneruskan informasi
Mengonfigurasi Dataverse pencarian untuk lingkungan Anda

Menyiapkan Dataverse tabel Akun

Tabel Akun adalah tabel standar yang tersedia secara default di Power Platform lingkungan. Namun, itu tidak dilengkapi dengan data akun. Sebelum agen Anda dapat mencari akun, Anda harus mengisi tabel Akun.

Jika Anda sudah memiliki tabel Akun dengan data, lewati langkah ini dan lanjutkan ke Membuat topik. Namun, ingatlah untuk menggunakan istilah penelusuran yang relevan dengan data Anda saat menguji agen Anda di langkah selanjutnya.

Buka Power Apps portal.
Di panel navigasi, pilih Tabel.
Pilih tabel Akun , lalu pada halaman properti tabel, pilih Edit.
Tambahkan baris berikut ke tabel:

Alamat 1: Kota Nama Akun Nomor Akun

Seattle Contoso Inc AC0125

San Francisco Contoso Residences AC0255 ·

Olympia Pengiriman Makanan Contoso AC0035 ·

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

Buat topik

Masuk Copilot Studio, buka halaman Topik untuk agen Anda.
Buat topik bernama Pencarian akun.
Tambahkan frasa pemicu berikut:
- Saya sedang mencari pelanggan
- Saya sedang mencari akun
- Cari akun
- Cari Pelanggan
Tambahkan simpul Pesan dan masukkan pesan "Kedengarannya seperti Anda sedang mencari akun. Aku bisa mencarinya untukmu."
Tambahkan simpul Pertanyaan dan masukkan pesan "Siapa nama pelanggan yang Anda cari?"
Untuk Identifikasi, pilih Organisasi.

Seluruh tanggapan pengguna juga akan berhasil. Namun, dengan memilih entitas Organisasi , Anda memanfaatkan kemampuan pemahaman bahasa agen untuk mengekstrak nama organisasi dari respons.
Untuk Simpan respons pengguna sebagai, ganti nama variabel menjadi "organisasi".

Buat alur

Pilih ikon Tambahkan simpul di bawah simpul apa pun, dan pilih Tambahkan tindakan .
Pada tab Tindakan dasar, pilih Alur Power Automate baru.
Dalam Power Automate, pilih nama alur dan ganti dengan Akun Penelusuran.
Pilih pemicu Jalankan alur dari alur Copilot dan tambahkan parameter input Teks bernama Organisasi.
Pilih ikon Tambahkan di bawah pemicu Jalankan alur dari Copilot .
Di Tambahkan tindakan, telusuri "Microsoft Dataverse", lalu pilih tindakan Cari baris .

Tindakan ini menggunakan pencocokan fuzzy untuk menemukan akun yang relevan di tabel Akun Anda Dataverse .
Dalam kotak Istilah pencarian, masukkan garis miring (/), pilih Sisipkan konten dinamis, lalu pilih parameter input Organisasi Anda .
Untuk Parameter tingkat lanjut, pilih Tampilkan semua dan atur nilai berikut:
- Item filter tabel: 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 dapat menggunakan data, Anda harus menganalisisnya dengan tindakan Parse JSON .

Pilih ikon Tambahkan di bawah tindakan Cari baris .
Di Tambahkan tindakan, cari "Operasi Data", dan pilih tindakan Uraikan JSON .
Dalam kotak Konten , masukkan garis miring (/), pilih Sisipkan konten dinamis, lalu pilih Daftar baris.

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"
        ]
    }
}

Cuplikan layar skema JSON di properti tindakan Uraikan JSON.

Pilih ikon Tambahkan di bawah tindakan Uraikan JSON .
Di Tambahkan tindakan, telusuri "Variabel", lalu pilih tindakan Inisialisasi variabel .
Di kotak Nama , masukkan "ListOfAccounts".
Untuk Jenis, pilih String.
Pilih ikon Tambahkan di bawah tindakan Inisialisasi variabel .
Di Tambahkan tindakan, cari "Kontrol", lalu pilih Terapkan ke setiap tindakan.
Dalam kotak Pilih output dari langkah sebelumnya, masukkan garis miring (/), pilih Sisipkan konten dinamis, lalu pilih variabel Isi di bawah Uraikan JSON.
Pilih ikon Tambahkandi dalam Terapkan ke setiap tindakan.
Di Tambahkan tindakan, telusuri "Variabel", lalu pilih tindakan Tambahkan ke variabel string .
Untuk Nama, pilihListOfAccounts .

Salin teks berikut dan tempelkan di kotak Nilai :

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

Tambahkan jeda baris setelah cuplikan untuk membuat setiap hasil muncul di barisnya sendiri.
Dalam tindakan Tanggapi Copilot , tambahkan output Teks .
Untuk Nama, masukkan "FoundAccounts".
Untuk nilainya, masukkan garis miring (/) di kotak, pilih Sisipkan konten dinamis, lalu pilih variabel ListOfAccounts .
Simpan dan publikasikan alur Anda.

Panggil alur dari Copilot Studio

Dalam Copilot Studio, pilih ikon Tambahkan simpul di bawah simpul Pertanyaan , pilih Tambahkan tindakan, lalu pilih alur yang Anda buat sebelumnya,Cari akun.
Atur parameter input alur ke variabel output dari simpul Pertanyaan : Organisasi (String)mendapatkan nilainya dari variabel organisasi .
Tambahkan simpul Pesan dan masukkan pesan "Oke, inilah yang saya temukan."
Tambahkan simpul Pesan kedua . Pilih ikon Sisipkan variabel , lalu pilih FoundAccounts.
Pilih Simpan.
Uji agen Anda.

Bagikan melalui