# MaviBot tabloları ile yapay zekâ asistanı

MaviBot ekibi tarafından geliştirilen özel bir fonksiyon kullanarak, yapay zekâ sohbet botunuz Google Sheet’ten değerleri akıllıca okuyup bunları proje ayarlarınız içindeki bir **sistem değişkenine**. Bu, asistanınız için senkronize, dinamik bir veri kaynağı oluşturur.

#### **Pratik kullanım alanları**

Bu özellik şu gibi senaryolar için kritik öneme sahiptir:

* **Ürün kataloğu asistanı:** müşterilere sizin **güncel ürün yelpazeniz, fiyatlarınız ve stok durumunuz** hakkında gerçek zamanlı olarak tavsiyede bulunan bir yapay zekâ.
* **Akıllı promosyon botu:** bir bot ki **sunduğunuz teklifleri** doğrudan tablonuzdan çekilen özellikleri, teknik bilgileri veya fırsatları dinamik olarak öne çıkararak tanıtır.

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

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

<div data-with-frame="true"><figure><img src="/files/857faded4e0c8757c79f94f8cdb32a2662969ea9" alt=""><figcaption></figcaption></figure></div>

Sonraki adımda, bir modal pencere açan "Sayfa ekle" düğmesini göreceksiniz; burada sayfanın adını girmeniz gerekir:

<div data-with-frame="true"><figure><img src="/files/6471fa01cd61ce07d6c80a992952b6e8e5f6513f" alt=""><figcaption></figcaption></figure></div>

Sayfanın adını 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:

<div data-with-frame="true"><figure><img src="/files/0d585ce31bb19d65516965d50c05db8c15c1559f" alt=""><figcaption></figcaption></figure></div>

### Sayfa ayarları

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

Şimdi aşağıdaki ayarları görürsünüz:

<div data-with-frame="true"><figure><img src="/files/07ae103753dfd34819b178805fbd2ce2aa767dad" alt="" width="563"><figcaption></figcaption></figure></div>

İsimli bir sütun eklemek için "+" düğmesine tıklayın:

<div data-with-frame="true"><figure><img src="/files/668dba92e6f14b72039bb248559544ef30ff6c0c" alt=""><figcaption></figcaption></figure></div>

Düğmeye tıkladığınızda, yeni sütunun adını 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 tabloya eklenecektir. Gerekli sayıda sütun ekleyin ve ardından satırları ekleyin.

<div data-with-frame="true"><figure><img src="/files/07f84e82e5fd6c6a4a41aa6f3f2a538a7a5a7a32" alt="" width="563"><figcaption></figcaption></figure></div>

&#x20;Şimdi tablonuz şöyle görünüyor.

<div data-with-frame="true"><figure><img src="/files/b3bdef150c02efa7429554f03d530d0fbdce6ce8" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/a531306ae386adb6590dd741a4ddc7cb6692a324" alt="" width="563"><figcaption></figcaption></figure></div>

Şimdi oluşturucudaki blokların yapılandırmasına geçelim.

## Sohbet botu oluşturucusunda çalışma

### get\_records\_from\_table() işlevi

get\_info\_from\_table() işlevini kullanmak için sohbet botu oluşturucusunda bir bloğa ihtiyacınız vardır.&#x20;

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

<div data-with-frame="true"><figure><img src="/files/c4fd1c2c700041f9dbe9c722ba992da28e4bf171" alt=""><figcaption></figcaption></figure></div>

Bir değişken tanımlayın (yapay zekâ asistanının bilgisi için kullanılacaktır): bu örnekte değişken 'record' olarak belirlenmiştir.

Hesaplayıcıdan kod örneği

<mark style="color:yeşil;">`project.`</mark><mark style="color:kırmızı;">`record`</mark>` ``=`` `<mark style="color:turuncu;">`get_records_from_table`</mark>`(1)`

1. <mark style="color:yeşil;">`project. - proje yapılandırmasında bir değişken ayarlamak için kullanılan yapıcıdır;`</mark>
2. <mark style="color:kırmızı;">`record - değişken adı;`</mark>
3. <mark style="color:turuncu;">`get_records_from_table`</mark>`(1) - parametresi tablo kimliği olarak geçirilen işlev.`&#x20;

<details>

<summary>get_record_from_table() işlevi hakkında daha fazla bilgi edinin</summary>

`get_records_from_table(table_id, start_row, count, start_col, end_col)` – tablodan kayıtları 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şlanacak satır numarasını, dahil olacak şekilde, kabul eder. Tırnak işaretleri 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şaretleri olmadan belirtilmelidir                                                  |
| start\_col      | isteğe bağlı parametre, string. Aralığın başlangıç sütununu belirtir  | tablo değerlerini okumaya başlanacak sütun adını, dahil olacak şekilde, kabul eder. Tırnak işaretleri içinde belirtilmelidir       |
| end\_col        | isteğe bağlı parametre, string. Aralığın bitiş sütununu belirtir      | tablo değerlerinin okunacağı bitiş sütununu, dahil olacak şekilde, kabul eder. Tırnak işaretleri içinde belirtilmelidir            |

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

</details>

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

<div data-with-frame="true"><figure><img src="/files/30a57a14b2fc3db0ddd2d49c9d4728f50545b936" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}

## Dikkat

Mesaja yerleştirilen değişken, botun işlevi doğru okuyup okumadığını kontrol etmek için gereklidir. Bloku test modunda çalıştırdığınızda, bot değişkene atanacak değerleri gösterecektir.
{% endhint %}

{% hint style="success" %}

## Lütfen dikkat edin

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

İhtiyaç duyabilirsiniz: örneğin, tabloya başka değerler eklediyseniz, bloğu test modunda başlatmanız yeterlidir. Ardından proje değişkenindeki veriler güncellenecektir.
{% endhint %}

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

### Veri aktarım bloğu&#x20;

Sonraki adımda, verileri müşterinin kartına aktarmak için bir "Sohbet" bloğu oluşturacağız.

<div data-with-frame="true"><figure><img src="/files/29e26adb9dd1096dc644047ac8b1ea1bb0264420" alt=""><figcaption></figcaption></figure></div>

"Bu blok ayrıca bottan şu gibi bir kapanış mesajı da iletebilir: 'Bilgileri yöneticiye aktarıyorum! Yönetici 10 dakika içinde bağlantı kuracak.'"

Sonraki adımda, blok kimliğini kopyalayın. Bunu, AI asistanını "start\_block\_from\_ai 11956" komutunda ve test "Block call 11956" komutunda yapılandırmak için ihtiyaç duyacaksınız; burada örnekteki <mark style="color:kırmızı;">blok kimliği</mark> yerine kendi blok kimliğinizi eklemeniz gerekir.

{% hint style="success" %}

## Lütfen dikkat edin

Testten sonra "Block call <mark style="color:kırmızı;">31241050</mark>" ifadesini "start\_block\_from\_ai <mark style="color:kırmızı;">31241050"</mark>.

"Block call <mark style="color:kırmızı;">31241050</mark>" komutu hata ayıklama içindir ve botun hangi verileri kaydettiğini anlamaya yardımcı olur (bkz. "Testing" bölümü).

Botu müşteriler için başlatmak için "start\_block\_from\_ai <mark style="color:kırmızı;">31241050</mark>".
{% endhint %}

### Bir tabloyu okuma

1. şuraya gidin: **bot testi** modu.
2. Tablo verilerini okumak için tetikleyiciyi içeren bloğu başlatın.

<div data-with-frame="true"><figure><img src="/files/e9c34bb8d03da9f410e529ddc3e1a5a00b3afc33" alt="" width="563"><figcaption></figcaption></figure></div>

Blok doğru şekilde çalıştı. Bunu, artık ilgili değişkende proje ayarlarınız içinde saklanan değerlerle doğrulayabilirsiniz.

**Elle doğrulamak için:**

1. Şuraya gidin: **Şuraya gidin** bölümünde görünecektir.
2. Mevcut verilerini görmek için değişkeni bulun.

<div data-with-frame="true"><figure><img src="/files/a2e71bd20f502fd70d3fe6bc3f6e223ac1809138" alt="" width="563"><figcaption></figcaption></figure></div>

Proje ayarlarındaki "Değişkenler" sekmesinde, tablodan eklenen değerlerle birlikte değişkeninizi göreceksiniz. Böylece artık projenizin içinde ürünler, maliyet ve tabloda belirttiğiniz her şeyle bir değişken bulunuyor.

## Yapay zekâ asistanında çalışma

"AI assistant" bölümüne gidin ve sohbet botunu yapay zekâ ayarlarıyla başlatın.

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

<div data-with-frame="true"><figure><img src="/files/43795d382a61e10723e091d090307f079533a46b" alt=""><figcaption></figcaption></figure></div>

Ayrıca ek ayarlar da yapacağız:

<div data-with-frame="true"><figure><img src="/files/e9a6b2acbd2f71ac99baaa46d8e822f814f5ce07" alt="" width="563"><figcaption></figcaption></figure></div>

### &#x20;Yapay zekâ asistanı ayarları

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

1. Botun konumu ve talimatları.

<div data-with-frame="true"><figure><img src="/files/2006763d92cae9ac87f146d5a82e0ae681df9cd1" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

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

### Bot bilgisi

"Bot Knowledge" alanında, daha önce bir tetikleyiciyle blok olarak önbelleğe alınmış değişkeni aktarın.

<div data-with-frame="true"><figure><img src="/files/c2247654d79c5dd96eecd5707962a7a6e9dad1b1" alt="" width="563"><figcaption></figcaption></figure></div>

Bot bilgisi.

<div data-with-frame="true"><figure><img src="/files/2cabddc74593a447d6656eaf7f182d8358660330" alt=""><figcaption></figcaption></figure></div>

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 verilerin formatında, kendi topladığınız verileri (örneğin bir ürün) belirtir, ardından "anahtar" ifadesini 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.`

<div data-with-frame="true"><figure><img src="/files/5d669ea7f800afedc8553c0afedae41fda4a979d" alt=""><figcaption></figcaption></figure></div>

Bu şekilde, blok çağrıldığında değişkenler müşterinin kartına aktarılacaktır; ardından örneğin sohbet botu oluşturucusunda değişkenlerle çalışabilirsiniz:

<div data-with-frame="true"><figure><img src="/files/013f00d0f2e04105ccee3d188d7380c9ef29c824" alt="" width="563"><figcaption></figcaption></figure></div>

Bu aşamada, yapay zekâ asistanı kurulumu tamamlandı.&#x20;

Kalan parametreler kendi takdirinize göre ayarlanabilir:

<div data-with-frame="true"><figure><img src="/files/b31e4298f63ce19da10832720a4c3be82424e844" alt="" width="563"><figcaption></figcaption></figure></div>

## Botu test etme

"Eğer zaten çalışan botlarınız varsa, yapay zekâ asistanının başlatma koşulunda yalnızca test penceresinde başlamasını belirtin."

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

<div data-with-frame="true"><figure><img src="/files/b5aa1362ae711d71707c9040ab3459562a9e4046" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/ccfa7a851e32e734d82634eee2b6d05027e6709d" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/841c2dd66a3f49d62bbd622efa5c804075dfe783" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/7347f7b8e1df99e79c0ff6e9557b1da51ac86c7d" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/04cf2fdf49aa1a4541a694e4f3110fd6a63fe279" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/c974e9ccbcfc836b0064b449ac30ffb9639b2f87" alt="" width="375"><figcaption></figcaption></figure></div>

Bu mesaj t modunda["Block call <mark style="color:kırmızı;">**3124105**</mark>](/doc/tr/chatbot/ai/assistant.md#data-transfer-format)

<div data-with-frame="true"><figure><img src="/files/bb2f6fc8c97c548ce0d69170a284b4a9b489de01" alt="" width="375"><figcaption></figcaption></figure></div>

Botu test edip hata ayıklamasını yaptıktan sonra, bot ayarlarına "start\_block\_from\_ai <mark style="color:kırmızı;">**31241050**</mark>".

{% hint style="success" %}
Bu yaklaşım, **her tür çevrimiçi mağaza oluşturmanıza** ve **tablonuzda saklanan** herhangi bir veri değerinden

yararlanmanıza olanak tanır. Gerçek tek sınır hayal gücünüzdür.
{% endhint %}


---

# 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/tables.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.