Edge Functions

Виконання коду на стороні сервера

Edge-функції — це функції JavaScript/TypeScript, що працюють у середовищі виконання Deno і дають змогу реалізувати логіку, яка не повинна або не може виконуватися в браузері. ШІ створює ці функції, коли ви описуєте можливості, що потребують серверної обробки, інтеграції із зовнішніми API чи підвищеного захисту.

Що дають edge-функції:

  • Обробляти форми з перевіркою даних і викликами зовнішніх API
  • Інтегрувати сервіси: надсилання листів, обробка платежів, виклики ШІ API
  • Захищати чутливу логіку, яка не повинна бути видимою в коді браузера
  • Безпечно користуватися секретами, не показуючи їх користувачам
  • Виконувати складні операції, надто повільні або ресурсомісткі для браузера

Як працюють функції

Коли ШІ створює для вас edge-функцію, він:

  1. Пише код JavaScript для виконання описаного вами завдання
  2. Налаштовує контроль доступу, щоб визначити, хто може викликати функцію
  3. Налаштовує доступ до секретів, якщо функції потрібні облікові дані зовнішнього API
  4. Тестує функцію, щоб переконатися, що вона працює правильно
  5. Надає URL, який ваш застосунок може викликати для виконання функції

Функції виконуються в ізольованих безпечних середовищах. Кожен запуск записується в журнал з даними про час виконання, помилками та користувачем, який його ініціював. Переглядати ці журнали можна в розділі «Налаштування» > «Конфігурація сайту» > «Моніторинг» > «Журнали», щоб стежити за роботою функцій і усувати проблеми.

Контроль доступу до функцій

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

Публічні функції

Будь-хто може їх викликати, навіть без входу в систему. Використовуються для обробників вебхуків (наприклад, сповіщень про платежі Stripe), публічних API або кінцевих точок перевірки працездатності.

Функції для авторизованих користувачів

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

Доступ на основі груп

Функцію можуть викликати лише користувачі з певних груп (наприклад, «admin»). Ідеально підходить для адміністративних операцій, інструментів модерації або функцій для окремих команд.

Доступ на основі метаданих

Доступ залежить від користувацьких атрибутів. Наприклад, певні функції можуть викликати лише користувачі з department = "engineering". Це дає змогу будувати гнучкі власні схеми дозволів.

Що можуть робити функції

Доступ до бази даних

Функції можуть робити запити до вашої бази даних і змінювати її, з дотриманням тих самих правил безпеки.

Виклики зовнішніх API

Функції можуть взаємодіяти із зовнішніми сервісами, використовуючи ваші збережені секрети.

Складна логіка

Функції можуть виконувати обчислення, перетворення даних, перевірки або багатокрокові робочі процеси.

Електронна пошта та сповіщення

Надсилайте транзакційні листи, SMS або push-сповіщення у відповідь на дії користувачів.

Обробка платежів

Керуйте платіжними процесами, обробкою вебхуків чи підписками за допомогою таких сервісів, як Stripe.

Інтеграція ШІ

Викликайте API ШІ, як-от OpenAI або Anthropic, щоб створювати вміст, аналізувати дані чи надавати інтелектуальні можливості.

Моніторинг і журнали

Кожен запуск функції автоматично записується в журнал із такими відомостями:

  • коли її викликали і хто
  • скільки часу тривало виконання
  • чи завершилося воно успішно, чи виникли помилки
  • будь-який вивід консолі або повідомлення про помилки
  • відповідь, яку вона повернула

Найкращі практики

✅ Описуйте чітко — просячи ШІ створити функцію, конкретно вказуйте, що вона має робити і хто може її викликати.

✅ Стежте за журналами — перевіряйте журнали запусків функцій, щоб розуміти продуктивність і завчасно помічати помилки.

✅ Зберігайте секрети в менеджері секретів — ШІ користуватиметься збереженими секретами, а не вписуватиме їх у код функцій.

❌ Не відкривайте чутливі операції — дозвольте ШІ налаштувати відповідний контроль доступу. Адміністративні функції ніколи не повинні бути публічними.


Пов’язана документація: