Strumenti di sistema

Gli strumenti di sistema sono strumenti integrati che possono essere utilizzati dall'agente per eseguire attività comuni. Non sono modificabili.

Come per altri strumenti, quando utilizzi gli strumenti di sistema, fornisci le istruzioni all'agente su quando utilizzare lo strumento e fornisci gli argomenti dello strumento.

customize_response

Genera una risposta vocale dell'agente con un controllo granulare sui parametri, inclusi i parametri di interruzione e DTMF disattivati.

Argomenti:

Argomento Obbligatoria/Facoltativa Descrizione Predefinito
contenuti Obbligatorio Il contenuto testuale della risposta dell'agente.
enable_dtmf Facoltativo Se abilitare l'input da tastiera (DTMF). Falso
dtmf_endpointing_timeout_modes Facoltativo Il tempo di attesa per la risposta digitata dagli utenti, scegliendo tra "breve", "medio" e "lungo". "mid"
dtmf_finish_digit Facoltativo La cifra DTMF che termina la raccolta DTMF. Ad esempio, "#". Stringa vuota
disable_barge_in Facoltativo Non consentire l'interruzione dell'utente quando l'agente sta parlando. Falso

Esempio di istruzione per la raccolta di un numero di telefono con DTMF:

make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True, dtmf_endpointing_timeout_modes='short')

Esempio di istruzione per la raccolta di un numero di carta di credito 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')

Esempio di istruzione per la lettura dei termini che consente l'interruzione:

make the tool call customize_response(
content="By proceeding, you agree to the terms and condition...",
disable_barge_in=True)

end_session

Termina la sessione. Questo strumento viene utilizzato per terminare la conversazione per riassegnarla a un agente umano o terminare la sessione se l'utente non ha altre richieste.

Se la sessione è terminata a causa di un problema e la richiesta dell'utente è stata riassegnata, fornisci un valore di True al parametro session_escalated. Utilizza l'argomento params per inoltrare i dati ai metadati della sessione finale della risposta finale.

Argomenti:

Argomento Obbligatoria/Facoltativa Descrizione Predefinito
motivo Obbligatorio Il motivo della fine della sessione.
session_escalated Facoltativo Indica se la sessione è stata riassegnata a un agente umano. Falso
parametri Facoltativo Altri parametri da passare al gestore di fine sessione. Nessuno

Esempio di istruzione per terminare la conversazione:

If the user has no more questions execute the tool end_session(reason="success")

Esempio di istruzioni per la riassegnazione quando l'utente richiede un agente:

If the user wants to talk to a human, execute the tool
end_session(reason="escalate_to_human", session_escalated=True)

Esempio di istruzione per controllare la lingua di input utente'utente:

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).