Aracılığıyla paylaş


Sonuç listesi döndürme

Bir aracıdan harici bir sistemde veri aramasını ve bir sonuç listesi döndürmesini istemek yaygın bir durumdur. Bunu yapmak için bir aracı Power Automate akışını çağırabilir:

  1. Kimlik doğrulama ve harici bir çözüme bağlanma.
  2. Kullanıcı girişine dayalı bir sorgu çalıştırmak.
  3. Sonuçları biçimlendirme.
  4. Sonuçları aracıya döndürün.

Bu örnekte hesapları aramak için Power Automate içindeki Dataverse bağlayıcısı kullanılmaktadır. Bağlayıcı, aracınıza hesap adını, şehri ve hesap numarasını içeren bir sonuç listesi döndürür.

Önkoşullar

Dataverse Firma tablosu ayarlama

Hesap tablosu, varsayılan olarak Power Platform ortamında bulunan standart bir tablodur. Ancak, firma verileriyle birlikte gelmez. Aracınızın hesapları arayabilmesi için önce 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, sonraki adımlarda aracınızı test ederken verilerinizle ilgili arama terimlerini kullanmayı unutmayın.

  1. Power Apps portalına gidin.

  2. Gezinti bölmesinde, 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. Copilot Studio'de, aracınızın Konular sayfasına gidin.

  2. Hesap 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. İleti düğümü ekleyin ve "Bir hesap arıyormuşsunuz gibi görünüyor" mesajını girin. Bunu senin için arayabilirim."

  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 tüm yanıtı da işe yarayacaktır. Ancak, Kuruluş varlığını seçerek, yanıttan kuruluş adını çıkarmak için aracının dil anlama yeteneklerinden yararlanırsınız.

  7. Kullanıcı yanıtını farklı kaydet seçeneği için değişkenin adını "kuruluş" olarak değiştirin.

    İleti düğümü ve Soru düğümü içeren 'Hesap arama' konusunun ekran görüntüsü.

Akış oluşturma

  1. Herhangi bir düğümün altına Düğüm ekle simgesini seçin ve Eylem ekle'yi seçin.

  2. Temel eylemler sekmesinde Yeni Power Automate akışı'nı seçin.

  3. Power Automate'de akışın adını seçin ve bunu Hesap ara ile değiştirin.

  4. Copilot'tan bir akış çalıştır akış tetikleyicisini seçin ve Kuruluş adlı bir Metin giriş parametresi ekleyin.

    'Kuruluş' metin girişine sahip akış tetikleyicisinin ekran görüntüsü.

  5. Copilot'tan akış çalıştır akış tetikleyicisinin altındaki Ekle simgesini seçin.

  6. Eylem ekle'de "Microsoft Dataverse" öğesini arayın ve Satırları ara eylemini seçin.

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

  7. Arama terimi kutusuna bir eğik çizgi (/) girin, Dinamik içerik ekle'yi seçin ve ardından Kuruluş giriş parametrenizi seçin.

  8. Gelişmiş parametreler için, Tümünü göster'i seçin ve aşağıdaki değerleri 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 kullanmadan önce, Parse JSON eylemi ile analiz etmelisiniz.

  1. Satırları ara eyleminin altındaki Ekle simgesini seçin.

  2. Eylem ekle bölümünde "Veri İşlemi"ni arayın ve JSON'u Ayrıştır eylemini seçin.

  3. İçerik kutusuna bir eğik çizgi (/) girin, Dinamik içerik ekle'yi ve ardından Satır listesi'ni 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"
            ]
        }
    }
    

    JSON'u ayrıştır eylem özelliklerinde JSON şemasının ekran görüntüsü.

  5. Parse JSON eyleminin altındaki Ekle simgesini seçin.

  6. Eylem ekle bölümünde "Değişken"i arayın ve Değişkeni başlat eylemini seçin.

  7. Ad kutusuna "ListOfAccounts" yazın.

  8. Tür olarak Dize seçin.

    'Değişkeni başlat' eylem özelliklerinin ekran görüntüsü.

  9. Değişkeni başlat eyleminin altındaki Ekle simgesini seçin.

  10. Eylem ekle bölümünde "Denetim"i arayın ve Her birine uygula eylemini seçin.

  11. Önceki adımlardan bir çıktı seçin kutusuna bir eğik çizgi (/) girin, Dinamik içerik ekle'yi seçin ve ardından JSON'u Ayrıştır altında Gövde değişkenini seçin.

  12. Her birine uygula eyleminin içindekiEkle simgesini seçin.

  13. Eylem ekle bölümünde "Değişken"i arayın ve Dize değişkenine ekle eylemini seçin.

  14. Ad olarak ListOfAccounts seçin.

  15. 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']}
    
  16. Her sonucun kendi satırında görünmesini sağlamak için kod parçacığından sonra satır sonu ekleyin.

    'Dize değişkenine ekle' eylem özelliklerinin ekran görüntüsü.

  17. Copilot'a Yanıt Ver eyleminde bir Metin çıktısı ekleyin.

  18. Ad olarak "FoundAccounts" girin.

  19. Değer için kutuya bir eğik çizgi (/) girin, Dinamik içerik ekle'yi seçin ve ardından ListOfAccounts değişkenini seçin.

    'Copilot'e yanıt ver' eylem özelliklerinin ekran görüntüsü.

  20. Akışınızı kaydedin ve yayımlayın.

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

  1. Copilot Studio'de, Soru düğümünün altında Düğüm ekle simgesini seçin, Eylem ekle'yi seçin ve ardından daha önce oluşturduğunuz akışı, Hesabı ara'yı seçin.

  2. Akış giriş parametresini Soru düğümünden çıktı değişkenine ayarlayın: Kuruluş (Dize) değerini kuruluş değişkeninden alır.

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

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

    Bulunan hesapların listesiyle yanıt veren konuşma akışının ekran görüntüsü.

  5. Kaydet'i seçin.

  6. Aracınızı test etme.

    Test panelindeki konuşma örneğinin ekran görüntüsü.