Vai alla navigazione

ElevenAgents

  • Accodamento delle chiamate e audio di attesa: Aggiunto l’accodamento delle chiamate per gli agenti al limite di concorrenza. I chiamanti in coda sentono l’audio di attesa e ricevono eventi queue_status finché non vengono ammessi o scade il tempo di attesa. Nuovi metodi API consentono di caricare o eliminare audio di attesa personalizzato.
  • Metadati delle versioni di test: I risultati dei test degli agenti ora identificano la versione dell’agente su cui sono stati eseguiti e se includevano modifiche in bozza. I riepiloghi delle invocation indicano inoltre quando i reinvii parziali sono stati eseguiti su versioni diverse.
  • Metadati di modelli e account: La configurazione LLM degli agenti ora accetta gemini-3.8-flash. Le risposte degli account WhatsApp identificano se l’account usa la Cloud API o il flusso di registrazione in coesistenza.

Musica

  • Supporto API Music v2.5: Gli endpoint e gli SDK Music ora accettano music_v2_5. I chunk di generazione dei piani di composizione supportano fino a 6.132 caratteri, con un massimo di 30 righe da 200 caratteri ciascuna.

Rilasci SDK

SDK JavaScript

  • v2.68.0 - Aggiunti metodi per caricare ed eliminare l’audio di attesa degli agenti. Rigenerati i tipi per l’accodamento delle chiamate, i riferimenti alle procedure, la creazione di rami in bozza, i limiti delle query RAG, i metadati delle versioni di test, gemini-3.8-flash e music_v2_5.

SDK Python

  • v2.68.0 - Aggiunti metodi sincroni e asincroni per caricare ed eliminare l’audio di attesa degli agenti. Rigenerati i tipi per l’accodamento delle chiamate, le procedure, la creazione di rami in bozza, i limiti delle query RAG, i metadati delle versioni di test, gemini-3.8-flash e music_v2_5. Il wrapper compose_detailed ora accetta ogni ID di modello musicale generato e piani di composizione basati sia su prompt sia su chunk.

SDK iOS

  • v3.3.1 - Riconcilia i messaggi degli agenti in base a response_id anziché a event_id, preservando più risposte attorno alle chiamate degli strumenti ed evitando che parti in streaming o correzioni vengano associate al messaggio sbagliato.

CLI ElevenLabs

  • v1.3.0 - Aggiunti metadati facoltativi --intent ai comandi API generati. Aggiunto elevenlabs feedback missing-capability per segnalare workflow non supportati dalla CLI.

Pacchetti

  • @elevenlabs/convai-widget-core@0.18.2 e @elevenlabs/convai-widget-embed@0.18.2 - Corrette le risposte duplicate degli agenti dopo chiamate di strumenti e procedure. Le risposte testuali in streaming mantengono la formattazione Markdown e le conversazioni vocali non visualizzano più parti della chat in streaming non pronunciate. Il pacchetto embed limita inoltre gli eventi user_activity a uno al secondo e rimuove il limite al termine di una sessione.

API

Nuovi endpoint

ElevenAgents

  • Carica audio di attesa dell’agente - POST /v1/convai/agents/{agent_id}/hold-audio
    • Accetta hold_audio_file obbligatorio (binario) come dati del form multipart. Il file deve essere MP3 o WAV, fino a 40 MB e 180 secondi.
    • Restituisce agent_id obbligatorio (stringa) e hold_audio (AgentHoldAudioConfig). L’oggetto hold-audio richiede audio_path, audio_url, original_filename (stringhe), duration_secs (numero) e size_bytes (intero).
  • Elimina audio di attesa dell’agente - DELETE /v1/convai/agents/{agent_id}/hold-audio
    • Rimuove la clip personalizzata, così i chiamanti in coda sentono il tono di attesa predefinito.
    • Restituisce agent_id obbligatorio (stringa).

Endpoint aggiornati

ElevenAgents

  • Crea agente, Ottieni agente e Aggiorna agente
    • Aggiunto platform_settings.queueing_config (AgentQueueingConfig) facoltativo con enabled (booleano, predefinito false) e wait_timeout_seconds (intero, 1–1.800, predefinito 180).
    • Le risposte di configurazione della coda includono hold_audio (AgentHoldAudioConfig) nullable di sola lettura. Le risposte dell’agente includono anche default_hold_audio_url facoltativo (stringa).
  • Ottieni conversazione - GET /v1/convai/conversations/{conversation_id}
    • I metadati aggiungono queue_wait_secs facoltativo e nullable (numero). Il tempo in coda è escluso da call_duration_secs e dal tempo fatturato.
  • Crea ramo dell’agente - POST /v1/convai/agents/{agent_id}/branches
    • Aggiunto include_draft facoltativo (booleano, predefinito false). Quando è true, un ramo creato dalla punta del ramo include il set di procedure in bozza del chiamante.
  • Elenca procedure e gli endpoint per creare, ottenere e gestire le bozze delle procedure
    • Gli elementi dell’elenco aggiungono referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids e referenced_dynamic_variables facoltativi (array di stringhe).
    • Le risposte dell’agente e di anteprima del merge aggiungono procedures facoltativo, una mappa con chiave ID della procedura.
  • Elenca invocation di test - GET /v1/convai/test-invocations
    • Aggiunto search facoltativo e nullable (stringa) per filtrare test e cartelle per nome.
  • Esegui test sull’agente e Ottieni invocation di test
    • Le risposte di invocation della suite di test e di esecuzione dei test unitari aggiungono version_id facoltativo e nullable (stringa) e ran_against_draft facoltativo (booleano, predefinito false).
    • I riepiloghi delle invocation aggiungono anche runs_diverged_from_version facoltativo (booleano, predefinito false).
  • POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query
    • Il body della richiesta aggiunge gli override specifici della query max_documents_length facoltativo e nullable (intero, 1–50.000) e max_retrieved_rag_chunks_count (intero, 1–20).
  • Ottieni account WhatsApp - GET /v1/convai/whatsapp-accounts/{phone_number_id}
    • Aggiunto account_type facoltativo (WhatsAppAccountType, predefinito cloud_api). I valori sono cloud_api e coexistence.
  • Calcola l’utilizzo LLM previsto - POST /v1/convai/agent/{agent_id}/llm-usage/calculate
    • LLMUsageCalculatorLLMResponseModel aggiunge price_per_message obbligatorio (numero).

Musica

  • MusicModelID aggiunge music_v2_5 per POST /v1/music/video-to-music, POST /v1/music/plan, Componi musica, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream, POST /v1/music/upload e POST /v1/music/finetunes.
  • GenerationChunk.text aumenta maxLength da 6.000 a 6.132 caratteri per POST /v1/music/plan, POST /v1/music, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream e POST /v1/music/upload. I nomi delle sezioni possono contenere da 1 a 100 caratteri e i chunk possono contenere fino a 30 righe con 200 caratteri per riga.

Modifiche allo schema

ElevenAgents

  • Gli eventi del server in tempo reale aggiungono queue_status. Il relativo queue_status_event.status obbligatorio accetta waiting, admitted o timed_out; timed_out precede il codice di chiusura WebSocket 4300. L’audio di attesa continua ad arrivare come normali eventi audio.
  • L’enum LLM aggiunge gemini-3.8-flash, inclusi gli override per l’avvio della conversazione.
  • Le union dei risultati degli strumenti di sistema delle conversazioni aggiungono start_procedure_success, start_procedure_error, end_procedure_success e end_procedure_error.
  • FeaturesUsageCommonModel aggiunge gli stati delle funzionalità facoltativi freeform_procedure e structured_procedure.