Funciones edge
Ejecución de código del lado del servidor
Las funciones edge son funciones JavaScript/TypeScript que se ejecutan en el runtime Deno y te permiten implementar lógica que no debería o no puede ejecutarse en el navegador. La IA crea estas funciones cuando describes funcionalidades que necesitan procesamiento del lado del servidor, integración con API externas o seguridad reforzada.
Qué permiten las funciones edge:
- Procesar formularios con validación y llamadas a API externas
- Integrar servicios como enviar correos, procesar pagos o llamar a API de IA
- Proteger lógica sensible que no debería ser visible en el código del navegador
- Acceder a secretos de forma segura sin exponerlos a usuarios
- Realizar operaciones complejas que son demasiado lentas o consumen demasiados recursos para el navegador
Cómo funcionan las funciones
Cuando la IA crea una función edge para ti, esta:
- Escribe el código JavaScript para realizar la tarea que describiste
- Configura el control de acceso para determinar quién puede llamar a la función
- Configura el acceso a secretos si la función necesita credenciales de API externas
- Prueba la función para asegurarse de que funcione correctamente
- Proporciona una URL que tu aplicación puede llamar para ejecutar la función
Las funciones se ejecutan en entornos aislados y seguros. Cada ejecución se registra con información de tiempos, cualquier error y qué usuario la activó. Puedes ver estos registros en Settings > Site configuration > Monitoring > Logs para monitorear cómo se comportan tus funciones y depurar problemas.
Control de acceso para funciones
Igual que las tablas de base de datos, las funciones edge tienen políticas de seguridad que controlan quién puede ejecutarlas. La IA las configura según lo que estás creando:
Funciones públicas
Cualquiera puede llamarlas, incluso sin iniciar sesión. Se usan para manejadores de webhooks (como notificaciones de pago de Stripe), API públicas o endpoints de comprobación de estado.
Funciones autenticadas
Solo los usuarios con sesión iniciada pueden llamarlas. La mayoría de las funciones usan esta política: es adecuada para funcionalidades orientadas al usuario, envíos de formularios o recuperación de datos para tu aplicación.
Acceso basado en grupos
Solo los usuarios en grupos específicos (como "admin") pueden llamar a la función. Es ideal para operaciones administrativas, herramientas de moderación o funcionalidades específicas de equipo.
Acceso basado en metadatos
Acceso basado en atributos personalizados del usuario. Por ejemplo, solo usuarios con department = "engineering" pueden llamar ciertas funciones. Esto permite esquemas de permisos flexibles y personalizados.
Qué pueden hacer las funciones
Acceso a base de datos
Las funciones pueden consultar y modificar tu base de datos, aplicando las mismas reglas de seguridad.
Llamadas a API externas
Las funciones pueden comunicarse con servicios externos usando tus secretos almacenados.
Lógica compleja
Las funciones pueden realizar cálculos, transformaciones de datos, validaciones o flujos de trabajo de varios pasos.
Correo electrónico y notificaciones
Envía correos transaccionales, mensajes SMS o notificaciones push en respuesta a acciones de usuarios.
Procesamiento de pagos
Maneja flujos de pago, procesamiento de webhooks o administración de suscripciones con servicios como Stripe.
Integración de IA
Llama a API de IA como OpenAI o Anthropic para generar contenido, analizar datos o proporcionar funcionalidades inteligentes.
Monitoreo y registros
Cada ejecución de función se registra automáticamente con:
- Cuándo se llamó y quién lo hizo
- Cuánto tardó en ejecutarse
- Si tuvo éxito o encontró errores
- Cualquier salida de consola o mensaje de error
- La respuesta que devolvió
Buenas prácticas
✅ Describe con claridad - Cuando le pidas a la IA que cree una función, sé específico sobre lo que debe hacer y quién debería poder llamarla.
✅ Monitorea los registros - Revisa los registros de ejecución de funciones para entender el rendimiento y detectar errores temprano.
✅ Guarda secretos en el administrador de secretos - La IA usará secretos almacenados en lugar de fijarlos directamente en las funciones.
❌ No expongas operaciones sensibles - Deja que la IA configure controles de acceso adecuados. Las funciones administrativas nunca deberían ser públicas.
Documentación relacionada: