Copilot Studio'ta eklenti eylemleri kullanma (önizleme)

Önemli

Power Virtual Agents yetenekleri ve özellikleri, Microsoft Copilot genelinde üretken yapay zekaya ve gelişmiş tümleştirmelere yapılan önemli yatırımların ardından artık Microsoft Copilot Studio'nun parçasıdır.

Bazı makalelerde ve ekran görüntülerinde, belgeler ve eğitim içeriği güncelleştirilirken Power Virtual Agents'a başvurulabilir.

Bir veya daha fazla eklenti eylemi ekleyerek yardımcı pilotunuzun özelliklerini genişletebilirsiniz. Eklenti eylemleri, yardımcı pilotunuz tarafından üreten eylemler kullanılarak kullanıcılara otomatik olarak yanıt vermek için kullanılır veya bunları konu içinden açıkça arayabilirsiniz.

[Bu makale, yayın öncesi belgelerine dahildir ve değiştirilebilir.]

Temel eklenti eylem türleri

Eklenti eylemleri aşağıdaki temel eylem türlerinden birini temel alır:

• Önceden oluşturulmuş bağlayıcı eylemi
• Özel bağlayıcı eylemi
• Power Automate bulut akışı
• Bot Framework Becerisi

Önemli

Copilot Studio'da oluşturulan konuşma eklentilerini eklenti eylemi olarak kullanamazsınız.

Her temel eylemin amacını açıklayan ek bilgiler bulunur ve yardımcı pilotun sorular oluşturmak için GPT'yi kullanmasına olanak tanır. Bu sorular, eylemi gerçekleştirmek için gereken girişleri doldurmak için gereklidir. Bu nedenle, bir akıştaki girişler gibi gereksinim duyulan tüm giriş değerlerini toplamak için soru düğümlerini el ile yazmanız gerekmez. Girişler çalışma zamanı sırasında sizin için işlenir.

Eklenti eylemleri, eylemin sonuçlarını kullanarak kullanıcının sorgusuna bağlamsal bir yanıt oluşturabilir. Alternatif olarak, eklenti eylemi için açıkça bir yanıt yazabilirsiniz.

İpucu

Bir eklenti işleminden oluşturulan soruları kullanırken kullanıcılarınıza konuşmanın bir kısmının AI tarafından oluşturulduğunu bildirin.

Örneğin Konuşma Başlatmasistem konusuna ek ileti ekleyin. Bu konu, yeni bir görüşme başladığında kullanıcılarınıza gösterilen iletiyi belirler.

Eklenti eylemi ekleme

1. Yardımcı pilotunuzu açın ve gezinti bölmesinde Konular ve Eklentiler'i seçin.

2. +Oluştur'u seçin.

3. Eklenti eylemi (önizleme) öğesini seçin.

   

4. Eylem ekleme (önizleme) sihirbazında, kullanmak istediğiniz eklenti eylemini arayıp seçin.

   Gösterilen varsayılan listede, ortamınızda kullanılabilen Power Automate Akışlar ve özel bağlayıcılar bulunur. Bu liste yaygın olarak kullanılan önceden oluşturulmuş bağlayıcıları ve yardımcı pilotunuza kayıtlı Bot Framework Becerileri de içerir. Daha fazla bilgi için bkz. Microsoft Copilot için AI eklentileri oluşturma (önizleme).

   

   Önemli

   Dinamik İstemler ve Dataverse API'lere dayalı olanlar gibi AI Eklentilerinden oluşturulan bazı eklenti eylemlerinin çalışması için kimlik doğrulama gerekir.

5. Bağlantıyı eylemler için yapılandırın.

   Eklentiye bağlı olarak bağlantınız örnekte gösterildiği gibi otomatik olarak yapılandırılır. Alternatif olarak, sihirbazda talimatlar verilmişse bağlantıyı yapılandırmanız gerekir. Bağlantınız başarıyla yapılandırıldıktan sonra İleri'yi seçin.

   

6. Eklenti eylemlerinizi inceleyin ve gerektiğinde Eklenti Eylemlerinizde değişiklikler yapın. Yardımcı pilotunuza eklenti eylemini eklemek için Sonlandır'ı seçin.

   

Eklenti eylemi çağırma

Üreten eylemleri etkinleştirdiyseniz, ilgili kullanıcı sorgusuna yanıt vermek için eklenti eyleminiz otomatik olarak çağrılabilir.

Alternatif olarak, bir eklenti eylemini açıkça konu içinden çağırabilirsiniz.

Eklenti eyleminizi sınama

Test sohbetini kullanarak yardımcı pilotunuza konuyla ilgili bir soru sorun. Gezinme menüsünün alt kısmındaki sohbet bölmesi görünümünü değiştirebilir (gösterebilir veya gizleyebilirsiniz).

Yardımcı pilotunuz, eklenti eyleminizi isme ve açıklamaya göre seçer ve çalıştırır. Yüksek kaliteli açıklamalar yazabilir ve yardımcı pilotunuzun hangi eklenti eylemlerini seçtiğini görmek için özel izleme modunu kullanma hakkında daha fazla ayrıntıyı üreten eylemler sayfasında bulabilirsiniz.

Alternatif olarak, konuya bir eklenti eylemi eklediyseniz, konu için tetikleme tümceciğiklerinden birine benzer bir ileti girerek bunu test edebilirsiniz.

Bu ekran görüntüsünde bir hava durumu eklentisi eylemini sınama işlemini görebilirsiniz:

GPT odaklı sohbetler, geleneksel olarak yazılan sorulardan daha akıcı olabilir. Kullanıcılar birden fazla soruyu tek seferde cevaplayabiliyor veya daha önce girdikleri değerleri sabitleyebiliyor.

Bu örnekte, yardımcı pilot kullanıcısının önce Orlando, FL için hava durumunu görmeyi seçtiğini ancak daha sonra onay aşamasında konumunu Seattle olarak değiştirmek istediğini belirttiğini görebilirsiniz. Giriş değerindeki bu değişiklik onay aşamasının yanı sıra herhangi bir zamanda yapılabilir.

Eklenti eylemi yapılandırmanızda değişiklikler yapın

Eklenti eyleminizi yapılandırmanın birçok yolu vardır. Eklenti eylem sihirbazının İncele ve Bitir isimli son adımında uygun bölümün yanındaki Düzenleme bölümüne tıklayarak eklenti eyleminizin yapılandırmasında değişiklik yapmayı seçebilirsiniz.

Eylem ayrıntıları

Burada, eklenti eyleminiz için Model görünen adı ve Model Açıklaması da dahil olmak üzere eyleminizle ilgili ayrıntıları yapılandırabilirsiniz. Ad ve açıklama genellikle seçtiğiniz eyleme göre sizin için önceden doldurulur.

Bu sayfada, bir tabloda kayıt ekleme veya güncelleme gibi kullanıcı için değişiklikler yapan eylemler için kullanışlı olan Bu eylemi çalıştırmadan önce sor onay kutusunu seçebilirsiniz.

Girişler

Girişler bölümü eyleminizdeki her giriş için Görünen ad ve Tanım alanlarını yönetmenize olanak sağlar. Ad ve açıklama, yardımcı pilotun kullanıcıya bir soru oluşturmasına yardımcı olur. Örneğin, konum girişi için oluşturulan bir soru şu şekilde olabilir: Hava durumunu görmek istediğiniz konum nedir? Bir Şehir, Bölge, Eyalet, Ülke, Yer İşareti veya Posta Kodu girebilirsiniz"

Toplanan girdiye bağlı olarak belirli bir varlık türüne Olarak tanımla seçeneğini de değiştirebilirsiniz; bu, yardımcı pilotun kullanıcının yanıtından girdi için doğru bir değer çıkarmasına yardımcı olabilir.

Varsayılan olarak her giriş şu şekilde ayarlanmıştır: En iyi seçenekle dinamik olarak doldurun. Yardımcı pilot, kullanıcının mesajından bir değer çıkarmak gibi mevcut bağlamdan değeri doldurmaya çalışır. Uygun bir değer bulunamazsa, kullanıcıdan bir değer istemek için bir soru oluşturur. Kullanıcıya sormak yerine bir girişi bir değerle geçersiz kılabilirsiniz. Geçersiz kılmak için Yardımcı pilot bu girişi nasıl dolduracak? açılır menüsünü Bir değer belirleyin olarak değiştirin ve ardından kullanmak istediğiniz değeri girin. Bu değer gerçek bir değer, mevcut bir değişken veya bir Power Fx formül olabilir.

Çıktılar

Varsayılan olarak eklenti işleminiz, kullanıcının sorgusuna ve işlemin sonucuna göre kullanıcı için otomatik olarak bağlamsal bir yanıt oluşturacak şekilde yapılandırılmıştır. Örneğin, bir kullanıcı "Londra'da mevcut sıcaklık nedir?" diye sorarsa GPT kullanılarak "Londra'da mevcut sıcaklık 9 santigrat derece" gibi bağlamsal bir yanıt oluşturulur.

Alternatif olarak, eklenti eyleminizin geri dönmesi için belirli bir yanıt yazmayı seçebilirsiniz. Onay düzenleyicisinde olduğu gibi eylemdeki çıkış değişkenlerine bu örnekte gösterilen değişken seçici gibi başvurular ekleyebilirsiniz.

Bir konu içinden eklenti eylemini arama

Bir eklenti eylemini, Power Automate Akışları gibi diğer eylem türlerini çağırırken olduğu gibi bir konu içinden açıkça çağırabilirsiniz. Kullanım durumunuza bağlı olarak Akışınızı, daha fazla düğüm kullanan daha geniş bir konunun parçası olarak kullanabilirsiniz. Veya, hava durumu örneğinde olduğu gibi konu dosyasına tek bir eklenti eylem düğümü eklemek ihtiyacınız olan tek şey olabilir.

Konu içinden bir eklenti eylemi çağırmak için:

1. Microsoft Copilot Studioda, düzenlemek istediğiniz yardımcı pilota ait Konular sayfasına gidin.

2. Yeni bir konu oluşturun ve Hava durumunu al olarak adlandırın.

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

   • yağmur yağacak mı
   • bugünün hava tahmini
   • hava durumunu al
   • hava nasıl

   

4. Düğüm ekle (+) seçeneğini belirleyin ve ardından Eylem çağır'ı seçin. Eklenti eylemleri (önizleme) sekmesine geçiş yapın ve ardından önceden oluşturduğunuz Hava tahminini al eklenti eylemini seçin.

   

5. Eklenti eylemi (önizleme) düğümünüz artık konunuza eklenir.

   

6. Kaydet'i seçin.

Bir konudan bir eklenti eylemini çağırırken girişleri geçersiz kılma

Varsayılan olarak, eklenti eyleminiz çalıştırıldığında yardımcı pilotunuz kullanıcının gerekli girişleri doldurması için sorular oluşturur. Ancak bir veya daha fazla girişi geçersiz kılmak ve kullanıcıya sormak yerine açık bir değer sağlamak isteyebilirsiniz. Girişler bölümünde eklenti eylemi yapılandırmasında geçersiz kılabilirsiniz. Veya yalnızca eklenti eyleminiz belirli bir konu'den kullanıldığında değerleri geçersiz kılabilirsiniz:

1. Düğümde Değer ayarla seçeneğini belirleyin ve geçersiz kılmak istediğiniz girişi seçin.

   

2. Bir değer yazarak bir değişken seçerek veya bir formül kullanarak girişin değerini girin.

   

Bu giriş geçersiz kılındığından yardımcı pilot kullanıcıdan bir değer istemez.

AI Eklentileri kimlik doğrulamasını etkinleştirme

Bazı eklenti eylemleri, Yapay Zeka Eklentilerine göre oluşturulduğunda doğru çalışmak için kimlik doğrulama gerektirir, örneğin Dinamik İstem veya Dataverse API çağıran diğerleri.

Eklentiler her zaman son kullanıcı bağlamındaki Microsoft Copilot çalışma zamanında çalıştırılır ve kimlik doğrulama etkinleştirilmedikçe çalıştırılamaz. İki farklı kimlik doğrulaması türü desteklenir:

• Entegre kimlik doğrulama (Teams ve Power Apps): Bu kimlik doğrulama kurulumu, yardımcı pilotunuz Teams kanalındaysa kullanılabilir. Kurulum aynı zamanda PPAPI standardıyla oluşturulmuş belirteçleri kullanan herhangi bir Power Platform uygulamadaki gömülü yardımcı pilotlarla da çalışır.

• El ile kimlik doğrulaması (üçüncü taraf yardımcı pilotlar): Bu kimlik doğrulama yöntemi Entra ID bağlantısının kurulumunu gerektirir.

El ile kimlik doğrulaması bağlantısı oluşturmak için:

1. Bir Entra ID uygulaması ayarlayın.

2. Copilot Studio yardımcı pilotunuzda el ile kimlik doğrulaması seçeneğini ayarlayın.

3. Uygulamanızın kullanıcı adına belirteç getirebilmesi için temsilci kullanmasına izin verin. Gerekli tüm kapsamları eklediğinizden emin olun.