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

> Envia configurações de agente de IA locais para a Base44. Agentes são assistentes de IA conversacionais que podem interagir com usuários, acessar 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 push

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

## Sintaxe

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

## Autenticação

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

## O que faz

1. Lê todos os arquivos de agente do diretório `base44/agents/`
2. Valida configurações de agente
3. Exibe a contagem de agentes a serem enviados
4. Faz upload de agentes para o backend Base44
5. Reporta os resultados: agentes criados, atualizados e excluídos

## Pré-requisitos

* Deve ser executado a partir de um diretório de projeto Base44
* O projeto deve ter definições de agente na pasta `base44/agents/`

## Saída

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

Found 2 agents to push
Pushing agents to Base44...

Created: support_agent
Updated: order_bot
Deleted: old_agent

✓ Agents pushed to Base44
```

## Sincronização de agentes

A operação de push sincroniza seus agentes locais com a Base44:

* **Created**: Novos agentes que não existiam na Base44
* **Updated**: Agentes existentes com configuração modificada
* **Deleted**: Agentes que foram removidos da sua configuração local

**Aviso**: Esta é uma operação de sincronização completa. Agentes removidos localmente serão excluídos da Base44.

## Tratamento de erros

Se nenhum agente for encontrado no seu projeto:

```bash theme={null}
$ npx base44 agents push
No local agents found - this will delete all remote agents
```

Se um agente tem um nome inválido:

```bash theme={null}
$ npx base44 agents push
Error: Agent name must be lowercase alphanumeric with underscores
```

## Schema de configuração do agente

Cada arquivo de agente deve ser um arquivo `.jsonc` em `base44/agents/` com esta estrutura:

```jsonc theme={null}
{
  "name": "agent_name",              // Required: lowercase alphanumeric with underscores, 1-100 chars
  "description": "Brief description of what this agent does",  // Required: min 1 char
  "instructions": "Detailed instructions for the agent's behavior",  // Required: min 1 char
  "tool_configs": [                  // Optional: defaults to []
    // Entity tool - gives agent access to entity operations
    { "entity_name": "Task", "allowed_operations": ["read", "create", "update", "delete"] },
    // Backend function tool - gives agent access to a function
    { "function_name": "send_email", "description": "Send an email notification" }
  ],
  "whatsapp_greeting": "Hello! How can I help you today?"  // Optional
}
```

**Regras de nomenclatura:**

* **Nomes de agente** devem corresponder ao padrão: `/^[a-z0-9_]+$/` (apenas alfanuméricos minúsculos com sublinhados, 1-100 caracteres)
  * Válido: `support_agent`, `order_bot`, `task_helper`
  * Inválido: `Support-Agent`, `OrderBot`, `task helper`
* **Nomes de arquivo de agente** devem usar sublinhados (correspondendo ao nome do agente)
  * Válido: `support_agent.jsonc`, `order_bot.jsonc`
  * Inválido: `support-agent.jsonc` (hifens não permitidos)
* **Nomes de entidade em `tool_configs`** devem usar PascalCase (correspondendo ao campo `name` da entidade)
  * Válido: `"entity_name": "Task"`, `"entity_name": "TeamMember"`
  * Inválido: `"entity_name": "task"`, `"entity_name": "team_member"`

**Campos obrigatórios:**

* `name`: Obrigatório, deve seguir as regras de nomenclatura acima
* `description`: Obrigatório, mínimo 1 caractere
* `instructions`: Obrigatório, mínimo 1 caractere
* `tool_configs`: Opcional, padrão para array vazio
* `whatsapp_greeting`: Opcional

### Erro comum: Formato tool\_configs errado

**ERRADO** - NÃO use `tools` com `type` e `entity`:

```jsonc theme={null}
{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}
```

**CORRETO** - Use `tool_configs` com `entity_name` e `allowed_operations`:

```jsonc theme={null}
{
  "name": "my_agent",
  "tool_configs": [                             // ✅ CORRECT
    { "entity_name": "Task", "allowed_operations": ["read"] }
  ]
}
```

### Melhores práticas para instruções de agente

Ao dar aos agentes acesso a entidades, seja explícito nas instruções sobre o uso das ferramentas:

```jsonc theme={null}
{
  "name": "support_agent",
  "instructions": "You are a helpful support agent.\n\nIMPORTANT: You have access to customer data through entity tools. When users ask about their orders or account:\n1. ALWAYS use the Order entity tool to query their order history\n2. Use the Customer entity tool to look up account details\n3. Analyze the data and provide personalized responses\n\nAlways query the relevant entities first before answering questions about user data.",
  "tool_configs": [
    { "entity_name": "Order", "allowed_operations": ["read"] },
    { "entity_name": "Customer", "allowed_operations": ["read"] }
  ]
}
```

Sem instruções explícitas para usar as ferramentas de entidade, o agente pode não consultar proativamente os dados do usuário quando solicitado.

## Casos de uso

* Após definir novos agentes no seu projeto
* Ao modificar configurações de agente existentes
* Para sincronizar alterações de agente antes de testar
* Como parte do seu fluxo de desenvolvimento quando o comportamento do agente muda

## Notas

* Este comando sincroniza a configuração do agente, não os dados da conversa
* As alterações são aplicadas ao seu projeto Base44 imediatamente
* Certifique-se de testar as alterações do agente em um ambiente de desenvolvimento primeiro
* As definições de agente estão localizadas no diretório `base44/agents/`
* Use `base44 agents pull` para baixar agentes da Base44

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