# Як працювати з таблицями Mavibot

Поле **"Аркуші"** розділ у MaviBot — це інструмент для зручного зберігання та керування даними всередині платформи. Вам більше не потрібно перемикатися між різними сервісами — усі ваші аркуші тепер доступні в одному проєкті.

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

**Можливості:**

* Створюйте аркуші з будь-якою кількістю рядків і стовпців.
* Зберігайте та редагуйте дані без сторонніх інструментів або сервісів.
* Вводьте значення, редагуйте рядки та стовпці або видаляйте їх безпосередньо через чатбот за допомогою функцій.

**Переваги:**

* **Спрощує керування даними:** ви можете вводити інформацію в таблицю безпосередньо з бота.&#x20;
* **Гнучкий і простий у використанні:** створюйте стільки таблиць, скільки потрібно, і налаштовуйте їх під свої бізнес-завдання.

{% hint style="success" %}

#### **Керуйте своїми таблицями, не виходячи з Mavibot**

Таблиці допомагають бізнесу структурувати дані та пришвидшувати процеси.
{% endhint %}

## Як створити аркуші

Щоб почати, перейдіть до **"Аркуші"** розділу в потрібному проєкті:

<div data-with-frame="true"><figure><img src="/files/7e1bf8788a720f81bb0b3d1134c406330b7f83c0" alt="" width="222"><figcaption></figcaption></figure></div>

Далі ви побачите **кнопку "Створити аркуш"** . Натисніть її, щоб відкрити модальне вікно, де потрібно ввести назву таблиці:

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

Введіть назву таблиці та натисніть **"Готово"**. Після цього нова таблиця буде створена в проєкті та з’явиться в **"Аркуші"** розділі.

### Налаштування аркушів

Після створення аркуша потрібно додати рядки та стовпці. Для цього знайдіть кнопку "Перейти" на потрібній таблиці та натисніть її:

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

Ви побачите такі налаштування:

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

1. Функція додавання стовпців:

а) щоб додати стовпці з літерами

<div data-with-frame="true"><figure><img src="/files/81071493ed244f6d2a0935e1aeb58566763b1531" alt="" width="350"><figcaption></figcaption></figure></div>

Кнопка додає до таблиці стовпці з позначеннями від A до Z.

б) щоб додати стовпці з власними назвами

<div data-with-frame="true"><figure><img src="/files/97669bcbd13e202efeb0fe86045b03da14ad5eac" alt="" width="339"><figcaption></figcaption></figure></div>

Натискання кнопки відкриває модальне вікно, де можна задати назву нового стовпця.

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

Введіть назву та натисніть **"Готово"** щоб додати стовпець до таблиці.

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

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

2. Кнопка для додавання рядків:

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

3. Експорт аркуша

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

Дозволяє експортувати аркуш у форматі CSV з усіма даними та значеннями, наприклад, щоб перенести аркуш до іншого проєкту Mavibot або до іншого сервісу електронних таблиць.

4. Поле **Імпорт CSV** функція дає змогу завантажувати дані із зовнішнього сервісу.

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

### Інші можливості

Є випадаюче меню, яке дає змогу швидко переглядати аркуші, не виходячи з головного розділу.

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

Також ви можете створювати нові таблиці безпосередньо з бокового меню.

Щоб видалити аркуш, перейдіть до головного розділу:

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

Потім знайдіть **Видалити** кнопку на картці таблиці, яку потрібно прибрати.

{% hint style="danger" %}
Увага!

Видалені таблиці неможливо відновити.
{% endhint %}

### Як вводити значення в аркуш

Ви можете вводити значення в аркуш вручну:

<div data-with-frame="true"><figure><img src="/files/726e81f286df2cd8b8a29316e77bf63372865cd0" alt="" width="513"><figcaption></figcaption></figure></div>

Або за допомогою функцій у чатботі.

### **Як знайти ID аркуша**

Для використання функцій чатбота, пов’язаних із цією таблицею, вам знадобиться ID аркуша.

1. **Перейдіть до своєї таблиці.** Знайдіть потрібну таблицю в списку та натисніть на її назву, щоб відкрити її.
2. **Знайдіть ID таблиці в адресному рядку.** Натисніть на адресний рядок вашого браузера — ID таблиці це унікальний рядок символів у кінці URL.

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

3. **Приклад:**\
   У такому URL, як `https://mavibot.ai/projects/11111/table/2`\
   ID таблиці — це **`2`**.
4. **Скопіюйте ID**\
   Виділіть і скопіюйте цей номер з адресного рядка, щоб використати його в конфігурації вашого чатбота.

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

### Як створити новий запис в аркуші

new\_record(table\_id, data) – створити новий запис у таблиці з указаними значеннями.

table\_id – ID таблиці

data – словник, що містить дані для введення. Приклад: {"column\_name1": "value1", "column\_name2": "value2"}. Якщо стовпець не існує, він буде створений. Відповідь: ID нового запису

### Приклад

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

### Як редагувати існуючий запис в аркуші

edit\_record(table\_id, record\_id, data)

table\_id – ID таблиці

record\_id – ID запису, який потрібно редагувати

data – словник, що містить дані для оновлення. Приклад: {"column\_name1": "value3", "column\_name2": "value4"}. Якщо стовпець не існує, він НЕ буде створений.

Відповідь: Повертає повні дані відредагованого запису у форматі {"column\_name1": "value3", "column\_name2": "value4"}

### Приклад

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

### Як видалити запис аркуша за його ID

delete\_record(table\_id, record\_id)

table\_id – ID таблиці

record\_id – ID запису, який потрібно видалити

Відповідь:

{'message': 'Deleted entries: 1'}

### Як знайти перший запис із указаним значенням в аркуші

find\_record(table\_id, value, find\_in, return\_from)

table\_id – ID таблиці

value – значення, яке потрібно знайти

find\_in – необов’язково. Назва стовпця, в якому потрібно виконувати пошук. Якщо не вказано, пошук буде виконано по всіх стовпцях

return\_from – необов’язково. Назва стовпця, з якого потрібно повернути значення

Відповідь: Якщо return\_from вказано, буде повернено значення з указаного стовпця (якщо він існує в таблиці). Якщо return\_from не вказано або стовпець не існує, буде повернено повні дані знайденого запису: {"column\_name1": "value3", "column\_name2": "value4"}

### Приклад

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

### Як отримати значення з указаного запису

get\_record\_data(table\_id, record\_id, return\_column )&#x20;

table\_id – ID таблиці

record\_id – ID запису, з якого потрібно отримати значення

return\_column – необов’язково. Назва стовпця, з якого потрібно повернути значення

Відповідь: Якщо запис знайдено, повертає словник на кшталт {"column\_name1": "value1", "column\_name2": "value2"}. Якщо вказано return\_column і стовпець існує, буде повернено лише значення з цього стовпця.

### Як отримати всі значення під час пошуку по кількох стовпцях&#x20;

find\_records\_multiple\_cols\_list(table\_id, column\_data, return\_col, with\_index, delimiter, algorithm) – використовуйте цю функцію, коли потрібно одночасно шукати по кількох стовпцях і отримати список значень зі стовпця в рядках, де всі значення знайдено. (Це аналог функції sheet\_search\_in\_multiple\_cols\_return\_list для Google Sheets.)

**table\_id** — ID таблиці

**column\_data** — пошуковий запит, тобто те, що ви хочете знайти

**return\_col** — номер стовпця, з якого потрібно повернути значення

**with\_index** — індекс або нумерація в списку знайдених значень (0 – нумерація (1, 2, 3,…); 1 – індекс рядка; "" – список значень на нових рядках без індексів або нумерації)

**delimiter** — роздільник між індексом і значенням

**algorithm** — алгоритм пошуку (F – точне співпадіння, K – пошук за ключовим словом, R – регулярний вираз, 1–100 – відсоток схожості (див. деталі вище))

Приклад:

table\_id = 7

data = {"age": "26", "city": "New York"}

return\_col = "name"

with\_index = 1

delimiter = " - "

algorithm = "F"

res = find\_records\_multiple\_cols\_list(table\_id, data, return\_col, with\_index, delimiter, algorithm)

res\_list = res\["list"]

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

Якщо запит виконується успішно, відповідь — це словник, що містить статус і всі клітинки зі значеннями:&#x20;

{"status":true,"rows\_index":\[2,3],"quantity":2,"list":"2 - John\n3 - Anna"}

**status** — результат пошуку

**rows\_index** — масив із номерами знайдених рядків

**quantity** — кількість знайдених рядків

**list** — рядок з усіма значеннями з вибраного стовпця

Якщо виникає помилка, відповідь матиме status: false разом з описом помилки: {"status": false, "error": "Помилка або опис"}

### Як отримати перше значення під час пошуку по кількох стовпцях

find\_first\_record\_multiple\_cols\_row(table\_id, column\_data, algorithm) – використовуйте цю функцію, коли потрібно одночасно шукати по кількох стовпцях і отримати перший відповідний рядок. (Це аналог функції sheet\_search\_in\_multiple\_cols\_return\_row для Google Sheets.)

**table\_id** — ID таблиці

**columns** — пошуковий запит, тобто те, що ви хочете знайти

**algorithm** — алгоритм пошуку (F – точне співпадіння, K – пошук за ключовим словом, R – регулярний вираз, 1–100 – відсоток схожості (див. деталі вище))

Приклад:

table\_id = 7

data = {"age": "26", "city": "New York"}

algorithm = "F"

res = find\_first\_record\_multiple\_cols\_row(table\_id, data, algorithm)

row\_data = res\["row\_data"]

row\_id = row\_data\["ID"]

row\_name = row\_data\["name"]

row\_age = row\_data\["age"]

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

Якщо запит виконується успішно, відповідь — це словник, що містить статус і всі клітинки зі значеннями.

{"status":true,"rows\_index":\[2,3],"quantity":2,"row\_data":{"ID":2,"name":"John","age":"26","city":"New York"},"row":2}

**status** — результат пошуку

**rows\_index** — масив із номерами знайдених рядків

**row\_data** — дані з знайденого рядка

**row** — номер знайденого рядка

Якщо виникає помилка, відповідь матиме status: false разом з описом помилки: {"status": false, "error": "Помилка або опис"}


---

# 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/uk/sheets/settings.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.