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 inhabilitada.
Argumentos:
| Argumento | Obligatorio/opcional | Descripción | Predeterminado |
|---|---|---|---|
| contenido | Obligatorio | Es el contenido de texto de la respuesta del agente. | |
| enable_dtmf | Opcional | Indica si se debe habilitar la entrada de teclado (DTMF). | Falso |
| dtmf_endpointing_timeout_modes | Opcional | Es el tiempo de espera para la respuesta de escritura de los usuarios, que se puede elegir entre "corto", "medio" y "largo". | "mid" |
| dtmf_finish_digit | Opcional | Es el dígito de 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 |
Ejemplo de instrucción para recopilar un número de teléfono con DTMF:
make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True, dtmf_endpointing_timeout_modes='short')
Ejemplo de instrucción 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')
Ejemplo de instrucción para leer condiciones y 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, ya sea para derivar el caso a un agente humano o para finalizar la sesión si el usuario no tiene más solicitudes.
Si la sesión finalizó debido a un problema y se tuvo que 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 | Es el motivo por el que se finalizó la sesión. | |
| session_escalated | Opcional | Indica si la sesión se derivó a un agente humano. | Falso |
| params | Opcional | Otros parámetros que se pasarán al controlador de finalización de sesión. | Ninguno |
Ejemplo de instrucción para finalizar la conversación:
If the user has no more questions execute the tool end_session(reason="success")
Ejemplo de instrucción para derivar el caso cuando el usuario quiere hablar con un agente humano:
If the user wants to talk to a human, execute the tool
end_session(reason="escalate_to_human", session_escalated=True)
Ejemplo de instrucción 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).