# Yapay zekâ asistanı için Google Sheets

Mavibot ekibi tarafından geliştirilen bir özellik sayesinde, yapay zekâ sohbet botu sayfaya girilen değerleri doğru şekilde yorumlar ve ardından bunları proje ayarlarında bir sistem değişkenine kaydeder.

Örneğin, bunu çevrimiçi mağazanızdaki mevcut ürün yelpazesi hakkında müşterilerinize tavsiyede bulunacak bir yapay zekâ asistanı için kullanmanız gerekebilir; ayrıca akıllı bir bot ile yeteneklerinizi tanıtmak için de kullanılabilir.

Bir botu Google sayfasını okumak için tam olarak nasıl kullanacağınız size bağlıdır; biz ise size bir sayfa oluşturmayı ve botu onunla çalışacak şekilde yapılandırmayı göstereceğiz.

## Google sayfasını hazırlama

### Oluşturma ve doldurma

Sayfa düzenleyicisini açın:

<figure><img src="/files/8a290fcf530b69687890b0c8590480e7a968dc17" alt="" width="563"><figcaption></figcaption></figure>

Satırları sütun kategorileriyle doldurmanız gerekir:

<figure><img src="/files/2160c7147863b5b9c8b1a35a9657719d4173f638" alt="" width="563"><figcaption></figcaption></figure>

Yapay zekâ verileri okuyabildiği için, sayfadaki değerleri proje ayarlarında bir değişkene yazma işlevini kullanacaktır; bu nedenle, botun mantığını kolayca anlamanız ve sizin için daha rahat olması adına kısa ve anlaşılır sütun kategori adları eklemenizi öneririz.

Sonraki adımda, sütunlardaki gerekli adları belirtin:

<figure><img src="/files/d6c140bc573693318df280d365c8614ee698ce98" alt="" width="563"><figcaption></figcaption></figure>

"Ölçü birimi" sütun kategorisine bakalım:

<figure><img src="/files/50977627d3ba06a874b1280d593a701a37d3b792" alt="" width="252"><figcaption></figcaption></figure>

Ölçü birimi şunları içerebilir:

1. Parça/birim biçiminde nicel bir gösterge (bir ürün birimi, iki ürün birimi, bir parça vb.):

<figure><img src="/files/4a0f68aabf94b3d25d61d37d521da4b0517c5779" alt=""><figcaption></figcaption></figure>

2. Birim ölçüleri: litre, kilogram, gram, metre:

<figure><img src="/files/98c19be1921b65c25c1b35e9a75592208e7f4edb" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Bot ne demek istediğinizi mükemmel şekilde anlayacak ve slotlara gömülü değerleri kullanacaktır.
{% endhint %}

Google Sayfasını doldurmanın son adımı, ölçü birimi başına fiyatı girmektir.

<figure><img src="/files/6b9fd672bd80c1d523936ae4a86c6ec5161ce00b" alt=""><figcaption></figcaption></figure>

Bu aşamada Google sayfası tamamlanmış olur.

### Erişim Ayarları

Yapay zekâ botunun sayfadaki değerleri alabilmesi için erişim ayarlarını açmanız gerekir:

<figure><img src="/files/b70dfe0328c9e3c0fada165866832e5e9f762bb1" alt=""><figcaption></figcaption></figure>

Ayarlar'a tıklayın; aşağıdaki pencere açılacaktır:

<figure><img src="/files/c79376dc0bd29b5af5253d3aabb5ccd500692a79" alt="" width="375"><figcaption></figcaption></figure>

Burada ayarı "Erişim kısıtlı"dan "Bağlantıya sahip herkes"e değiştirmeniz gerekir:

<figure><img src="/files/a6982d5e5439384ff329b7cd19156d2682291f94" alt="" width="563"><figcaption></figcaption></figure>

### Sayfa kimliği

get\_info\_from\_table(!sheet\_id, number\_sheet, sheet\_json\_keys) işleviyle çalışmak için sayfa kimliğine ihtiyacımız olacak; çünkü işlev, zorunlu bir parametre olarak sheet\_id alır.

Kimliği almak için adres çubuğuna tıklamanız yeterlidir:

<figure><img src="/files/f1068efe3f6fda39cdf0053a0adeb5d5da8cf23a" alt=""><figcaption></figcaption></figure>

Sayfa adresini içeren bir satır göreceksiniz:

<figure><img src="/files/ea9be1fab780e4e6b77a53652e7cd1e7f69aee7c" alt=""><figcaption></figcaption></figure>

Buradan, sayfanın kimliği olan semboller ve harflerden oluşan bir kümeye ihtiyacımız olacak:

<figure><img src="/files/42d9c3cb106131b5e40c70ecafd149b4d13a9c6e" alt=""><figcaption></figcaption></figure>

Böylece sayfa ve yapılandırmasıyla ilgili çalışma tamamlanmış olur.

## Funnel oluşturucuda çalışma

### get\_info\_from\_table() işlevini kullanma

get\_info\_from\_table() işlevini kullanmak için funnel oluşturucuda bir blok gerekecektir.

Mavibot'ta ilgili sekmeye gidin ve birincil koşul doğrulama bloğu oluşturun:

<figure><img src="/files/39ccf9d3760d5bf553e76691c7897dd2b4f6c8a4" alt=""><figcaption></figcaption></figure>

\#{none} yerine, bu bloğu başlattıktan sonra test modu için mesaja bir bildirim ve #{} yapısı aracılığıyla gömülü bir değişken yazacağız:

<figure><img src="/files/e9d22f0a0bf63bb08000b025fb0b5a73cb02cd5b" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Dikkat!&#x20;

Mesaja gömülü değişken, botun işlevi okuduğunu doğrulamak için gereklidir.&#x20;

Bloğu test modunda çalıştırdığınızda, bot değişkenin içinde yer alacak değerleri gösterecektir.
{% endhint %}

{% hint style="success" %}
Dikkat!

Test modunda blok çağrısını yapılandırdıktan ve değişkeni proje ayarlarında kaydettikten sonra bu bloğu silmeyin.

Buna ihtiyacınız olabilir: örneğin tabloya başka değerler eklediyseniz, bloğu yalnızca test modunda çalıştırın. Ardından proje değişkenindeki veriler güncellenecektir.
{% endhint %}

{% hint style="info" %}
Değişken adı size uygun herhangi bir ad olabilir.
{% endhint %}

Sonraki adımda, verileri bir tablodan okumak için tasarlanmış get\_info\_from\_table(sheet\_id, number\_sheet, sheet\_json\_keys) işlevine ihtiyacımız var.

<table><thead><tr><th width="248">parametreler</th><th>açıklama </th></tr></thead><tbody><tr><td><mark style="color:kırmızı;"><strong>!</strong></mark> sheet_id</td><td>Google tablosu kimliği</td></tr><tr><td>number_sheet</td><td>Tablodaki sayfa numarası; varsayılan = 1</td></tr><tr><td>sheet_json_keys </td><td>İsteğe bağlı parametre, tablo verilerine erişim anahtarı</td></tr></tbody></table>

Hesaplayıcıyı açın ve tablo kimliğini girin, onu bir değişken içine alın (örneğin, sheet):

<figure><img src="/files/98babcdd929b78ac8842ea65457d8dae8f589aca" alt="" width="537"><figcaption></figcaption></figure>

Sonraki adımda, blok mesajında belirtilen değişkeni atayın ve ona get\_info\_from\_table() işlevi biçiminde, gerekli sheet\_id parametresiyle bir değer verin (bunun yerine tablo kimliğinin bulunduğu sheet değişkenini ekleyin):

<figure><img src="/files/573deb78d1699458b709c0a57f10b5b66e9285f6" alt="" width="563"><figcaption></figcaption></figure>

<mark style="color:kırmızı;">**Dikkat!**</mark> Hesaplayıcıda product\_pay\_info değişkeninden önce project yazın. Bu, tabloda bulunan DEĞİŞKEN ve DEĞERLERİN proje ayarlarına (önbelleğe) girilmesi için gereklidir:

<figure><img src="/files/764b526c6c720add85a473b10293b92caeb3439a" alt=""><figcaption></figcaption></figure>

Şimdi blok koşuluna herhangi bir kelime/rakam yazın:

<figure><img src="/files/55f533ce7cf50b0851d382a12eb1e53cb1e3cfbb" alt="" width="563"><figcaption></figcaption></figure>

### Veri aktarım bloğu

Sonraki adımda ikinci bir Durum bloğu oluşturun:

<figure><img src="/files/c8e6dbe5f43a95ddbe2e201d826ab78a9bbfdede" alt=""><figcaption></figcaption></figure>

Bu Durum bloğu, değişkenleri müşterinin kartına aktarmak için gerekli olacaktır.

Bu blokta bottan son bir mesaj da gönderebilirsiniz; örneğin, "Sipariş verdiğiniz için teşekkürler! Verileri iletişim yöneticisine gönderiyorum!":

<figure><img src="/files/1c23c33abb881671f0720774a2dd78f2c2d316e5" alt=""><figcaption></figcaption></figure>

Sonraki adımda blok kimliğini kopyalayın - AI asistanını "start\_block\_from\_ai 31241050" komutunda yapılandırmak için buna ihtiyacınız olacak; örnekteki kimlik yerine kendi blok kimliğinizi eklemeniz gerekir.

### Sayfa okuma

Şimdi bloğu test sürümünde başlatın, böylece sohbet botu sayfadaki değerleri okur ve bunları proje ayarlarındaki değişkeninize yerleştirir:

<figure><img src="/files/cd76ebedd838eb60d696619e6eeac96d19502d01" alt="" width="563"><figcaption></figcaption></figure>

Böylece blok doğru şekilde çalıştı: okuduğunuz ve proje ayarlarındaki değişkende yer alan değerleri görüyorsunuz.

Bunu ilgili bölüme giderek doğrulayabilirsiniz:

<figure><img src="/files/e917a8696d2cd5c75e1144a21f7ee82ba76eec15" alt="" width="287"><figcaption></figcaption></figure>

Sonraki adımda, tabloda yer alan ve içine gömülü değerleri olan değişkeninizi göreceksiniz:

<figure><img src="/files/ab030ed96d1f77a9e9968a03c9bd46eee1e14a93" alt=""><figcaption></figcaption></figure>

Böylece artık projenizin içinde ürünler, maliyet ve sayfada belirttiğiniz her şeyin bulunduğu bir değişken var.

## AI asistanı olarak çalışma

"AI asistanı" bölümüne gidin ve yapay zekâ yapılandırmasını başlatın.

Asistan rolü: satış temsilcisi

<figure><img src="/files/c3c4ec44bd7c96c6102298206b0bc5481610aea7" alt="" width="512"><figcaption></figcaption></figure>

Ayrıca "Düğmeler" ve "Adım adım veri girişi" seçeneklerini de ayarlayacağız:

<figure><img src="/files/bef39e36647a039b7f60a903a0a007fe1ce89d70" alt=""><figcaption></figcaption></figure>

Botun görsel olarak düzenlenmiş yanıtları ve müşterinin rahatlığı için düğmelere ihtiyacımız olacak (böylece kullanıcı diyalogda kelimeleri manuel olarak girmek zorunda kalmaz); adım adım veri girişi ise botun oluşturulan siparişi sorgulaması içindir.

### AI Asistan Ayarları

Botun ayarlarına aşağıdaki verileri yazıyoruz:

1. Botun konumu ve talimatları.

Örnek:

\<Sen bir mağaza satıcısısın. "Tüm küçük ayrıntılar.\
Görevin, müşteriye hangi ürünü seçmek istediğini, ürünün kaç birimini istediğini sormak ve ardından ürünün bir biriminin maliyeti ile çarpımına eşit olan toplam ürün maliyetini hesaplamaktır.

Müşteriye satın alımı hakkında sorular sorduktan sonra, siparişi onun için kopyala ve "Sipariş doğru mu?" diye sor.>

**Dikkat** "Ürünün toplam maliyetini, ürünün birim maliyeti ile çarpımına eşit olarak hesapla" satırına dikkat edin - bu satır, müşterinin seçtiği tüm kategorilerin maliyetinin nihai sonucunu gösterecektir:

Örnek:

Müşteri bir üründen üç kg seçti. Bot ise toplam maliyeti hesaplar:

<figure><img src="/files/d422a947e63cf66124e868742f4f725a81b0753e" alt="" width="563"><figcaption></figcaption></figure>

2. Bloğu çağırmak ve değişkenleri sisteme aktarmak için komut şu şekilde yazılır:

\<Müşteri "Sipariş doğru" veya "Doğru" yazarsa, o zaman "start\_block\_from\_ai N" yazın>, burada N yerine final mesajı olan blok kimliği yazılır: Durum bloğu verileri müşterinin kartına aktarır:

<figure><img src="/files/5cfcc6ccb55e10e0b1dfcf8d575957ceee57c715" alt="" width="563"><figcaption></figcaption></figure>

AI asistanı ayarlarındaki komutlar şu şekilde görünür:

<figure><img src="/files/71a280e5a04acd2b3b9dbeec0386e3b05f5fd2ab" alt=""><figcaption></figcaption></figure>

### Bot bilgisi

"Bot Bilgisi" alanına, koşulun Birincil Doğrulama bloğu tarafından daha önce önbelleğe alınmış değişkeni aktarın:

<figure><img src="/files/23e3dccec910b044406bac3474172b038c76408f" alt=""><figcaption></figcaption></figure>

Bot Bilgisi:

<figure><img src="/files/96e1059f6acaadfa84ffbcc2a540d4fd75c63598" alt=""><figcaption></figcaption></figure>

Böylece bot, proje ayarlarındaki bir değişkenden bilgi alacak ve müşterilerinize mevcut ürün yelpazesi hakkında tavsiyede bulunacaktır.

### Veri formatı

Aktarılan veri biçiminde, kendiniz topladığınız verileri (örneğin bir ürün) belirtirsiniz, ardından "anahtar" ifadesini girer ve anahtara bir değer atarsınız:

<figure><img src="/files/445ea3fca07c3ea5b31e35126e28f20eaab65925" alt=""><figcaption></figcaption></figure>

#### Açıklama

1\. satır: "Aktarılan verilerin biçimi: ürün anahtarıyla ürün, şey anahtarıyla ölçü birimi, sayı anahtarıyla fiyat, sonuç anahtarıyla seçilen tüm ürünlerin toplam maliyeti" - botun, sisteme hangi verinin ve hangi değerle aktarılması gerektiğini anlamasını sağlar.

Bu değişkenler müşterinin kartında görüntülenecektir:

<figure><img src="/files/c4b4839ba6ea31bed476f46f5b59e6d1d0691c0d" alt="" width="563"><figcaption></figcaption></figure>

2. Müşteri tarafından seçilen her ürünün ayrı ayrı görüntülenmesi gerekiyorsa, ikinci bir satır ekleyin:

"Müşteri birden fazla ürün seçtiyse, birinci ürünü product1 anahtarıyla, ikinci ürünü product2 anahtarıyla, üçüncü ürünü product3 anahtarıyla ve böyle devam ederek ekleyin".

Böylece AI asistanının kurulumu tamamlanmış olur.

Kalan parametreler kendi takdirinize göre ayarlanabilir:

<figure><img src="/files/1d1d402914e1383d10f82faafb11edacce6d54be" alt="" width="563"><figcaption></figcaption></figure>

## Botu test etme&#x20;

Test penceresindeki botun çalışmasını eklemek için koşul oluşturucuyu kullanın:

1\. Adım. Koşul oluşturucuya tıklayın

<figure><img src="/files/0dc64e557767a5b5aeb1884db60b7376155e8d8e" alt=""><figcaption></figcaption></figure>

2\. Adım. Metin kutusu olan sekmeyi seçin ve "Ekle"ye tıklayın:

<figure><img src="/files/889f75d26b0b5b2d8fb2d7faa995a68d5b8d6904" alt="" width="563"><figcaption></figcaption></figure>

Şimdi, başlangıç koşulunda aşağıdaki değeri görüyorsunuz:

<figure><img src="/files/2f2d774e2ed7aa37c56bfee9da36526b0e861d3a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Böylece bot yalnızca test penceresinde ve başka hiçbir yerde başlatılacaktır.

Botun hata ayıklaması tamamlandıktan sonra bu koşulu kaldırın.
{% endhint %}

Şimdi botu test edelim:

1. Bot'a ürün yelpazesi hakkında bir güvenlik sorusu soralım:

<figure><img src="/files/b03022c41a98393ccfc7f0eb5af91e0c88eead8f" alt="" width="375"><figcaption></figcaption></figure>

Bot, google sayfasına girilen ve proje ayarlarında bulunan bir değişkendeki değerleri yakalayarak çeşitli ürünleri gösterdi.

2. Sonraki adımda ürünü seçip akıllı botla konuşacağız:

<div><figure><img src="/files/6e4691c0d58417a097e9ea6d7afffc7fd54fa283" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/c8b1b87161c5078c2f1a3cb3544889596fd8ab3d" alt="" width="375"><figcaption></figcaption></figure></div>

3. Başka bir ürün seçelim:

<figure><img src="/files/5ded70bbde7dae42be9b2fdbe6283f403a9ee134" alt="" width="375"><figcaption></figcaption></figure>

Bot da doğru şekilde görüntüleniyor ve müşteriye daha sonraki seçim için ürün kategorilerini gösteriyor.

4. Müşteri birkaç ürün seçti ve miktarlarını belirtti:

<div><figure><img src="/files/8897585cffd6476ccf0b52cc78fc4b4688876634" alt=""><figcaption></figcaption></figure> <figure><img src="/files/cc8a600f0601b4e414ca2a8f40ffc94e548a2131" alt=""><figcaption></figcaption></figure></div>

Bot, seçilen öğelerin maliyetini hesapladı ve toplam maliyeti hesapladı.

5. Verileri sisteme gönderme:

<figure><img src="/files/6f3fcd485115e23474ba26ea6dfe1e422ac94f3f" alt="" width="375"><figcaption></figcaption></figure>

Sonuç: bot siparişi kopyaladıktan ve müşteri siparişin doğru olduğunu söyledikten sonra, sohbet botu ayarlara dayanarak "Diyalog durumu" bloğunu çağırdı:

<figure><img src="/files/1c23c33abb881671f0720774a2dd78f2c2d316e5" alt=""><figcaption></figcaption></figure>

Bundan sonra, botun müşteriyle yaptığı diyalogda ürettiği veriler müşterinin kartına gönderildi:

<figure><img src="/files/a32c9030022dd6c5f471e992e051f7a08417730e" alt="" width="563"><figcaption></figcaption></figure>

Bot her şeyi doğru şekilde çalıştırdı.

{% hint style="success" %}
Bu şekilde her türden bir çevrimiçi mağaza oluşturabilir ve tablonun içindeki gerekli tüm değerleri kullanabilirsiniz.

Ana sınırlama - yalnızca hayal gücünüzdür!
{% endhint %}

## Video Kılavuzu

{% embed url="<https://youtu.be/LTEmRgbRp8M>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/tr/chatbot/ai/yapay-zeka-asistani-icin-google-sheets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.