> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Chat

> Взаємодійте зі своїми даними природною мовою для аналізу, візуалізації та створення.

<Note>Доступно на всіх хмарних тарифних планах; для самостійного розгортання потрібен план Business або вище.</Note>

AI Chat допомагає аналізувати поточну Таблицю, пояснювати вміст Записів, створювати діаграми та звіти, а також створювати чи оновлювати Таблиці, Перегляди, застосунки й автоматизації.

ШІ надає пріоритет поточній сторінці. Щоб послатися на інші Таблиці, Перегляди, застосунки, автоматизації або папки, введіть `@` у полі введення та виберіть відповідний вузол.

## Як відкрити

Відкрийте Таблицю або Перегляд, а потім натисніть <img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/ai/cuppy-icon.svg?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=1e7abd74de22dba2ee1e4bb40c1ca2d0" alt="Cuppy" className="docs-inline-icon" width="72" height="72" data-path="images/docs/ai/cuppy-icon.svg" /> у верхньому правому куті, щоб відкрити AI Chat. Опишіть запитання або завдання в полі введення. Якщо завдання змінюватиме дані або створюватиме вузли, спочатку попросіть ШІ показати план, а потім підтвердьте виконання.

## На що може посилатися ШІ

ШІ надає пріоритет інформації з поточної сторінки:

* **Поточна Таблиця та Перегляд**: поточна Таблиця, поточний Перегляд, а також відфільтровані або відсортовані результати в ньому.
* **Вибрані рядки, стовпці та комірки**: якщо в сітковому Перегляді вибрано рядки, стовпці, одну комірку або діапазон комірок, ШІ використовує цей вибір як ключовий контекст.
* **Завантажені файли**: додавайте до розмови PDF-файли, файли Excel, документи Word, зображення та інші файли.
* **Інші вузли за допомогою `@`**: введіть `@` у полі введення, щоб додати Таблиці, Перегляди, застосунки, автоматизації або папки з дерева.

Файли також можна вставляти або перетягувати безпосередньо в поле введення. Спочатку вони відображаються як позначки вкладень, а після надсилання повідомлення стають доступними для ШІ.

Коли ви вставляєте довгий фрагмент звичайного тексту, Teable перетворює його на вкладення Markdown, щоб поле введення залишалося зручним для читання. Текстові вкладення та вкладення Markdown можна попередньо переглядати за їхніми позначками.

## Елементи керування введенням

* **Голосове введення**: натисніть кнопку мікрофона в полі введення та надайте доступ до мікрофона, щоб розпочати запис. Під час запису виберіть **Завершити голосове введення** або **Відхилити голосове введення**. Після завершення Teable транскрибує запис у поле введення.
* **Модель**: у меню моделей виберіть модель для розмови. Використовуйте легшу модель для простих запитів, очищення або переписування, а потужнішу — для складного планування, аналізу кількох Таблиць і створення застосунків.
* **Інтелект**: окремо виберіть рівень **Інтелект** у меню моделей. Він визначає глибину міркування; вищі рівні забезпечують докладніший аналіз.
* **Секрети**: відкрийте меню **+** і виберіть **Секрети**, щоб зберігати ключі API або інші облікові дані для AI Chat. AI Chat може читати ці значення як змінні середовища. Збережені значення доступні лише для запису; щоб оновити секрет, введіть нове значення.
* **Інтеграції**: коли ШІ потрібен доступ до стороннього облікового запису, у розмові може з’явитися картка на кшталт **Підключити Slack**. Натисніть **Підключити**, щоб авторизуватися через OAuth. Натисніть **Пропустити**, щоб скасувати авторизацію; ШІ продовжить виконувати частини завдання, для яких це підключення не потрібне.
* **Навички**: відкрийте меню **+** і виберіть **Навички**, щоб імпортувати, увімкнути, вимкнути або випробувати навички в поточному чаті. Під час імпорту виберіть, хто може використовувати навичку: **Особиста** доступна лише вам, **База** — співавторам у цій Базі, а **Простір** — усім у цьому Просторі. Введіть `/` у полі введення, щоб вибрати ввімкнену навичку. Щоб підключити або перенести зовнішню систему, див. розділ [Підключення та перенесення будь-яких даних](/uk/basic/ai/connect-everything).
* **Використання контексту**: кільце поруч із полем введення показує, яку частину контекстного вікна моделі зараз використовує розмова. Натисніть його, щоб переглянути відсоток і кількість токенів. Коли контекст заповнюється, Teable стискає розмову; почніть новий чат, якщо потрібен чистий контекст.
* **Керування файлами**: відкрийте **+** → **Більше** → **Керування файлами**, щоб переглянути файли в пісочниці поточного чату. Можна попередньо переглядати підтримувані файли, завантажувати їх або видаляти непотрібні файли й папки. Для керування файлами має існувати розмова.
* **Черга повідомлень**: надсилання ще одного повідомлення під час роботи ШІ не перериває її. Повідомлення очікує в черзі над полем введення й надсилається після завершення поточного запуску. Елементи черги зберігають ті самі позначки Таблиці, Перегляду, вкладень і вибраних даних, що й поле введення чату; команда **Видалити** вилучає елемент, **...** → **Редагувати повідомлення** повертає його до поля введення, а для текстового елемента також доступна команда **Спрямувати**, яка передає його текст активному запуску без очікування.

## Поширені сценарії використання

<CardGroup cols={2}>
  <Card title="Створення Таблиць і автоматизацій" icon="sitemap">
    Плануйте бізнес-базу даних, створюйте Таблиці, Перегляди, застосунки й автоматизації або оновлюйте наявні Записи.
  </Card>

  <Card title="Аналіз даних" icon="chart-line">
    Узагальнюйте дані в поточній Таблиці чи Перегляді або аналізуйте кілька пов’язаних вузлів.
  </Card>

  <Card title="Діаграми та звіти" icon="chart-pie">
    Перетворюйте результати запитів на діаграму, звіт або невелику інтерактивну сторінку, яку можна знову відкрити й поширити.
  </Card>

  <Card title="Читання файлів" icon="file-lines">
    Отримуйте відповіді на запитання за допомогою PDF-файлів, файлів Excel, документів Word, зображень та інших вкладень.
  </Card>
</CardGroup>

### Створення Таблиць і автоматизацій

AI Chat може не лише відповідати на запитання, а й допомагати створювати, оновлювати та впорядковувати дані. Для нового бізнес-процесу спочатку обговоріть структуру даних, а потім попросіть ШІ створити Таблиці, Перегляди, застосунки й автоматизації.

Приклади доречних запитів:

* Допоможи спланувати систему подальшої роботи з клієнтами. Які Таблиці та Поля мені потрібні?
* На основі наведеного вище плану створи ці Таблиці, Перегляди та Поля.
* Додай до Таблиці завдань Поля пріоритету, виконавця, терміну й статусу, а потім створи поширені Перегляди.
* Зміни статус вибраних Записів на «Завершено».
* Створи нову Таблицю з цього файлу Excel і перевір, чи правильно вибрано типи Полів.
* Створи CRM-застосунок із цієї Таблиці клієнтів зі сторінками списку клієнтів, відомостей про клієнта та Записів подальшої роботи.
* Коли буде створено нове замовлення, повідом власника й додай номер замовлення, ім’я клієнта та суму.

Для повної бізнес-бази даних спочатку попросіть ШІ спланувати структуру Таблиць. Перевіривши план, переходьте до створення Таблиць, Переглядів, застосунків і автоматизацій.

<Steps>
  <Step title="Спочатку сплануйте">
    Опишіть бізнес-ціль, наприклад створення системи подальшої роботи з клієнтами, і попросіть ШІ окреслити необхідні Таблиці, Поля, Перегляди й автоматизації.
  </Step>

  <Step title="Підтвердьте структуру">
    Перевірте запропоновані Таблиці, Поля, типи Полів і зв’язки. Додайте відсутні правила або відомості про робочий процес.
  </Step>

  <Step title="Перейдіть до створення">
    Попросіть ШІ створити підтверджені Таблиці та Перегляди, а потім продовжуйте із застосунками або автоматизаціями.
  </Step>
</Steps>

Докладніше про створення застосунків див. у розділі [App Builder](/uk/basic/ai/app-builder). Докладніше про автоматизацію див. у розділі [Автоматизація](/uk/basic/automation).

### Аналіз даних

Ставте запитання про дані в поточній Таблиці, наприклад:

* Порахуй завершені цього місяця завдання за виконавцями.
* Знайди клієнтів із найбільшим обсягом продажів за останні 30 днів.
* Проаналізуй незвичні Записи в цьому Перегляді.

Якщо запитання стосується кількох Таблиць, скористайтеся `@`, щоб додати відповідні Таблиці або Перегляди до розмови.

У сітковому Перегляді також можна вибрати рядки, стовпці, одну комірку або діапазон комірок, а потім скористатися командою **Додати до чату** в контекстному меню. Вибрані дані з’являться як позначка в полі введення, а натискання цієї позначки знову виділить відповідну область сітки. Для позначок стовпців за можливості використовуються назви Полів, а довгі списки скорочуються після перших кількох назв.

### Створення діаграм і звітів

Попросіть ШІ перетворити отримані дані на діаграму, письмовий звіт або невелику інтерактивну сторінку:

* Створи діаграму тижневого тренду продажів.
* Перетвори результат цього запиту на кругову діаграму.
* Створи зведений звіт із цих Записів.

ШІ створює їх як **артефакти**: вони відображаються в розмові як картка, відкриваються в окремому засобі перегляду й залишаються доступними після завершення розмови. Можливості роботи з ними описано в розділі [Артефакти](#artifacts).

<Info>
  Артефакт містить дані, які ШІ додав до нього під час створення, тому самостійно не оновлюється. Для сторінки, яка постійно отримує актуальні дані Таблиці або збирає введені дані й зберігає стан, створіть застосунок за допомогою [App Builder](/uk/basic/ai/app-builder).
</Info>

### Читання файлів

Після завантаження файлів ШІ може відповідати на запитання, використовуючи як вміст файлів, так і дані Таблиці:

* Узагальни цей PDF-файл і пов’яжи його з поточним Записом клієнта.
* Прочитай цей файл Excel і визнач Поля, які потрібно імпортувати.
* Створи опис продукту на основі цього зображення.

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

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

### Пам’ять

Пам’ять зберігає інформацію, яку ви явно просите Cuppy запам’ятати. Її область визначається користувачем і Базою: кожен користувач у кожній Базі має незалежний контекст пам’яті, а пам’ять, збережена в іншій Базі, не з’являється автоматично в поточній.

* Збереження пам’яті в поточній Базі

У розмові вкажіть, що Cuppy має запам’ятати:

```text theme={null}
Будь ласка, запам’ятай xxx.
```

* Повторне використання пам’яті з іншої Бази

Попросіть Cuppy прочитати іншу Базу й зберегти відповідні частини в поточній Базі:

```text theme={null}
Cuppy, прочитай пам’ять для Base ID bsexxxxxxxxxxxx і збережи відповідні відомості в поточній Базі.
```

### Виконання тривалих завдань

AI Chat може підтримувати середовище однієї розмови доступним близько 24 годин — цього достатньо для більшості завдань з аналізу даних, опрацювання файлів і створення застосунків. Виконуйте тривалу роботу в поточній розмові, щоб стежити за її перебігом і за потреби надавати додаткові вказівки.

<Steps>
  <Step title="Стежте за перебігом у поточній розмові">
    Якщо в інтерфейсі відображається `Обмірковування` або продовжують надходити оновлення про перебіг, завдання ще виконується. Якщо відображається `Завершено`, поточний запуск завершено.
  </Step>

  <Step title="Зберігайте результати на важливих етапах">
    Для багатоетапної роботи просіть Cuppy записувати результати назад у Teable, експортувати їх або створювати файл для завантаження на ключових етапах. Збережена робота залишатиметься доступною, навіть якщо середовище розмови згодом буде звільнено.
  </Step>

  <Step title="Знайте, коли середовище звільняється">
    Приблизний максимальний час існування середовища однієї розмови становить 24 години. Після завершення виконання на передньому плані неактивне середовище звільняється приблизно через 30 хвилин. Якщо середовище перезапуститься, тимчасові файли та незбережені проміжні результати не збережуться.
  </Step>
</Steps>

Для тривалої або повторюваної роботи використовуйте функцію, яка відповідає робочому процесу:

<CardGroup cols={2}>
  <Card title="Поля ШІ" icon="sparkles" href="/uk/basic/field/ai/ai-field">
    Використовуйте для поетапного опрацювання окремих Записів, наприклад великих Таблиць, пакетної класифікації, опрацювання вмісту або заповнення Полів.
  </Card>

  <Card title="Автоматизація" icon="bolt" href="/uk/basic/automation">
    Використовуйте для повторюваної роботи після створення або оновлення Записів, надсилання сповіщень чи запланованого опрацювання даних.
  </Card>
</CardGroup>

<h2 id="artifacts">
  Артефакти
</h2>

Коли ШІ створює діаграму, звіт, сторінку у стилі інформаційної панелі або невеликий інтерактивний інструмент, він зберігає результат як **артефакт** — автономну сторінку, що відображається поза розмовою. Артефакти з’являються в чаті як картки й залишаються доступними надалі. Кожен із них є інтерактивною HTML-сторінкою або звітом Markdown.

Натисніть картку, щоб відкрити артефакт. У засобі перегляду можна:

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

Щоб змінити артефакт, зверніться до ШІ в тій самій розмові. Кожна зміна стає новою версією того самого артефакту, а не окремим об’єктом, тому посилання для поширення продовжує працювати й можна повернутися до попередньої версії. Якщо сторінка не запускається, засіб перегляду показує помилку й пропонує команду **Виправити за допомогою ШІ**, яка надсилає помилку назад у чат, щоб ШІ міг її виправити.

### Поширення артефакту

Артефакти приватні й доступні лише користувачу, який їх створив. Щоб відкрити доступ іншим, скористайтеся посиланням для поширення.

<Steps>
  <Step title="Увімкніть поширення">
    Натисніть **Поширити** в засобі перегляду й увімкніть **Дозволити поширення**. Teable створить посилання.
  </Step>

  <Step title="Виберіть, хто може переглядати">
    Для параметра **Хто може переглядати** виберіть **Усі, хто має посилання** або **Учасники Простору**, щоб артефакт могли відкрити лише учасники Простору, які ввійшли в систему.
  </Step>

  <Step title="Додайте пароль (необов’язково)">
    У розширених налаштуваннях увімкніть **Захист паролем** і задайте пароль. Глядачі мають ввести його перед завантаженням артефакту.
  </Step>

  <Step title="Надішліть посилання">
    Натисніть **Копіювати посилання**, щоб скопіювати його. Якщо посилання потрапило до небажаних користувачів, команда **Скинути посилання** створить нове й припинить дію попереднього.
  </Step>
</Steps>

### Як знайти артефакти пізніше

Відкрийте **+** → **Більше** → **Керування артефактами**, щоб переглянути все, що ви створили в різних чатах. Знайдіть артефакт за назвою, а потім відкрийте його для перегляду або повторного поширення.

## Поради зі створення запитів

* **Спочатку вкажіть мету**: у першому повідомленні опишіть, що потрібно зробити, відповідні умови та очікуваний результат. Наприклад: проаналізуй тижневі тенденції продажів за останні 3 місяці з групуванням за регіонами та поверни Таблицю тенденцій із коротким висновком.
* **Використовуйте назви Полів**: наприклад, сортуйте за `Час створення`, щоб ШІ міг визначити потрібний стовпець.
* **Надайте кілька прикладів**: для результату у фіксованому форматі наведіть 3–5 прикладів «вхідні дані -> очікуваний результат».
* **Використовуйте `@` для вибору вузлів**: коли ШІ має звернутися до Таблиць, Переглядів, застосунків, автоматизацій або папок, введіть `@` і виберіть їх безпосередньо.
* **Підтверджуйте перед виконанням**: для завдань, що змінюють дані, створюють Таблиці чи застосунки або вмикають автоматизації, попросіть ШІ описати зміни перед їх виконанням.
* **Вибирайте модель відповідно до завдання**: якщо Простір підтримує вибір моделі, використовуйте легшу модель для простих запитів, очищення чи переписування, а потужнішу — для складного планування, аналізу кількох Таблиць і створення застосунків.
* **Налаштовуйте рівень Інтелекту**: параметр **Інтелект** визначає глибину міркування; вищі рівні забезпечують докладніший аналіз.
* **Починайте новий чат зі зміною теми**: новий чат рекомендовано починати, коли змінюється тема, розмова стає надто довгою або потрібно зменшити використання контексту.

## Поширені запитання

<AccordionGroup>
  <Accordion title="Як надати AI Chat доступ до іншої Таблиці, Перегляду, застосунку або автоматизації?">
    Введіть `@` у полі введення й виберіть вузол, на який має посилатися AI Chat. У сітковому Перегляді також можна вибрати рядки, стовпці, одну комірку або діапазон комірок, а потім скористатися командою **Додати до чату** в контекстному меню.
  </Accordion>

  <Accordion title="Чи може AI Chat працювати в іншій Базі?">
    Так. ШІ не обмежений Базою, до якої належить чат: він може знаходити інші доступні вам Бази й працювати в них. Укажіть назву Бази в запиті, наприклад «порівняй цю Таблицю з Таблицею замовлень у Базі “Продажі”». За допомогою `@` можна вибирати лише вузли поточної Бази, а всі дії, для яких не вказано інше місце, і надалі виконуватимуться у власній Базі чату.
  </Accordion>

  <Accordion title="Чи зберігаються діаграми та звіти, створені ШІ?">
    Так. Вони зберігаються як артефакти з історією версій і необов’язковим посиланням для поширення. Їх можна знову відкрити через **+** → **Більше** → **Керування артефактами**. Артефакт зберігає дані, на основі яких його створено, і не оновлюється самостійно. Для сторінки, що отримує актуальні дані Таблиці, створіть застосунок за допомогою [App Builder](/uk/basic/ai/app-builder).
  </Accordion>

  <Accordion title="Чи можуть колеги відкрити створений мною артефакт?">
    За замовчуванням — ні. Лише ви можете відкривати власні артефакти. Увімкніть **Дозволити поширення** в засобі перегляду й надішліть посилання, вибравши **Учасники Простору**, якщо артефакт має залишатися в межах Простору.
  </Accordion>

  <Accordion title="Чи переноситься пам’ять між Базами?">
    Ні. Область пам’яті визначається користувачем і Базою. Щоб повторно використати пам’ять з іншої Бази, попросіть Cuppy прочитати пам’ять тієї Бази й зберегти відповідні частини в поточній Базі.
  </Accordion>

  <Accordion title="Чи може AI Chat продовжувати роботу у фоновому режимі після мого виходу?">
    Не використовуйте AI Chat як засіб виконання фонових завдань. Продовжуйте роботу у видимій розмові й просіть Cuppy записувати результати назад у Teable, експортувати їх або створювати файл для завантаження.
  </Accordion>

  <Accordion title="Чому Teable повідомляє, що Cuppy зайнятий в іншій розмові?">
    Кожен користувач може одночасно запускати до 3 агентів, зокрема AI Chat і App Builder. Якщо з’являється повідомлення `Агент зайнятий в іншій розмові. Зачекайте.`, інше завдання ще виконується. Зачекайте, доки Cuppy завершить попереднє завдання, перш ніж продовжити.
  </Accordion>

  <Accordion title="Як повертаються кредити, якщо запуск ШІ завершився помилкою?">
    Один хід AI Chat може містити кілька етапів опрацювання. На сторінках розмови й оплати відображається загальна кількість кредитів за цей хід. Уже виконану й збережену Cuppy роботу можна й надалі використовувати. Якщо останній етап перервано через неочікувану помилку, кредити за нього повертаються автоматично. Ви можете продовжити роботу в тій самій розмові.
  </Accordion>

  <Accordion title="Що станеться, якщо надіслати ще одне повідомлення під час роботи ШІ?">
    Воно потрапить у чергу над полем введення й не перериватиме поточний запуск. Після його завершення Teable надішле всю чергу як одне повідомлення. Черга зберігається на сервері, тому не зникає після оновлення сторінки й однаково відображається на кожній вкладці чи пристрої, де відкрито цю розмову.

    Поки елемент очікує, його можна **Видалити** або скористатися командою **Редагувати повідомлення**, щоб повернути до поля введення. Текстовий елемент також можна спрямувати: команда **Спрямувати** негайно передає його активному запуску, після чого він з’являється в розмові з позначкою **Спрямована розмова**.

    У розмові може бути до 30 повідомлень у черзі. Після досягнення цієї межі повідомлення не додається до черги, а Teable відповідає: `Черга надсилання заповнена. Зачекайте, доки Cuppy її опрацює.`
  </Accordion>

  <Accordion title="Чому вказано, що чергу призупинено?">
    Зупинення запуску також призупиняє чергу, тому повідомлення в ній не надсилаються через зупинку, призначену для поточної відповіді. Після цього в заголовку черги відображається `Чергу призупинено, оскільки ви перервали виконання`. Натисніть **Відновити**, щоб продовжити надсилання, або просто надішліть наступне повідомлення: початок нового запуску також відновить чергу.
  </Accordion>

  <Accordion title="Як використовувати Навички в AI Chat?">
    Відкрийте меню **+** і виберіть **Навички**, щоб імпортувати навички або керувати ними, чи введіть `/` у полі введення, щоб вибрати ввімкнену навичку. Під час імпорту виберіть, хто може використовувати навичку: особиста — у ваших чатах, Бази — для співавторів у тій самій Базі, а Простору — для всіх у цьому Просторі. Користувачі з правом керування Базою можуть додавати навички Бази, а власники й автори Простору — навички Простору. Якщо AI Chat показує файл `.skill`, натисніть **Установити** на картці файлу, щоб додати його.
  </Accordion>

  <Accordion title="Яка навичка застосовується, якщо дві мають однакову назву?">
    Одночасно діє лише одна версія, а спільна командна версія має пріоритет над особистою копією: навичка Бази — над навичкою Простору, а навичка Простору — над особистою. У розмові застосунку або бота найвищий пріоритет має навичка, додана для цього застосунку чи бота. Щоб перевести всіх на нову версію, оновіть копію в Базі або Просторі.
  </Accordion>

  <Accordion title="Які файли зберігаються в розділі «Керування файлами»?">
    У розділі **Керування файлами** є дві папки: `uploads` для доданих вами файлів і `outputs` для файлів, створених у розмові. Обидві використовують окреме сховище, тому зберігаються після звільнення або перебудови пісочниці; до них можна повернутися пізніше для попереднього перегляду, завантаження чи видалення.

    Усе, що Cuppy записує поза цими двома папками, є тимчасовим, наприклад проміжні результати скрипту. Такі файли не відображаються в розділі **Керування файлами** й зникають після перезапуску пісочниці. Результати, які потрібно зберегти, попросіть Cuppy записати в `outputs` або назад у Teable чи завантажте, поки розмова відкрита; якщо відповідь містить кілька файлів, скористайтеся командою **Завантажити все**.
  </Accordion>

  <Accordion title="Що відбувається під час копіювання повідомлення з позначками?">
    Під час копіювання повідомлення користувача Таблиці, Перегляди, застосунки, автоматизації, папки, вибрані дані та вкладення зберігаються як текстові маркери. Коли ви вставите цей текст назад у AI Chat, Teable відновить як позначки усі маркери, які зможе розпізнати.
  </Accordion>

  <Accordion title="Де зберігати ключі API для AI Chat?">
    Скористайтеся **+** → **Секрети** в полі введення чату. AI Chat може використовувати ці значення під час розмови, не додаючи відкритий текст до вашого запиту.
  </Accordion>
</AccordionGroup>
