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

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.

​

Festlegen, wer ein Secret nutzen darf

Jedes Secret gehört zu genau einem Geltungsbereich: 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. 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. Speichern, Löschen und Änderungen am Teilen werden namentlich im Aktivitätsprotokoll festgehalten — nie der Wert.

​

Verwandte Seiten