Agenten-Schlüssel für Skripte und Automatisierungen
Erstellen Sie einen Agenten-Schlüssel, legen Sie fest, was er darf, sehen Sie ihn einmal, erneuern Sie ihn vor dem Ablauf und widerrufen Sie ihn.
Auf dieser Seite
Ein Agenten-Schlüssel lässt ein Skript, eine Automatisierung oder einen CI-Job ohne Anmeldebildschirm mit Verimly sprechen. Der Schlüssel handelt als die Person, die ihn erstellt hat, mit höchstens deren eigenen Rechten. Alles, was den Schlüssel nutzt, funktioniert in dem Moment nicht mehr, in dem Sie ihn widerrufen.
Nutzen Sie eine App wie Claude oder ChatGPT, brauchen Sie keinen Schlüssel: Verbinden Sie sie wie in Eigenen KI-Agenten mit Verimly verbinden beschrieben.
Bevor Sie beginnen
- Agenten erlauben muss unter Einstellungen › KI & Agents an sein. Ein Inhaber steuert es. Ist es aus, funktionieren Schlüssel nicht.
- Ein Schlüssel handelt als Sie und kann daher nie mehr sehen oder ändern, als Ihre Rolle erlaubt. Ein Kassierer, der Die Speisekarte ändern ankreuzt, bekommt nichts extra, weil die Rolle die Speisekarte nicht ändern kann.
- Ist Nur lesen für alle an, ist jeder neue Schlüssel nur lesend, was Sie auch wählen.
- Behandeln Sie einen Schlüssel wie ein Passwort: Jeder, der ihn hat, kann im Rahmen seiner Bereiche als Sie handeln.
Einen Schlüssel erstellen
- Öffnen Sie Einstellungen › KI & Agents, suchen Sie Agenten-Schlüssel und wählen Sie Schlüssel erstellen.
- Geben Sie einen Name ein, der sagt, wofür er gedacht ist, etwa Skript für den Wochenbericht.
- Lassen Sie unter Was er darf den Schalter Nur lesen an oder schalten Sie es aus, um Änderungen zu erlauben, und kreuzen Sie die benötigten Bereiche an (siehe unten). Ihren Betrieb ansehen ist immer enthalten.
- Wählen Sie unter Standorte entweder Alle Standorte oder Nur diese Standorte und wählen Sie mindestens einen.
- Wählen Sie Läuft ab: nach 30, 90 oder 365 Tagen. Jeder Schlüssel läuft ab; es gibt keinen Schlüssel, der ewig lebt.
- Wählen Sie Schlüssel erstellen.
- Kopieren Sie Ihren Schlüssel jetzt. Er beginnt mit
vk_live_und wird nur einmal angezeigt. Bewahren Sie ihn in einem Passwortmanager oder in Ihren CI-Geheimnissen auf und wählen Sie dann Ich habe ihn kopiert.
Senden Sie den Schlüssel im Header Authorization als Bearer-Token: Authorization: Bearer vk_live_…. Ein Schlüssel funktioniert an der Adresse für vollen Zugriff und an der Adresse Nur lesen, die auf derselben Seite stehen. Schlüssel können keine Person um mehr Zugriff bitten, sie können also nicht über die Bereiche hinausgehen, die Sie ihnen gegeben haben.
Bereiche
| Bereich | Was er erlaubt |
|---|---|
| Ihren Betrieb ansehen | Umsatz, Speisekarte, Lager, Dienstplan, Reservierungen und Berichte: was Sie selbst sehen können |
| Die Speisekarte ändern | Produkte, Preise, Kategorien und was ausverkauft ist |
| Reservierungen verwalten | Buchungen anlegen, verschieben und stornieren |
| Personal und Schichten verwalten | Mitarbeiterprofile, Einladungen und den Dienstplan |
| Online-Bestellungen bearbeiten | Online-Bestellungen annehmen und ihren Status und ihre Notizen aktualisieren. Nie Erstattungen oder Stornos. Bisher nutzt keine Agenten-Aktion diesen Bereich. |
Agenten können nie Geld bewegen: keine Erstattungen, Stornos, Auszahlungen oder Zahlungseinstellungen.
Schlüssel ansehen und verwalten
Die Liste zeigt jeden Schlüssel mit seinem Namen, den ersten Zeichen des Schlüssels, wer er Handelt als, Zuletzt genutzt (oder Noch nicht genutzt) und Läuft ab oder Abgelaufen mit dem Datum. Inhaber sehen alle Schlüssel des Betriebs; alle anderen sehen ihre eigenen.
Einen Schlüssel vor dem Ablauf erneuern
Wählen Sie beim Schlüssel Erneuern. Sie erhalten einen neuen geheimen Schlüssel mit denselben Einstellungen, und der alte funktioniert sofort nicht mehr. Der neue Schlüssel behält die verbleibenden Tage. Aktualisieren Sie Ihr Skript sofort. Ein Inhaber, der den Schlüssel eines anderen erneuert, übernimmt ihn: Der neue Schlüssel handelt als der Inhaber.
Einen Schlüssel widerrufen
Wählen Sie Widerrufen und bestätigen Sie. Alles, was den Schlüssel nutzt, funktioniert sofort nicht mehr. Tun Sie das, wenn der Schlüssel irgendwo eingefügt wurde, wo er nicht hingehört, ein Kollege geht oder das Skript außer Dienst gestellt wird.
Wird eine Person aus dem Betrieb entfernt, werden auch ihre Schlüssel und verbundenen Apps widerrufen.
Limits
- Aufrufe werden pro Monat für den Betrieb gezählt: Starter 3000, Pro 10000 und Business 30000 pro Standort, zusammengefasst. Die Seite zeigt … von … Agenten-Aufrufen und wann sie zurückgesetzt wird.
- Jeder Schlüssel kann in Starter und Pro 60 Aufrufe pro Minute machen, in Business 120. Über dem Limit wird der Aufruf mit der Aufforderung zu warten abgelehnt.
Häufige Fragen
Ich habe den Schlüssel verloren
Er lässt sich nicht erneut anzeigen. Erstellen Sie einen neuen Schlüssel (oder erneuern Sie den alten) und widerrufen Sie den verlorenen.
Der Schlüssel hat gestern funktioniert und liefert jetzt einen Fehler
Er ist vielleicht widerrufen (AGENT_KEY_REVOKED), abgelaufen oder Agenten erlauben ist aus (MCP_DISABLED). Prüfen Sie den Schlüssel in der Liste und den Schalter auf der Seite.
Warum kann der Schlüssel lesen, aber nichts ändern?
Nur lesen ist für den Schlüssel an, oder Nur lesen für alle ist für den Betrieb an, oder der Bereich wurde nicht gewählt. Siehe AGENT_READ_ONLY in Sicherheit bei Agenten.
Wenn etwas nicht klappt
Schauen Sie unter Aktivität auf derselben Seite: Sie listet jede Aktion von Agenten mit Ergebnis und Uhrzeit auf. Bei einem durchgesickerten Schlüssel widerrufen Sie ihn zuerst und prüfen dann im Aktivitätsprotokoll, was er getan hat. Nutzen Sie Den Support kontaktieren, wenn Sie Hilfe brauchen.