Değişkenlere genel bakış

Note

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

Değişkenler dört düzeyde veya kapsamda bulunur:

  • Yalnızca bunları oluşturduğunuz konularda kullanabileceğiniz konu değişkenleri. Bu kapsam, oluşturulan değişkenler için varsayılandır.
  • Tüm konularda kullanabileceğiniz global değişkenler. Bir konu değişkeninin kapsamını global bir değişken yapmak için değiştirebilirsiniz.
  • Copilot Studio sistem değişkenleri bir aracı için otomatik olarak oluşturur. Bunlar, konuşma veya kullanıcı hakkında daha fazla bağlamsal bilgi sağlarlar. Bunlar tüm konularda kullanılabilir.
  • Power Platform'da oluşturduğunuz ortam değişkenleri. Copilot Studio'da salt okunur durumdalar. Parametre anahtarlarını ve değerlerini saklarlar; bunlar daha sonra Copilot Studio da dahil olmak üzere çeşitli diğer uygulama nesnelerine girdi olarak kullanılır. Parametreleri tüketen nesnelerden ayırarak değerleri aynı ortam içinde veya çözümleri başka ortamlara geçirdiğinizde değiştirebilirsiniz. Bunun alternatifi, sabit kodlanmış parametre değerlerini onları kullanan bileşenler içinde bırakmaktır.

Değişken türleri

Her değişkenin bir temel türü vardır. Tür, değişkenin hangi değerleri alabileceğini ve onunla mantıksal bir ifade oluştururken kullanabileceğiniz operatörleri belirler.

Türü Açıklama
String Metni göstermek için kullanılan karakter dizisi
Boolean Yalnızca true veya false olabilecek mantıksal bir değer
Number Herhangi bir gerçek sayı
Tabela Değerlerin listesi, ancak tüm değerlerin aynı türde olması gerekir
Kayıt Değerlerin herhangi bir türde olabileceği ad-değer çiftleri koleksiyonu
DateTime Zaman içindeki bir noktaya göre tarih, saat, haftanın günü veya ay
Seçenek İlişkilendirilmiş eş anlamlı sözcüklerle dize değerlerinin listesi
Boş "değer yok" veya "bilinmeyen değer" için bir yer tutucu; daha fazla bilgi için Power Fx belgelerindeki Boş başlığına bakın

Bir değişkene ilk kez değer atadığınızda değişkenin türünü ayarlarsınız. Bundan sonra, tür sabittir ve başka bir türe değer atayamazsınız. Örneğin, bir değişkene başlangıç değeri 1 atarsanız, değişkenin türünü Sayı olarak ayarlarsınız. Eğer daha sonra Dize değerine "apples" gibi bir değer atamaya çalışırsanız, bir hata alırsınız.

Bir aracıyı test ettiğinizde, bilinmeyen türde bir değişken geçici olarak görünebilir. Bilinmeyen bir değişkenin henüz bir değeri yok.

Değişkenlerin sırası, yazma tuval öğesinin yukarıdan aşağıya doğru belirlenir. Aracı, yazma tuvalinin üst kısmındaki düğümleri alt kısmındaki düğümlerden önce değerlendirir.

Koşul düğümlerini kullanarak dallar oluşturduğunuzda, Copilot Studio dalları soldan sağa doğru sıralar. Aracı, en soldaki dal üzerindeki düğümleri en sağdaki dal üzerindeki düğümlerden önce değerlendirir.

Entities

Copilot Studio, kullanıcının yanıtlarından belirli bilgi türlerini tanımlamak için varlıkları kullanır. Tanımlanan bilgiler, bilgi için uygun olan türde bir değişkene kaydedilir. Aşağıdaki tabloda, önceden oluşturulmuş varlıklarla ilişkilendirilmiş değişken taban türü listelenmektedir.

Varlık Değişken taban türü
Çoktan seçmeli seçenekler Seçenek
Kullanıcının tüm yanıtı String
Yaş Number
Boolean Boolean
City String
Renk String
Continent String
Ülke veya bölge String
Tarih ve saat DateTime
E-posta String
Etkinlik String
Integer Integer
Dil String
Para Number
Number Number
Sıralı Number
Kuruluş String
Yüzde Number
Kişi adı String
Telefon numarası String
İlgi konusu String
Hız Number
State String
Posta adresi String
Sıcaklık Number
URL String
Weight Number
Posta kodu String
Özel varlık Seçenek

Ortam değişkenleri

Ortam değişkenleri bir Power Platform kavramıdır. Ortam değişkenleri, uygulamaları Power Platform ortamları arasında taşıyarak temel uygulama yaşam döngüsü yönetimi (ALM) senaryosunu etkinleştirir. Bu senaryoda, kaynak ortam ve hedef ortam arasında farklı olan birkaç önemli dış başvuru dışında, uygulama tam olarak aynı kalır.

Ortam değişkenlerini konu, genel ve sistem değişkenleriyle aynı şekilde kullanın. Önemli bir fark, ortam değişkenlerinin Copilot Studio içinde salt okunur olmasıdır. Aracı yazarlar, Copilot Studio'da ortam değişkenlerini değiştiremez. Ancak, yöneticiler Power Apps içindeki ortam değişkenlerinin değerini değiştirebilir. Copilot Studio'da, bir ortam değişkeni hakkındaki bilgileri görmek için Değişkenler panelini kullanabilirsiniz. Değişken özellikleri panelinde, ortam değişkenleri için yazma deneyimi olan Power Apps bağlantısı da bulunur.

Ortam değişkenlerini kullanan bir aracının yayımlanmış sürümü, aracı yayımlandığında bu değişkenler için ayarladığınız değerleri içerir. Bir yönetici ortam değişkenlerini güncelleştirdiğinde, değişikliklerin çalışma zamanında geçerli olması için bu değişkenleri kullanan tüm aracıları yeniden yayımlamanız gerekir. Ancak bir istisna var: Gizli dizi türündeki bir ortam değişkeninin değeri değiştiğinde aracılarınızı yeniden yayınlamanıza gerek yok. Diğer ortam değişkenlerinden farklı olarak, gizli değişkenler çalışma zamanında alınır.

Copilot Studio içindeki ortam değişkeni türleri, Power Apps veri türleriyle aşağıdaki gibi eşlenir:

Copilot Studio'da yazın Power Apps'teki tür
Ondalık sayı Number
JSON Türü değerden algılayın. JSON => değilse Belirtilmemiş (doğrulama hatası)
Metin String
Evet/Hayır Boolean
Veri kaynağı String
Gizli String

Note

Test sohbetinde ve yayımlama sırasında ortam değişkeni hataları görürsünüz. Ancak ortam değişkenleri konu değişkenleri olmadığından, bu hatalar Konu listesinde görünmez.

Sistem değişkenleri

Her aracı, bir konuşma hakkında ek bilgi sağlayan yerleşik sistem değişkenleri içerir.

Bir konudaki sistem değişkenlerinin ekran görüntüsü.

Copilot Studio tüm sistem değişkenlerini göstermez. Gizli sistem değişkenlerine erişmek için bir Power Fx formülü kullanın.

Power Fx formülünde sistem değişkenlerini kullanmak için, değişken adının önüne System. ekleyin. Örneğin, User.DisplayName sistem değişkenini bir formüle eklemek için buna System.User.DisplayName olarak başvurun.

Name Türü Definition
Aktivite.Ekler table Kullanıcının sağladığı dosya ekleri.
Activity.Channel choice Geçerli konuşmanın kanal kimliği.
Activity.ChannelData any Kanala özgü içerik içeren bir nesne.
Activity.ChannelId String Mevcut konuşmanın kanal kimliği, string formatında.
Activity.From.Id String Gönderenin kanala özgü eşsiz kimliği.
Activity.From.Name String Gönderenin kanala özgü kullanıcı dostu adı.
Aktivite.Adı String Olayın adı.
Activity.Recipient.Id String Gelen aktivitenin Tür özelliği.
Activity.Recipient.Name String Kanal içindeki temsilcinin görünen adını temsil eder. Telefon kanalı bağlamında, bu değişkenin değeri, ajanın bağlı olduğu telefon numarası olacaktır.
Activity.Text String Kullanıcı tarafından gönderilen en son ileti.
Aktivite.Tip choice Etkinlik türü.
Activity.TypeId String Etkinlik türü, dize olarak.
Activity.Value any Açık uçlu değer.
Bot.EnvironmentId String Aracı ortam kimliği.
Bot.Id String Ajanın kimliği.
Bot.Name String Temsilcinizin adı.
Bot.SchemaName String Ajansın şema adı.
Bot.TenantId String Etkenin kiracı kimliği.
ClientPluginActions choice Üretken düzenleme için dikkate alınacak Dinamik İstemci Eklenti Eylemleri Koleksiyonu.
Conversation.Id String Mevcut oturumun benzersiz ID'si.
Konuşma.TestModunda Boolean Konuşmanın test tuvalinde olup olmadığını gösteren Boole bayrağı.
Conversation.LocalTimeZone String Kullanıcı tarafından IANA Saat Dilimi veritabanı biçiminde kullanılacak saat diliminin adı.
Conversation.LocalTimeZoneOffset tarih/zaman Geçerli yerel saat dilimi için UTC'den saat farkı.
Hata.Kodu String Mevcut hata için hata kodu
Mevcut hata için hata mesajı.
Hata.Mesajı String Mevcut hata için hata mesajı.
Not: Bu değişken yalnızca tetikleyici On Error olduğunda desteklenir.
FallbackCount number Bu değişken, bir konu kullanıcı girişiyle eşleşemeyeceği saatleri sayar.
Not: Bu değişken yalnızca tetikleyici On Unknown Intent olduğunda desteklenir.
InactivityTimer.Continue Boolean Zamanlayıcının devam ettirilmesi gerekip gerekmediğini gösteren boole bayrağı.
Not: Bu değişken yalnızca tetikleyici Inactivity olduğunda desteklenir.
InactivityTimer.Sayı (İşlem Süresizliğini Say) number Yapılandırılan süreden sonra kullanıcının etkin olmaması nedeniyle OnInactivity zamanlayıcısının tetiklenme sayısı.
Not: Bu değişken yalnızca tetikleyici Inactivity olduğunda desteklenir. Etkinliksizlik tetikleyicisi hakkında daha fazla bilgi edinin.
LastMessage.Id (SonMesaj.Kimlik) String Kullanıcı tarafından gönderilen önceki iletinin kimliği.
SonMesaj.Metin String Kullanıcı tarafından gönderilen önceki ileti.
Tanıyıcı.ÇıkartılmışVarlıklar choice Tetikleyen iletiden ayıklanan varlıkları temsil eder.
Not: Bu değişken yalnızca tetikleyici On Select Intent olduğunda desteklenir.
Recognizer.IntentOptions choice Tanıyıcı belirsiz sonuçlar döndürdüğünde amaç seçeneklerini temsil eder.
Not: Bu değişken yalnızca tetikleyici On Select Intent olduğunda desteklenir.
Tanıyıcı.SeçiliNiyet choice Tanıyıcıdan seçilen amacı temsil eder.
Not: Bu değişken yalnızca tetikleyici On Select Intent olduğunda desteklenir.
Recognizer.TriggeringMessage.Id String Geçerli konuyu tetikleyen kullanıcı iletisinin kimliği.
Recognizer.TetiklemeMesajı.Metin String Geçerli konuyu tetikleyen kullanıcı iletisi.
Recognizer.MultipleTopicsMatchedReason String Birden çok konunun neden eşleştirildiğini belirlemek için kullanılır.
Not: Bu değişken yalnızca tetikleyici On Select Intent olduğunda desteklenir.
Oturum Açma Nedeni choice Konu tetiklerken hangi oturum açma seçeneğinin gerektiğini belirlemek için kullanılır.
Not: Bu değişken yalnızca tetikleyici On Sign In olduğunda desteklenir.
User.Language choice Bu değişken konuşma başına kullanıcı dili yerel ayarını ayarlamak için kullanılır.

Ses özellikli aracılar için değişkenler

Aşağıdaki değişkenler yalnızca ses özellikli aracılar için kullanılabilir. Daha fazla bilgi için Ses değişkenleri kullanma bölümüne bakın.

Name Türü Definition
Etkinlik.InputDTMFKeys String Telefondan alınan ham DTMF anahtar değeri.
Aktivite.KonuşmaTanıma.Güven düzeyi number Otomatik konuşma tanıma hipotezinin tam sonucu için güvenilirlik puanı (0 ile 1 arası).
Activity.SpeechRecognition.MinimallyFormattedText String Otomatik konuşma tanıma hipotezi sonucunun hafifçe biçimlendirilmiş metni. Örneğin, "Beş yüz dolar". Sözcükler hecelenir, ancak temel büyük harf kullanımı ve noktalama işaretleri dahil edilir.
Activity.UserInputType choice Ajandan alınan son girişin türü. Değer test, konuşma veya DTMF olabilir.
Görüşme.SadeceDTMFIzinVer Boolean IVR'nin çalışma zamanında yalnızca DTMF modu olarak ayarlanıp ayarlanmayacağını gösteren Boole bayrağı.
Conversation.SipUuiHeaderValue String Çağrı başlatmasında bağlamı IVR'ye iletmek için kullanılan UUI başlık dizesi.

Tümleşik kimlik doğrulama için değişkenler (varsayılan)

Microsoft ile kimlik doğrulaması yapmak üzere yapılandırılmış aracılar için aşağıdaki değişkenler kullanılabilir. Bu yapılandırma Microsoft Entra ID kimlik doğrulaması kullanır ve yeni aracılar için varsayılandır. Kimlik doğrulama değişkenleri bölümünde daha fazla bilgi edinin.

Name Türü Definition
User.DisplayName String Şu anda aracı ile konuşan kullanıcının görünen adı.
Kullanıcı.E-posta String Şu anda aracı ile konuşmakta olan kullanıcının e-posta adresi.
Kullanıcı.Adı String Şu anda aracı ile konuşan kullanıcının adı.
User.Id String Şu anda acente ile konuşan kullanıcının benzersiz kimliği.
User.IsLoggedIn Boolean Kullanıcının, aracı ile konuşurken kimlik doğrulamasının yapılıp yapılmadığını belirten bir Boole bayrağı.
Kullanıcı.Soyadı String Şu anda aracı ile konuşan kullanıcının aile adı.
Kullanıcı.PrincipalName String O anda aracı ile konuşan kullanıcının kullanıcı ana adı.

Generic OAuth 2 ile el ile kimlik doğrulama için değişkenler

Aşağıdaki değişkenler, Genel OAuth 2 hizmet sağlayıcısını kullanmak üzere yapılandırılmış aracılar için kullanılabilir.

Name Türü Definition
User.AccessToken String Kimlik doğrulama işlemini aracı ile yapan kullanıcı için erişim belirteci.
User.DisplayName String Şu anda aracı ile konuşan kullanıcının görünen adı.
User.Id String Şu anda acente ile konuşan kullanıcının benzersiz kimliği.
User.IsLoggedIn Boolean Kullanıcının, aracı ile konuşurken kimlik doğrulamasının yapılıp yapılmadığını belirten bir Boole bayrağı.

Microsoft Entra ID ile manuel kimlik doğrulama için değişkenler

Aşağıdaki değişkenler, Microsoft Entra ID (eski adıyla Azure Active Directory) hizmet sağlayıcılarını kullanacak şekilde yapılandırılmış aracılar için kullanılabilir.

Name Türü Definition
User.AccessToken String Kimlik doğrulama işlemini aracı ile yapan kullanıcı için erişim belirteci.
User.DisplayName String Şu anda aracı ile konuşan kullanıcının görünen adı.
Kullanıcı.E-posta String Şu anda aracı ile konuşmakta olan kullanıcının e-posta adresi.
Kullanıcı.Adı String Şu anda aracı ile konuşan kullanıcının adı.
User.Id String Şu anda acente ile konuşan kullanıcının benzersiz kimliği.
User.IsLoggedIn Boolean Kullanıcının, aracı ile konuşurken kimlik doğrulamasının yapılıp yapılmadığını belirten bir Boole bayrağı.
Kullanıcı.Soyadı String Şu anda aracı ile konuşan kullanıcının aile adı.
Kullanıcı.PrincipalName String Şu anda ajanla konuşan kullanıcının ana adı.
  • Last updated on