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

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

$ 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: 
$ npx base44 agents push
No local agents found - this will delete all remote agents
Se um agente tem um nome inválido: 
$ 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: 
{
  "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: 
{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}
CORRETO - Use tool_configs com entity_name e allowed_operations: 
{
  "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: 
{
  "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
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.