Sonuç listesi döndürme

Yardımcı pilotdan dış sistemde veri aramasını ve sonuçların listesini döndürmesini istemek yaygındır. Bunu yapmak için, Microsoft Copilot Studio aşağıdakileri yapmak için bir Power Automate akışı çağırabilir:

• Kimlik doğrulama ve harici bir çözüme bağlanma
• Kullanıcı girişlerine göre sorgu çalıştırma
• Sonuçları biçimlendirme
• Sonuçları yardımcı pilota döndürme

Bu örnekte, firma aramak için Power Automate'te Dataverse bağlayıcısı kullanacaksınız. Daha sonra firma adını, şehri ve firma numarasını içeren sonuçların listesini Microsoft Copilot Studio'a döndürüreceksiniz.

Önkoşullar

• Copilot Studio yazma tuvalinden akış oluşturma işleminin nasıl gerçekleştirilebileceğini öğrenin
• Bilgiyi iletmek için giriş ve çıkış değişkenlerini kullanın
• Ortamınız için Dataverse aramasını yapılandırma

Dataverse Firma tablosu ayarlama

Firma tablosu, Power Platform ortamlarına otomatik olarak dahil edilen standart bir tablodur. Ancak, firma verileriyle birlikte gelmez. Yardımcı pilotunuzun firmaları arayabilmesi için Firma tablosunu doldurmanız gerekir.

Zaten veri içeren bir Firma tablonuz varsa bu adımı atlayın ve Konu oluşturma'ya geçiş yapın. Ancak yardımcı pilotunuzu sonraki adımlarda test ederken farklı arama terimleri kullanmanız gerekir.

1. Power Apps portalına gidin.

2. Yan bölmede Dataverse altından Tablolar'ı seçin.

3. Firma tablosunu seçin ve tablo özellikleri sayfasında Düzenle'yi seçin.

4. Tabloya aşağıdaki satırları ekleyin:

   Adres 1: Şehir	Hesap Adı	Hesap Numarası
   Seattle	Contoso Inc	AC0125
   San Francisco	Contoso Residences	AC0255
   Olympia	Contoso Meal Delivery	AC0035

Konu oluşturma

1. Yardımcı pilotunuzun Konular sayfasına gidin.

2. Firma Araması adlı bir konu oluşturun.

3. Aşağıdaki tetikleme tümcecikleri'ni ekleyin:

   • Müşteri arıyorum
   • Firma arıyorum
   • firma ara
   • müşteri ara

4. Bir İleti düğümü ekleyin ve Firma aradığınız anlaşılıyor. Sizin için arama yapabilirim. iletisini girin.

5. Bir Soru düğümü ekleyin ve Aradığınız müşterinin adı nedir? iletisini girin.

6. Kimlik için Kuruluş'u seçin.

   Kullanıcının tam yanıtı da çalışır. Ancak Kuruluş varlığını seçmek, yanıttan kuruluş adını ayıklamak için yardımcı pilotun dil anlama özelliklerinden yararlanır.

   

7. Yanıtı farklı kaydet için değişkeni kuruluş olarak yeniden adlandırın.

Akış oluşturma

1. Yazma tuvalinde Düğüm ekle'yi (+) seçin. Bir eylem çağırın'ı seçin ve ardından Akış oluştur seçeneğini belirleyin.

2. Power Automate portalında akışı Firma Ara olarak adlandırın.

3. Kuruluş adlı bir Metin girişi ekleyin.

   

4. Yeni adım ekleyin'i (+) ve Eylem ekleyin'i seçin.

5. Microsoft Dataverse bağlayıcısını ve ardından Satır ara'yı seçin.

   Bu eylem, Dataverse Firma tablonuzda ilgili firmaları bulmak için benzer öğe eşleştirmeyi kullanır.

   

6. Arama terimi için Kuruluş değişkenini seçin.

7. Gelişmiş seçenekleri göster'i seçin ve aşağıdaki öğeleri belirtilen şekilde ayarlayın:

   • Tablo filtre Öğesi: account
   • Öğeye göre sırala - 1: @search.score desc
   • Öğeye göre sırala - 2: name asc

   

Sonuçları biçimlendirme

Satır ara eylemi JSON verilerini içeren Satır listesi değişkenini döndürür. Verileri kullanabilmeniz için bunu JSON ayrıştır eylemiyle analiz etmeniz gerekir.

1. Yeni adım ekleyin'i (+) ve Eylem ekleyin'i seçin.

2. Veri İşlemi bağlayıcısını seçin ve ardından JSON ayrıştır eylemini seçin.

3. İçerik kutusunda, Satır ara altında Satır listesi değişkenini seçin.

4. Aşağıdaki JSON şemasını kopyalayıpŞema kutusuna yapıştırın:

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

   

5. Yeni adım ekleyin'i (+) ve Eylem ekleyin'i seçin. Değişken bağlayıcısını seçin ve ardından Değişkeni Başlat eylemini seçin.

6. Ad olarak ListOfAccounts girin. Tür olarak Dize seçin.

   

7. Yeni adım ekleyin'i (+) ve Eylem ekleyin'i seçin. Denetim bağlayıcısını ve ardından Her birine uygula eylemini seçin.

8. Dinamik içerik menüsünü açmak için Önceki adımlardan bir çıkış seçin kutusunu seçin. Gövde araması yapın ve JSON Ayrıştır altından Gövde değişkenini seçin.

9. Yeni adım ekleyin'i (+) ve Eylem ekleyin'i seçin. Değişken bağlayıcısını seçin ve ardından Dize değişkenine ekle eylemini seçin.

10. Ad olarak ListOfAccounts seçin. Aşağıdaki metni kopyalayın ve Değer kutusuna yapıştırın:

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

11. Her sonucun kendi satırında görünmesini sağlamak için kod parçacığından sonra satır sonu ekleyin.

    

12. Değerleri Microsoft Copilot Studio'a döndür eyleminde bir Metin çıkışı ekleyin. Ad olarak FoundAccounts girin. Değer olarak ListOfAccounts seçin.

    

13. Kaydet'i seçin.

Akışı Microsoft Copilot Studio'dan çağırma

1. Microsoft Copilot Studio yazma tuvalinde Düğüm ekle'yi (+) ve ardından Eylem çağır'ı seçin.

2. Daha önce oluşturduğunuz Firma Ara'yı seçin.

3. Kuruluşun değeri aldığı kaynak olarak kuruluş değişkenini seçin.

4. Bir İleti düğümü ekleyin ve Tamam, bunu buldum. iletisini girin

5. İkinci bir İleti düğümü ekleyin. Değişken ekle'yi ve ardından FoundAccounts öğesini seçin.

   

6. Kaydet'i seçin.

7. Yardımcı pilotunuzu Yardımcı pilotu test etme bölmesinde test edin.