Değişkenlere İlişkin Veri Türlerini Anlamak
Değişkenleri kullanmanın pratik yönlerine dalmadan önce, Botpress'teki farklı veri türlerini tanıyalım.
- Sicim: Dizeler, harflerden, rakamlardan veya özel karakterlerden oluşabilen metni depolamak için kullanılır. Genellikle kullanıcı adlarını veya yapay zeka tarafından oluşturulan mesajları depolamak için kullanılırlar.
- Boolean: Boolean'lar yalnızca iki değeri tutabilir; doğru veya yanlış. Bir kullanıcının geri dönen bir müşteri olup olmadığı veya kullanıcının başka bir şey sormak isteyip istemediği gibi ikili bilgilerin depolanması için idealdirler.
- Sayı: Adından da anlaşılacağı gibi sayı değişkenleri, tam sayılar veya ondalık basamaklı sayılar olabilen sayısal değerleri depolamak için kullanılır. Telefon numaralarını, alan kodlarını ve diğer sayısal verileri depolamak için kullanışlıdırlar.
- Tarih: Tarih değişkenleri ISO 8601 tarih/saat biçimini kullanır. Tek bir tarihi veya tarih ve saati temsil eder.
- Nesne: Bir nesne değişkeni, sözlüklere veya haritalara benzeyen anahtar/değer çiftlerinin bir koleksiyonudur. Kullanıcı profilleri veya bir API çağrısının sonuçları gibi karmaşık veri yapılarını depolamak açısından değerlidirler.
- Sıralamak: Diziler benzer değişkenlerin koleksiyonlarını depolamak için kullanılır. Dizeleri veya nesneleri tutabilirler, bu da onları kullanıcının geçmiş mesajlarını depolamak veya kullanıcıya aralarından seçim yapabileceği seçenekler sunmak gibi çeşitli kullanım durumları için çok yönlü hale getirir.
- Sıralama: Bu, sınırlı sayıda önceden tanımlanmış seçeneğe sahip bir değişkendir. Haftanın günlerinin veya yemek menüsündeki mevcut öğelerin saklanması gibi senaryolar için uygundurlar.
- Model: Kalıp değişkenleri, belirli kelimeleri veya sayıları eşleştirmek için kullanılabilecek özel kalıpları depolamak için Normal İfadeleri (Regex) kullanır. Hesap numaralarını veya uçuş numaralarını saklamak için kullanışlıdırlar.
Değişken Kapsamları Anlamak
Botpress'te çeşitli değişken türleri bulunur ve bunlar, sohbet robotunuzun akışında nereden erişilebileceğine bağlı olarak değişir. En sınırlı olandan en geniş olana doğru farklı değişken kapsamlarını inceleyelim:
İş Akışı Değişkenleri
Bu değişkenler tek veya aynı iş akışında tanımlanır ve kullanılır. Yapay zeka görev çıktılarının saklanması, soruların kullanıcı yanıtları veya API çağrılarından elde edilen verilerin düzenlenmesi gibi tek kullanımlık akışlar için mükemmeldirler.
İş akışı değişkeni oluşturmak için şu adımlar izlenebilir:
Aşama 1. “Gezgin” menüsünde uygun iş akışını seçin.
Adım 2. İş akışı düzenleyicisinde boş bir alana çift tıklandığında Denetçi paneli açılır.
Aşama 3. Değişken adını belirtin, değişkenin veri türünü seçin ve değişkeni oluşturmak için “Ekle” düğmesine tıklayın.
“Ek Ayarlar” bölümünden değişkeninize varsayılan (başlangıç) bir değer ekleyebilirsiniz.
Giriş ve Çıkış İş Akışı Değişkenleri
Bilgi alışverişinde bulunmak için iş akışlarında giriş ve çıkış değişkenleri bulunabilir. Girişler, dış kaynaklardan veya diğer iş akışlarından bilgi almak için kullanılırken, çıkışlar, dış kaynaklara veya diğer iş akışlarına bilgi sağlar. Bu, bot içinde daha esnek iletişim ve veri alışverişine olanak tanır.
Bir giriş değişkenini işaretlemek için şu adımlar izlenebilir:
Aşama 1. Değişkeni iş akışı içinde oluşturun.
Adım 2. Denetçi panelinde iş akışının giriş düğümünü tıklatarak değişkeni seçin.
Bir çıkış değişkenini işaretlemek için şu adımlar izlenebilir:
Aşama 1. Değişkeni iş akışı içinde oluşturun.
Adım 2. Denetçi panelinde iş akışının çıkış düğümünü tıklatarak değişkeni seçin.
Oturum Değişkenleri
Tüm akışlar bu değişkenlere erişebilir ancak yalnızca tek bir konuşma için. Sohbet geçmişi, sanal alışveriş sepetinde toplanan öğeler veya API çağrılarından gelen geçici veriler gibi bir konuşma boyunca kullanılan verileri depolamak için idealdirler.
Bir oturum değişkeni oluşturmak için aşağıdaki kodu yazabilirsiniz:
oturum.değişkenadı = 'Merhaba beyler!' ;Değişkeninizi bir metin kartında kullanmak için onu küme parantezleri içinde kapatmamız gerekir; örneğin, {{session.variablename}} .
Kullanıcı Değişkenleri
Kullanıcı değişkenleri, bir kullanıcıyı konuşmalar arasında takip ederek verilerin sohbet robotuyla birden fazla etkileşimde kalmasını sağlar. Kişisel ayrıntılar, geçmiş konuşmalara ait etiketler veya dil tercihleri gibi zaman içinde kullanıcıyla alakalı kalan bilgileri depolamak için mükemmeldirler.
Bir kullanıcı değişkeni oluşturmak için:
Aşama 1. Sol üst köşede bulunan Botpress simgesinden 'Chatbot Ayarları'nı açın.
Adım 2. Sekmelerden “Değişkenler”i seçin.
Aşama 3. Kullanıcı değişkenini adlandırıp veri türünü belirterek tanımlayın.
Bir metin kartındaki 'Kullanıcı' değişkenine atıfta bulunmak için @user.variablename veya {{user.variablename}} kullanılabilir.
Bot Değişkenleri
Chatbottaki tüm kullanıcılar, tüm görüşmelerde bu değişkenlere erişebilir. API çağrıları için uç noktaların, botun sürüm numarasının veya adının saklanması gibi geliştirici bilgilerini ve yapılandırmasını depolamak için sıklıkla kullanılırlar.
Bot değişkeni oluşturmak için şu adımları izleyin:
Aşama 1. Sol üst köşedeki Botpress simgesine tıklayarak “Chatbot Ayarları”nı seçin.
Adım 2. Sekmelerden “Değişkenler”i seçin.
Aşama 3. Bot değişkeninin adını ve veri türünü belirtin.
Kullanıcı değişkenleri gibi, @bot.variablename veya bot.variablename de kartlardaki bot değişkenlerine atıfta bulunmak için kullanılabilir.
Yapılandırma Değişkenleri
Bunlar özel bir tür güvenli bot değişkenidir. Bunları Cloud Dashboard'dan yönetebilirsiniz ve botu açmanıza gerek yoktur. Yapılandırma değişkenleri, API belirteçleri, özel IP adresleri veya veritabanı kimlik bilgileri gibi hassas bilgileri depolamak için idealdir.
Bir yapılandırma değişkeni oluşturmak için:
Aşama 1. Sol üst köşede bulunan Botpress simgesinden 'Chatbot Ayarları'nı açın.
Adım 2. “Değişkenler” sekmesine tıklayın.
Aşama 3. Bir yapılandırma değişkeni ekleyin ve adını ve değerini sağlayın.
Koddaki konfigürasyon değişkenlerine erişmek için “env.key”i kullanabilirsiniz; burada “anahtar”, alınacak konfigürasyon değişkeni adını temsil eder.
Kodda Değişkenleri Kullanmak
Kodda değişkenler kullanılırken küme parantezleri “{{ }}” veya @ sembolüne gerek yoktur. Koddaki değişkenlere erişim sözdizimi “değişkentipi.değişkenadı” modelini takip eder. Örneğin:
Kod:
- iş akışı.phoneNumber
- session.userAcctId
- user.firstName
- bot.uç nokta
- env.apiKey
Değişkenlere değerler atanabilir veya kodda güncellenebilir. Ancak hataları önlemek için atanan değerin değişkenin veri türüyle eşleştiğinden emin olmak çok önemlidir.
Çözüm
Değişkenler Botpress'teki dinamik ve kişiselleştirilmiş etkileşimlerin yapı taşlarıdır. Geliştiriciler, çeşitli veri türlerini kullanarak ve değişken kapsamları anlayarak güçlü yeteneklere sahip sohbet robotları oluşturabilirler. Botpress'te kullanıcı bilgilerini saklamanız, API'lerle bağlantı kurmanız veya verileri iş akışları ve değişkenler arasında aktarmanız gerekip gerekmediği, gerekli esnekliği ve kontrolü sağlar.