Agentsleutels voor scripts en automatiseringen
Maak een agentsleutel, kies wat hij mag doen, zie hem één keer, vernieuw hem voordat hij verloopt en trek hem in.
Op deze pagina
Met een agentsleutel kan een script, een automatisering of een CI-taak met Verimly praten zonder inlogscherm. De sleutel handelt als de persoon die hem heeft gemaakt, met hooguit de eigen rechten van die persoon. Alles wat de sleutel gebruikt, stopt met werken zodra je hem intrekt.
Gebruik je een app zoals Claude of ChatGPT, dan heb je geen sleutel nodig: koppel die zoals beschreven in Je eigen AI-agent koppelen aan Verimly.
Voordat je begint
- Agents toestaan moet aan staan in Instellingen › AI & agents. Een eigenaar beheert het. Staat het uit, dan werken sleutels niet meer.
- Een sleutel handelt als jij, dus hij kan nooit meer zien of wijzigen dan je rol toestaat. Een kassamedewerker die Het menu aanpassen aanvinkt, krijgt er niets extra’s bij, omdat de rol het menu niet kan wijzigen.
- Staat Alleen lezen voor iedereen aan, dan is elke nieuwe sleutel alleen-lezen, wat je ook kiest.
- Behandel een sleutel als een wachtwoord: iedereen die hem heeft, kan als jou handelen binnen zijn scopes.
Een sleutel maken
- Open Instellingen › AI & agents, zoek Agentsleutels en kies Sleutel maken.
- Vul een Naam in die zegt waarvoor hij is, zoals Script weekrapport.
- Laat onder Wat het mag doen de optie Alleen lezen aan staan, of zet het uit om wijzigingen toe te staan en vink de scopes aan die je nodig hebt (zie hieronder). Je bedrijf bekijken zit er altijd bij.
- Kies onder Locaties de optie Alle locaties, of Alleen deze locaties en kies er minstens één.
- Kies Verloopt: na 30, 90 of 365 dagen. Elke sleutel verloopt; er is geen sleutel die eeuwig leeft.
- Kies Sleutel maken.
- Kopieer je sleutel nu. Hij begint met
vk_live_en wordt maar één keer getoond. Bewaar hem in een wachtwoordmanager of je CI-secrets en kies dan Ik heb hem gekopieerd.
Stuur de sleutel mee in de header Authorization als bearer-token: Authorization: Bearer vk_live_…. Een sleutel werkt op zowel het volledige als het Alleen lezen-serveradres dat op dezelfde pagina staat. Sleutels kunnen een persoon niet vragen meer toegang goed te keuren, dus ze kunnen niet verder gaan dan de scopes die je hebt gegeven.
Scopes
| Scope | Wat het toestaat |
|---|---|
| Je bedrijf bekijken | Omzet, menu, voorraad, personeelsrooster, reserveringen en rapporten: wat je zelf kunt zien |
| Het menu aanpassen | Producten, prijzen, categorieën en wat is uitverkocht |
| Reserveringen beheren | Boekingen aanmaken, verplaatsen en annuleren |
| Personeel en diensten beheren | Personeelsprofielen, uitnodigingen en het rooster |
| Online bestellingen afhandelen | Online bestellingen accepteren en hun status en notities bijwerken. Nooit terugbetalingen of stornos. Geen enkele agentactie gebruikt deze scope al. |
Agents kunnen nooit geld verplaatsen: geen terugbetalingen, stornos, uitbetalingen of betalingsinstellingen.
Sleutels bekijken en beheren
De lijst toont elke sleutel met zijn naam, de eerste tekens van de sleutel, wie hij Werkt als, Laatst gebruikt (of Nog niet gebruikt), en Verloopt of Verlopen met de datum. Eigenaren zien alle sleutels van het bedrijf; iedereen anders ziet zijn eigen.
Een sleutel vernieuwen voordat hij verloopt
Kies Vernieuwen bij de sleutel. Je krijgt een nieuw geheim met dezelfde instellingen, en het oude werkt direct niet meer. De nieuwe sleutel behoudt de resterende dagen. Werk je script meteen bij. Een eigenaar die de sleutel van iemand anders vernieuwt, neemt hem over: de nieuwe sleutel handelt als de eigenaar.
Een sleutel intrekken
Kies Intrekken en bevestig. Alles wat de sleutel gebruikt, stopt direct met werken. Doe dit als de sleutel ergens is geplakt waar dat niet hoort, een teamlid weggaat, of het script buiten gebruik wordt gesteld.
Wordt een persoon uit het bedrijf verwijderd, dan worden zijn sleutels en gekoppelde apps ook ingetrokken.
Limieten
- Aanroepen worden per maand voor het bedrijf geteld: Starter 3.000, Pro 10.000 en Business 30.000 per vestiging, gepoold. De pagina toont … van … agent-aanroepen en wanneer het opnieuw begint.
- Elke sleutel kan 60 aanroepen per minuut doen op Starter en Pro, 120 op Business. Boven de limiet wordt de aanroep geweigerd met een melding om te wachten.
Veelgestelde vragen
Ik ben de sleutel kwijt
Hij kan niet opnieuw worden getoond. Maak een nieuwe sleutel (of vernieuw de oude) en trek de verloren sleutel in.
De sleutel werkte gisteren en geeft nu een fout
Hij is misschien ingetrokken (AGENT_KEY_REVOKED), verlopen, of Agents toestaan staat misschien uit (MCP_DISABLED). Controleer de sleutel in de lijst en de schakelaar op de pagina.
Waarom kan de sleutel lezen maar niets wijzigen?
Alleen lezen staat aan voor de sleutel, of Alleen lezen voor iedereen staat aan voor het bedrijf, of de scope is niet geselecteerd. Zie AGENT_READ_ONLY in Veiligheid van agents.
Als er iets misgaat
Kijk bij Activiteit op dezelfde pagina: daar staat elke actie van agents, met resultaat en tijd. Trek bij een gelekte sleutel hem eerst in en bekijk dan in het log van Nagaan wie wat heeft gewijzigd wat hij heeft gedaan. Gebruik Contact opnemen met support als je hulp nodig hebt.