Skip to main content
Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a documentação para desenvolvedores.

​
base44 exec

Executa um script com o SDK da Base44 pré-autenticado como o usuário atual. Lê o script do stdin.

​
Sintaxe

cat ./script.ts | npx base44 exec
echo "<code>" | npx base44 exec

​
Como funciona

O comando exec lê um script do stdin e o executa no lado do servidor com o SDK da Base44 pré-autenticado como o usuário atualmente logado. Isso permite executar scripts únicos contra os dados do seu aplicativo sem escrever uma função completa.

​
Variáveis globais disponíveis

base44 — um cliente SDK pré-inicializado, disponível como variável global em cada script exec. Você não precisa importá-lo ou configurá-lo — está pronto para usar imediatamente.
Use-o para interagir com os recursos do seu aplicativo:
  • base44.entities.<EntityName> — operações CRUD em entidades (.list(), .get(id), .create(data), .update(id, data), .delete(id))
  • base44.functions.invoke(name, data?) — chama uma função de backend
  • base44.agents.<AgentName> — invoca agentes de IA
  • Para mais recursos e métodos disponíveis, veja a referência do SDK da Base44

​
Exemplos

# Executa um arquivo de script
cat ./script.ts | npx base44 exec

# Script inline
echo "const users = await base44.entities.User.list(); console.log(users)" | npx base44 exec

# Executa contra um aplicativo específico sem um checkout de projeto local
cat ./script.ts | npx base44 exec --app-id app_123

# Ou resolve o aplicativo a partir do ambiente
BASE44_APP_ID=app_123 npx base44 exec < ./script.ts

​
Requisitos

  • Deve estar autenticado (npx base44 login)
  • Deve ser executado em um destes contextos:
    • de um diretório de projeto Base44 vinculado, ou
    • com --app-id <id>, ou
    • com BASE44_APP_ID definido
  • O script deve ser canalizado via stdin (modo não interativo)

​
Notas

  • O script é executado com o SDK da Base44 pré-autenticado — você pode usar base44.entities, base44.functions, etc. diretamente
  • --app-id é útil quando você quer inspecionar dados do aplicativo sem mudar para um projeto local vinculado
  • O código de saída do script é encaminhado como código de saída do processo CLI
  • Este comando requer que stdin seja canalizado (não aceita entrada em modo TTY interativo)
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.