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

# Regeln mit Hooks hinzufügen

> Nutze Hooks, um eigene Regeln zu prüfen, bevor deine Base44-App Daten speichert, eine Registrierung zulässt, eine Integration ausführt oder eine Nachricht an einen ihrer In-App-Agenten weitergibt.

Hooks sind eine Art Workflow. Du findest sie zusammen mit deinen anderen Workflows auf der Seite **Workflows** deiner App. Mit Hooks legst du fest, was passiert, bevor deine App bestimmte Aktionen ausführt. Beispiele sind das Speichern eines Datensatzes oder die Registrierung einer Person. Ein Hook prüft deine Regeln und erlaubt oder blockiert dann die Aktion. Mit Hooks hältst du deine Daten korrekt, steuerst, wer in deine App kommt, und gibst deinen In-App-Agenten die richtigen Informationen. Dafür musst du selbst keinen Code schreiben.

> [!WARNING]
>
> **Was du für Hooks brauchst:**
>
> * **Rollout:** Hooks werden schrittweise eingeführt. Eventuell siehst du sie noch nicht.
> * **Plan:** Du brauchst einen [Builder Plan](https://base44.com/pricing) oder höher, um Hooks zu nutzen.

![Die Seite Workflows mit einem aktiven Hook Before data is saved namens Require Delivery Address über einem normalen Workflow](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-in-list.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=0e76770e28c780882b3a38e650d812c3)

Ein Hook auf der Seite Workflows

> [card] Wofür kann ich Hooks nutzen?
>
> Einige Beispiele für Regeln, die du mit Hooks bauen kannst:
>
> * **Datenänderungen schützen:** Nur Manager dürfen einen genehmigten Betrag ändern. Oder niemand darf eine Aufgabe ohne Verantwortlichen abschließen.
> * **Steuern, wer beitritt:** Nur Personen mit deiner Firmen-E-Mail dürfen sich registrieren. Beim Beitritt erhalten sie die richtige Rolle.
> * **Nutzung von Integrationen steuern:** Nur zahlende Mitglieder dürfen integrierte Integrationen wie KI-Aktionen nutzen.
> * **Agenten Kontext geben:** Prüfe die erste Nachricht eines Gesprächs mit einem In-App-Agenten. Füge Details hinzu, die der Agent in seinen Antworten nutzt.

***

## So funktionieren Hooks

Ein Hook ist eine Art Workflow, der direkt vor einer Aktion in deiner App läuft. Deine App wartet auf seine Antwort. Dann lässt sie die Aktion zu oder stoppt sie.

* **Seine Antwort:** Jeder Hook gibt **Zugelassen** oder **Blockiert** zurück. Manche geben zusätzliche Details zurück, etwa die Rolle einer neuen Person oder Kontext für einen In-App-Agenten.
* **Wenn er blockiert:** Die Person sieht die Meldung, die du in deiner Regel festgelegt hast. Hast du keine festgelegt, sieht sie eine allgemeine Meldung.
* **Externe Informationen:** Die meisten Hooks können eine Backend-Funktion aufrufen, etwa um ein internes Verzeichnis zu prüfen. Der Hook **Vor dem Speichern von Daten** kann nur Bedingungen und Berechnungen prüfen. So bleibt das Speichern schnell.
* **Änderungen aus Code:** Der Hook **Vor dem Speichern von Daten** läuft auch, wenn eine Backend-Funktion Daten ändert, nicht nur bei den Seiten deiner App.

> [!WARNING]
>
> Schlägt ein Hook fehl oder dauert er zu lange, blockiert deine App die Aktion. Bevor du dich auf einen neuen Hook verlässt, [prüfe seine Logik und seine ersten Läufe](#checking-a-hook). So hält ein Fehler in einer Regel niemanden davon ab, deine App zu nutzen.

***

## Einen Hook wählen

Jeder Hook läuft vor einer anderen Aktion in deiner App. Wenn du dem KI-Chat eine Regel beschreibst, wählt er den passenden Hook für dich. Wenn du die Hooks kennst, kannst du aber besser beschreiben, was du möchtest.

| Hook | Läuft | Wenn er fehlschlägt oder zu lange dauert |
| - | - | - |
| **Vor dem Speichern von Daten** | Jedes Mal, wenn ein Datensatz erstellt oder aktualisiert wird | Der Datensatz wird nicht gespeichert |
| **Vor der Registrierung** | Jedes Mal, wenn sich eine neue Person registriert | Die Registrierung wird blockiert |
| **Vor dem ersten Zugriff** | Wenn eine angemeldete Person deine App zum ersten Mal öffnet | Die Person kann deine App nicht öffnen |
| **Vor der Nutzung einer Integration** | Jedes Mal, wenn jemand eine integrierte Integration nutzt, auch KI-Aktionen | Die Anfrage wird blockiert |
| **Vor Beginn einer Unterhaltung** | Bei der ersten Nachricht jedes Gesprächs mit einem In-App-Agenten | Das Gespräch startet nicht |
| **Vor jeder Benutzernachricht** | Bei jeder Nachricht an einen In-App-Agenten | Die Nachricht erreicht den Agenten nicht |

Die Hooks für Registrierung und ersten Zugriff können auch die Rolle oder andere Details der Person festlegen. Der Gesprächs-Hook fügt Informationen hinzu, die der Agent für das ganze Gespräch nutzt. Der Nachrichten-Hook fügt Informationen nur für diese eine Antwort hinzu.

> [!NOTE]
>
> Manche Hooks erscheinen nur, wenn deine App sie braucht. Die Hooks für Registrierung und ersten Zugriff siehst du nur, wenn deine App eine Anmeldung erfordert. Die Hooks für Gespräche und Nachrichten siehst du nur, wenn deine App einen [In-App-Agenten](https://docs.base44.com/de/Building-your-app/AI-agents-for-apps.md) hat.

***

## Einen Hook erstellen

Du erstellst einen Hook wie jeden anderen Workflow: Du beschreibst im KI-Chat, was du möchtest. Die KI baut den Hook, stellt nötige Rückfragen und fügt ihn deiner Liste **Workflows** hinzu.

### Deine Regel beschreiben

Beschreibe deine Regel in einfachen Worten, und die KI wählt den passenden Hook für dich. Zum Beispiel:

```text theme={null}
Bevor eine Aufgabe als erledigt gespeichert wird, prüfe, ob sie einen Verantwortlichen hat. Wenn nicht, blockiere das Speichern und zeige "Füge einen Verantwortlichen hinzu, bevor du diese Aufgabe abschließt."
```

```text theme={null}
Lass nur Personen mit einer @northwind.com-E-Mail registrieren. Gib ihnen die Rolle Member.
```

**So erstellst du einen Hook im KI-Chat:**

1. Öffne deinen App-Editor.
2. Beschreibe die Regel im KI-Chat und sende sie ab.
3. Beantworte alle Rückfragen der KI.

### Zuerst die Aktion wählen

Starte auf der Seite **Workflows**, wenn du weißt, welche Aktion du prüfen möchtest, etwa das Speichern eines Datensatzes. Wenn du die Aktion wählst, öffnet sich der KI-Chat mit einem angefangenen Prompt, den du ergänzt.

**So erstellst du einen Hook auf der Seite Workflows:**

1. Öffne deinen App-Editor.
2. Klicke auf **Dashboard**.
3. Klicke auf **Workflows**.
4. Klicke auf **Workflow erstellen**.
5. Klicke auf **Startpunkt hinzufügen**.
6. Wähle unter **Hooks** die Aktion, die geprüft werden soll, etwa **Vor dem Speichern von Daten**.
7. Ergänze deine Regel im Prompt im KI-Chat und sende ihn ab.
8. Beantworte alle Rückfragen der KI.

![Das Menü Add starting point, gescrollt zum Bereich Hooks, mit hervorgehobenem Before data is saved](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hooks-menu.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=b610ec9221998e03fa99200f7f8f348c)

Einen Hook als Startpunkt wählen

***

## Einen Hook prüfen

Bevor du dich auf einen Hook verlässt, prüfe, ob er tut, was du meintest. Du kannst seine Logik lesen und ihn mit echten Daten testen. Wie du seine Läufe ansiehst, erfährst du unter [Läufe überwachen](https://docs.base44.com/de/Building-your-app/managing-workflows.md#monitoring-runs). Wie du ihn ausschaltest oder archivierst, erfährst du unter [Workflows verwalten](https://docs.base44.com/de/Building-your-app/managing-workflows.md#changing-a-workflow).

### Die Logik eines Hooks lesen

Öffne einen Hook aus deiner Workflow-Liste, um ihn als Diagramm zu sehen. Es reicht von der geprüften Aktion über jede Bedingung bis zum Ergebnis. Klicke auf einen Schritt, um seine Details zu sehen. Ein Bedingungsschritt zeigt, was er prüft. Ein Ergebnisschritt zeigt seine Entscheidung, **Zugelassen** oder **Blockiert**, und die Meldung, die Personen sehen.

![Ein Hook-Diagramm mit ausgewähltem Schritt Block order, das im Detailbereich seine Meldung und die Entscheidung Blocked zeigt](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-diagram.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=a3dbe0bc71f2cd8b13909ebd048cfc59)

Die Logik eines Hooks lesen

### Einen Hook testen

Teste einen Hook, um zu sehen, wie er mit seinen aktuellen Regeln auf die Daten eines früheren Laufs reagiert. Der Hook muss mindestens einmal gelaufen sein, bevor du ihn testen kannst. Wenn der Test startet, öffnet sich das Diagramm des Hooks auf dem Testlauf. So siehst du, ob er die Aktion erlaubt oder blockiert hat. Auf dem Tab **Aktivität** sind Testläufe mit **Test** gekennzeichnet.

> [!WARNING]
>
> Beim Testen wird die Aktion, die der Hook schützt, nicht ausgeführt, etwa das Speichern des Datensatzes. Backend-Funktionen, die der Hook aufruft, laufen aber. Sie können also echte Daten ändern oder externe Dienste kontaktieren.

**So testest du einen Hook:**

1. Öffne deinen App-Editor.
2. Klicke auf **Dashboard**.
3. Klicke auf **Workflows**.
4. Klicke auf den Hook, um ihn zu öffnen.
5. Klicke im Detailbereich auf **Jetzt ausführen**.
6. Wähle im Dialog einen früheren Lauf als Testdaten.
7. Klicke auf **Test starten**.

![Das Fenster Test hook with previous data mit einem ausgewählten früheren Lauf und hervorgehobenem Button Run test](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-test-dialog.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=75872758b2837c1a3513f76eec332907)

Einen Hook mit früheren Daten testen

> [!NOTE]
>
> Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der [englischen Version](https://docs.base44.com/index.md).


## Related topics

- [Workflows verwalten](https://docs.base44.com/de/Building-your-app/managing-workflows.md)
- [Entitäten erstellen](https://docs.base44.com/de/developers/skills/base44-cli/references/entities-create.md)
- [Artifacts mit deinem Superagent nutzen](https://docs.base44.com/de/superagents/artifacts.md)
- [Apps und Superagents in deinem Enterprise-Workspace verwalten](https://docs.base44.com/de/Enterprise/Enterprise-SSO-and-app-visibility.md)
- [Eine Domain mit deiner App verbinden](https://docs.base44.com/de/Setting-up-your-app/Setting-up-your-custom-domain.md)


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