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

# Über Agenten

> Definiere KI-Agenten über lokale Konfigurationsdateien

<div className="dev-docs-banner">
  <div className="dev-docs-banner-content">
    <div className="dev-docs-banner-title">
      Du siehst gerade die Entwicklerdokumentation
    </div>

    <div className="dev-docs-banner-text">
      Diese Dokumentation richtet sich an Entwickler, die mit der Base44-Entwicklerplattform arbeiten. Informationen zu KI-Agenten im App-Editor findest du unter <a href="/Building-your-app/AI-agents-for-apps">Einen KI-Agenten einrichten</a>.
    </div>
  </div>
</div>

[KI-Agenten](/Building-your-app/AI-agents-for-apps) sind anpassbare KI-Assistenten, die handeln und sich mit Tools verbinden, um Teammitgliedern und Endbenutzern zu helfen. Definiere das Verhalten, die Berechtigungen und die Tools der Agenten über lokale JSONC-Konfigurationsdateien.

## Agenten erstellen

Erstelle JSONC-Konfigurationsdateien in deinem `base44/agents/`-Verzeichnis (eine Datei pro Agent) und führe dann [`agents push`](/developers/references/cli/commands/agents-push) aus, um sie mit Base44 zu synchronisieren.

## Beispiel

```jsonc theme={null}
{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent. Help users resolve their issues politely and efficiently. If you cannot help, escalate to a human agent.",
  "model": "anthropic/claude-sonnet-4-20250514",
  "tool_configs": [
    {
      "entity_name": "tickets",
      "allowed_operations": ["read", "create", "update"],
    },
    {
      "entity_name": "customers",
      "allowed_operations": ["read"],
    },
    {
      "function_name": "send_notification",
      "description": "Sends a push notification to the customer",
    },
    {
      "function_name": "escalate_to_human",
      "description": "Escalates the conversation to a human support agent",
    },
  ],
  "whatsapp_greeting": "Hi, I'm your support assistant. How can I help you today?",
}
```

## Feldreferenz

Agenten-Konfigurationen verwenden JSONC. Jeder Agent wird in einer separaten Datei im Verzeichnis `base44/agents/` definiert.

### Erforderliche Felder

<ResponseField name="name" type="string" required>
  Eindeutige Kennung für den Agenten. Verwende Kleinbuchstaben und Unterstriche. Der
  Name sollte mit dem Dateinamen übereinstimmen, sodass ein Agent namens `customer_support`
  in `customer_support.jsonc` läge.
</ResponseField>

<ResponseField name="description" type="string" required>
  Kurze Beschreibung dessen, was der Agent tut.
</ResponseField>

<ResponseField name="instructions" type="string" required>
  System-Prompt, der das Verhalten, die Persönlichkeit und die Richtlinien des Agenten definiert.
</ResponseField>

<ResponseField name="model" type="string" required>
  Das zu verwendende KI-Modell im Format `provider/model-name`.

  Unterstützte Modelle:

  * `anthropic/claude-sonnet-4-20250514`
  * `anthropic/claude-3-5-sonnet-20241022`
  * `openai/gpt-4o`
  * `openai/gpt-4o-mini`
</ResponseField>

### Optionale Felder

<ResponseField name="tool_configs" type="array">
  Tools, die der Agent verwenden kann, um mit deiner App zu interagieren. Siehe [Tool-Konfiguration](#tool-configuration).
</ResponseField>

<ResponseField name="whatsapp_greeting" type="string">
  Begrüßungsnachricht für WhatsApp-Konversationen mit diesem Agenten.
</ResponseField>

## Tool-Konfiguration

Das `tool_configs`-Array definiert, welche Fähigkeiten dein Agent hat. Es gibt zwei Typen: **Entity-Tools** und **Funktions-Tools**.

### Entity-Tools

Entity-Tools ermöglichen es dem Agenten, CRUD-Operationen auf den [Entitäten](/developers/backend/resources/entities/overview) deiner App durchzuführen.

<ResponseField name="entity_name" type="string" required>
  Name der Entität. Muss mit einer in deiner App existierenden Entität übereinstimmen.
</ResponseField>

<ResponseField name="allowed_operations" type="array" required>
  Operationen, die der Agent auf dieser Entität ausführen kann. Gültige Werte sind `"read"`,
  `"create"`, `"update"` und `"delete"`.
</ResponseField>

### Funktions-Tools

Funktions-Tools ermöglichen es dem Agenten, die [Backend-Funktionen](/developers/backend/resources/backend-functions/overview) deiner App aufzurufen.

<ResponseField name="function_name" type="string" required>
  Name der Funktion. Muss mit einer in deiner App existierenden Funktion übereinstimmen.
</ResponseField>

<ResponseField name="description" type="string" required>
  Beschreibung dessen, was die Funktion tut. Der Agent verwendet diese, um zu entscheiden,
  wann er sie aufruft.
</ResponseField>

## TypeScript-Typen

Generiere TypeScript-Typen aus deinen Agenten-Konfigurationen, um Typsicherheit und Autovervollständigung für Agenten-Namen in deinem SDK-Code zu erhalten. Erfahre mehr über [dynamische Typen](/developers/references/sdk/getting-started/dynamic-types).

## Siehe auch

* [`agents pull`](/developers/references/cli/commands/agents-pull): Synchronisiere Agenten-Konfigurationen von Base44 in dein lokales Projekt
* [`agents push`](/developers/references/cli/commands/agents-push): Veröffentliche deine lokalen Agenten-Konfigurationen bei Base44
* [`agents`](/developers/references/sdk/docs/interfaces/agents): SDK-Referenz für die Arbeit mit Agenten in deinem Code
* [KI-Agenten einrichten](/Building-your-app/AI-agents-for-apps): Anleitung zum Erstellen und Konfigurieren von KI-Agenten

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