> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

<Warning>
  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](/developers).
</Warning>

# 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

```bash theme={null}
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

```bash theme={null}
$ 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:

```bash theme={null}
$ npx base44 agents push
No local agents found - this will delete all remote agents
```

Wenn ein Agent einen ungültigen Namen hat:

```bash theme={null}
$ 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:

```jsonc theme={null}
{
  "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`:

```jsonc theme={null}
{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}
```

**RICHTIG** — Verwende `tool_configs` mit `entity_name` und `allowed_operations`:

```jsonc theme={null}
{
  "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:

```jsonc theme={null}
{
  "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

<Note>Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die [englische Version](/). </Note>