# Как работать с таблицами Mavibot

Текст **«Листы»** раздел в MaviBot — это инструмент для удобного хранения и управления данными внутри платформы. Вам больше не нужно переключаться между разными сервисами — все ваши листы теперь доступны в одном проекте.

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

**Возможности:**

* Создавайте листы с любым количеством строк и столбцов.
* Храните и редактируйте данные без сторонних инструментов или сервисов.
* Вводите значения, редактируйте строки и столбцы или удаляйте их прямо через чат-бота с помощью функций.

**Преимущества:**

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

{% hint style="success" %}

#### **Управляйте своими таблицами, не покидая Mavibot**

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

## Как создать листы

Чтобы начать, перейдите в **«Листы»** раздел в нужном проекте:

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

Далее вы увидите **«Создать лист»** кнопку. Нажмите её, чтобы открыть модальное окно, где нужно ввести название таблицы:

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

Введите название таблицы и нажмите **«Готово»**. Затем новая таблица будет создана в проекте и появится в **«Листы»** разделе.

### Настройки листов

После создания листа необходимо добавить строки и столбцы. Для этого найдите кнопку «Перейти» на нужной таблице и нажмите её:

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

Вы увидите следующие настройки:

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

1. Функция добавления столбцов:

а) чтобы добавить столбцы с буквенными обозначениями

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

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

б) чтобы добавить столбцы с пользовательскими названиями

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

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

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

Введите название и нажмите **«Готово»** чтобы добавить столбец в таблицу.

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

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

2. Кнопка для добавления строк:

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

3. Экспорт листа

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

Позволяет экспортировать лист в формате CSV со всеми данными и значениями, например, чтобы перенести лист в другой проект Mavibot или в другой сервис таблиц.

4. Текст **Импорт CSV** функция позволяет загрузить данные из внешнего сервиса.

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

### Другие возможности

Есть выпадающее меню, которое позволяет быстро просматривать листы, не покидая основной раздел.

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

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

Чтобы удалить лист, перейдите в основной раздел:

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

Затем найдите **Удалить** кнопку на карточке таблицы, которую хотите удалить.

{% hint style="danger" %}
Внимание!

Удалённые таблицы нельзя восстановить.
{% endhint %}

### Как вводить значения в лист

Вы можете вводить значения в лист вручную:

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

Или с помощью функций в чат-боте.

### **Как найти ID листа**

Вам понадобится ID листа, чтобы использовать функции чат-бота, связанные с этой таблицей.

1. **Перейдите к своей таблице.** Найдите нужную таблицу в списке и нажмите на её название, чтобы открыть её.
2. **Найдите ID таблицы в адресной строке.** Нажмите на адресную строку браузера — ID таблицы это уникальная строка символов в конце URL.

<div data-with-frame="true"><figure><img src="/files/1531577e8c4b5ae5e8070b913fe7a7eb8a496bd6" 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/e966b46ba66f7ce982ee711dc23dde7ea7b026bf" 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/512521f0e056081c873f945c63f262d62fc6088c" 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/e7b88a4341f0cc7a2121df35586f205c57484044" alt="" width="375"><figcaption></figcaption></figure></div>

### Как удалить запись листа по её ID

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

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

record\_id – ID записи, которую нужно удалить

Ответ:

{'message': 'Удалённые записи: 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/3d5cad53584e2983361ed3d2cf898e1bafa934d2" 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/8fc684c6f2dbe5c1fb311c5c020307539b0a5325" 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/fa3984e4e98af0330182de5ae8574b90dc62072d" 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/ru/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.