Les outils système sont des outils intégrés que l'agent peut utiliser pour effectuer des tâches courantes. Vous ne pouvez pas les modifier.
Comme pour les autres outils, lorsque vous utilisez des outils système, fournissez des instructions à l'agent pour savoir quand utiliser l'outil et fournissez les arguments de l'outil.
customize_response
Génère une réponse vocale de l'agent avec un contrôle précis des paramètres, y compris les paramètres d'interruption et DTMF désactivés.
Arguments :
| Argument | Obligatoire/Facultatif | Description | Par défaut |
|---|---|---|---|
| contenu | Obligatoire | Contenu textuel de la réponse de l'agent. | |
| enable_dtmf | Facultatif | Permet d'activer ou non la saisie au clavier (DTMF). | Déterminé par les paramètres de l'application de l'agent |
| dtmf_endpointing_timeout_modes | Facultatif | Temps d'attente pour la réponse saisie par l'utilisateur, à choisir parmi "court", "moyen" et "long". | "mid" |
| dtmf_finish_digit | Facultatif | Chiffre DTMF qui met fin à la collecte DTMF. Par exemple, "#". | Chaîne vide |
| disable_barge_in | Facultatif | Interdire à l'utilisateur d'interrompre l'agent lorsqu'il parle. | Faux |
Exemple d'instruction pour collecter un numéro de téléphone avec DTMF, où DTMF est explicitement activé, en remplaçant éventuellement le paramètre de l'application d'agent :
make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True,
dtmf_endpointing_timeout_modes='short')
Vous pouvez également définir explicitement enable_dtmf sur False ou omettre cet argument et vous fier aux paramètres de l'application de l'agent.
Exemple d'instruction pour collecter un numéro de carte de crédit avec DTMF :
make the tool call customize_response(
content="Using your keypad, please enter your 16-digit credit card number, then press the pound key when you are finished.",
enable_dtmf=True,
dtmf_finish_digit='#',
dtmf_endpointing_timeout_modes='mid')
Exemple d'instruction pour lire les conditions sans autoriser l'interruption :
make the tool call customize_response(
content="By proceeding, you agree to the terms and condition...",
disable_barge_in=True)
end_session
Met fin à la session. Cet outil permet de mettre fin à la conversation pour la transférer à un agent humain ou pour clore la session si l'utilisateur n'a plus de demandes.
Si la session est interrompue en raison d'un problème et que l'utilisateur a dû être transféré, indiquez la valeur True pour le paramètre session_escalated.
Utilisez l'argument params pour transférer les données vers les métadonnées de fin de session de la réponse finale.
Arguments :
| Argument | Obligatoire/Facultatif | Description | Par défaut |
|---|---|---|---|
| reason | Obligatoire | Raison de la fin de la session. | |
| session_escalated | Facultatif | Indique si la session a été escaladée à un agent humain. | Faux |
| params | Facultatif | Autres paramètres à transmettre au gestionnaire de fin de session. | Aucun |
Exemple d'instruction pour mettre fin à la conversation :
If the user has no more questions execute the tool end_session(reason="success")
Exemple d'instruction pour escalader le problème lorsque l'utilisateur souhaite parler à un agent réel :
If the user wants to talk to a human, execute the tool
end_session(reason="escalate_to_human", session_escalated=True)
Exemple d'instruction pour vérifier la langue de saisie de l'utilisateur :
If the user speaks a language that is not English or Spanish, escalate by
calling: end_session(
reason='Encountered an unsupported language, escalating to a human agent.',
session_escalated=true).