Problemen oplossen: prompt en tools
Acties tijdens het gesprek (tools) en eigen variabelen werken alleen goed als de voorwaarde, de omschrijving en de prompt op elkaar zijn afgestemd. Hieronder vind je de meest voorkomende problemen met hun oorzaak en oplossing.
Controleer na elke aanpassing het resultaat. Het resultaat van een actie Na het gesprek staat bij het gesprek in de Inbox, onder Technische details bij Wat de acties hebben gedaan. Een actie Tijdens het gesprek staat daar niet bij: bekijk in het Transcript wat de assistent ermee deed en controleer in je eigen systeem of het verzoek is binnengekomen. Gesprekken in Uitproberen komen niet in de Inbox, en daar worden acties alleen gesimuleerd tenzij je Acties echt uitvoeren aanzet.
Symptomen, oorzaken en oplossingen
| Symptoom | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| Actie tijdens het gesprek wordt niet uitgevoerd | Actie staat uit, voorwaarde vaag, of in de prompt gezet in plaats van op de actie | Zet de actie aan en schrijf een specifieke voorwaarde op de actie zelf |
| Actie wordt te vaak uitgevoerd | Voorwaarde te breed | Maak de voorwaarde specifieker |
| Eigen variabelen leeg of verkeerd na het gesprek | Variabele niet gedefinieerd op een actie Na het gesprek, of omschrijving vaag | Definieer de variabele op de actie met een precieze omschrijving |
| Parameters verkeerd ingevuld | Geen formaataanwijzing | Voeg een formaataanwijzing en een spel-en-herhaal-regel toe |
| Assistent negeert een promptinstructie | Prompt te lang, niet dwingend of instructie weggestopt | Kort in, formuleer dwingend, zet de regel in Belangrijke regels |
| Antwoord van de tool wordt niet gebruikt | Toelichting op het antwoord ontbreekt of antwoord te groot | Vul de toelichting in en houd het antwoord kort: de assistent krijgt maximaal 6.000 tekens |
| Actie wordt pas na het gesprek uitgevoerd | Verkeerd moment gekozen | Zet de actie op Tijdens het gesprek |
Een actie tijdens het gesprek wordt niet uitgevoerd
De assistent beslist op basis van het veld Wanneer moet de assistent dit gebruiken? van de actie of hij haar aanroept. Staat de voorwaarde alleen in de prompt, of is ze vaag ("bij vragen over bestellingen"), dan gebeurt er vaak niets.
- Open de assistent, ga naar het tabblad Taken, open de kaart Acties en controleer of de actie aan staat.
- Open de actie en schrijf in het veld Wanneer moet de assistent dit gebruiken? een concrete trigger, bijvoorbeeld "Als de beller een ordernummer noemt".
- Verwijder de instructie uit de prompt; de voorwaarde op de actie is de plek waar de assistent kijkt.
Zie Acties.
Een actie wordt te vaak uitgevoerd
Roept de assistent een tool aan bij elke vraag, dan is de voorwaarde te breed ("als de beller iets vraagt over zijn bestelling"). Maak haar smaller en koppel haar aan een concreet gegeven dat de beller moet hebben genoemd: "Als de beller een ordernummer van acht cijfers heeft genoemd en de status wil weten".
Eigen variabelen zijn leeg of verkeerd na het gesprek
Eigen variabelen worden na afloop uit het gesprek gehaald. Dat gebeurt alleen als ze zijn gedefinieerd op een actie Na het gesprek die aan staat, onder Extra variabelen om te extraheren, met een omschrijving die het AI-model kan volgen. Een variabele die alleen in de prompt wordt genoemd, blijft leeg. Definieer haar op de actie (naam orderNumber, Beschrijving voor de assistent: "Het ordernummer dat de beller noemde, alleen cijfers"). Noemt de beller het gegeven niet, dan blijft de variabele leeg. Wat er is gevonden, zie je bij het gesprek onder Technische details, bij Gegevens uit het gesprek.
Gebruik waar mogelijk de ingebouwde variabelen zoals personNumber en summary, die je niet hoeft te definiëren. Ook die kunnen leeg zijn: personNumber als er geen telefoonnummer bekend is, summary als de beller niets heeft gezegd. Op een actie Tijdens het gesprek zijn ingebouwde variabelen niet beschikbaar: laat de assistent het gegeven dan invullen bij Parameters die de assistent invult. Zie Acties.
Parameters worden verkeerd ingevuld
Komt een ordernummer binnen als "12 34 56 78" of een postcode zonder letters, dan weet het model niet welk formaat je verwacht. Zet bij Parameters die de assistent invult een formaataanwijzing in de Beschrijving voor de assistent ("acht cijfers zonder spaties, bijvoorbeeld 12345678") en voeg in de prompt de regel toe dat de assistent nummers laat spellen en herhaalt voordat hij ze gebruikt.
De assistent negeert een promptinstructie
Instructies raken ondergesneeuwd als de prompt te lang is, als ze vrijblijvend zijn geformuleerd ("het zou fijn zijn als je...") of als ze halverwege een alinea staan. Kort de prompt in, formuleer dwingend ("Vraag altijd...", "Noem nooit...") en zet de belangrijkste regels op het tabblad Instructies in het veld Belangrijke regels, één per regel. In de Geavanceerde modus zet je ze bovenaan de Volledige prompt. Zie Een goede prompt schrijven en Je assistent verbeteren.
Het antwoord van de tool wordt niet gebruikt
Als je endpoint wel antwoordt maar de assistent er niets mee doet, ontbreekt meestal de Toelichting op het antwoord die uitlegt wat het antwoord bevat en wat de assistent ermee moet doen, of is het antwoord te groot. Vul de toelichting in ("Noem de bezorgdatum uit het veld deliveryDate") en houd het antwoord kort, met alleen de velden die de assistent nodig heeft: hij krijgt maximaal de eerste 6.000 tekens.
Je endpoint heeft 6 seconden om te antwoorden. Antwoordt het niet op tijd of is het niet bereikbaar, dan hoort de assistent in een tekstgesprek dat het opzoeken is mislukt. Op een telefoongesprek met een ChatGPT-stem krijgt hij dan geen enkel resultaat terug en weet hij dus niet dat het verzoek is mislukt. Geeft je endpoint een foutstatus, dan hoort de assistent alleen dat dit is gebeurd. Bij Rijen opzoeken (tijdens het gesprek) in Google Sheets is er geen toelichting; de assistent krijgt maximaal 5 passende rijen. Zie Webhook tijdens het gesprek.
De actie wordt pas na het gesprek uitgevoerd
Het veld Wanneer bepaalt het moment van een actie: Vóór het gesprek, Tijdens het gesprek of Na het gesprek. Een nieuwe actie staat standaard op Na het gesprek. Staat een HTTP-verzoek dat iets opzoekt daarop, dan wordt het wel uitgevoerd, maar te laat om de beller te helpen. Staat Rijen opzoeken (tijdens het gesprek) van Google Sheets daarop, dan wordt de actie helemaal niet uitgevoerd: bij Wat de acties hebben gedaan staat dan een regel die begint met skipped:.
Zet acties waarvan het resultaat in het gesprek nodig is op Tijdens het gesprek. Controleer bij Google Sheets dat bij Modus Rijen opzoeken (tijdens het gesprek) is gekozen en dat Wanneer op Tijdens het gesprek staat.
Alle drie de momenten kunnen alleen bij een HTTP-verzoek. Google Sheets kan tijdens en na het gesprek. E-mail, Sms en WhatsApp lopen altijd na het gesprek.
Nog steeds problemen?
Staat je probleem er niet bij of helpt de oplossing niet? Meld het via Een probleem melden en vermeld de link naar het gesprek en de naam van de actie, zodat wij het kunnen uitzoeken.