> ## Documentation Index
> Fetch the complete documentation index at: https://docs.analytics.synapside.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral do Analytics Lab

O **Analytics Lab** é a infraestrutura de computação serverless orientada a dados do Synapside. Ele permite que desenvolvedores e analistas criem, testem e executem funções personalizadas na nuvem para automatizar ingestões, processamentos de dados, enriquecimento de perfis e integrações com o CDP Synapside ou serviços externos.

***

## ⚡ Principais Características

* **Execução Serverless Isolada:** Cada função executa em um ambiente seguro e isolado com recursos dedicados de CPU e memória.
* **Instalação Automática de Pacotes com Cache de 24h:** Declare suas dependências (`package.json` ou `requirements.txt`) e o ambiente instala e mantém os pacotes em cache de alta velocidade.
* **Testes Imediatos via CLI:** Teste seu código local diretamente na nuvem em segundos usando o comando `sanalytics test` antes de publicar uma versão.
* **Controle de Versão e Rollback:** Todo deploy gera uma versão imutável com checksum e histórico, permitindo reversão instantânea a qualquer momento.
* **Integração Nativa com o CDP:** Conecte facilmente seus pipelines de dados ao CDP Synapside via API REST ou SQL livre.

***

## 🛠️ Runtimes Suportados

O Analytics Lab oferece suporte nativo para dois ambientes modernos:

| Runtime         | Identificador | Linguagem / Padrão            | Arquivo de Entrada Padrão |
| :-------------- | :------------ | :---------------------------- | :------------------------ |
| **Node.js 22**  | `node22`      | JavaScript / TypeScript (ESM) | `index.js:handler`        |
| **Python 3.12** | `python3.12`  | Python 3.12                   | `main.py:handler`         |

***

## 🔄 Modos de Invocação

Ao criar uma função, você pode configurar seu modo de processamento:

1. **Assíncrono (`async` - Padrão):** Ideal para pipelines de dados, ingestões de APIs (como Google Ads, Facebook Ads, CRMs) e tarefas pesadas em segundo plano.
2. **Síncrono (`sync`):** Ideal para processamentos que precisam responder imediatamente à requisição do cliente com dados calculados.

***

## 🚀 Próximos Passos

* [Instalação e Uso do CLI sanalytics](/lab/cli-sanalytics)
* [Estrutura de Pastas e Projetos](/lab/estrutura-do-projeto)
* [Gerenciamento de Pacotes e Cache](/lab/pacotes-e-dependencias)
* [Tutorial Prático: Ingestão do Google Ads no CDP](/lab/exemplo-google-ads)
