Funções Neon

Este é um recurso de pré-visualização e está disponível apenas em us-east-2. As Funções Neon são manipuladores HTTP Node.js de longa duração implantados em um branch Neon. Cada função recebe um URL HTTPS público, é executada na mesma região do seu banco de dados e — se o branch tiver Postgres — recebe DATABASE_URL injetado automaticamente. Você as implanta e gerencia através do mesmo Neon CLI, neon.ts e API que você já usa.

Use esta habilidade para ajudar o usuário a definir, executar localmente, implantar e gerenciar funções ao lado de seu banco de dados. Entregue uma função implantada com seu URL de invocação, um loop neon dev local funcionando ou uma resposta precisa da documentação oficial do Neon.

Quando Usar

Recorra às Funções Neon quando a carga de trabalho for um manipulador de requisição/resposta que se beneficia de permanecer ativo e próximo aos dados:

• Fluxos de requisição/resposta de longa duração que superam os limites estilo lambda. Agentes que fazem várias chamadas LLM e invocações de ferramentas por requisição, ou geração de imagem/vídeo, rotineiramente ultrapassam os limites de execução de ~10–60s e as janelas de streaming curtas das funções serverless tradicionais. As Funções Neon são de longa duração: o manipulador só precisa começar a responder em até 15 minutos, e um stream aberto permanece ativo enquanto os bytes continuarem fluindo. Isso é espaço suficiente para cargas de trabalho de agentes reais.
• Streaming com estado sem precisar de Redis. Como uma função permanece ativa durante uma requisição, ela pode hospedar um endpoint SSE ou um servidor WebSocket e manter a conexão aberta no processo — nenhuma loja de estado externa (Redis, etc.) é necessária apenas para manter um stream coerente. O estado no escopo do módulo (um pool de pg, um contador em memória) persiste entre requisições na mesma isola.
• Computação que deve ficar ao lado do Postgres. A função é executada na mesma região do banco de dados do branch, portanto, não há idas e vindas entre regiões em cada consulta. DATABASE_URL é injetado para você.
• Um backend que se ramifica com seus dados. Cada branch executa sua própria versão da função em seu próprio URL, contra seu próprio estado isolado de banco de dados (e armazenamento, e gateway). Implantações de pré-visualização, CI e ambientes de desenvolvimento recebem um backend autônomo — implantar em um filho nunca afeta o pai.
• Webhooks, bots e trabalho pós-resposta. Manipuladores de Webhook que se espalham para múltiplas escritas no DB, bots Discord/WebSocket e acompanhamentos "dispare e esqueça" via waitUntil (análises, logs de auditoria) se encaixam.

Se a carga de trabalho for um site puramente estático, um job cron/de fundo que precisa de seu próprio ciclo de vida e cancelamento, ou algo que precise ser executado fora do us-east-2 hoje, esta não é a ferramenta certa ainda (veja Tempos Limite e Disponibilidade abaixo).

O Que Faz

• Longa duração e serverless — Construído para servidores WebSocket (veja Servidores WebSocket), endpoints SSE (veja Eventos enviados pelo servidor (SSE)), streams HTTP de agentes longos e APIs. Ainda escala para zero quando ocioso.
• Manipulador padrão da web — Uma função é qualquer exportação padrão com um método fetch(request) retornando um Response (compatível com Workers/WinterTC). Um aplicativo Hono exporta exatamente essa forma, então export default app funciona perfeitamente. Executa no Node.js 24, então todas as APIs do Node estão disponíveis.
• Próximo ao seu banco de dados — Executa na região do branch; DATABASE_URL injetado automaticamente quando o branch tem Postgres.
• Ramificável — Cada branch executa sua própria versão da função em seu próprio URL contra seu próprio estado isolado.
• Mesmo CLI/API — Implante e gerencie via neon, neon.ts ou a API Neon.

Arquitetura: onde as Funções se encaixam

Neon (incluindo Funções) são primitivas de backend, não hospedagem de aplicativos full-stack. Hospede seu aplicativo em Vercel (ou Netlify, ou outro host de frontend/aplicativo); Funções são a fatia de longa duração e com estado do seu backend que vive ao lado dos seus dados. Elas se compõem com essa plataforma de duas maneiras:

• Adicione uma Função a um aplicativo full-stack. Seu aplicativo Next.js / TanStack Start no Vercel (ou Netlify) gerencia a UI, autenticação (por exemplo, Neon Auth) e fala diretamente com Neon Postgres e Object Storage. Quando uma carga de trabalho excede os limites serverless curtos do host — um servidor WebSocket ou SSE, ou um agente de longa duração que atingiria o tempo limite — mova apenas essa parte para uma Função Neon. (Veja Funções como um backend de agente para o padrão cliente-direto.)

…