Procedures

Taakspecifieke instructies die je agent laadt wanneer ze relevant zijn

Overzicht

Een procedure bevat instructies voor één specifieke taak. Elke procedure heeft een trigger die beschrijft wanneer deze van toepassing is en inhoud die beschrijft wat er moet gebeuren. Wanneer een gesprek overeenkomt met de trigger, laadt de agent de procedure.

Gebruik procedures wanneer je agent veel verschillende taken moet afhandelen. Een voorbeeld is een klantenserviceagent, waarbij elke procedure één type verzoek afdekt: terugbetalingen, identiteitsverificatie, accountherstel of het oplossen van verbindingsproblemen.

Tabblad Procedures in het agentdashboard

Proceduretypen

Er zijn twee soorten procedures:

Free-form procedures worden geschreven als instructies in natuurlijke taal die de agent interpreteert en aanpast aan de situatie.
Structured procedures zijn een geordende lijst met getypeerde stappen die de agent elke keer op dezelfde manier uitvoert.

Je kunt beide soorten voor dezelfde agent gebruiken. De agent kiest op basis van de trigger de relevante procedure, ongeacht het type.

Procedures kunnen elkaar aanroepen. Een free-form procedure roept een andere procedure aan met een inlineverwijzing, en een structured procedure roept een andere structured procedure aan met een Sub-procedure- stap. Een veelvoorkomend patroon is om open afhandeling in een free-form procedure te houden en de onderdelen die elke keer op dezelfde manier moeten worden uitgevoerd door te geven aan een structured procedure.

Een agent kan procedures, een workflow of beide hebben. Wanneer beide aanwezig zijn, is elke procedure beschikbaar vanuit elk punt in de workflow; een procedure kan niet worden beperkt tot specifieke workflownodes. De meeste agents zijn opgebouwd rond de ene of de andere aanpak, maar je kunt de twee combineren.

Wanneer procedures gebruiken

Elke agent heeft een system prompt. Procedures en workflows zijn twee manieren om daar structuur aan toe te voegen, en een agent kan beide gebruiken. Kies een startpunt op basis van hoeveel het gesprek kan variëren.

Vereiste	Gebruik	Waarom
Eenvoudige proof-of-conceptagent	Alleen system prompt	Het snelst om in te stellen en op te itereren, maar één prompt wordt onoverzichtelijk naarmate de agent meer taken krijgt.
Taak waarbij de agent formulering en volgorde kan aanpassen	Free-form procedure	Houdt het hele gesprek in de context van één LLM, zodat de agent formulering en volgorde kan aanpassen en onverwachte wendingen kan volgen. Gebruikt meer van het contextvenster.
Taak waarvan de stappen elke keer op dezelfde manier moeten worden uitgevoerd	Structured procedure	Elke stap wordt uitgevoerd in de volgorde die je instelt, elke keer op dezelfde manier, en je schrijft deze als een korte lijst met stappen.
Volledige controle over complexe vertakkingen en uitzonderingsgevallen	Workflow	Wordt uitgevoerd als een grafiek van subagents die je zelf ontwerpt en verbindt, met volledige controle over vertakkingen en het model dat elke stap gebruikt.

Free-form procedures zijn de standaardkeuze. Ze zijn het snelst te schrijven, lezen als een document zodat niet-technische teams ze kunnen beheren, en de agent kan herstellen wanneer een gesprek afwijkt van het script. Kies een structured procedure wanneer de gevolgen van een overgeslagen of anders geordende stap groot zijn, zoals bij authenticatie, escalatie of een financiële transactie. Kies een workflow wanneer je routeringslogica of controle over het model per stap nodig hebt die geen van beide proceduretypen biedt.

Procedures beheren

Het dashboard is de aanbevolen manier om procedures te schrijven. Gebruik de CLI of de API om procedures programmatisch te beheren of ze in implementatietooling te integreren.

Bouwen via het dashboard

Beheren via de CLI

Beheren via de API

Open je agent in het dashboard en selecteer vervolgens Procedures. Gebruik + om een free-form of structured procedure te maken. Je kunt procedures vanuit hetzelfde menu in mappen groeperen. Zie Free-form procedures en Structured procedures voor richtlijnen voor het schrijven.

Beperkingen

De inhoud van een procedure is beperkt tot 50.000 tekens.
De agent houdt de vijf meest recent gestarte procedures in de context. Wanneer er in één gesprek meer zijn gestart, verdwijnen de inhoud, inline tools en kennisbankdocumenten van de oudste free-form procedures uit de prompt. Houd procedures gericht en gebruik subprocedures, zodat er weinig tegelijk actief zijn.
Je kunt het type van een procedure na het maken niet wijzigen. Maak een nieuwe procedure om tussen free-form en structured te converteren en werk alle verwijzingen ernaar bij.
Procedures behoren tot één agent. Ze kunnen niet tussen agents worden gedeeld of als resources op workspaceniveau worden opgeslagen.
Bij het dupliceren van een agent worden de procedures gekopieerd in plaats van gedeeld. De kopieën krijgen nieuwe procedure-ID’s, dus verwijzingen in de gedupliceerde agent moeten die nieuwe ID’s gebruiken.
Procedures kunnen niet worden beperkt tot specifieke workflownodes. Wanneer een agent beide heeft, is elke procedure beschikbaar vanuit elke node.
Structured procedures kunnen niet verwijzen naar kennisbankdocumenten.