As ferramentas do sistema são integradas e podem ser usadas pelo agente para realizar tarefas comuns. Elas não são editáveis.
Assim como outras ferramentas, ao usar as do sistema, forneça instruções ao agente sobre quando usar a ferramenta e os argumentos dela.
customize_response
Gera uma resposta de voz do agente com controle granular sobre os parâmetros, incluindo os parâmetros de DTMF e de interrupção desativada.
Argumentos:
| Argumento | Obrigatório/Opcional | Descrição | Padrão |
|---|---|---|---|
| conteúdo | Obrigatório | O conteúdo de texto da resposta do agente. | |
| enable_dtmf | Opcional | Define se a entrada do teclado (DTMF) será ativada. | Determinado pelas configurações do aplicativo do agente |
| dtmf_endpointing_timeout_modes | Opcional | O tempo de espera para a resposta de digitação dos usuários, escolhendo entre "curto", "médio" e "longo". | "médio" |
| dtmf_finish_digit | Opcional | O dígito DTMF que finaliza a coleta de DTMF. Por exemplo, "#". | String em branco |
| disable_barge_in | Opcional | Não permite a interrupção do usuário quando o agente está falando. | Falso |
Exemplo de instrução para coletar um número de telefone com DTMF, em que o DTMF está explicitamente ativado, possivelmente substituindo a configuração do aplicativo do agente:
make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True,
dtmf_endpointing_timeout_modes='short')
Como alternativa, defina enable_dtmf explicitamente como False ou omita esse argumento e confie nas configurações do aplicativo do agente.
Exemplo de instrução para coletar um número de cartão com 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')
Exemplo de instrução para ler os termos sem permitir a interrupção:
make the tool call customize_response(
content="By proceeding, you agree to the terms and condition...",
disable_barge_in=True)
end_session
Encerra a sessão. Essa ferramenta é usada para encerrar a conversa e encaminhar para um agente humano ou encerrar a sessão se o usuário não tiver mais solicitações.
Se a sessão for encerrada devido a um problema e o usuário precisar ser encaminhado, forneça um valor de True para o parâmetro session_escalated.
Use o argumento params para encaminhar dados aos metadados de encerramento da sessão da resposta final.
Argumentos:
| Argumento | Obrigatório/Opcional | Descrição | Padrão |
|---|---|---|---|
| reason | Obrigatório | O motivo do encerramento da sessão. | |
| session_escalated | Opcional | Define se a sessão será encaminhada para um agente humano. | Falso |
| params | Opcional | Outros parâmetros a serem transmitidos para o handler de encerramento da sessão. | Nenhum |
Exemplo de instrução para finalizar a conversa:
If the user has no more questions execute the tool end_session(reason="success")
Exemplo de instrução para encaminhar quando o usuário quiser um agente humano:
If the user wants to talk to a human, execute the tool
end_session(reason="escalate_to_human", session_escalated=True)
Exemplo de instrução para verificar o idioma de entrada do usuário:
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).