Edge Functions

Execução de código no lado do servidor

Edge Functions são funções JavaScript/TypeScript executadas no tempo de execução do Deno, permitindo implementar lógica que não deve ou não pode ser executada no navegador. A IA cria essas funções quando você descreve recursos que precisam de processamento no servidor, integração externa de API ou segurança aprimorada.

Quais Edge Functions permitem:

  • Processe formulários com validação e chamadas externas de API
  • Integre serviços como envio de e-mails, processamento de pagamentos ou chamada de APIs de IA
  • Proteja a lógica confidencial que não deveria estar visível no código do navegador
  • Acesse secrets com segurança, sem expô-los aos usuários
  • Execute operações complexas que são muito lentas ou que consomem muitos recursos para o navegador

Como funcionam as funções

Quando a IA cria uma função de borda para você, ela:

  1. Escreve o código JavaScript para executar a tarefa que você descreveu
  2. Configura o controle de acesso para determinar quem pode chamar a função
  3. Configura o acesso a secrets se a função precisar de credenciais de API externas
  4. Testa a função para garantir que ela funcione corretamente
  5. Fornece uma URL que seu aplicativo pode chamar para executar a função

As funções são executadas em ambientes isolados e seguros. Cada execução é registrada com informações de tempo, erros e qual usuário a acionou. Você pode visualizar esses logs em Configurações > Configuração do site > Monitoramento > Logs para monitorar o desempenho de suas funções e depurar quaisquer problemas.

Controle de acesso para funções

Assim como as tabelas de banco de dados, as Edge Functions possuem políticas de segurança que controlam quem pode executá-las. A IA configura isso com base no que você está construindo:

Funções Públicas

Qualquer pessoa pode chamá-las, mesmo sem fazer login. Usado para manipuladores de webhook (como notificações de pagamento Stripe), APIs públicas ou endpoints de verificação de integridade.

Funções autenticadas

Somente usuários logados podem chamá-las. A maioria das funções usa esta política — ela é apropriada para recursos voltados ao usuário, envios de formulários ou busca de dados para seu aplicativo.

Acesso baseado em grupo

Somente usuários de grupos específicos (como "admin") podem chamar a função. Perfeito para operações administrativas, ferramentas de moderação ou recursos específicos de equipe.

Acesso baseado em metadados

Acesso baseado em atributos de usuário personalizados. Por exemplo, apenas usuários com department = "engineering" podem chamar determinadas funções. Isso permite esquemas de permissão personalizados e flexíveis.

Quais funções podem fazer

Acesso ao banco de dados

As funções podem consultar e modificar seu banco de dados, com as mesmas regras de segurança aplicadas.

Chamadas externas API

As funções podem se comunicar com serviços externos usando seus secrets armazenados.

Lógica Complexa

As funções podem realizar cálculos, transformações de dados, validações ou workflows de várias etapas.

E-mail e notificações

Envie e-mails transacionais, mensagens SMS ou notificações push em resposta às ações do usuário.

Processamento de Pagamento

Lide com fluxos de pagamento, processamento de webhook ou gerenciamento de assinaturas com serviços como Stripe.

Integração de IA

Chame APIs de IA como OpenAI ou Anthropic para gerar conteúdo, analisar dados ou fornecer recursos inteligentes.

Monitoramento e registros

Cada execução de função é registrada automaticamente com:

  • Quando foi chamado e por quem
  • Quanto tempo demorou para executar
  • Se foi bem-sucedido ou encontrou erros
  • Qualquer saída do console ou mensagens de erro
  • A resposta que retornou

Melhores práticas

✅ Descreva claramente - Ao pedir à IA para criar uma função, seja específico sobre o que ela deve fazer e quem deve poder chamá-la.

✅ Monitore logs - Verifique os logs de execução de funções para entender o desempenho e detectar erros antecipadamente.

✅ Mantenha secrets no secrets manager - A IA usará secrets armazenados em vez de codificá-los em funções.

❌ Não exponha operações confidenciais - Deixe a IA configurar controles de acesso apropriados. As funções administrativas nunca devem ser públicas.


Documentação relacionada: