> ## 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.

# base44 functions pull

> Extrai funções implantadas da Base44 para arquivos locais.

<Warning>
  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](/developers).
</Warning>

# base44 functions pull

Extrai funções implantadas da Base44 para arquivos locais.

## Sintaxe

```bash theme={null}
npx base44 functions pull [name]
```

## Argumentos

| Argumento | Descrição                                          | Obrigatório |
| --------- | -------------------------------------------------- | ----------- |
| `[name]`  | Nome da função a extrair (extrai todas se omitido) | Não         |

## Autenticação

**Obrigatório**: Sim. Se não estiver autenticado, você será solicitado a fazer login primeiro.

## O que faz

1. Busca funções implantadas da Base44
2. Filtra para a função especificada se `[name]` for fornecido
3. Ignora funções pertencentes a um plugin (elas não são gravadas localmente)
4. Grava arquivos de função no diretório local `functions/` (configurado em `base44/config.jsonc`)
5. Reporta cada arquivo como `written` (novo/atualizado) ou `unchanged`

## Exemplos

```bash theme={null}
# Extrai todas as funções implantadas
npx base44 functions pull

# Extrai uma função específica
npx base44 functions pull process-order
```

## Saída

```bash theme={null}
$ npx base44 functions pull
✓ Functions fetched successfully
✓ Function files written successfully
✓ process-order              written
◆ send-notification          unchanged

✓ Pulled 2 functions to base44/functions
```

Função única:

```bash theme={null}
$ npx base44 functions pull process-order
✓ Functions fetched successfully
✓ Function files written successfully
✓ process-order              written

✓ Pulled 1 function to base44/functions
```

## Tratamento de erros

Se a função especificada não for encontrada no remoto:

```bash theme={null}
$ npx base44 functions pull nonexistent
✓ Function "nonexistent" not found on remote
```

Se a função especificada pertencer a um plugin:

```bash theme={null}
$ npx base44 functions pull plugin-func
✓ Function "plugin-func" is managed by a plugin and was not pulled into base44/functions
```

Se nenhuma função existir no remoto:

```bash theme={null}
$ npx base44 functions pull
✓ No functions found on remote
```

## Notas

* Os arquivos são gravados no `functionsDir` configurado em `base44/config.jsonc` (padrão para `functions/`)
* Arquivos que já correspondem ao conteúdo remoto são ignorados (reportados como `unchanged`)
* **Funções pertencentes a plugins são ignoradas** — funções gerenciadas por um plugin nunca são gravadas localmente; elas aparecem como `plugin-owned, skipped` na saída
* Isto sobrescreve arquivos de função locais existentes com versões remotas — faça commit das alterações locais primeiro
* Use `npx base44 functions deploy` para enviar alterações locais de volta à Base44
* Use `npx base44 functions list` para ver quais funções estão implantadas no remoto

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