Systemtools sind integrierte Tools, die vom Agenten verwendet werden können, um häufige Aufgaben auszuführen. Sie können nicht bearbeitet werden.
Ähnlich wie bei anderen Tools müssen Sie bei der Verwendung von Systemtools Agent-Anweisungen für die Verwendung des Tools und Tool-Argumente angeben.
customize_response
Generiert eine Sprachantwort des Agenten mit detaillierter Steuerung der Parameter, einschließlich deaktivierter Unterbrechung und DTMF-Parameter.
Argumente:
| Argument | Erforderlich/Optional | Beschreibung | Standard |
|---|---|---|---|
| Inhalte | Erforderlich | Der Textinhalt der Agent-Antwort. | |
| enable_dtmf | Optional | Gibt an, ob die Tastatureingabe (DTMF) aktiviert werden soll. | Wird durch die Einstellungen der Agent-Anwendung bestimmt |
| dtmf_endpointing_timeout_modes | Optional | Die Wartezeit für die Eingabeantwort der Nutzer. Sie können zwischen „kurz“, „mittel“ und „lang“ wählen. | „mittel“ |
| dtmf_finish_digit | Optional | Die DTMF-Ziffer, die die DTMF-Erfassung beendet. Beispiel: „#“. | Leerer String |
| disable_barge_in | Optional | Unterbrechung durch den Nutzer verhindern, wenn der Agent spricht. | Falsch |
Beispiel für eine Anweisung zum Erfassen einer Telefonnummer mit DTMF, wobei DTMF explizit aktiviert ist und möglicherweise die Einstellung der Agent-Anwendung überschrieben wird:
make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True,
dtmf_endpointing_timeout_modes='short')
Alternativ können Sie enable_dtmf explizit auf False setzen oder dieses Argument weglassen und sich auf die Einstellungen der Agent-Anwendung verlassen.
Beispiel für eine Anweisung zum Erfassen einer Kartennummer mit 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')
Beispiel für eine Anweisung zum Lesen von Nutzungsbedingungen, ohne Unterbrechung zuzulassen:
make the tool call customize_response(
content="By proceeding, you agree to the terms and condition...",
disable_barge_in=True)
end_session
Beendet die Sitzung. Mit diesem Tool wird die Unterhaltung beendet, um entweder an einen menschlichen Kundenservicemitarbeiter weiterzuleiten oder die Sitzung zu beenden, wenn der Nutzer keine weiteren Anfragen hat.
Wenn die Sitzung aufgrund eines Problems beendet wird und der Nutzer weitergeleitet werden musste, geben Sie für den Parameter session_escalated den Wert True an.
Verwenden Sie das Argument params, um Daten an die Metadaten der Sitzungsbeendigung der endgültigen Antwort weiterzuleiten.
Argumente:
| Argument | Erforderlich/Optional | Beschreibung | Standard |
|---|---|---|---|
| reason | Erforderlich | Der Grund für das Beenden der Sitzung. | |
| session_escalated | Optional | Gibt an, ob die Sitzung an einen menschlichen Kundenservicemitarbeiter weitergeleitet wird. | Falsch |
| params | Optional | Weitere Parameter, die an den Handler für die Sitzungsbeendigung übergeben werden sollen. | Keine |
Beispiel für eine Anweisung zum Beenden der Unterhaltung:
If the user has no more questions execute the tool end_session(reason="success")
Beispiel für eine Anweisung zur Weiterleitung, wenn der Nutzer mit einem menschlichen Kundenservicemitarbeiter sprechen möchte:
If the user wants to talk to a human, execute the tool
end_session(reason="escalate_to_human", session_escalated=True)
Beispiel für eine Anweisung zum Prüfen der Eingabesprache des Nutzers:
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).