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

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# Über Agenten

> Definiere KI-Agenten mit lokalen 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](/de/Building-your-app/AI-agents-for-apps) sind anpassbare KI-Assistenten, die Aktionen ausführen und sich mit Tools verbinden. So helfen sie Teammitgliedern und Endnutzern. Definiere Verhalten, Berechtigungen und Tools der Agenten mit lokalen JSONC-Konfigurationsdateien.

## Agenten erstellen

Erstelle JSONC-Konfigurationsdateien in deinem Verzeichnis `base44/agents/`, eine Datei pro Agent. Führe dann [`agents push`](/de/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": "claude-sonnet-5",
  "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?",
  "selected_skill_names": ["refund-policy", "brand-voice"],
}
```

## Feldreferenz

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

### Pflichtfelder

<ResponseField name="name" type="string" required>
  Eindeutige Kennung des Agenten. Verwende Kleinbuchstaben und Unterstriche. Der
  Name sollte dem Dateinamen entsprechen. Ein Agent namens `customer_support`
  liegt also in `customer_support.jsonc`.
</ResponseField>

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

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

<ResponseField name="model" type="string" required>
  Das KI-Modell, auf dem der Agent läuft. Verwende `automatic`, damit Base44 eines auswählt. Oder lege eine Preset-ID aus der Liste der [unterstützten Modelle](/de/developers/backend/resources/models) fest, zum Beispiel `claude-sonnet-5` oder `gpt_6_sol`.

  Eingestellte Preset-IDs, die Base44 noch erkennt, werden automatisch auf einen aktuellen Ersatz aktualisiert.
</ResponseField>

### Optionale Felder

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

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

<ResponseField name="selected_skill_names" type="array">
  Namen der [Agent-Skills](/de/developers/backend/resources/agents/agent-skills),
  die diesem Agenten zugeordnet sind. Bis zu 10 Skills pro Agent.
</ResponseField>

## Tool-Konfiguration

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

### Entity-Tools

Mit Entity-Tools führt der Agent CRUD-Operationen auf den [Entitäten](/de/developers/backend/resources/entities/overview) deiner App aus.

<ResponseField name="entity_name" type="string" required>
  Name der Entität. Muss einer vorhandenen Entität in deiner App entsprechen.
</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

Mit Funktions-Tools ruft der Agent die [Backend-Funktionen](/de/developers/backend/resources/backend-functions/overview) deiner App auf.

<ResponseField name="function_name" type="string" required>
  Name der Funktion. Muss einer vorhandenen Funktion in deiner App entsprechen.
</ResponseField>

<ResponseField name="description" type="string" required>
  Beschreibung dessen, was die Funktion tut. Der Agent entscheidet damit, wann er
  sie aufruft.
</ResponseField>

## TypeScript-Typen

Generiere TypeScript-Typen aus deinen Agent-Konfigurationen. So erhältst du Typsicherheit und Autovervollständigung für Agentennamen in deinem SDK-Code. Erfahre mehr über [dynamische Typen](/de/developers/references/sdk/getting-started/dynamic-types).

## Siehe auch

* [`agents pull`](/de/developers/references/cli/commands/agents-pull): Synchronisiere Agent-Konfigurationen von Base44 in dein lokales Projekt
* [`agents push`](/de/developers/references/cli/commands/agents-push): Deploye deine lokalen Agent-Konfigurationen zu Base44
* [Agent-Skills](/de/developers/backend/resources/agents/agent-skills): Definiere wiederverwendbare Anweisungssets für deine Agenten
* [`agents`](/de/developers/references/sdk/docs/interfaces/agents): SDK-Referenz für die Arbeit mit Agenten in deinem Code
* [KI-Agenten einrichten](/de/Building-your-app/AI-agents-for-apps): Anleitung zum Erstellen und Konfigurieren von KI-Agenten

<Note>Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der [englischen Version](/). </Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.