​

base44 agents push

​

Syntax

npx base44 agents push

​

Authentifizierung

​

Was der Befehl tut

1. Liest alle Agent-Dateien aus dem Verzeichnis base44/agents/
2. Validiert Agent-Konfigurationen
3. Zeigt die Anzahl der zu pushenden Agenten an
4. Lädt Agenten in das Base44-Backend hoch
5. Meldet die Ergebnisse: erstellte, aktualisierte und gelöschte Agenten

​

Voraussetzungen

• Muss aus einem Base44-Projektverzeichnis ausgeführt werden
• Das Projekt muss Agent-Definitionen im Ordner base44/agents/ enthalten

​

Ausgabe

$ 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

​

Agenten-Synchronisation

• Created: Neue Agenten, die in Base44 nicht existierten
• Updated: Bestehende Agenten mit geänderter Konfiguration
• Deleted: Agenten, die aus deiner lokalen Konfiguration entfernt wurden

​

Fehlerbehandlung

$ 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

​

Agent-Konfigurations-Schema

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

• Agentennamen müssen dem Muster entsprechen: /^[a-z0-9_]+$/ (nur Kleinbuchstaben, Ziffern, Unterstriche, 1-100 Zeichen)
  • Gültig: support_agent, order_bot, task_helper
  • Ungültig: Support-Agent, OrderBot, task helper
• Agent-Dateinamen müssen Unterstriche verwenden (passend zum Agentennamen)
  • Gültig: support_agent.jsonc, order_bot.jsonc
  • Ungültig: support-agent.jsonc (Bindestriche nicht erlaubt)
• Entitätsnamen in tool_configs müssen PascalCase verwenden (passend zum Feld name der Entität)
  • Gültig: "entity_name": "Task", "entity_name": "TeamMember"
  • Ungültig: "entity_name": "task", "entity_name": "team_member"

• name: Erforderlich, muss den obigen Benennungsregeln entsprechen
• description: Erforderlich, mindestens 1 Zeichen
• instructions: Erforderlich, mindestens 1 Zeichen
• tool_configs: Optional, Standardwert ist ein leeres Array
• whatsapp_greeting: Optional

​

Häufiger Fehler: Falsches tool_configs-Format

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

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

​

Best Practices für Agent-Anweisungen

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

​

Anwendungsfälle

• Nach dem Definieren neuer Agenten in deinem Projekt
• Beim Ändern bestehender Agent-Konfigurationen
• Um Agent-Änderungen vor dem Testen zu synchronisieren
• Als Teil deines Entwicklungs-Workflows, wenn sich das Agent-Verhalten ändert

​

Hinweise

• Dieser Befehl synchronisiert die Agent-Konfiguration, nicht Konversationsdaten
• Änderungen werden sofort auf dein Base44-Projekt angewendet
• Teste Agent-Änderungen zuerst in einer Entwicklungsumgebung
• Agent-Definitionen befinden sich im Verzeichnis base44/agents/
• Verwende base44 agents pull, um Agenten von Base44 herunterzuladen