Guida rapida
In questa guida imparerai a creare il tuo primo agente conversazionale. Sarà la base per creare workflow conversazionali su misura per i casi d’uso della tua azienda. Lascia che il tuo coding agent lo configuri oppure segui manualmente i passaggi qui sotto.
Configura con il tuo coding agent
Non ti servono né un account né una chiave API prima di iniziare. Incolla questo nel tuo coding agent:
La CLI di ElevenLabs fa il resto e indica ogni passaggio al tuo coding agent. Il browser si apre una volta per consentirti di accedere o creare un account e fare clic su Authorize. La chiave viene salvata nel file env del progetto (.env.local oppure .env in un progetto Python) e mantenuta fuori da git; non viene mai mostrata nella chat. Quando il coding agent ti chiede cosa vuoi creare, descrivi l’agente che desideri: cosa deve fare e dove le persone potranno parlarci, ad esempio in un widget sul tuo sito web o con un pulsante vocale nella tua app. Il coding agent lo crea, lo aggiunge alla tua app e ti fornisce un link per provarlo.
Se il tuo coding agent viene eseguito in un ambiente raggiungibile dal browser, ad esempio su una macchina remota tramite SSH
o in una sandbox cloud, la CLI ti chiede di creare una
chiave e di incollarla nel file env,
quindi continua. Il comando richiede Node.js per npx. Se non lo hai,
installa la CLI di ElevenLabs con Homebrew (macOS
e Linux) o Scoop (Windows), oppure aggiornala se è già installata (brew upgrade elevenlabs,
scoop update elevenlabs), e chiedi al tuo coding agent di eseguire invece elevenlabs onboard init.
Per conservare nel tuo coding agent la skill per gli agenti ElevenLabs per lavorare in seguito sui tuoi agenti, installala:
Per creare agenti da Claude, ChatGPT o un altro client MCP, connettiti invece al server MCP ospitato.
Per iniziare
Gli agenti ElevenLabs possono essere gestiti dalla dashboard di ElevenAgents, dall’API di ElevenLabs, dalla CLI Agents o dal server MCP ospitato.

Creare il tuo primo agente
In questa guida rapida inizieremo creando un agente tramite l’API o la dashboard web. Successivamente testeremo l’agente, incorporandolo nel tuo sito web o tramite la dashboard di ElevenLabs.
Crea un agente tramite la dashboard web
Crea un agente tramite la CLI
Crea un agente tramite l'API
In questa guida creeremo un assistente conversazionale per il supporto, in grado di rispondere a domande sul tuo prodotto, sulla documentazione o sul servizio. Puoi incorporare questo assistente nel tuo sito web o nella tua app per offrire supporto in tempo reale ai clienti.

Crea un nuovo assistente
Nella Dashboard di ElevenLabs, crea un nuovo assistente inserendo un nome e selezionando l’opzione Blank template.

Configura il comportamento dell'assistente
Vai alla scheda Agent per configurare il comportamento dell’assistente. Imposta quanto segue:
Aggiungi una knowledge base
Vai alla sezione Knowledge Base per fornire all’assistente il contesto sulla tua azienda.
Qui puoi caricare documenti pertinenti e link a risorse esterne:
- Includi documentazione, FAQ e altre risorse per aiutare l’assistente a rispondere alle richieste dei clienti.
- Mantieni aggiornata la knowledge base per assicurarti che l’assistente fornisca informazioni corrette e aggiornate.
Ora configureremo la voce del tuo assistente.
Seleziona una voce
Nella scheda Voice, scegli dalla libreria vocale la voce più adatta al tuo assistente:

Configura i criteri di valutazione e la raccolta dati per analizzare le conversazioni e migliorare le prestazioni dell’assistente.
Configura i criteri di valutazione
Vai alla scheda Analysis nelle impostazioni dell’assistente per definire criteri personalizzati per valutare le conversazioni.

Ogni trascrizione della conversazione viene passata all’LLM per verificare se sono stati raggiunti obiettivi specifici. I risultati saranno success, failure o unknown, accompagnati da una motivazione che spiega il risultato scelto.
Aggiungiamo un criterio di valutazione con il nome solved_user_inquiry:
Configura la raccolta dati
Nella sezione Data collection, configura i dettagli da estrarre da ogni conversazione.
Fai clic su Add item e configura quanto segue:
- Tipo di dati: seleziona “string”
- Identificatore: inserisci un identificatore univoco per questo dato:
user_question - Descrizione: fornisci all’LLM istruzioni dettagliate su come estrarre i dati specifici dalla trascrizione:
L’agente appena creato può essere testato in vari modi, ma il più rapido è usare la dashboard di ElevenLabs.
La dashboard web utilizza internamente il nostro SDK React per gestire le conversazioni in tempo reale.
Se invece vuoi testare rapidamente l’agente sul tuo sito web, puoi usare il widget Agent. Incolla semplicemente il seguente snippet HTML nel tuo sito web, sostituendo agent-id con l’ID del tuo agente.
Passaggi successivi
Dopo questa guida rapida, puoi rendere il tuo agente più efficace integrando:
- Knowledge base per fornirgli informazioni specifiche del dominio.
- Strumenti per consentirgli di eseguire attività per tuo conto.
- Autenticazione per limitare l’accesso a determinate conversazioni.
- Valutazione del successo per analizzare le conversazioni e migliorarne le prestazioni.
- Raccolta dati per raccogliere dati sulle conversazioni e migliorarne le prestazioni.
- Conservazione delle conversazioni per visualizzare la cronologia delle conversazioni e migliorarne le prestazioni.
