Özel aracılarla eylemler kullanma (önizleme)

Bir veya daha fazla eylem ekleyerek aracı yeteneğinizin özelliklerini genişletebilirsiniz. Eylemler, üretken düzenleme kullanarak kullanıcılara otomatik olarak yanıt vermek için aracınız tarafından kullanılır veya bunları bir konu içinden açık olarak çağırabilirsiniz.

Temel eylem türleri

üretken orkestrasyonu açarsanız, aracınız otomatik olarak en uygun eylemi veya konuyu seçebilir veya bir kullanıcıya yanıt vermek için bilgi genelinde arama yapabilir.

Klasik modda (üretken orkestrasyon devre dışı), bir aracı kullanıcıya yanıt vermek için yalnızca konuları kullanabilir. Ancak yine de aracı eylemlerinizi açıkça konuların içinden çağıracak şekilde tasarlayabilirsiniz.

Eylemler 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ışı
• AI Builder İstemler (konu içinde)
• Bot Framework becerisi
• REST API bağlantısı

Her temel eylem, amacını açıklayan ek bilgilere sahiptir ve aracı soru oluşturmak için üretken yapay zekayı 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 gereken tüm girişleri toplamak için soru düğümlerini el ile yazmanız gerekmez. Girişler çalışma zamanında sizin için işlenir.

Varsayılan olarak, üretken mod kullanılırken eylemler bilgilerini aracı'a geri döndürür, böylece aracı kullanıcının sorgusuna bağlamsal bir yanıt oluşturabilir. Alternatif olarak, bir ileti oluşturarak veya açık bir ileti yazarak eyleminize her zaman hemen yanıt vermesi talimatını verebilirsiniz.

Eylem ekleme

1. Sol taraftaki gezinme bölmesinde Aracılar'ı seçip listeden aracınızı seçerek aracınızı açın.

2. Aracı için eylemleri görüntülemek için Eylemler'i seçin.

3. Eylem ekle'yi seçin.

4. Eylem seç sihirbazında, kullanmak istediğiniz eylemi 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 Bot Framework aracınıza kayıtlı Becerileri içerir.

   

   Önemli

   AI Eklentilerinden oluşturulan Dinamik İstemler ve Dataverse API'leri temel alan eylemler gibi bazı eylemler kimlik doğrulama gerektirir.

   Eyleme bağlı olarak, bağlantınız örnekte gösterildiği gibi otomatik olarak yapılandırılır. Aksi takdirde, bağlantıyı yapılandırmak için sihirbazın yönergelerini izleyin. Bağlantınız başarıyla yapılandırıldıktan sonra İleri'yi seçin.

   

5. Eklenti eylemi yapılandırmanızı gözden geçirin ve gerekirse değişiklikler yapın.

   İleri'yi seçin.

6. Aracınıza eylemi eklemek için Sonlandır'ı seçin.

Eyleminizi test edin

Üretken düzenlemeyi etkinleştirdiyseniz, eyleminiz ilgili bir kullanıcı sorgusuna yanıt olarak otomatik olarak çağrılır.

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

Aracınız eyleminizi ada ve açıklamaya göre seçer ve çalıştırır. Etkinlik haritasını kullanarak, aracınızın eylemler sayfasından hangi eylemleri seçtiğini görerek yüksek kaliteli açıklamalar yazabilirsiniz.

Bu ekran görüntüsünde bir hava durumu eyleminin sınanmakta olduğunu görebilirsiniz:

Eylem yapılandırmanızda değişiklikler yapın

Eyleminizi yapılandırmanın birçok yolu vardır. Eylem sihirbazının Gözden Geçir ve Son olarak adlandırılan son adımında, ilgili bölümün yanındaki Düzenle'yi tıklatarak eyleminizin yapılandırmasında değişiklikler yapabilirsiniz. Sihirbazdaki Giriş ve çıkışları gözden geçir ekranından veya aracınızın zaten parçası olan bir eylemin ayrıntılar sayfasından, eylemin giriş ve çıkış parametrelerini yönetebilirsiniz.

Eylem ayrıntıları

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

Her girişin Görünen ad ve Açıklama özellikleri, aracı girişin amacını anlamasına, kullanıcı için uygun bir soru oluşturmasına ve kullanıcının yanıtındaki doğru değeri tanımasına yardımcı olur. Örneğin, MSN Hava Durumu bağlayıcısı için konum giriş parametresinin varsayılan adı ve açıklaması aşağıdadır.

• Ad: Konum
• Açıklama: Konum arama sorgusu. Geçerli girişler Şehir, Bölge, Eyalet, Ülke/Bölge, Yer İşareti, Posta Kodu, enlem ve boylamdır

Aracı kullanıcıdan bir konum istediğinde, Hava durumunu kontrol etmek istediğiniz konum hangisidir? Bir şehir, bölge, eyalet, ülke, dönüm noktası veya posta kodu girebilirsiniz gibi bir soru üretir.

Toplanan girişe bağlı olarak Farklı tanımla seçeneğini belirli bir varlık türüyle değiştirebilirsiniz ve bu da aracı kullanıcının yanıtından doğru bir şekilde değer ayıklamasına yardımcı olabilir.

Girişler

Varsayılan olarak her giriş şu şekilde ayarlanmıştır: En iyi seçenekle dinamik olarak doldurun. Aracı, değeri kullanılabilir bağlamdan (örneğin, kullanıcının iletisinden) ayıklamaya ç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ılma ayarlamak için Aracı bu girişi nasıl dolduracak? için Değer olarak ayarla'yı seçin ve 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.

Bir değer isterken veya bir kullanıcının yanıtını doğrularken aracı davranışınızı kontrol etmek için girişler için ek ayarlar yapılandırabilirsiniz.

Çıktılar

Varsayılan olarak, eyleminiz, sorguları ve eylemin sonucu temelinde kullanıcılar için otomatik olarak bağlamsal yanıt üretecek şekilde yapılandırılı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, eyleminizin döndürülmesi için belirli bir yanıt vermeyi 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.

Konunun içinden bir eylem çağırma

Bir eylemi, Power Automate Akışlar gibi diğer eylem türlerini çağırmaya benzer şekilde, bir konu içinden açık olarak ç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, bir konu tek bir eylem düğümü ekleyerek tüm ihtiyacınız olabilir.

Konunun içinden bir eylem çağırmak için:

1. Copilot Studio'de, düzenlemek istediğiniz aracının 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çin ve daha önce oluşturduğunuz eylemi seçin, Hava tahmini al.

   

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

   

6. Kaydet'i seçin.

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

Varsayılan olarak, işleminiz çalıştığında, aracı numaranız 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. Ya da, yalnızca belirli bir konu sizin eyleminiz 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.

   

Artık bu giriş geçersiz kılındığına göre, aracı kullanıcıdan bir değer istemez.

AI eylemleri için kimlik doğrulamasını etkinleştirme

AI eylemleri temel alınarak oluşturulduğunda bazı eylemlerin doğru çalışması için kimlik doğrulaması gerekir (örneğin, Dinamik İstem veya Dataverse API çağıran diğer eylemler).

Eylemler her zaman kullanıcı bağlamında aracı çalışma zamanında çalıştırılır ve kimlik doğrulaması etkinleştirilmedikçe çalıştırılamaz. İki farklı kimlik doğrulaması türü desteklenir:

1. Bağlayıcı eylem özelliklerine gidin.

2. Son kullanıcı kimlik doğrulaması altında, Aracı yazar kimlik doğrulamayı seçin.

3. Deneyimi aracı test bölmesinde veya istediğiniz bir kanalda yayımlayın ve test edin.

   

Kullanıcı kimlik bilgileriyle akış eylemlerini kullanma

Akış eylemleri, kullanıcı kimlik bilgilerini kullanacak şekilde yapılandırılabilir. Desteklenen bir kanalda bir akışı kullanmak, aracı iletişim kutunuzda özel bir yapılandırma gerektirmez ve kullanıcılar, sağlanan bir deneyimde belirli bir akış için bağlantılarını yönetebilir.

Kitaplığınızdaki eklentilere dayanarak eylemler için kimlik doğrulama

AI eklentileri temel alınarak oluşturulduğunda eylemlerin doğru çalışması için kimlik doğrulaması gerekir. Bu, en yaygın olarak, istemlere veya Dataverse API'leri çağıran diğerlerine dayalı eylemlerde görülür. Eklentileri temel alan eylemler her zaman kullanıcı bağlamında çalıştırılır ve kimlik doğrulaması etkinleştirilmedikçe çalıştırılamaz. İki farklı kimlik doğrulaması türü desteklenir:

• Tümleşik kimlik doğrulaması (Teams ve Power Apps): aracı verilerinizi bir Teams kanalında yayımlamak istiyorsanız bu kimlik doğrulama yöntemini kullanabilirsiniz. Bu yöntem, PPAPI standardıyla oluşturulmuş belirteçleri kullanan herhangi bir Power Platform uygulamaya katıştırılmış aracılar için de çalışır.

• El ile kimlik doğrulama (üçüncü taraf aracılar): Bu kimlik doğrulama yöntemi, Microsoft Entra ID bağlantısı kurulumunu içerir.

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

1. Microsoft Entra ID uygulaması kurun.

2. Aracınız için manuel kimlik doğrulama kurun.

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.