Skip to main content
Diese Seite ist Teil eines KI-Coding-Agent-Skills und für Agenten geschrieben, nicht für Menschen. Für die menschenlesbare Base44-Dokumentation siehe die Entwicklerdokumentation.

​
base44 agents push

Lokale KI-Agent-Konfigurationen zu Base44 pushen. Agenten sind konversationelle KI-Assistenten, die mit Benutzern interagieren, auf die Entitäten deiner App zugreifen und Backend-Funktionen aufrufen können.

​
Syntax

npx base44 agents push

​
Authentifizierung

Erforderlich: Ja. Wenn du nicht authentifiziert bist, wirst du zur Anmeldung aufgefordert.

​
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

Der Push-Vorgang synchronisiert deine lokalen Agenten mit Base44:
  • Created: Neue Agenten, die in Base44 nicht existierten
  • Updated: Bestehende Agenten mit geänderter Konfiguration
  • Deleted: Agenten, die aus deiner lokalen Konfiguration entfernt wurden
Warnung: Dies ist ein vollständiger Sync-Vorgang. Lokal entfernte Agenten werden auch aus Base44 gelöscht.

​
Fehlerbehandlung

Wenn keine Agenten in deinem Projekt gefunden werden: 
$ npx base44 agents push
No local agents found - this will delete all remote agents
Wenn ein Agent einen ungültigen Namen hat: 
$ npx base44 agents push
Error: Agent name must be lowercase alphanumeric with underscores

​
Agent-Konfigurations-Schema

Jede Agent-Datei sollte eine .jsonc-Datei in base44/agents/ mit dieser Struktur sein: 
{
  "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
}
Benennungsregeln:
  • 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"
Erforderliche Felder:
  • 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

FALSCH — Verwende NICHT tools mit type und entity: 
{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}
RICHTIG — Verwende tool_configs mit entity_name und allowed_operations: 
{
  "name": "my_agent",
  "tool_configs": [                             // ✅ CORRECT
    { "entity_name": "Task", "allowed_operations": ["read"] }
  ]
}

​
Best Practices für Agent-Anweisungen

Wenn du Agenten Zugriff auf Entitäten gibst, formuliere in den Anweisungen ausdrücklich die Nutzung der Tools: 
{
  "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"] }
  ]
}
Ohne ausdrückliche Anweisungen zur Nutzung der Entity-Tools fragt der Agent auf Anfrage möglicherweise keine Nutzerdaten proaktiv ab.

​
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
Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die englische Version.