input и передают результаты последующим шагам с помощью функции output.set().
Когда использовать «Запустить скрипт», а когда — встроенные действия
В целом используйте встроенные действия, когда они соответствуют вашим потребностям. Выбирайте «Запустить скрипт», если нужна пользовательская логика, преобразование данных или сложное взаимодействие с API.
Среда
Как настроить
- Добавьте действие Запустить скрипт в рабочий процесс.
- Редактор скрипта откроется с пустым холстом. Напишите здесь код JavaScript.
- Скрипт может читать данные из предыдущих шагов с помощью объекта
input(см. ниже). - Используйте
output.set(key, value), чтобы передать результаты последующим шагам. - (Необязательно) Добавьте зависимости npm на панели конфигурации, если скрипту нужны внешние библиотеки.
- Нажмите Тест, чтобы запустить скрипт с реальными данными из последнего выполнения триггера.
- Проверьте результат теста и журналы консоли, чтобы убедиться, что скрипт работает правильно.
- Сохраните действие.
Чтение входных данных
Объектinput содержит данные всех предыдущих шагов рабочего процесса. Каждый шаг определяется идентификатором действия.
Структура входных данных
Получение данных триггера (Полей Записи)
Получение данных из шага «Получить Записи»
Получение данных из результатов других действий
Запись результата
Используйтеoutput.set(key, value), чтобы сделать данные доступными последующим шагам. Можно задать несколько ключей.
output.set("status", "success"), следующий шаг сможет обратиться к status в результате этого скрипта.
Отладка с помощью console.log
Во время разработки используйтеconsole.log() для проверки данных и отслеживания хода выполнения. После нажатия Тест данные журнала появятся на панели тестирования.
Управление пакетами npm
В скриптах можно использовать пакеты npm. Объявите зависимости на панели конфигурации:require():
Встроенные переменные
Безопасность: область действия AUTOMATION_TOKEN
ТокенAUTOMATION_TOKEN автоматически создаётся для каждого запуска Автоматизации. Он имеет те же разрешения, что и создатель Автоматизации, и действует только в рамках текущего выполнения. Основные моменты:
- Он предоставляет доступ к любой Таблице, доступной создателю Автоматизации.
- Он действителен только во время выполнения скрипта (ограничение — 60 секунд).
- Не передавайте этот токен внешним системам: он предназначен для вызова API Teable из скрипта.
Вызов API Teable
Вызов ИИ из скрипта
POST /api/automation/runtime/ai отправляет запрос модели ИИ вашей Базы. База определяется из контекста Автоматизации, поэтому её идентификатор не требуется. Тело принимает prompt, а также необязательные параметры attachments, modelKey, temperature и outputType; ответ имеет вид { "message": ... }.
Вложения представляют собой элементы { url, mimetype, name }: не более 10 на один вызов, каждый размером менее 20 МБ и со временем загрузки до 30 секунд. Поддерживаются изображения, PDF-файлы и документы Office. Модель чата по умолчанию может не читать изображения и подобные вложения, поэтому при отправке файлов укажите modelKey. Каждый вызов расходует кредиты.
Обработка ошибок
Всегда помещайте потенциально рискованные операции в блоки try/catch, чтобы рабочий процесс мог корректно обрабатывать сбои:Полный пример: обработка и маршрутизация обращений в поддержку
Советы
- Начните с console.log. При создании нового скрипта сначала запишите в журнал весь объект
input, чтобы понять его структуру. - Не перегружайте скрипты. Лучше хорошо решить одну задачу, чем помещать в один скрипт множество задач. При необходимости объедините в цепочку несколько действий «Запустить скрипт».
- Помните об ограничении в 60 секунд. Продолжительные операции (обработка большого объёма данных, множество последовательных вызовов API) могут превысить ограничение времени. Разделяйте большие задачи на меньшие части.
- Тестируйте с реальными данными. Панель тестирования использует фактические данные последнего выполнения триггера, поэтому результаты будут реалистичными.
- Обрабатывайте отсутствующие данные. Используйте значения по умолчанию (оператор
||) для Полей, которые могут быть пустыми или неопределёнными.
Связанные материалы
- Генерация с помощью ИИ — задачи ИИ на основе запросов, не требующие пользовательского кода
- HTTP-запрос — простые вызовы API, не требующие скриптов

