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) можуть перевищити тайм-аут. Розділяйте великі завдання на менші частини.
- Перевіряйте з реальними даними. Панель тестування використовує фактичні дані останнього виконання тригера, забезпечуючи реалістичні результати.
- Обробляйте відсутні дані. Використовуйте стандартні значення (оператор
||) для полів, які можуть бути порожніми або undefined.
Пов’язані матеріали
- Генерування за допомогою ШІ — завдання ШІ на основі запитів, які не потребують власного коду
- HTTP-запит — прості виклики API, які не потребують сценаріїв

