Outils système

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). Faux
dtmf_endpointing_timeout_modes Facultatif Temps d'attente pour la réponse de 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 :

make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True, dtmf_endpointing_timeout_modes='short')

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 tout en autorisant 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 y mettre fin 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 terminer la conversation :

If the user has no more questions execute the tool end_session(reason="success")

Exemple d'instruction pour l'escalade 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).