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 dell'agente per 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 | Obbligatorio/Facoltativo | Descrizione | Predefinito |
|---|---|---|---|
| contenuti | Obbligatorio | Il contenuto testuale della risposta dell'agente. | |
| enable_dtmf | Facoltativo | Se abilitare l'input da tastiera (DTMF). | Determinato dalle impostazioni dell'applicazione dell'agente |
| 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, in cui DTMF è abilitato in modo esplicito, con la possibilità di ignorare l'impostazione dell'applicazione dell'agente:
make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True,
dtmf_endpointing_timeout_modes='short')
In alternativa, puoi impostare enable_dtmf in modo esplicito su False
oppure puoi omettere questo argomento e fare affidamento sulle impostazioni dell'applicazione dell'agente.
Esempio di istruzione per la raccolta di un numero 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 senza consentire 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 per 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 | Obbligatorio/Facoltativo | 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 il riassegnamento quando l'utente richiede un agente in carne e ossa:
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).