Agentic UI-statussen: hoe u AI-denken, tooloproepen en voortgang kunt laten zien
Hoe u de statussen van een AI-agent kunt ontwerpen: ontvangen, denken, tooloproepen, streaming, klaar, gestopt en mislukt. Patronen, timing en voorbeelden.
Kern afhaalmaaltijd
Een agentrun heeft meer statussen nodig dan een normaal verzoek: ontvangen, nadenken, elke tooloproep, het antwoord streamen, klaar, gestopt en mislukt. Laat ze allemaal op een andere manier zien, noem de stap waarin de agent zich bevindt, laat mensen de run op elk gewenst moment stoppen en eindig met een korte samenvatting van wat er is gedaan. Houd details op laag niveau beschikbaar, maar samengevouwen.
Waarom agentruns hun eigen status nodig hebben
Een klassiek verzoek heeft twee zichtbare statussen: laden en klaar. Een AI-agentrun is anders. Het kan seconden of minuten duren, het doorloopt verschillende stappen zoals zoeken, bestanden lezen of een API aanroepen, en het kan acties ondernemen met gevolgen. Responstijdonderzoek van Nielsen Norman Group geldt nog steeds: ongeveer 0,1 seconde voelt direct aan, ongeveer 1 seconde houdt de gedachtestroom vast en na ongeveer 10 seconden hebben mensen feedback nodig over wat er gebeurt en hoe lang het ongeveer zal duren. De meeste agenten komen terecht in die laatste groep.
De staten om te ontwerpen
Ontwerp elk van deze als zijn eigen staat met zijn eigen uiterlijk en woorden, niet als één spinner:
- Ontvangen: bevestig de aanvraag direct (minder dan 0,1 s), bijvoorbeeld door het bericht in de thread te tonen.
- Denken: een rustige indicator in de buurt van waar het antwoord zal verschijnen. Vermijd valse voortgangspercentages.
- Tooloproep: geef de stap een naam in gewone woorden ("De documenten doorzoeken", "3 bestanden lezen"), met een telling als u deze kent.
- Wachten op goedkeuring: een duidelijke pauze waarin de agent toestemming nodig heeft voordat hij kan handelen.
- Streaming: toon de uitvoer zodra deze binnenkomt; stop de denkindicator zodra de tekst begint.
- Klaar: een korte samenvatting van wat er is gewijzigd, met waar mogelijk ongedaan maken.
- Gestopt en mislukt: zeg wat er is gebeurd, wat is bewaard en hoe u het opnieuw kunt proberen.
Toon het plan, niet het onbewerkte logboek
Lange logboeken met tooloproepen zijn handig voor het opsporen van fouten, maar zijn voor de meeste gebruikers overweldigend. Een goede standaard is een status van één regel voor de huidige stap, plus een samengevouwen lijst met voltooide stappen die mensen kunnen uitvouwen. Ontwikkelaars en hoofdgebruikers kunnen de details openen; alle anderen zien vooruitgang in duidelijke taal. Protocollen zoals AG-UI, een open, op gebeurtenissen gebaseerde standaard voor het verbinden van agenten met gebruikersgerichte apps, bestaan deels zodat front-ends deze stapgebeurtenissen op een consistente manier kunnen ontvangen.
Controle en vertrouwen
Mensen vertrouwen agenten meer als zij de controle behouden. Houd een stopknop zichtbaar gedurende de hele run. Vraag om bevestiging vóór onomkeerbare acties zoals verzenden, betalen of verwijderen en laat precies zien wat er gaat gebeuren. Maak het na de uitvoering gemakkelijk om een enkele stap ongedaan te maken, te bewerken of opnieuw te proberen in plaats van opnieuw te beginnen.
Motie voor agentstaten
Beweging is een sterk signaal dat er "iets gebeurt", maar loops worden tijdens lange runs vermoeiend. Gebruik een zachte, contrastarme lus om na te denken, een duidelijke verandering wanneer een gereedschapsoproep begint en een duidelijke afwikkeling wanneer de run eindigt. Respecteer de instelling voor verminderde beweging door beweging om te wisselen voor een subtiele verandering in de dekking. Stemassistenten gebruiken vaak een geanimeerde bol met duidelijk verschillende inactieve, luister-, denk- en spreektoestanden.
Toets Principles in om te onthouden
- Ontwerp ontvangen, nadenken, tool call, goedkeuring, streaming, klaar, gestopt en mislukt als afzonderlijke statussen
- Benoem de huidige stap in duidelijke taal; vouw het volledige logboek samen
- Houd de stop gedurende de hele run zichtbaar en bevestig onomkeerbare acties
- Na ongeveer 10 seconden hebben mensen voortgangsinformatie nodig
- Gebruik rustige bewegingen en respecteer de instellingen voor verminderde beweging
Veelgestelde vragen
Bronnen
- Response Times: The 3 Important Limits — Nielsen Norman Group
- Progress Indicators Make a Slow System Less Insufferable — Nielsen Norman Group
- AG-UI Overview: Agent User Interaction Protocol — AG-UI
- Understanding SC 2.3.3: Animation from Interactions — W3C WAI