Las herramientas del sistema son herramientas integradas que el agente puede usar para realizar tareas comunes. No se pueden editar.
Al igual que con otras herramientas, cuando uses herramientas del sistema, proporciona instrucciones al agente sobre cuándo usar la herramienta y proporciona argumentos de la herramienta.
customize_response
Genera una respuesta de voz del agente con un control detallado sobre los parámetros, incluidos los parámetros de DTMF y de interrupción inhabilitados.
Argumentos:
| Argumento | Obligatorio/opcional | Descripción | Predeterminado |
|---|---|---|---|
| contenido | Obligatorio | El contenido de texto de la respuesta del agente | |
| enable_dtmf | Opcional | Indica si se debe habilitar la entrada del teclado (DTMF). | Lo determinan los parámetros de configuración de la aplicación del agente. |
| dtmf_endpointing_timeout_modes | Opcional | El tiempo de espera para la respuesta de escritura de los usuarios, que se elige entre "corto", "medio" y "largo" | "medio" |
| dtmf_finish_digit | Opcional | El dígito DTMF que finaliza la recopilación de DTMF (por ejemplo, "#") | String vacío |
| disable_barge_in | Opcional | No permite la interrupción del usuario cuando el agente está hablando. | Falso |
Instrucción de ejemplo para recopilar un número de teléfono con DTMF, en la que DTMF está habilitado de forma explícita, lo que posiblemente anule la configuración de la aplicación del agente:
make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True,
dtmf_endpointing_timeout_modes='short')
Como alternativa, puedes establecer enable_dtmf de forma explícita en False o puedes omitir este argumento y depender de la configuración de la aplicación del agente.
Instrucción de ejemplo para recopilar un número de tarjeta de crédito con 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')
Instrucción de ejemplo para leer los términos sin permitir la interrupción:
make the tool call customize_response(
content="By proceeding, you agree to the terms and condition...",
disable_barge_in=True)
end_session
Finaliza la sesión. Esta herramienta se usa para finalizar la conversación y derivarla a un agente humano o finalizar la sesión si el usuario no tiene más solicitudes.
Si la sesión finaliza debido a un problema y se debe derivar al usuario, proporciona un valor de True al parámetro session_escalated.
Usa el argumento params para reenviar datos a los metadatos de la sesión final de la respuesta final.
Argumentos:
| Argumento | Obligatorio/opcional | Descripción | Predeterminado |
|---|---|---|---|
| Reason | Obligatorio | El motivo para finalizar la sesión | |
| session_escalated | Opcional | Indica si la sesión se deriva a un agente humano. | Falso |
| params | Opcional | Otros parámetros para pasar al controlador de la sesión final | Ninguno |
Instrucción de ejemplo para finalizar la conversación:
If the user has no more questions execute the tool end_session(reason="success")
Instrucción de ejemplo para derivar cuando el usuario quiere un agente en vivo:
If the user wants to talk to a human, execute the tool
end_session(reason="escalate_to_human", session_escalated=True)
Instrucción de ejemplo para verificar el idioma de entrada del usuario:
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).