> ## 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 agents pull

> Extrai configurações de agente de IA da Base44 para arquivos locais. Agentes são assistentes de IA conversacionais que podem interagir com usuários, acessar as entidades do seu aplicativo e chamar funções de backend.

<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 agents pull

Extrai configurações de agente de IA da Base44 para arquivos locais. Agentes são assistentes de IA conversacionais que podem interagir com usuários, acessar as entidades do seu aplicativo e chamar funções de backend.

## Sintaxe

```bash theme={null}
npx base44 agents pull
```

## Autenticação

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

## O que faz

1. Busca todos os agentes da Base44
2. Grava arquivos de agente no diretório `base44/agents/`
3. Exclui arquivos de agente locais que não existem remotamente
4. Reporta agentes gravados e excluídos

## Pré-requisitos

* Deve ser executado a partir de um diretório de projeto Base44
* O projeto deve estar vinculado a um aplicativo Base44

## Saída

```bash theme={null}
$ npx base44 agents pull

Fetching agents from Base44...
✓ Agents fetched successfully

Syncing agent files...
✓ Agent files synced successfully

Written: support_agent, order_bot
Deleted: old_agent

Pulled 2 agents to base44/agents
```

Quando os agentes já estão atualizados (sem alterações):

```bash theme={null}
$ npx base44 agents pull

Fetching agents from Base44...
✓ Agents fetched successfully

Syncing agent files...
✓ Agent files synced successfully

All agents are already up to date

Pulled 3 agents to base44/agents
```

## Sincronização de agentes

A operação de pull sincroniza agentes remotos com seus arquivos locais:

* **Written**: Arquivos de agente criados ou atualizados do remoto
* **Deleted**: Arquivos de agente locais removidos (não existiam remotamente)

**Aviso**: Esta operação substitui todas as configurações de agente locais com versões remotas. Quaisquer alterações locais não enviadas à Base44 serão sobrescritas.

## Casos de uso

* Sincronize configurações de agente para uma nova máquina de desenvolvimento
* Obtenha as configurações de agente mais recentes da sua equipe
* Restaure arquivos de agente locais após exclusão acidental
* Comece a trabalhar em um projeto existente com agentes

## Notas

* Este comando sincroniza configurações de agente, não dados de conversa
* Os arquivos de agente são armazenados como `.jsonc` no diretório `base44/agents/`
* A localização do diretório é configurável via `agentsDir` em `config.jsonc`
* Use `base44 agents push` para enviar alterações locais à Base44

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