Edge funkce
Spouštění kódu na straně serveru
Edge funkce jsou funkce v JavaScriptu/TypeScriptu, které běží v prostředí Deno a umožňují implementovat logiku, která by neměla nebo nemůže běžet v prohlížeči. AI tyto funkce vytváří, když popíšete vlastnosti, které vyžadují zpracování na straně serveru, integraci externích API nebo vyšší zabezpečení.
Co edge funkce umožňují:
- Zpracovat formuláře s validací a voláním externích API
- Integrovat služby, například odesílání e-mailů, zpracování plateb nebo volání AI API
- Chránit citlivou logiku, která by neměla být viditelná v kódu v prohlížeči
- Bezpečně přistupovat k secrets, aniž by byly vystaveny uživatelům
- Provádět složité operace, které jsou pro prohlížeč příliš pomalé nebo náročné na zdroje
Jak funkce fungují
Když pro vás AI vytvoří edge funkci, provede tyto kroky:
- Napíše kód v JavaScriptu, který splní popsaný úkol
- Nastaví řízení přístupu, které určí, kdo může funkci volat
- Nakonfiguruje přístup k secrets, pokud funkce potřebuje přihlašovací údaje k externímu API
- Otestuje funkci, aby se ujistila, že funguje správně
- Poskytne adresu URL, kterou může vaše aplikace zavolat a funkci tak spustit
Funkce běží v izolovaných, zabezpečených prostředích. Každé spuštění je zaprotokolováno s údaji o době trvání, případnými chybami a informací o tom, který uživatel je spustil. Protokoly si můžete prohlédnout v části Nastavení > Konfigurace webu > Monitorování > Protokoly, abyste mohli sledovat výkon svých funkcí a ladit případné potíže.
Řízení přístupu k funkcím
Stejně jako databázové tabulky mají i edge funkce bezpečnostní zásady, které určují, kdo je může spouštět. AI je nastaví podle toho, co vytváříte:
Veřejné funkce
Může je volat kdokoli, i bez přihlášení. Používají se pro obslužné rutiny webhooků (například oznámení o platbách ze Stripe), veřejná API nebo koncové body pro kontrolu stavu.
Funkce pro přihlášené
Mohou je volat jen přihlášení uživatelé. Tuto zásadu používá většina funkcí – hodí se pro funkce určené uživatelům, odesílání formulářů nebo načítání dat pro vaši aplikaci.
Přístup podle skupin
Funkci mohou volat jen uživatelé v určitých skupinách (například „admin“). Ideální pro administrativní operace, nástroje pro moderování nebo funkce určené pro konkrétní tým.
Přístup podle metadat
Přístup podle vlastních atributů uživatele. Například jen uživatelé s department = "engineering" mohou volat určité funkce. To umožňuje flexibilní, vlastní schémata oprávnění.
Co funkce umí
Přístup k databázi
Funkce se mohou dotazovat na vaši databázi a upravovat ji, přičemž platí všechna stejná bezpečnostní pravidla.
Volání externích API
Funkce mohou komunikovat s externími službami pomocí vašich uložených secrets.
Složitá logika
Funkce mohou provádět výpočty, transformace dat, validace nebo vícekrokové pracovní postupy.
E-maily a oznámení
Odesílají transakční e-maily, SMS zprávy nebo push notifikace v reakci na akce uživatelů.
Zpracování plateb
Zvládají platební toky, zpracování webhooků nebo správu předplatného pomocí služeb, jako je Stripe.
Integrace AI
Volají AI API, například OpenAI nebo Anthropic, a generují obsah, analyzují data nebo poskytují inteligentní funkce.
Monitorování a protokoly
Každé spuštění funkce se automaticky zaprotokoluje, včetně:
- kdy a kým byla zavolána
- jak dlouho trvalo její provedení
- zda uspěla, nebo došlo k chybám
- výstupu konzole nebo chybových zpráv
- odpovědi, kterou vrátila
Osvědčené postupy
✅ Popište to srozumitelně – když žádáte AI o vytvoření funkce, uveďte konkrétně, co má dělat a kdo ji má moci volat.
✅ Sledujte protokoly – kontrolujte protokoly spuštění funkcí, abyste pochopili výkon a včas zachytili chyby.
✅ Uchovávejte secrets ve správci secrets – AI použije uložená secrets, místo aby je natvrdo zapisovala do funkcí.
❌ Nevystavujte citlivé operace – nechte AI nastavit vhodné řízení přístupu. Administrativní funkce by nikdy neměly být veřejné.
Související dokumentace: