​

base44 agents push

​

Sintassi

npx base44 agents push

​

Autenticazione

​

Cosa fa

1. Legge tutti i file degli agenti dalla directory base44/agents/
2. Valida le configurazioni degli agenti
3. Mostra il conteggio degli agenti da inviare
4. Carica gli agenti sul backend di Base44
5. Riporta i risultati: agenti creati, aggiornati ed eliminati

​

Prerequisiti

• Deve essere eseguito da una directory di progetto Base44
• Il progetto deve avere definizioni di agenti nella cartella base44/agents/

​

Output

$ 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

​

Sincronizzazione degli agenti

• Created: nuovi agenti che non esistevano in Base44
• Updated: agenti esistenti con configurazione modificata
• Deleted: agenti rimossi dalla tua configurazione locale

​

Gestione degli errori

$ 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 di configurazione dell’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
}

• I nomi degli agenti devono corrispondere al pattern: /^[a-z0-9_]+$/ (alfanumerico minuscolo con solo underscore, 1-100 caratteri)
  • Validi: support_agent, order_bot, task_helper
  • Non validi: Support-Agent, OrderBot, task helper
• I nomi dei file degli agenti devono usare underscore (corrispondenti al nome dell’agente)
  • Validi: support_agent.jsonc, order_bot.jsonc
  • Non validi: support-agent.jsonc (trattini non consentiti)
• I nomi delle entità in tool_configs devono usare PascalCase (corrispondenti al campo name dell’entità)
  • Validi: "entity_name": "Task", "entity_name": "TeamMember"
  • Non validi: "entity_name": "task", "entity_name": "team_member"

• name: obbligatorio, deve seguire le regole di denominazione qui sopra
• description: obbligatorio, minimo 1 carattere
• instructions: obbligatorio, minimo 1 carattere
• tool_configs: facoltativo, predefinito array vuoto
• whatsapp_greeting: facoltativo

​

Errore comune: formato tool_configs sbagliato

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

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

​

Migliori pratiche per le istruzioni degli agenti

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

​

Casi d’uso

• Dopo aver definito nuovi agenti nel tuo progetto
• Quando modifichi configurazioni di agenti esistenti
• Per sincronizzare le modifiche degli agenti prima di testare
• Come parte del tuo flusso di sviluppo quando cambia il comportamento dell’agente

​

Note

• Questo comando sincronizza la configurazione dell’agente, non i dati delle conversazioni
• Le modifiche vengono applicate al tuo progetto Base44 immediatamente
• Assicurati di testare le modifiche degli agenti in un ambiente di sviluppo prima
• Le definizioni degli agenti si trovano nella directory base44/agents/
• Usa base44 agents pull per scaricare gli agenti da Base44