Edge Functions

Esecuzione del codice lato server

Le edge function sono funzioni JavaScript/TypeScript eseguite sul runtime Deno, che permettono di implementare logica che non dovrebbe o non può essere eseguita nel browser. L'intelligenza artificiale crea queste funzioni quando descrivi funzionalità che richiedono elaborazione lato server, integrazione API esterna o maggiore sicurezza.

Cosa rendono possibile le edge function:

  • Elaborare moduli con validazione e chiamate API esterne
  • Integrare servizi come l'invio di e-mail, l'elaborazione di pagamenti o la chiamata alle API AI
  • Proteggere la logica sensibile che non dovrebbe essere visibile nel codice del browser
  • Accedere ai secrets in modo sicuro senza esporli agli utenti
  • Eseguire operazioni complesse che sono troppo lente o richiedono molte risorse per il browser

Come funzionano le funzioni

Quando l'intelligenza artificiale crea una funzione edge per te, essa:

  1. Scrive il codice JavaScript per eseguire l'attività descritta
  2. Imposta il controllo dell'accesso per determinare chi può chiamare la funzione
  3. Configura l'accesso ai secrets se la funzione necessita di credenziali API esterne
  4. Testa la funzione per assicurarsi che funzioni correttamente
  5. Fornisce un URL che l'applicazione può chiamare per eseguire la funzione

Le funzioni vengono eseguite in ambienti isolati e sicuri. Ogni esecuzione viene registrata con informazioni sui tempi, eventuali errori e quale utente l'ha attivata. Puoi visualizzare questi registri in Impostazioni > Configurazione sito > Monitoraggio > Registri per monitorare l'esecuzione delle tue funzioni ed eseguire il debug di eventuali problemi.

Controllo degli accessi alle funzioni

Proprio come le tabelle del database, le edge function hanno policy di sicurezza che controllano chi può eseguirle. L'intelligenza artificiale le imposta in base a ciò che stai costruendo:

Funzioni pubbliche

Chiunque può chiamarle, anche senza effettuare l'accesso. Usate per gestori webhook (come notifiche di pagamento Stripe), API pubbliche o endpoint di controllo dello stato.

Funzioni autenticate

Solo gli utenti che hanno effettuato l'accesso possono chiamarle. La maggior parte delle funzioni usa questa policy: è adatta per le funzionalità rivolte agli utenti, l'invio di moduli o il recupero di dati per la tua applicazione.

Accesso basato su gruppi

Solo gli utenti di gruppi specifici (come "admin") possono richiamare la funzione. Perfetto per operazioni amministrative, strumenti di moderazione o funzionalità specifiche del team.

Accesso basato sui metadati

Accesso basato su attributi utente personalizzati. Ad esempio, solo gli utenti con department = "engineering" possono richiamare determinate funzioni. Ciò consente schemi di autorizzazione flessibili e personalizzati.

Quali funzioni possono fare

Accesso al database

Le funzioni possono interrogare e modificare il tuo database, applicando tutte le stesse regole di sicurezza.

Chiamate API esterne

Le funzioni possono comunicare con servizi esterni utilizzando i secrets archiviati.

Logica complessa

Le funzioni possono eseguire calcoli, trasformazioni di dati, convalide o workflow in più fasi.

E-mail e notifiche

Invia e-mail transazionali, messaggi SMS o notifiche push in risposta alle azioni dell'utente.

Elaborazione dei pagamenti

Gestisci i flussi di pagamento, l'elaborazione dei webhook o la gestione degli abbonamenti con servizi come Stripe.

Integrazione dell'intelligenza artificiale

Chiama API AI come OpenAI o Anthropic per generare contenuti, analizzare dati o fornire funzionalità intelligenti.

Monitoraggio e registri

Ogni esecuzione di funzione viene automaticamente registrata con:

  • Quando è stato chiamato e da chi
  • Quanto tempo è stato necessario per l'esecuzione
  • Se ha avuto successo o ha riscontrato errori
  • Qualsiasi output della console o messaggio di errore
  • La risposta restituita

Buone pratiche

✅ Descrivi chiaramente - Quando chiedi all'AI di creare una funzione, sii specifico su cosa dovrebbe fare e chi dovrebbe essere in grado di chiamarla.

✅ Monitora i registri: controlla i registri di esecuzione delle funzioni per comprendere le prestazioni e individuare tempestivamente gli errori.

✅ Mantieni i secrets nel secrets manager - L'intelligenza artificiale utilizzerà i secrets archiviati anziché codificarli nelle funzioni.

❌ Non esporre operazioni sensibili: lascia che sia l'intelligenza artificiale a configurare i controlli di accesso appropriati. Le funzioni amministrative non dovrebbero mai essere pubbliche.


Documentazione correlata: