> ## 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.
# ИИ-чат
> Взаимодействуйте с данными на естественном языке для анализа, визуализации и создания.
Доступно во всех тарифах Cloud; для Self-Hosted требуется тариф Business или выше.
ИИ-чат помогает анализировать текущую таблицу, объяснять содержимое записей, создавать диаграммы и отчёты, а также создавать или обновлять таблицы, представления, приложения и автоматизации.
ИИ отдает приоритет текущей странице. Чтобы сослаться на другие таблицы, представления, приложения, автоматизации или папки, введите `@` в поле ввода и выберите соответствующий узел.
## Как открыть
Откройте таблицу или представление, затем нажмите 
в правом верхнем углу, чтобы открыть ИИ-чат. Опишите вопрос или задачу в поле ввода. Если задача изменит данные или создаст узлы, сначала попросите ИИ перечислить план, а затем подтвердите выполнение.
## На что может ссылаться ИИ
ИИ отдает приоритет информации с текущей страницы:
* **Текущая таблица и представление**: текущая таблица, текущее представление и отфильтрованные или отсортированные результаты в этом представлении.
* **Выбранные строки, столбцы и ячейки**: если в представлении «Сетка» выбраны строки, столбцы, одна ячейка или диапазон ячеек, ИИ использует выбранное как важный контекст.
* **Загруженные файлы**: добавляйте в беседу PDF-файлы, файлы Excel, документы Word, изображения и другие файлы.
* **Больше узлов с помощью `@`**: введите `@` в поле ввода, чтобы добавить из дерева таблицы, представления, приложения, автоматизации или папки.
Файлы также можно вставить или перетащить непосредственно в поле ввода. Сначала они отображаются как чипы вложений, а после отправки сообщения становятся доступны ИИ.
Когда вы вставляете длинный блок обычного текста, Teable преобразует его во вложение Markdown, чтобы поле ввода сообщения оставалось удобным для чтения. Текстовые вложения и вложения Markdown можно просматривать через их чипы вложений.
## Элементы управления ввода
* **Голосовой ввод**: нажмите кнопку микрофона в поле ввода и разрешите доступ к микрофону, чтобы начать запись. Во время записи выберите **Завершить голосовой ввод** или **Отменить голосовой ввод**. После завершения Teable преобразует запись в текст в поле ввода.
* **Модель**: используйте меню модели, чтобы выбрать модель для беседы. Выбирайте более легкую модель для простых запросов, очистки или переписывания, а более мощную — для сложного планирования, анализа нескольких таблиц и создания приложений.
* **Интеллект**: отдельно выберите уровень **Интеллекта** в меню модели. Он управляет глубиной рассуждений; более высокие уровни дают более тщательное обоснование.
* **Секреты**: откройте меню **+** и выберите **Секреты**, чтобы сохранить API-ключи или другие учетные данные для ИИ-чата. ИИ-чат может читать эти значения как переменные окружения. Сохраненные значения доступны только для записи; введите новое значение, чтобы обновить секрет.
* **Интеграции**: когда ИИ требуется доступ к сторонней учетной записи, он может показать в беседе карточку, например **Подключить Slack**. Нажмите **Подключить**, чтобы авторизоваться через OAuth. Нажмите **Пропустить**, чтобы отменить авторизацию; ИИ продолжит работу с теми частями, которые может выполнить без этого подключения.
* **Навыки**: откройте меню **+** и выберите **Навыки**, чтобы импортировать, включать, отключать или пробовать навыки в текущем чате. При импорте выберите, кто сможет его использовать: **Личный** оставляет его только вам, **База** предоставляет его соавторам в этой базе, а **Пространство** — всем в этом пространстве. Введите `/` в поле ввода, чтобы выбрать включенный навык. Сведения о подключении или миграции внешней системы см. в разделе [Подключайте и переносите всё](/ru/basic/ai/connect-everything).
* **Использование контекста**: кольцо рядом с полем ввода показывает, какую часть контекстного окна модели сейчас использует беседа. Нажмите его, чтобы увидеть процент и количество токенов. Когда контекст заполняется, Teable сжимает беседу; если нужен чистый контекст, начните новый чат.
* **Управление файлами**: откройте **+** → **Ещё** → **Управление файлами**, чтобы просмотреть файлы в изолированной среде текущего чата. Можно просматривать поддерживаемые файлы, скачивать их или удалять ненужные файлы и папки. Для управления файлами беседа уже должна существовать.
* **Очередь сообщений**: отправка другого сообщения, пока ИИ работает, не прерывает его. Сообщение ожидает в очереди над полем ввода и будет отправлено после завершения текущего запуска. Элементы в очереди сохраняют те же чипы таблицы, представления, вложения и выбора, что и поле ввода чата; **Удалить** удаляет элемент, **...** → **Редактировать сообщение** возвращает его в поле ввода, а для элемента только с текстом также доступно **Направить**, чтобы передать его текст текущему запуску вместо ожидания.
## Распространённые сценарии
Спланируйте бизнес-базу данных, создайте таблицы, представления, приложения, автоматизации или обновите существующие записи.
Обобщайте данные в текущей таблице или представлении либо анализируйте несколько связанных узлов.
Превращайте запрошенные данные в диаграмму, отчёт или небольшую интерактивную страницу, которую можно снова открыть и предоставить другим.
Отвечайте на вопросы, используя PDF-файлы, файлы Excel, документы Word, изображения и другие вложения.
### Создание таблиц и автоматизаций
ИИ-чат может помогать создавать, обновлять и организовывать данные, а не только отвечать на вопросы. Для нового бизнес-процесса сначала обсудите структуру данных, затем попросите ИИ создать таблицы, представления, приложения и автоматизации.
Подходящие запросы:
* Помоги спланировать систему сопровождения клиентов. Какие таблицы и поля мне нужны?
* На основе плана выше создай эти таблицы, представления и поля.
* Добавь в таблицу задач поля приоритета, исполнителя, срока и статуса, затем создай распространённые представления.
* Измени выбранные записи на «Завершено».
* Создай новую таблицу из этого файла Excel и проверь, подходят ли типы полей.
* Создай CRM-приложение из этой таблицы клиентов со страницами списка клиентов, сведений о клиенте и записей сопровождения.
* Когда создаётся новый заказ, уведомляй владельца и включай номер заказа, имя клиента и сумму.
Для полноценной бизнес-базы данных начните с просьбы к ИИ спланировать структуру таблиц. После проверки плана продолжите созданием таблиц, представлений, приложений и автоматизаций.
Опишите бизнес-цель, например создание системы сопровождения клиентов, и попросите ИИ обозначить необходимые таблицы, поля, представления и автоматизации.
Проверьте предложенные таблицы, поля, типы полей и связи. Добавьте недостающие правила или детали процесса.
Попросите ИИ создать подтверждённые таблицы и представления, затем продолжите с приложениями или автоматизациями.
Подробнее о создании приложений см. в разделе [Конструктор приложений](/ru/basic/ai/app-builder). Подробнее об автоматизациях см. в разделе [Автоматизация](/ru/basic/automation).
### Анализ данных
Задавайте вопросы о данных в текущей таблице, например:
* Подсчитай завершённые задачи за этот месяц по исполнителям.
* Найди клиентов с наибольшими продажами за последние 30 дней.
* Проанализируй необычные записи в этом представлении.
Если вопрос затрагивает несколько таблиц, используйте `@`, чтобы добавить в беседу связанные таблицы или представления.
В представлении «Сетка» также можно выбрать строки, столбцы, одну ячейку или диапазон ячеек, а затем использовать **Добавить в чат** в контекстном меню. Выбор отображается как чип в поле ввода; нажатие на чип снова выделяет связанную область сетки. Чипы столбцов используют названия полей, когда они доступны, и сокращают длинные выборки после первых нескольких названий.
### Создание диаграмм и отчётов
Попросите ИИ превратить запрошенные данные в диаграмму, текстовый отчёт или небольшую интерактивную страницу:
* Создай диаграмму недельной динамики продаж.
* Преврати результат этого запроса в круговую диаграмму.
* Создай сводный отчёт по этим записям.
ИИ создаёт их как **артефакты**: они появляются в виде карточки в беседе, открываются в отдельном просмотрщике и остаются доступными после завершения беседы. О том, что можно сделать с артефактом, см. в разделе [Артефакты](#artifacts).
Артефакт хранит данные, которые ИИ поместил в него при создании, поэтому он не обновляется автоматически. Для страницы, которая продолжает читать актуальные данные таблицы или собирает ввод и хранит состояние, создайте приложение с помощью [Конструктора приложений](/ru/basic/ai/app-builder).
### Чтение файлов
После загрузки файлов ИИ может отвечать на вопросы, используя как содержимое файлов, так и данные таблицы:
* Обобщи этот PDF-файл и свяжи его с текущей записью клиента.
* Прочитай этот файл Excel и определи поля, которые следует импортировать.
* Создай описание продукта на основе этого изображения.
Файлы, загруженные в беседу, и файлы, созданные во время беседы, сохраняются в изолированной среде текущего чата. Используйте **Управление файлами**, чтобы просмотреть их позже.
Когда в ответе сразу представлено несколько файлов, используйте **Скачать всё** под карточками файлов, чтобы сохранить их одним zip-архивом.
### Память
Память хранит информацию, которую вы явно просите Cuppy запомнить. Память ограничена пользователем и Базой: у каждого пользователя в каждой Базе есть независимый контекст памяти, и память, сохраненная в другой Базе, не появится автоматически в текущей.
* Сохранение памяти в текущей Базе
Скажите в беседе, что Cuppy должен запомнить:
```text theme={null}
Пожалуйста, запомни xxx.
```
* Повторное использование памяти из другой Базы
Попросите Cuppy прочитать другую Базу и сохранить соответствующие части в текущей Базе:
```text theme={null}
Cuppy, пожалуйста, прочитай память для Базы с ID bsexxxxxxxxxxxx и сохрани соответствующую память в этой текущей Базе.
```
### Работа с длительными задачами
ИИ-чат может сохранять среду одной беседы доступной около 24 часов — этого достаточно для большинства задач анализа данных, обработки файлов и создания приложений. Выполняйте долгую работу в текущей беседе, чтобы отслеживать ход выполнения и при необходимости предоставлять ввод.
Если интерфейс показывает `Размышление` или продолжает возвращать обновления хода выполнения, задача всё ещё выполняется. Если он показывает `Завершено`, текущий запуск завершён.
Для работы из нескольких этапов попросите Cuppy записать результаты обратно в Teable, экспортировать их или создать скачиваемый файл на ключевых контрольных точках. Сохранённая работа остаётся доступной, даже если среда беседы будет освобождена позднее.
Среда одной беседы имеет приблизительный максимальный срок существования 24 часа. После завершения выполнения на переднем плане неактивная среда освобождается примерно через 30 минут. Временные файлы и несохранённые промежуточные результаты не сохраняются при перезапуске среды.
Для долгой или повторяемой работы используйте функцию, соответствующую процессу:
Используйте для работы с записями по отдельности, например для обработки больших таблиц, пакетной классификации, обработки контента или заполнения полей.
Используйте для повторяемой работы после создания или обновления записей, уведомлений или обработки данных по расписанию.
Артефакты
Когда ИИ создаёт диаграмму, отчёт, страницу в стиле панели управления или небольшой интерактивный инструмент, он сохраняет результат как **артефакт**: автономную страницу, которая отображается вне беседы. Артефакты отображаются как карточки в чате и остаются доступными после этого. Каждый из них является либо интерактивной HTML-страницей, либо отчётом Markdown.
Нажмите карточку, чтобы открыть артефакт. В просмотрщике можно:
* **Полноэкранный режим** или **Открыть на новой странице**, чтобы предоставить артефакту больше места.
* **Скачать** текущую версию как файл.
* Открыть список версий, просмотреть более раннюю версию и нажать **Восстановить эту версию**, чтобы снова сделать её текущей.
* **Удалить** артефакт. Его карточки в беседе превратятся в заполнитель удалённого объекта, поэтому удаляйте его только тогда, когда результат больше не нужен.
Чтобы изменить артефакт, попросите ИИ в той же беседе. Каждая редакция становится новой версией того же артефакта, а не отдельным артефактом, поэтому ссылка для общего доступа продолжает работать и вы по-прежнему можете вернуться назад. Если страницу не удаётся запустить, просмотрщик показывает ошибку и предлагает **Исправить с помощью ИИ**, что отправляет ошибку обратно в чат, чтобы ИИ мог её исправить.
### Поделиться артефактом
Артефакты доступны только создавшему их человеку, поэтому используйте ссылку для общего доступа, чтобы позволить другим открыть артефакт.
Нажмите **Поделиться** в просмотрщике и включите **Включить общий доступ**. Teable сгенерирует ссылку.
Установите для **Кто может просматривать** значение **Все, у кого есть ссылка** или **Участники пространства**, чтобы только вошедшие в систему участники пространства могли открыть артефакт.
В дополнительных настройках включите **Защита паролем** и задайте пароль. Зрители должны ввести его до загрузки артефакта.
Используйте **Копировать ссылку**, чтобы скопировать её. Если ссылка распространилась слишком широко, **Сбросить ссылку** создаст новую и отключит старую.
### Найти артефакты позже
Откройте **+** → **Ещё** → **Управление артефактами**, чтобы просмотреть всё, что вы создали во всех чатах. Выполните поиск по имени, затем откройте артефакт, чтобы просмотреть его или снова предоставить к нему доступ.
## Советы по формулировке запросов
* **Сначала укажите цель**: в первом сообщении опишите, что нужно сделать, соответствующие условия и ожидаемый результат. Например, проанализируй недельную динамику продаж за последние 3 месяца с группировкой по регионам и верни таблицу динамики с кратким выводом.
* **Используйте названия полей**: например, сортируй по `Created Time`, чтобы ИИ мог определить целевой столбец.
* **Приводите несколько примеров**: для вывода в фиксированном формате предоставьте 3–5 примеров «ввод -> ожидаемый вывод».
* **Используйте `@` для выбора узлов**: когда ИИ должен ссылаться на таблицы, представления, приложения, автоматизации или папки, введите `@` и выберите их напрямую.
* **Подтверждайте перед выполнением**: для задач, которые изменяют данные, создают таблицы, приложения или включают автоматизации, попросите ИИ описать изменения до их выполнения.
* **Выбирайте модель по задаче**: если пространство поддерживает выбор модели, используйте более лёгкую модель для простых запросов, очистки или переписывания и более мощную модель для сложного планирования, анализа нескольких таблиц и создания приложений.
* **Настраивайте уровень Интеллекта**: **Интеллект** управляет глубиной рассуждений; более высокие уровни дают более тщательное обоснование.
* **Начинайте новый чат при смене темы**: новый чат рекомендуется, когда меняется тема, беседа становится слишком длинной или нужно уменьшить использование контекста.
## Часто задаваемые вопросы
Введите `@` в поле ввода и выберите узел, на который должен ссылаться ИИ-чат. Для выборок в представлении «Сетка» также можно выбрать строки, столбцы, одну ячейку или диапазон ячеек, а затем использовать **Добавить в чат** в контекстном меню.
Да. ИИ не ограничен Базой, к которой относится чат: он может искать другие Базы, к которым у вас есть доступ, и работать в них. Укажите Базу в запросе, например «сравни эту таблицу с таблицей заказов в Базе продаж». `@` выводит только узлы текущей Базы, а всё, что вы явно не направили в другое место, по-прежнему происходит в собственной Базе чата.
Да. Они сохраняются как артефакты с историей версий и необязательной ссылкой для общего доступа, и их можно снова открыть через **+** → **Ещё** → **Управление артефактами**. Артефакт сохраняет данные, с которыми был создан, и не обновляется автоматически. Для страницы, которая читает актуальные данные таблицы, создайте приложение с помощью [Конструктора приложений](/ru/basic/ai/app-builder).
По умолчанию нет. Только вы можете открывать собственные артефакты. Включите **Включить общий доступ** в просмотрщике и отправьте ссылку, выбрав **Участники пространства**, если артефакт должен оставаться внутри пространства.
Нет. Память ограничена пользователем и Базой. Если хотите повторно использовать память из другой Базы, попросите Cuppy прочитать память этой Базы и сохранить соответствующие части в текущей Базе.
Не используйте ИИ-чат как средство выполнения фоновых задач. Продолжайте работу в видимой беседе и попросите Cuppy записать результаты обратно в Teable, экспортировать результаты или создать скачиваемый файл.
Каждый пользователь может одновременно запускать до 3 Агентов, включая ИИ-чат и Конструктор приложений. Если вы видите `Агент занят в другой беседе. Пожалуйста, подождите.`, другая задача всё ещё выполняется. Прежде чем продолжить, дождитесь, пока Cuppy завершит предыдущую задачу.
Один ход ИИ-чата может включать несколько этапов обработки. И беседа, и страница оплаты показывают общее число кредитов за этот ход. Работу, которую Cuppy уже завершил и сохранил, всё ещё можно использовать. Если финальный этап прерывается неожиданной ошибкой, кредиты за прерванный этап возвращаются автоматически. Вы можете продолжать работу в той же беседе.
Оно добавляется в очередь отправки над полем ввода, а не прерывает запуск, и Teable отправляет всю очередь одним сообщением после завершения запуска. Очередь хранится на сервере, поэтому переживает обновление страницы и выглядит одинаково на каждой вкладке или устройстве, где открыта эта беседа.
Пока элемент ожидает, вы можете **Удалить** его или использовать **Редактировать сообщение**, чтобы вернуть его в поле ввода. Элемент только с текстом также можно направить: **Направить** сразу передаёт его текущему запуску, после чего он появляется в беседе с меткой **Направленная беседа**.
Беседа может содержать до 30 сообщений в очереди. После этого сообщение не ставится в очередь, и Teable отвечает `Очередь отправки заполнена. Подождите, пока Cuppy обработает предыдущие сообщения.`
Остановка запуска также удерживает очередь, поэтому сообщения в очереди не будут отправлены вслед за остановкой, предназначенной для текущего ответа. В заголовке очереди отобразится `Очередь приостановлена, потому что вы прервали выполнение`. Нажмите **Возобновить**, чтобы снять удержание, или просто отправьте следующее сообщение: запуск новой задачи также снимает удержание очереди.
Откройте меню **+** и выберите **Навыки**, чтобы импортировать навыки или управлять ими, либо введите `/` в поле ввода, чтобы выбрать включенный навык. При импорте выберите, кто может использовать навык: «личный» для собственных чатов, «база», когда он нужен соавторам в той же Базе, и «пространство», когда он нужен всем в пространстве. Пользователи, которые могут управлять Базой, могут добавлять навыки Базы, а владельцы и создатели пространства могут добавлять навыки Пространства. Если ИИ-чат представляет файл `.skill`, используйте **Установить** на карточке файла, чтобы добавить его.
Одновременно действует только одна версия, и общая версия команды имеет приоритет над личной копией: навык Базы имеет приоритет над навыком Пространства, а навык Пространства — над личным навыком. В беседе приложения или бота сначала применяется навык, добавленный для этого приложения или бота. Чтобы перевести всех на новую версию, обновите копию в Базе или Пространстве.
В разделе **Управление файлами** есть две папки: `uploads` для добавленных вами файлов и `outputs` для файлов, созданных в беседе. Обе используют собственное хранилище, поэтому сохраняются после освобождения или пересоздания изолированной среды и доступны позже для просмотра, скачивания или удаления.
Всё, что Cuppy записывает за пределами этих двух папок, является временным, например промежуточные результаты скрипта. Это не отображается в разделе **Управление файлами** и исчезает после перезапуска изолированной среды. Чтобы сохранить нужные результаты, попросите Cuppy записать их в `outputs` или обратно в Teable либо скачайте их, пока беседа открыта, используя **Скачать всё**, когда ответ создал несколько файлов.
При копировании сообщения пользователя таблицы, представления, приложения, автоматизации, папки, выборки и вложения сохраняются как текстовые маркеры. Когда вы вставляете текст обратно в ИИ-чат, Teable восстанавливает распознанные маркеры как чипы.
Используйте **+** → **Секреты** в поле ввода чата. ИИ-чат может использовать эти значения во время беседы, не помещая открытый текст в ваш запрос.