MaviBot ekibi tarafından geliştirilen özel bir işlevi kullanarak, AI sohbet robotunuz bir Google Sheet'ten değerleri akıllıca okuyabilir ve bunları proje ayarlarınızda bir sistem değişkenine kaydedebilir. Bu, asistanınız için senkronize, dinamik bir veri kaynağı oluşturur.

Pratik uygulamalar

Bu yetenek, aşağıdaki gibi senaryolar için gereklidir:

  • Ürün kataloğu asistanı: Müşterilere mevcut ürün yelpazeniz, fiyatlarınız ve stok durumunuz hakkında gerçek zamanlı olarak danışmanlık yapan bir AI.
  • Akıllı promosyon botu: Doğrudan sayfanızdan alınan özellikleri, teknik özellikleri veya fırsatları dinamik olarak vurgulayarak tekliflerinizi tanıtan bir bot.

Tablonuzu entegrasyona nasıl hazırlarsınız

Başlamak için sayfalar bölümüne gidin:

Ardından, sayfanın adını girmeniz gereken bir modal pencere açan "Sayfa ekle" düğmesini göreceksiniz:

Sayfa için bir ad girin ve "Bitti" düğmesine tıklayın. Ardından projede yeni bir sayfa oluşturulacak ve "Sayfalar" bölümünde görünecektir:

Sayfa ayarları

Sayfayı oluşturduktan sonra satır ve sütun eklemeniz gerekir. Bunu yapmak için, istediğiniz sayfanın kartındaki "Git" düğmesini bulun ve tıklayın.

Aşağıdaki ayarları göreceksiniz:

Bir adla sütun eklemek için "+" düğmesine tıklayın:

Düğmeye tıkladığınızda, yeni sütun için bir ad girebileceğiniz bir modal pencere açılacaktır.

Sütun adını girdikten sonra "Bitti" düğmesine tıklayın, ardından yeni sütun sayfaya eklenecektir. Gerekli sayıda sütun ve ardından satır ekleyin.

Artık sayfanız şu şekilde görünüyor.

Sayfa kimliğini kopyalayın (hatırlayın): bunu yapmak için adres çubuğuna tıklayın:

Ardından, oluşturucudaki blokları yapılandırmaya geçelim.

Sohbet robotu oluşturucuda çalışma

get_records_from_table() işlevi

get_info_from_table() işlevini kullanmak için sohbet robotu oluşturucuda bir bloğa ihtiyacınız vardır.

Mavibot'ta uygun sekmeye gidin ve bir tetikleyici ile blok oluşturun (Başlangıç bloğu veya Tetikleyici bloğu):

Bir değişken tanımlayın (AI asistanının bilgisi için kullanılacaktır): bu örnekte değişken 'record'.

Hesap Makinesi'nden kod örneği

project.****record``=``get_records_from_table(1)

  1. project. - proje yapılandırmasında bir değişken ayarlamak için oluşturucu;
  2. record - değişken adı;
  3. get_records_from_table(1) - parametre olarak tablo kimliğinin iletildiği işlev.

get_records_from_table(table_id, start_row, count, start_col, end_col) – bir tablodan kayıt almak için

Parametre Açıklama Not
! table_id tablo kimliği (zorunlu parametre)
start_row isteğe bağlı parametre, tamsayı. Aralığın başlangıç satırını belirtir tablo değerlerini okumaya başlayacağı satır numarasını kabul eder, dahil. Tırnak işareti olmadan belirtilmelidir
count isteğe bağlı parametre, tamsayı. Alınacak satır sayısını belirtir varsayılan değer: 1000. Maksimum: 5000. Tırnak işareti olmadan belirtilmelidir
start_col isteğe bağlı parametre, dize. Aralığın başlangıç sütununu belirtir tablo değerlerini okumaya başlayacağı sütun adını kabul eder, dahil. Tırnak işareti içinde belirtilmelidir
end_col isteğe bağlı parametre, dize. Aralığın bitiş sütununu belirtir tablo değerlerini okuyacağı sütun adını kabul eder, dahil. Tırnak işareti içinde belirtilmelidir

Belirli bir noktadan itibaren tüm verileri okumak için: Yalnızca aralığın başlangıcını belirtin. Belirli bir noktaya kadar tüm verileri okumak için: Yalnızca aralığın sonunu belirtin.

#{none} yerine, proje değişkenine hangi verilerin yazıldığını görsel olarak görmek için mesajda #{} yapısını kullanarak değişkenimizi yazacağız.

Dikkat

Mesaja gömülü değişken, botun işlevi doğru okuyup okumadığını kontrol etmek için gereklidir. Bloğu test modunda çalıştırdığınızda, bot değişkene atanacak değerleri görüntüleyecektir.

Lütfen unutmayın

Blok çağrısını test modunda yapılandırdıktan ve değişkeni proje ayarlarına kaydettikten sonra, bu bloğu silmeyin.

Buna ihtiyacınız olabilir: örneğin, tabloya herhangi bir değer eklediyseniz, bloğu test modunda başlatmanız yeterlidir. Ardından proje değişkenindeki veriler güncellenecektir.

Değişken adı, istediğiniz herhangi bir ad olabilir.

Veri aktarım bloğu

Ardından, verileri müşteri kartına aktarmak için bir "Sohbet" bloğu oluşturacağız.

"Bu blok ayrıca bottan bir kapanış mesajı da iletebilir, örneğin: 'Bilgileri yöneticiye iletiyorum! Yönetici 10 dakika içinde bağlanacak.'"

Ardından, blok kimliğini kopyalayın. AI asistanını "start_block_from_ai 11956" komutunda ve test "Block call 11956" komutunda yapılandırmak için buna ihtiyacınız olacak; burada örnekteki blok kimliği yerine kendi blok kimliğinizi eklemeniz gerekir.

Lütfen unutmayın

Testten sonra, "Block call 31241050" komutunu "start_block_from_ai 31241050" komutuyla değiştirin.

"Block call 31241050" komutu hata ayıklama amaçlıdır ve botun hangi verileri kaydettiğini anlamaya yardımcı olur ("Test Etme" bölümüne bakın).

Botu müşteriler için başlatmak için "start_block_from_ai 31241050" komutunu belirtin.

Tablo okuma

  1. Bot testi moduna gidin.
  2. Tablo verilerini okumak için tetikleyiciyi içeren bloğu başlatın.

Blok doğru çalıştı. Bunu, proje ayarlarınızdaki ilgili değişkende artık saklanan değerlerden doğrulayabilirsiniz.

Manuel olarak doğrulamak için:

  1. Proje ayarları bölümüne gidin.
  2. Geçerli verilerini görüntülemek için değişkeni bulun.

Proje ayarlarındaki "Değişkenler" sekmesinde, tablodan eklenen değerlerle birlikte değişkeninizi göreceksiniz. Artık projenizin içinde, tabloda belirttiğiniz mallar, maliyet ve her şeyi içeren bir değişken var.

AI asistanında çalışma

"AI asistanı" bölümüne gidin ve AI ayarlarıyla sohbet robotunu başlatın.

"Satış asistanı" rolünü seçmeniz gerekir:

Ayrıca ek ayarlar da yapacağız:

AI asistanı ayarları

Bot ayarlarına aşağıdaki verileri yazın:

  1. Botun konumu ve talimatları.

  1. Bloğu çağırma ve değişkenleri sisteme aktarma komutu şu şekilde yazılır:

"Her şey doğruysa, "start_block_from_ai 11956" komutunu çalıştırın; burada N yerine son mesajı içeren blok kimliği yazılır: Sohbet bloğu verileri müşteri kartına iletir:

Bot bilgisi

"Bot Bilgisi" alanına, daha önce tetikleyicili blok olarak önbelleğe alınan değişkeni iletin.

Bot bilgisi.

Bu şekilde bot, proje ayarlarındaki bir değişkenden bilgi alır ve müşterilerinize mevcut ürün yelpazesi hakkında danışmanlık yapar.

Veri formatı

İletilen verilerin formatında, topladığınız verileri (örneğin, bir ürün) kendiniz belirtir, ardından "anahtar" ile ifadeyi girer ve anahtara bir değer atarsınız.

müşteri adı client_name anahtarıyla, müşteri telefon numarası phone_number anahtarıyla, şehir ve adres city_address anahtarıyla, seçilen ürün product anahtarıyla, ürün miktarı quantity anahtarıyla, toplam sipariş tutarı total_amount anahtarıyla.

Bu şekilde, blok çağrıldığında müşteri kartına değişkenler iletilecektir: daha sonra örneğin sohbet robotu oluşturucuda değişkenlerle çalışabilirsiniz:

Bu aşamada AI asistanı kurulumu tamamlanmıştır.

Kalan parametreleri kendi takdirinize göre ayarlayabilirsiniz:

Botu test etme

"Zaten çalışan botlarınız varsa, AI asistanının başlatma koşulunda yalnızca test penceresinde başlatılacak şekilde belirtin."

Adım 1. Tetikleyici oluşturucuya tıklayın

Adım 2. Test penceresi olan sekmeyi seçin ve "Tetikleyici ekle"ye tıklayın:

Şimdi, tetikleyici koşulunda aşağıdaki değeri göreceksiniz:

Bu şekilde bot yalnızca test penceresinde çalışacak ve başka hiçbir yerde çalışmayacaktır.

Botta hata ayıkladıktan sonra bu koşulu kaldırın.

Bu mesaj, "Block call 3124105](/docs/chatbot-ai-assistant#data-transfer-format) komutu nedeniyle test modunda gönderiliyor

Botu test edip hatalarını ayıkladıktan sonra, bot ayarlarına "start_block_from_ai 31241050" komutunu yazın.

Bu yaklaşım, her türlü çevrimiçi mağazayı oluşturmanıza ve tablonuzda depolanan herhangi bir veri değerinden yararlanmanıza olanak tanır.

Tek gerçek sınır, hayal gücünüzdür.