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:
- Pisze kod JavaScript realizujący opisane przez Ciebie zadanie
- Ustawia kontrolę dostępu, aby określić, kto może wywołać funkcję
- Konfiguruje dostęp do sekretów, jeśli funkcja potrzebuje zewnętrznych danych uwierzytelniających API
- Testuje funkcję, aby upewnić się, że działa poprawnie
- 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: