Zum Hauptinhalt springen
Du siehst gerade die Entwicklerdokumentation
Diese Dokumentation richtet sich an Entwickler, die mit der Base44-Entwicklerplattform arbeiten. Informationen zu KI-Agenten im App-Editor findest du unter Einen KI-Agenten einrichten.
KI-Agenten 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 aus, um sie mit Base44 zu synchronisieren.

Beispiel

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

name
string
erforderlich
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.
description
string
erforderlich
Kurze Beschreibung dessen, was der Agent tut.
instructions
string
erforderlich
System-Prompt, der das Verhalten, die Persönlichkeit und die Richtlinien des Agenten definiert.
model
string
erforderlich
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

Optionale Felder

tool_configs
array
Tools, die der Agent verwenden kann, um mit deiner App zu interagieren. Siehe Tool-Konfiguration.
whatsapp_greeting
string
Begrüßungsnachricht für WhatsApp-Konversationen mit diesem Agenten.

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 deiner App durchzuführen.
entity_name
string
erforderlich
Name der Entität. Muss mit einer in deiner App existierenden Entität übereinstimmen.
allowed_operations
array
erforderlich
Operationen, die der Agent auf dieser Entität ausführen kann. Gültige Werte sind "read", "create", "update" und "delete".

Funktions-Tools

Funktions-Tools ermöglichen es dem Agenten, die Backend-Funktionen deiner App aufzurufen.
function_name
string
erforderlich
Name der Funktion. Muss mit einer in deiner App existierenden Funktion übereinstimmen.
description
string
erforderlich
Beschreibung dessen, was die Funktion tut. Der Agent verwendet diese, um zu entscheiden, wann er sie aufruft.

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.

Siehe auch

  • agents pull: Synchronisiere Agenten-Konfigurationen von Base44 in dein lokales Projekt
  • agents push: Veröffentliche deine lokalen Agenten-Konfigurationen bei Base44
  • agents: SDK-Referenz für die Arbeit mit Agenten in deinem Code
  • KI-Agenten einrichten: Anleitung zum Erstellen und Konfigurieren von KI-Agenten
Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die englische Version.