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

# Secrets: API-Schlüssel für deine Genie Agents und Tools

> Speichere einen API-Schlüssel oder ein Token einmal in deinem Workspace und lass Genie Agents, Genie Tools und optional deine Genie Apps es nutzen — ohne dass der Wert je wieder angezeigt wird.

Ein **Secret** ist ein API-Schlüssel oder Token, den ein Schritt braucht, um einen anderen Dienst aufzurufen — etwa ein Resend-Schlüssel zum Versenden von E-Mails oder das Token einer Register-API. Statt ihn in einen Ablauf einzufügen, speicherst du ihn einmal unter einem Namen, und ein Schritt verweist auf diesen Namen. Der Wert selbst wird nie wieder angezeigt — weder dir noch deinen Teammitgliedern noch Genie AI.

Öffne **Workspace-Einstellungen → Secrets**, um sie zu verwalten.

> [!NOTE]
>
> Für die Seite brauchst du die Berechtigung, Integrationen, Genie Agents oder Genie Tools einzusehen. Was du ändern kannst, hängt vom Geltungsbereich des Secrets ab (siehe unten).

## Festlegen, wer ein Secret nutzen darf

Jedes Secret gehört zu genau einem Geltungsbereich:

| Geltungsbereich | Wer es nutzen kann | Wer es hinzufügen oder ändern kann |
| - | - | - |
| **Ganzer Workspace** | Jeder Genie Agent und jedes Genie Tool im Workspace — und, wenn du es teilst, deine Genie Apps | Mitglieder, die Integrationen verwalten dürfen |
| **Ein Genie Agent** | Nur dieser Agent | Mitglieder, die diesen Agenten bearbeiten dürfen |
| **Ein Genie Tool** | Nur dieses Tool | Mitglieder, die dieses Tool bearbeiten dürfen |

Existiert derselbe Name in mehreren Geltungsbereichen, gewinnt der spezifischste: Zuerst wird das eigene Secret des Agenten oder Tools verwendet, dann das des Workspace. So versorgt ein workspaceweiter `RESEND_API_KEY` alle, und ein Agent, der ein anderes Konto braucht, kann ein eigenes halten, ohne dass etwas umbenannt werden muss.

Der Name eines Secrets ist so privat wie das, wozu es gehört — die Namen der Secrets eines privaten Agenten sind nur für Personen sichtbar, die diesen Agenten sehen können.

## Secret hinzufügen, ersetzen oder löschen

1. Klicke auf **Secret hinzufügen**.
2. Wähle, wer es nutzen darf, gib dann einen **Namen** ein (Großbuchstaben, Ziffern und Unterstriche, beginnend mit einem Buchstaben) und füge den **Wert** ein.
3. Klicke auf **Speichern**.

Die Seite listet nur Namen auf. Um einen Wert zu ändern, klicke auf **Ersetzen** und füge den neuen ein — ein Wert lässt sich ersetzen, aber nie zurücklesen. Wird ein Secret gelöscht, schlägt jeder Schritt, der es nutzt, fehl, bis du es erneut speicherst (oder bis ein Workspace-Secret gleichen Namens einspringt) — deshalb bittet Genie dich vorher um Bestätigung.

Verweist ein Schritt auf einen Namen, der nirgends existiert, stoppt er mit einer Fehlermeldung, die das Secret nennt — er sendet nie eine Anfrage ohne seine Zugangsdaten.

## Genie AI ein Secret einrichten lassen

Genie AI kann die Namen deiner Secrets auflisten und dich durchführen, was fehlt. Braucht es einen Wert, zeigt es im Chat eine Karte, in die **du** den Schlüssel eingibst — der Wert geht direkt an Genies Server und läuft nie durch die KI oder erscheint in der Unterhaltung. Es kann außerdem ein Secret löschen oder ändern, ob eines geteilt wird — jeweils nach deiner Bestätigung auf einer Karte.

Nutze **Genie AI fragen** auf der Secrets-Seite, um mit einem Prompt darüber zu starten, welche Schlüssel deinen Agenten und Tools fehlen.

## Ein Secret mit deinen Genie Apps teilen

Ein Workspace-Secret kann auch **mit deinen Genie Apps geteilt** werden. Genie kopiert es dann in die Genie Cloud jeder App, wo die Edge Functions der App es lesen können. Aktiviere das Teilen mit der Schaltfläche **Apps** in der Zeile eines Secrets.

> [!WARNING]
>
> Alles, was in der Genie Cloud einer App läuft, kann ein geteiltes Secret lesen. Teile nur, was der Code deiner Apps haben soll.

Das Teilen achtet darauf, wer den Wert sonst noch sehen könnte:

* Eine Genie Cloud, die auch eine App **außerhalb dieses Workspace** bedient, wird übersprungen, und die Seite nennt dir, wie viele Apps das betrifft.
* Setzt eine App unter demselben Namen einen **eigenen** Wert, gewinnt der Wert der App und bleibt unberührt.
* Genies eingebaute Namen werden pro App verwaltet und lassen sich nicht teilen.

Beim Speichern eines geteilten Secrets wird der neue Wert übertragen, sodass eine Rotation jede App erreicht, die noch den alten Wert hält. Wird das Teilen ausgeschaltet oder das Secret gelöscht, wird es wieder entfernt. Die Zeile zeigt, wie viele Apps erreicht wurden und warum manche übersprungen wurden; erneutes Teilen bringt ein Secret auch zu Apps, die seitdem erstellt wurden. Die eigenen Secrets jeder App werden weiterhin in den Einstellungen dieser App verwaltet — siehe [Projekt-Secrets](https://docs.genie-app.de/de/projects/secrets.md).

Speichern, Löschen und Änderungen am Teilen werden namentlich im [Aktivitätsprotokoll](https://docs.genie-app.de/de/workspaces/overview.md#aktivitätsprotokoll) festgehalten — nie der Wert.

## Verwandte Seiten

> [card] [Genie Agents](https://docs.genie-app.de/de/workspaces/workflow-apps.md)
>
> Schritte, die eine API aufrufen, nutzen ein Secret über seinen Namen.

> [card] [Projekt-Secrets](https://docs.genie-app.de/de/projects/secrets.md)
>
> Die Secrets, die die Edge Functions einer einzelnen App lesen.


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