Strumenti webhook

Gli strumenti consentono al tuo assistente di connettersi a dati e sistemi esterni. Puoi definire un insieme di strumenti a cui l’assistente ha accesso e che utilizzerà quando opportuno in base alla conversazione.

Panoramica

Molte applicazioni richiedono agli assistenti di chiamare API esterne per ottenere informazioni in tempo reale. Gli strumenti consentono al tuo assistente di effettuare chiamate a funzioni esterne verso app di terze parti, così puoi ottenere informazioni in tempo reale.

Ecco alcuni esempi in cui gli strumenti possono essere utili:

• Recuperare dati: consenti a un assistente di recuperare dati in tempo reale da qualsiasi database compatibile con REST o integrazione di terze parti prima di rispondere all’utente.
• Eseguire azioni: consenti a un assistente di attivare azioni autenticate in base alla conversazione, come pianificare riunioni o avviare resi di ordini.

Configurazione degli strumenti

Gli agenti ElevenLabs possono essere dotati di strumenti per interagire con API esterne. A differenza delle richieste tradizionali, l’assistente genera dinamicamente i parametri query, body e path in base alla conversazione e alle descrizioni dei parametri che fornisci.

Tutte le configurazioni degli strumenti e le descrizioni dei parametri aiutano l’assistente a stabilire quando e come usare questi strumenti. Per orchestrare efficacemente l’uso degli strumenti, aggiorna il system prompt dell’assistente per specificare la sequenza e la logica di queste chiamate. Ciò include:

• Quale strumento usare e in quali condizioni.
• Quali parametri servono allo strumento per funzionare correttamente.
• Come gestire le risposte.

Guida

In questa guida creeremo un assistente meteo in grado di fornire informazioni meteorologiche in tempo reale per qualsiasi località. L’assistente userà le sue conoscenze geografiche per convertire i nomi delle località in coordinate e recuperare dati meteo accurati.

You are a helpful conversational agent with access to a weather tool. When users ask about
weather conditions, use the get_weather tool to fetch accurate, real-time data. The tool requires
a latitude and longitude - use your geographic knowledge to convert location names to coordinates
accurately.
Never ask users for coordinates - you must determine these yourself. Always report weather
information conversationally, referring to locations by name only. For weather requests:
1. Extract the location from the user's message
2. Convert the location to coordinates and call get_weather
3. Present the information naturally and helpfully
For non-weather queries, provide friendly assistance within your knowledge boundaries. Always be
concise, accurate, and helpful.
First message: "Hey, how can I help you today?"

Metodi di autenticazione supportati

ElevenLabs Agents supporta più metodi di autenticazione per connettere in modo sicuro i tuoi strumenti ad API esterne. I metodi di autenticazione vengono configurati nelle impostazioni dell’agente e poi collegati ai singoli strumenti secondo necessità.

Dopo la configurazione, puoi collegare questi metodi di autenticazione ai tuoi strumenti e gestire gli header personalizzati nella configurazione dello strumento:

Credenziali client OAuth2

Gestisce automaticamente il flusso delle credenziali client OAuth2. Configura con ID client, secret client e URL del token (ad esempio, https://api.example.com/oauth/token). Facoltativamente, specifica gli scope come valori separati da virgole e parametri JSON aggiuntivi. Configura facendo clic su Add Auth in Workspace Auth Connections, nella sezione Agent della pagina delle impostazioni dell’agente.

JWT OAuth2

Usa l’autenticazione JSON Web Token per il flusso OAuth 2.0 JWT Bearer. Richiede il secret di firma JWT, l’URL del token e l’algoritmo (predefinito: HS256). Configura le claim JWT, inclusi emittente, pubblico e soggetto. Facoltativamente, imposta l’ID della chiave, la scadenza (predefinita: 3600 secondi), gli scope e parametri aggiuntivi. Configura facendo clic su Add Auth in Workspace Auth Connections, nella sezione Agent della pagina delle impostazioni dell’agente.

Autenticazione di base

Semplice autenticazione con nome utente e password per API che supportano HTTP Basic Auth. Configura facendo clic su Add Auth in Workspace Auth Connections, nella sezione Agent della pagina delle impostazioni dell’agente.

Token Bearer

Autenticazione basata su token che aggiunge il valore del token bearer all’header della richiesta. Configura aggiungendo un header alla configurazione dello strumento, selezionando Secret come tipo di header e facendo clic su Create New Secret.

Header personalizzati

Aggiungi header di autenticazione personalizzati con qualsiasi nome e valore per metodi di autenticazione proprietari. Configura aggiungendo un header alla configurazione dello strumento e specificandone nome e valore.

Best practice

Assegna agli strumenti nomi intuitivi e descrizioni dettagliate

Se noti che l’assistente non effettua chiamate agli strumenti corretti, potrebbe essere necessario aggiornare i nomi e le descrizioni degli strumenti affinché capisca più chiaramente quando selezionare ciascuno strumento. Evita di usare abbreviazioni o acronimi per accorciare i nomi degli strumenti e degli argomenti.

Puoi anche includere descrizioni dettagliate che indicano quando chiamare uno strumento. Per gli strumenti complessi, includi descrizioni per ciascun argomento, così da aiutare l’assistente a capire cosa deve chiedere all’utente per raccogliere quell’argomento.

Assegna ai parametri degli strumenti nomi intuitivi e descrizioni dettagliate

Usa nomi chiari e descrittivi per i parametri degli strumenti. Se pertinente, specifica nella descrizione il formato previsto per un parametro, ad esempio YYYY-mm-dd o dd/mm/yy per una data.

Valuta di fornire ulteriori informazioni su come e quando chiamare gli strumenti nel prompt di sistema dell’assistente

Fornire istruzioni chiare nel prompt di sistema può migliorare notevolmente la precisione delle chiamate agli strumenti dell’assistente. Ad esempio, guida l’assistente con istruzioni come le seguenti:

Use `check_order_status` when the user inquires about the status of their order, such as 'Where is my order?' or 'Has my order shipped yet?'.

Fornisci contesto per scenari complessi. Ad esempio:

Before scheduling a meeting with `schedule_meeting`, check the user's calendar for availability using check_availability to avoid conflicts.

Selezione dell’LLM

È importante notare che la scelta dell’LLM influisce sul successo delle chiamate di funzione. Alcuni LLM possono avere difficoltà a estrarre dalla conversazione i parametri pertinenti.

Suoni delle chiamate agli strumenti

Puoi configurare un audio ambientale da riprodurre durante l’esecuzione dello strumento per migliorare l’esperienza utente. Scopri di più sui suoni delle chiamate agli strumenti.