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 em outras ferramentas, ao usar ferramentas do sistema, forneça instruções ao agente sobre quando usar a ferramenta e argumentos para ela.
customize_response
Gera uma resposta de voz do agente com controle granular sobre parâmetros, incluindo parâmetros de interrupção e DTMF desativados.
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 de teclado (DTMF) será ativada. | Falso |
| 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". | "mid" |
| dtmf_finish_digit | Opcional | O dígito DTMF que encerra a coleta de DTMF. Por exemplo, "#". | String em branco |
| disable_barge_in | Opcional | Não permitir que o usuário interrompa o agente enquanto ele fala. | Falso |
Exemplo de instrução para coletar um número de telefone com DTMF:
make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True, dtmf_endpointing_timeout_modes='short')
Exemplo de instrução para coletar um número de cartão de crédito 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 termos e permitir 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 ao parâmetro session_escalated.
Use o argumento params para encaminhar dados
aos metadados da sessão final da resposta final.
Argumentos:
| Argumento | Obrigatório/Opcional | Descrição | Padrão |
|---|---|---|---|
| reason | Obrigatório | O motivo para encerrar a sessão. | |
| session_escalated | Opcional | Se a sessão foi encaminhada para um agente humano. | Falso |
| params | Opcional | Outros parâmetros a serem transmitidos para o manipulador de encerramento da sessão. | Nenhum |
Exemplo de instrução para encerrar 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 quer 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).