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:

  1. Napíše kód v JavaScriptu, který splní popsaný úkol
  2. Nastaví řízení přístupu, které určí, kdo může funkci volat
  3. Nakonfiguruje přístup k secrets, pokud funkce potřebuje přihlašovací údaje k externímu API
  4. Otestuje funkci, aby se ujistila, že funguje správně
  5. 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: