​

base44 agents push

​

Sintaxe

npx base44 agents push

​

Autenticação

​

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

$ 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

• 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

​

Tratamento de erros

$ npx base44 agents push
No local agents found - this will delete all remote agents

$ npx base44 agents push
Error: Agent name must be lowercase alphanumeric with underscores

​

Schema de configuração do agente

{
  "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
}

• 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"

• 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

{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}

{
  "name": "my_agent",
  "tool_configs": [                             // ✅ CORRECT
    { "entity_name": "Task", "allowed_operations": ["read"] }
  ]
}

​

Melhores práticas para instruções de agente

{
  "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"] }
  ]
}

​

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