Olay tetikleyicisine genel bakış

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Olay tetikleyicilerini kullanarak, gerçekleşen bir şeye yanıt olarak eylemleri gerçekleştirecek veya konuları çağıracak şekilde özel aracıları yapılandırabilirsiniz. Kullanıcıdan girdi gerektiren konu tetikleyicilerinin aksine, olay tetikleyicileri aracınızın tanımlanan olayın gerçekleşmesine yanıt olarak özerk bir şekilde hareket etmesini sağlar.

Important

Olay tetikleyicilerinin etkinleştirilmesi, faturalandırmanın hesaplanma şeklini etkileyebilir. Daha fazla bilgi için Copilot Kredi faturalama ücretleri tablosuna bakın.

Note

Bu özellik yalnızca üretken düzenleme açık olan aracılar için kullanılabilir.

Olay tetikleyicileri nasıl çalışır?

Olay tetikleyicileri, bir tetikleyici yükü oluşturarak bunu bir bağlayıcı aracılığıyla ajana gönderen belirli bir olay gerektirir. Yük verisi, belirli veri türleri için değişkenler de dahil olmak üzere olay hakkında bilgiler içerir. Aracı, yük verisini aldığında, hem aracı yazarı tarafından aracı yönergelerinde sağlanan hem de tetikleyici yük verisi aracılığıyla gönderilen yönergeleri yerine getirir.

Ajanslar sadece yazarlarının tasarımına ve talimatlarına göre hareket eder. Örneğin, yeni bir ekip üyesi eklendiğinde bir tetikleyici ekleyebilir ve yanıtını yeni çalışana oryantasyon kaynaklarıyla bir karşılama mesajı gönder eylemi olarak belirleyebilirsiniz.

Olay tetikleyicileri, aracı dışındaki olaylara göre etkinleştirilir. Bunlar, kullanıcılar tarafından girilen tetikleme tümceciklerine göre konuları veya eylemleri etkinleştirmek için kullanılan konu tetikleyicilerinden farklıdır.

Bu makalede olay tetikleyicilerinin nasıl çalıştığı, sınırlamaları ve sorun giderme stratejileri açıklanmaktadır. Olay tetikleyicisi ekleme hakkında daha fazla bilgi için bkz Olay tetikleyicisi ekleme.

Olay tetikleyicilerinin diğer örnekleri şunlardır:

• SharePoint'de bir öğe oluşturulduğunda
• OneDrive'de bir dosya oluşturulduğunda
• Planner'da bir görev tamamlandığında
• Belirli bir süre geçti (Yinelenme tetikleyicisi)

Important

Kullanılabilir tetikleyiciler, kuruluşunuzun bir yönetici tarafından Power Automate'te yapılandırılan veri ilkelerine bağlıdır.

Olay tetikleyicileri için faturalandırma ve kullanım

Olay tetikleyicisi etkinliği, kullanım ve faturalandırma için tüketim birimlerine dahil edilir. Mesaj, aracıya gönderilen ve aracıdan bir eylemi veya yanıtı tetikleyen herhangi bir istek veya mesaj olarak tanımlanır. Bu, olay tetikleyicilerinden aracılara gönderilen yükleri içerir. Örneğin, her 10 dakikada bir etkinleştirilecek şekilde ayarlanmış bir yinelenme tetikleyicisi, her 10 dakikada bir aracı mesaj olarak bir tetikleyici yükü gönderir.

Daha fazla bilgi için Faturalama ücretleri ve yönetimi bölümüne gidin.

Tetikleyici iş akışı

Tetikleyici, birden çok bölümden oluşan bir iş akışının bir parçasıdır:

1. Bir olay tetikleyicisi, belirli bir olayın meydana geldiğini kaydeder.
2. Tetikleyici, olay ve talimatlar hakkında bilgi içeren bir yük gönderir.
3. Aracın, yüke bağlı olarak bir veya daha fazla eylem veya konu seçmesi için talimatları vardır.

Etkinliğinize uyan tetikleyiciyi bulun

Copilot Studio, Microsoft ve iş ortağı hizmetlerinde gerçekleşebilecek çeşitli olaylar için tetikleyici kitaplığına sahiptir. Tetikleyici yapılandırması, tetikleyiciyi başlatan olayın parametrelerini belirler. Ayrıca tetikleyici yükünün içeriğini de belirler.

Çoğu tetikleyici, tetikleyiciyi etkinleştiren olay hakkında parametreler belirtmenize olanak tanır. Örneğin, Dataverse için Bir satır eklendiğinde, değiştirildiğinde veya silindiğinde tetikleyicisinde, hangi tablonun değişikliklerinin tetikleyiciyi etkinleştireceğini seçersiniz.

Tetikleyici yükünü tanımlayın

Tetikleyici yükü, bir olay hakkında bilgi içeren ve aracınıza mesaj olarak gönderilen bir JSON veya düz metin mesajıdır. Bir tetikleyici eklerken, söz konusu tetikleyici için varsayılan yük içeriğini koruyabilir veya kendi talimatlarınızı ekleyebilirsiniz. Daha sonra Power Automate değişken ve dize işleçleri ekleme dahil olmak üzere yük içeriğini değiştirebilirsiniz.

Örneğin, Bir satır eklendiğinde, değiştirildiğinde veya silindiğinde tetikleyicisindeki varsayılan mesaj Body'ten içerik kullan'dır. Aracı yükü aldığında, beraberinde satırdaki içeriği ve bu içeriği kullanma talimatlarını da bulundurur.

Tetikleyici tarafından etkinleştirildiğinde aracının nasıl davranması gerektiğini belirten talimatları yük içine ekleyebilirsiniz. Birden fazla tetikleyiciniz varsa, her tetikleyici yükü özel ve ayrıntılı talimatlara sahip olabilir. Sonuç olarak, aracının genel yönergelerinde uzun ve karmaşık yönergeler yazmaktan veya hangi yönergelerin hangi tetikleyici için geçerli olduğu konusunda aracı karıştırmaktan kaçınabilirsiniz.

Örneğin, Bir satır eklendiğinde, değiştirildiğinde veya silindiğinde tetikleyici yükünde, Sohbette değişikliklerin bir özetini gönder seçeneğini ekleyebilirsiniz. Aracı, yükü aldığında kullanıcı için değişiklikleri aracı sohbetinde özetler.

Ancak, aracının genel talimatlarıyla çelişen veri yükü talimatları yazmaktan kaçının. Talimatlardaki çakışmalar bir hataya veya beklenmeyen sonuçlara neden olabilir. Olay tetikleyicilerini içeren tüm değişiklikleri test ettiğinizden emin olun.

Tetikleyici oluşturduktan sonra, tetikleyici yükünde değişkenleri veya dize işleçlerini add veya değiştirebilir ve mevcut yük yönergelerini Power Automate kullanarak değiştirebilirsiniz.

Aracı talimatları ile yük talimatları arasındaki fark

Yük talimatları, bir olaya nasıl tepki verileceğine özeldir. Ayrıca, aracınızın tetikleyiciden gelen bilgileri nasıl işleyeceğini ve tetikleyici yükü aldığında nasıl davranacağını belirlemek ve aracınızın genel davranışını belirlemek için aracı talimatlarını da kullanabilirsiniz. Örneğin, yeni Dataverse tablo satırlarında yinelenen hesap adlarını kontrol eden bir aracı için talimatlar şöyle olabilir: Yeni bir satır eklendiğinde, bunun yinelenen bir hesap olup olmadığını kontrol edin. Yinelenen bir hesap varsa, araştırmak için Yapılacaklar görevi oluşturun ve değişiklikler ve yinelenenler hakkında ayrıntılar ekleyin.

Ancak aracı talimatları her durumda en iyi sonucu vermeyebilir. Eğer aracınızın birden fazla tetikleyicisi veya birden fazla karmaşık hedefi varsa, bunun yerine tetikleyici yükündeki talimatları kullanmalısınız.

Son örneği sürdürerek, tetikleyici yüküne Aynı Dataverse tablosunda yinelenen hesap adlarını ara talimatını ekleyebilirsiniz. Aracı yükü aldığında, yinelenen hesap adlarını araması talimatı verilir. Atanın genel yönergelerinde şöyle deniyor: Bir yinelenen öğe varsa, araştırmak için bir Yapılacaklar listesi oluşturun ve değişiklikler ve yinelemeler hakkında ayrıntılı bilgi ekleyin.

Aracılar için talimatlar oluşturmak pratik gerektirir. Daha fazla ipucu için yazma kılavuzuna gidin ve her zaman aracınıza yaptığınız tüm değişiklikleri test edin.

Eylem veya konu çağırma

Bir aracı bir tetikleyici yükü aldığında, ona sağladığınız yönergeler, sahip olduğu bilgilere dayanarak yanıt olarak çağırdığı eylemi veya konuyu belirler.

Aracınız anında yeni bir eylem veya konu oluşturmaz. Aracı yazar olarak, temsilcinin seçebileceği eylemleri veya konuları tanımlamanız gerekir. Aracınızın hangi eylemi veya konuyu çağıracağını nasıl belirlediğini öğrenmek için Üretken düzenleme nasıl çalışır? bölümüne gidin

Aracınız beklendiği gibi tepki vermiyorsa, herhangi bir önemli giriş bilgisinin eksik olup olmadığını görmek için etkinlik haritasını kullanabilirsiniz.

Talimatlarda yapabileceğiniz bazı iyileştirmeler şunlardır:

• Tetikleyici yüküne veya ajan talimatlarına daha ayrıntılı talimatlar eklemek. Aracınız, eylem için belirli bir giriş alanında hangi bilgilerin kullanılacağı konusunda daha fazla yönlendirmeye ihtiyaç duyabilir.
• Tetikleyici yüküne talimatlar dahil etme.
• Temsilcinize belirli bir işlem veya konuyu çağırması talimatını vermek.
• Tetikleyici yükü ile aracı talimatları arasındaki çakışan talimatları kontrol edin.
• Eylem açıklamalarına eklemeler yapın, böylece aracı ne zaman çağrılacağını belirlemek için daha fazla bilgiye sahip olur.
• Aracınızın parametreleri doğru şekilde doldurmasına yardımcı olmak için eylem giriş alanlarına açıklamalar ekleyin. Eğer bir eylemin girdileri her seferinde aynıysa, değeri kendiniz ayarlayabilirsiniz.
• 15'ten az eylem veya konuyu art arda çağırmak. Birçok eylemi veya konuyu tek bir dizi halinde çalıştıran karmaşık aracıların bunları güvenilir bir şekilde çalıştırması zor olabilir.

Aracınız hala beklenen eylemi çağırmakta zorlanıyorsa, aracınız için bir eylem olarak hedefinizi gerçekleştiren bir Power Automate akışı eklemeyi düşünün.

Etkinlik tetikleyicileriyle araç yayınlama

Yeni bir olay tetikleyicisiyle aracınızı yayınlamadan önce, aracınız bu tetikleyiciye otomatik olarak tepki vermez. Yayımlamadan önce aracı iyice test ettiğinizden emin olun, çünkü yeni bir tetikleyiciyle bir aracı yayınladıktan sonra, tetikleyicileri her etkinleştirildiğinde aracınız otomatik olarak tepki verir. Etkinlik sayfasında, aracınızın tetikleyicilerinin ve tepkilerinin adım adım kaydını görebilirsiniz.

Test sırasında tetikleyicileri etkinleştirme hakkında bilgi için Tetikleyiciyi test etme bölümüne gidin.

Olay tetikleyicileri, tetikleyiciniz için kimlik doğrulama amacıyla yalnızca aracı oluşturucunun kimlik bilgilerini (başka bir deyişle, bağlantıları yetkilendirmek için kullandığınız kimlik bilgilerini) kullanabilir. Bu, bir aracının kullanıcılarının aynı yetkilendirmeyi kullanarak verilere ve sistemlere erişmek için aracıyı kullanmasına izin verebilir. Daha fazla bilgi için Sorun giderme ve sınırlamalar bölümüne gidin.

Yayımlamadan sonra kimlik doğrulama eylemleri

Aracınız bir eylemi gerçekleştirmek için kimlik doğrulaması eksikse veya kullanıcı kimlik doğrulaması isteyecek şekilde yapılandırılmışsa, kullanıcıya kimlik bilgilerini soran bir ileti gönderir. Bir ajanın iş akışı, bilgi alamadığı veya bir eylem başarısız olduğunda kesilirse, oturumu sürdüremez. Aracınızın otonom olarak çalışmasını istiyorsanız, her eylemin kullanıcı girişi gerektirmeyen çalışan oluşturucu kimlik doğrulamasıyla yapılandırılması gerekir. Ayrıca aracınıza kullanıcılardan kimlik bilgisi istememesini de söyleyebilirsiniz.

Tetikleyiciler oluşturucu kimlik doğrulaması kullandığından, tetikleyicileri olan yayımlanmış bir aracı aracılığıyla potansiyel kullanıcıların hangi verilere erişebileceğine dikkat edin. Daha fazla bilgi için Tetikleyiciler ile veri koruması bölümüne bakın.

Etkinlik ve bilgi kaynağı kullanımı

Copilot Studio'da yerleşik aracılar kanallar aracılığıyla Teams'e bağlanabilir. Bu bağlantıyı kullandığınızda, Teams'te bazı durumlar meydana gelir, kullanılan tetikleyiciye ve ajanın kullandığı araçlara bağlı olarak, bazı değişkenlerinActivity.Text boş kalmasına neden olabilir. Bu boşluk, bazı araçların tasarım gereği faaliyet olarak tasarlanmış olmasından kaynaklanır. Activity.Text ajanınızın ne yaptığını kaydetmek için kullanabileceğiniz bir değişkendir. Ancak, Activity.Text her zaman önceki mesajlara sahip olmayabilir. Bu durumda, değişkeni LastMessage.Text kullanmalısınız.

Bir ajan yetersiz bağlam ipucu nedeniyle bilgi kaynağı çağırdığında, o tur için ortaya çıkan Activity.Text değişken boş bırakılır. Bu boş değer, karar bilgi kaynağına devredildiğinde ajanın doğal dilde bir yanıt oluşturmaması nedeniyle oluşur. Değişkenin Activity.Text genellikle kullanıcının önceki mesajı olmasını bekliyorsanız, bunun yerine LastMessage.Text değişkenini kullanmalısınız. Değişken, Activity.Text ajana verilen herhangi bir faaliyeti algılar.

Tetikleyiciyle etkileşim kurma

Tetikleyici OnPlanComplete , yalnızca araç çalışmayı tamamladıktan sonra çalışacak şekilde tasarlanmıştır. Bir bilgi kaynağı kullanıldığında, bilgi kaynağı çıktısı doğrudan faaliyete yazılır. Değişken Activity.Text başlangıçta boş olduğundan, etkinlik bir konuşma mesajı yerine araç kullanım detaylarıyla doldurulur.

Bu davranış, niyete dayalı veya doğal dil tetikleyicileri gibi diğer tetikleyicilerin daha erken tetiklendiği senaryolardan farklıdır. Bu durumlarda, etkinlik genellikle zaten oluşturulmuş bir mesaj içerir, bu yüzden araç çıktısı değişkeni Activity.Text değiştirmez veya tanımlamaz olur.

Teams ile Copilot Studio davranışı arasındaki fark

Teams, etkinlik nesnelerini Copilot Studio ile aynı şekilde soyutlamaz veya normalleştirmez. Sonuç olarak:

• Copilot Studio'da sistem etkinlikleri bu temel ayrıntıları gizleyecek şekilde dönüştürülebilir veya işlenebilir.
• Teams'te etkinlik nesneleri daha doğrudan ortaya çıkar, bu da bu tutarsızlığı daha görünür hale getirir.

Bu fark, temel ajan mantığı aynı olsa bile farklı gözlemlenebilir davranışlara yol açar.

Sorun giderme ve sınırlamalar

Kota sınırlaması

Tetikleyiciler çok sık etkinleşirse, aracınız beklenenden daha fazla kaynak kullanabilir. Acenteniz daha sonra hizmet yükleme kotası sınırlarını aşabilir ve hizmetiniz kısıtlara uğrayabilir.

Yöneticiler kaynak kullanımını Power Platform aracılığıyla izleyebilirler. Ayrıca bir ortamda olay tetikleyicilerinin kullanılmasını engelleyebilirler.

Kota sınırlarının aşılmasını önlemek için:

• Çok sık tetikleyiciler veya süresiz olarak yinelenen tetikleyiciler eklerken dikkatli olun. Örneğin, belirli bir süre geçtiğinde bir yineleme tetikleyicisi etkinleşir. Etkinleştirmeler arasındaki süre ne kadar küçük olursa, tetikleyici o kadar fazla kaynak kullanır.
• Bir ortamda kaç tetikleyicinin etkin olduğunu takip edin.

Tetikleyicileri olan aracılar için veri koruması

Şu anda olay tetikleyicileri, kimlik doğrulaması için yalnızca aracı yazarının kimlik bilgilerini kullanabilir. Ayrıca, aracının özerk olarak çalışması için, kimlik doğrulaması gerektiren tüm tetikleyicilerin ve eylemlerin oluşturucunun kimlik bilgilerini kullanması gerekir.

Kimliği doğrulanmış olay tetikleyicileri olan bir aracı yayımlarsanız, kullanıcılar bilgilere erişebilir veya aracıdan yazarın kimlik bilgilerini kullanarak eylemler gerçekleştirmesini isteyebilir. Üreticiler bir ajanı kimlik doğrulamalı bir olay tetikleyici ile yapılandırırsa, ajanı yayınlamadan önce bu sınırlama kendilerine hatırlatılır.

Tetikleyici yükleri, bir aracının eylemler aracılığıyla diğer konumlarda çıktısını alabileceği hassas bilgiler içerebilir. Örneğin, Dataverse tablolarında yeni satırlar doldurmak için gelen e-postalardaki bilgileri kullanan bir aracı oluşturduysanız.

Yöneticiler, Copilot Studio kullanıcılarının aracılarıyla olay tetikleyicilerini kullanmasını engelleyebilir. Daha fazla bilgi için, Ajanlar için veri politikalarını yapılandırma bölümünü inceleyebilirsiniz.

Veri koruma en iyi uygulamaları

Kullanıcıların hassas verilere erişmesini engellemeye yardımcı olmak için:

• Kimlik doğrulaması gerektiren verilerin ve sistemlerin olay tetikleyicileri olan aracılar tarafından kullanılıp kullanılmadığını ve nasıl kullanıldığını değerlendirin.
• Tetikleyicilerin yüklerinde hangi bilgileri içerebileceğini ve bu yük girdilerini test yoluyla hangi bilgi eylemlerinin çıkardığını anlayın.
• Tetikleyici parametrelerini kullanarak bir tetikleyiciyi neyin etkinleştireceğinin kapsamını daraltın ve aracınıza yük verilerini işleme yönergeleri sağlayın.

Çözüm odaklı bulut akışı paylaşımı etkinleştirilmelidir

Oluşturucular, yalnızca çözüm odaklı bulut akışı paylaşımının açık olduğu ortamlardaki aracılara olay tetikleyicileri ekleyebilir.

Tetikleyici ekleyemiyorsan ve organizasyonunuzun veri politikaları tetikleyicilere izin veriyorsa, ortamınızda bu seçenek kapalı olabilir. Çözüm odaklı bulut paylaşımını açmak için ortamınızın yöneticisine başvurun.

Bağlayıcı sorunlarını giderme

Aracılar her bağlayıcıyı başarıyla çalıştıramayabilir. Bir temsilci tekrar tekrar bir bağlayıcıyı çağıramıyorsa, eylemi tamamlamak için sorunlu bağlayıcıyı kullanan bir Power Automate akış eylemi oluşturmayı düşünün.