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

# Scripts autônomos

> Execute scripts autônomos contra seu app

Você pode executar scripts autônomos que interagem com seu app Base44 usando o comando `base44 exec`.

Scripts autônomos:

* Não requerem configuração ou gerenciamento de token. Um cliente SDK pré-autenticado está disponível como uma variável global `base44`.
* São executados localmente usando [Deno](https://docs.deno.com/runtime/) e rodam contra o app implantado vinculado ao diretório atual do seu projeto.
* Têm acesso total às entidades, funções e integrações do seu app através do SDK.
* Rodam com as permissões do seu usuário, não com acesso de service-role.

## Pré-requisitos

Você precisa instalar o [Deno](https://docs.deno.com/runtime/getting_started/installation/) para executar scripts com exec.

## Casos de uso

O comando `exec` dá acesso direto ao SDK completo a partir de scripts autônomos. Casos de uso comuns incluem:

* **Migrações de dados:** Reformule, preencha ou transforme registros de entidade em lote.
* **Scripts de seed:** Popule seu app com dados de amostra para desenvolvimento ou staging.
* **Consultas ad-hoc:** Inspecione ou depure rapidamente os dados do seu app a partir do terminal.
* **Tarefas de IA e LLM:** Execute operações de IA pontuais como sumarizar dados, gerar conteúdo ou enriquecer registros.
* **Teste de funções:** Invoque funções de backend com dados reais para testá-las fora do app.
* **Automação:** Execute scripts em pipelines CI ou jobs agendados para realizar tarefas de manutenção.

## Começar

Para começar, crie um arquivo de script e direcione-o (pipe) para exec.

<Steps>
  <Step title="Escreva um script">
    Crie um arquivo de script que use a variável global `base44`. Nenhum import ou configuração é necessário. Por exemplo:

    ```typescript theme={null}
    // list-tasks.ts
    const tasks = await base44.entities.Task.list();
    console.log(`Found ${tasks.length} tasks:`);
    for (const task of tasks) {
      console.log(`  - ${task.title} (${task.status})`);
    }
    ```
  </Step>

  <Step title="Execute-o">
    Execute o script a partir do diretório do seu projeto:

    ```bash theme={null}
    cat ./list-tasks.ts | base44 exec
    ```

    A CLI autentica como seu usuário atual, inicia um processo Deno e executa seu script com o cliente SDK `base44` pronto para uso.

    <Tip>
      Para one-liners rápidos, direcione (pipe) código inline diretamente:

      ```bash theme={null}
      echo "console.log(await base44.entities.Task.list())" | base44 exec
      ```
    </Tip>
  </Step>
</Steps>

## Veja também

* [`exec`](/developers/references/cli/commands/exec): Referência completa do comando
* [Funções de backend](/developers/backend/resources/backend-functions/overview): Escreva funções serverless que rodam na infraestrutura da Base44
* [SDK JavaScript](/developers/references/sdk/getting-started/overview): Referência do SDK para entidades, auth, functions e integrações

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>