Vai alla navigazione

ElevenAgents

  • Log SIP: i log di segnalazione SIP sono ora disponibili per le chiamate su trunk SIP nella cronologia delle conversazioni e nelle impostazioni dei numeri di telefono. I log includono l’ID della chiamata SIP, numeri di telefono, indirizzi, trasporto, direzione dei messaggi, messaggi non elaborati ed errori per aiutarti a eseguire il debug dei problemi di configurazione e instradamento delle chiamate.
  • Aggiornamenti dei documenti della knowledge base: nuova API per elencare i chunk indicizzati (RAG) di un documento. I documenti possono anche essere modificati sul posto: puoi rinominare l’elemento e, per i documenti basati su testo, aggiornare il body senza ricaricare il file. (I documenti basati su file usano ancora il flusso esistente di sostituzione del file, quando applicabile.)
  • Metadati delle conversazioni SMS: aggiunto il supporto SMS ai metadati delle conversazioni con SMSConversationInfo, sms come metodo di autorizzazione e twilio_sms come origine di avvio della conversazione.
  • Aggiornamenti della configurazione dell’agente: aggiunti gli schemi di configurazione della musica di sottofondo, la configurazione del monitoraggio degli avvisi, i campi di layout 2D, la configurazione di caricamento file del widget e le nuove opzioni LLM gpt-5.4-mini, gpt-5.4-nano, gpt-5.4-mini-2026-03-17 e gpt-5.4-nano-2026-03-17.

Workspace

  • Analisi delle richieste API: aggiunto un endpoint di analisi del workspace per interrogare le richieste API con controlli per intervallo di tempo, filtri, ricerca, ordinamento e limite.
  • Allowlist IP per le chiavi API: aggiunto allowed_ips agli schemi di creazione, modifica e risposta delle chiavi API degli account di servizio. Le richieste di creazione accettano un array di indirizzi IP o intervalli CIDR, oppure null per consentire tutti gli IP. Le richieste di modifica accettano anche clear e no_update.
  • Autorizzazioni del workspace: aggiunti conversational_ai_read e voice_design alle autorizzazioni dei gruppi del workspace.

Progettazione della voce

  • Migrazione dell’anteprima vocale: deprecato POST /v1/text-to-voice/create-previews. Usa Progetta una voce per creare anteprime, quindi usa il valore generated_voice_id restituito quando crei una voce.

Modificatore di Voce

  • Formati di output WAV: aggiunti wav_8000, wav_16000, wav_22050, wav_24000, wav_32000, wav_44100 e wav_48000 al parametro query output_format nella conversione da parlato a parlato.

Rilasci SDK

SDK Python

  • v2.47.0 - SDK rigenerato per lo schema API del 12 maggio 2026. Il rilascio aggiunge supporto tipizzato per l’elenco dei chunk RAG, gli aggiornamenti dei documenti file, l’analisi delle richieste API del workspace, l’allowlist IP per le chiavi API degli account di servizio, i campi di configurazione dell’agente per i numeri di telefono, gli header delle richieste webhook, la moderazione dei metadati vocali, le nuove opzioni LLM e i formati di output aggiornati per la conversione da parlato a parlato.

SDK JavaScript

  • v2.47.0 - SDK rigenerato per lo schema API del 12 maggio 2026. Il rilascio aggiunge supporto tipizzato per l’elenco dei chunk RAG, gli aggiornamenti dei documenti file, l’analisi delle richieste API del workspace, l’allowlist IP per le chiavi API degli account di servizio, i campi di configurazione dell’agente per i numeri di telefono, gli header delle richieste webhook, la moderazione dei metadati vocali, le nuove opzioni LLM e i formati di output aggiornati per la conversione da parlato a parlato.

Pacchetti

API

Nuovi endpoint

ElevenAgents

  • Ottieni i messaggi SIP per una conversazione - GET /v1/convai/conversations/{conversation_id}/sip-messages
    • Aggiunto il parametro path obbligatorio conversation_id (stringa)
    • Aggiunti i parametri query facoltativi page_size (intero, predefinito 20) e cursor
    • Restituisce GetSIPLogMessagesResponse con sip_messages, next_cursor nullable e has_more
  • Ottieni i messaggi SIP per un numero di telefono - GET /v1/convai/phone-numbers/{phone_number_id}/sip-messages
    • Aggiunto il parametro path obbligatorio phone_number_id (stringa)
    • Aggiunti i parametri query facoltativi page_size (intero, predefinito 20) e cursor
    • Restituisce GetSIPLogMessagesResponse
  • Ottieni i chunk RAG per un documento - GET /v1/convai/knowledge-base/{documentation_id}/chunks
    • Aggiunto il parametro path obbligatorio documentation_id (stringa)
    • Aggiunto il parametro query obbligatorio embedding_model
    • Aggiunti i parametri query facoltativi page_size (intero, predefinito 30) e cursor
    • Restituisce KnowledgeBaseDocumentChunksResponseModel con chunks e next_cursor nullable
  • Aggiorna il file del documento - PATCH /v1/convai/knowledge-base/{documentation_id}/update-file
    • Aggiunto il parametro path obbligatorio documentation_id (stringa)
    • Aggiunto un body del form multipart con file obbligatorio (stringa, binario)
    • Restituisce il modello del documento della knowledge base aggiornato

Workspace

  • POST /v1/workspace/analytics/requests
    • Aggiunto body della richiesta con start_time, end_time, limit (intero, predefinito 100, massimo 1000), sort, filters e search facoltativi
    • Restituisce WorkspaceAnalyticsQueryResponseModel con columns, column_types, rows e column_units

Endpoint e schemi aggiornati

ElevenAgents

  • Aggiorna documento della knowledge base - PATCH /v1/convai/knowledge-base/{documentation_id}
    • Aggiunti i campi del body della richiesta JSON name (stringa nullable facoltativa) e content (stringa nullable facoltativa)
  • Crea agente - POST /v1/convai/agents/create
    • Modificato il valore predefinito di enable_versioning da false a true
  • Aggiorna agente - PATCH /v1/convai/agents/{agent_id}
    • Modificato il valore predefinito di enable_versioning_if_not_enabled da false a true
  • Aggiorna numero di telefono - PATCH /v1/convai/phone-numbers/{phone_number_id}
    • Aggiunti environment e branch_id alla configurazione dell’agente del numero di telefono
    • store_sip_messages ora ha come valore predefinito true
  • Ottieni widget - GET /v1/convai/agents/{agent_id}/widget
    • Aggiunto file_input_config per i caricamenti di file del widget
  • Enumerazione LLM
    • Aggiunti gpt-5.4-mini, gpt-5.4-nano, gpt-5.4-mini-2026-03-17 e gpt-5.4-nano-2026-03-17
  • Enumerazione AuthorizationMethod
    • Aggiunto sms
  • Enumerazione ConversationInitiationSource
    • Aggiunto twilio_sms
  • AgentTopicResponseModel
    • Aggiunti parent_topic_id, x_2d e y_2d nullable facoltativi
  • BackgroundMusicConfig e BackgroundMusicConfigWorkflowOverride
    • Aggiunti source_type, source_id, volume e crossfade_loop
    • Aggiunti i valori dell’enumerazione BackgroundMusicPresetId city, elevator1, elevator2, elevator3, elevator4, office1, office2, restaurant e typing
  • AgentPlatformSettingsResponseModel
    • Aggiunto alerting con i valori dell’enumerazione Monitor elevated_conversation_failure_rate e elevated_tool_failure_rate
  • Enumerazione ProcedureCompilerMode
    • Rimosso deterministic

Workspace

  • Schemi di creazione e modifica della chiave API dell’account di servizio
    • Aggiunto allowed_ips come array facoltativo di indirizzi IP o intervalli CIDR, con da 1 a 100 voci
    • Le richieste di creazione possono passare null per consentire tutti gli IP
    • Le richieste di modifica possono passare clear o no_update; il valore predefinito è no_update
  • WorkspaceApiKeyResponseModel
    • Aggiunto allowed_ips nullable
  • Enumerazione WorkspaceGroupPermission
    • Aggiunti conversational_ai_read e voice_design
  • Schemi di connessione per l’autenticazione
    • Aggiunto ApiIntegrationOAuth2CustomAppResponse per le connessioni ad app OAuth2 personalizzate di proprietà dell’utente

Progettazione della voce

Modificatore di Voce

  • Converti parlato in parlato - POST /v1/speech-to-speech/{voice_id}
    • Aggiunti wav_8000, wav_16000, wav_22050, wav_24000, wav_32000, wav_44100 e wav_48000 all’enumerazione output_format
    • Aggiornata la descrizione per indicare che i formati PCM e WAV a 44,1 kHz richiedono il piano Pro o superiore