Funkcje brzegowe

Wykonywanie kodu po stronie serwera

Funkcje brzegowe (edge functions) to funkcje JavaScript/TypeScript uruchamiane w środowisku Deno, które pozwalają zaimplementować logikę, która nie powinna lub nie może działać w przeglądarce. AI tworzy je, gdy opisujesz funkcje wymagające przetwarzania po stronie serwera, integracji z zewnętrznymi API lub podwyższonego bezpieczeństwa.

Co umożliwiają funkcje brzegowe:

  • Przetwarzanie formularzy z walidacją i wywołaniami zewnętrznych API
  • Integrację usług, takich jak wysyłanie e-maili, przetwarzanie płatności czy wywoływanie API AI
  • Ochronę wrażliwej logiki, która nie powinna być widoczna w kodzie przeglądarki
  • Bezpieczny dostęp do sekretów bez ujawniania ich użytkownikom
  • Złożone operacje, które są zbyt wolne lub zasobochłonne dla przeglądarki

Jak działają funkcje

Gdy AI tworzy dla Ciebie funkcję brzegową, to:

  1. Pisze kod JavaScript realizujący opisane przez Ciebie zadanie
  2. Ustawia kontrolę dostępu, aby określić, kto może wywołać funkcję
  3. Konfiguruje dostęp do sekretów, jeśli funkcja potrzebuje zewnętrznych danych uwierzytelniających API
  4. Testuje funkcję, aby upewnić się, że działa poprawnie
  5. Udostępnia adres URL, który aplikacja może wywołać, aby uruchomić funkcję

Funkcje działają w izolowanych, bezpiecznych środowiskach. Każde uruchomienie jest rejestrowane wraz z informacją o czasie, ewentualnych błędach i o tym, kto je wywołał. Dzienniki te zobaczysz w Ustawienia > Konfiguracja witryny > Monitorowanie > Dzienniki, aby sprawdzać, jak działają Twoje funkcje, i debugować wszelkie problemy.

Kontrola dostępu do funkcji

Tak jak tabele bazy danych, funkcje brzegowe mają zasady bezpieczeństwa określające, kto może je uruchamiać. AI ustawia je na podstawie tego, co budujesz:

Funkcje publiczne

Każdy może je wywołać, nawet bez logowania. Stosowane do obsługi webhooków (np. powiadomień o płatnościach Stripe), publicznych API lub punktów kontroli stanu (health check).

Funkcje dla uwierzytelnionych

Tylko zalogowani użytkownicy mogą je wywoływać. Większość funkcji używa tej zasady — jest odpowiednia dla funkcji widocznych dla użytkownika, wysyłania formularzy lub pobierania danych dla aplikacji.

Dostęp oparty na grupach

Tylko użytkownicy z określonych grup (np. „admin”) mogą wywoływać funkcję. Idealne do operacji administracyjnych, narzędzi moderacji lub funkcji przeznaczonych dla zespołu.

Dostęp oparty na metadanych

Dostęp zależny od niestandardowych atrybutów użytkownika. Na przykład tylko użytkownicy z department = "engineering" mogą wywoływać określone funkcje. Pozwala to na elastyczne, niestandardowe schematy uprawnień.

Co mogą robić funkcje

Dostęp do bazy danych

Funkcje mogą wysyłać zapytania do bazy danych i ją modyfikować, przy zachowaniu tych samych reguł bezpieczeństwa.

Wywołania zewnętrznych API

Funkcje mogą komunikować się z usługami zewnętrznymi, korzystając z przechowywanych sekretów.

Złożona logika

Funkcje mogą wykonywać obliczenia, przekształcenia danych, walidacje lub wieloetapowe przepływy pracy.

E-maile i powiadomienia

Wysyłaj e-maile transakcyjne, wiadomości SMS lub powiadomienia push w odpowiedzi na działania użytkowników.

Przetwarzanie płatności

Obsługuj przepływy płatności, przetwarzanie webhooków lub zarządzanie subskrypcjami za pomocą usług takich jak Stripe.

Integracja z AI

Wywołuj API AI, takie jak OpenAI lub Anthropic, aby generować treści, analizować dane lub dodawać inteligentne funkcje.

Monitorowanie i dzienniki

Każde uruchomienie funkcji jest automatycznie rejestrowane wraz z:

  • Informacją, kiedy została wywołana i przez kogo
  • Czasem wykonania
  • Informacją, czy zakończyła się sukcesem, czy błędem
  • Wszelkimi danymi wyjściowymi konsoli lub komunikatami o błędach
  • Zwróconą odpowiedzią

Dobre praktyki

✅ Opisuj jasno - Prosząc AI o utworzenie funkcji, określ dokładnie, co ma robić i kto ma móc ją wywoływać.

✅ Monitoruj dzienniki - Sprawdzaj dzienniki uruchomień funkcji, aby poznać wydajność i wcześnie wyłapywać błędy.

✅ Trzymaj sekrety w menedżerze sekretów - AI użyje przechowywanych sekretów zamiast wpisywać je na stałe w funkcjach.

❌ Nie wystawiaj wrażliwych operacji publicznie - Pozwól AI skonfigurować odpowiednią kontrolę dostępu. Funkcje administracyjne nigdy nie powinny być publiczne.


Powiązana dokumentacja: