Registro delle modifiche

Nuovi endpoint

ElevenAgents

• Aggiunti nove endpoint per i ticket di triage delle conversazioni:
  • Crea ticket di conversazione - POST /v1/convai/triage-tickets. La richiesta richiede conversation_id (stringa) e accetta qa_comment (stringa nullable, 1–10.000 caratteri) e fino a 200 commenti sui turni.
  • Elenca ticket - GET /v1/convai/agents/{agent_id}/triage-tickets, con paginazione tramite cursore.
  • Crea ticket manuale - POST /v1/convai/agents/{agent_id}/triage-tickets. La richiesta richiede qa_comment (stringa, 1–10.000 caratteri).
  • Elenca utenti assegnabili - GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users. La risposta elenca i membri del workspace che non sono account di servizio e indica se ciascun membro ha accesso all’agente.
  • Ottieni ticket - GET /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Aggiorna ticket - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. La richiesta accetta status facoltativo e assignee_user_id nullable.
  • Elimina ticket - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Aggiungi commento - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. La richiesta richiede comment (stringa, 1–10.000 caratteri).
  • Aggiungi commento al turno - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. La richiesta richiede turn_index con indice a base zero (intero) e comment (stringa, 1–10.000 caratteri).

Endpoint aggiornati

ElevenAgents

• Ottieni URL firmato - GET /v1/convai/conversation/get-signed-url
  • Aggiunto debug_events_request facoltativo (booleano, valore predefinito false). Gli eventi di debug richiedono l’accesso editor all’agente.
• Ottieni token WebRTC - GET /v1/convai/conversation/token
  • Aggiunto debug_events_request facoltativo (booleano, valore predefinito false). Il percorso legacy GET /v1/convai/conversation/get_signed_url accetta lo stesso parametro.
• Elenca conversazioni - GET /v1/convai/conversations
  • Aggiunto triggered_procedure_ids facoltativo (array di stringhe nullable, massimo 50) per trovare le conversazioni in cui è stata eseguita una qualsiasi procedura specificata.
  • Aggiunto include_invalid_tool_calls facoltativo (booleano, valore predefinito false) per includere le chiamate di strumenti che non sono state eseguite.
  • Aggiunto sort_direction facoltativo (asc o desc, valore predefinito desc) per l’ora di inizio della chiamata.
• Ricerca testuale nei messaggi delle conversazioni - GET /v1/convai/conversations/messages/text-search
  • Aggiunto triggered_procedure_ids facoltativo (array di stringhe nullable, massimo 50).
  • Aggiunto include_invalid_tool_calls facoltativo (booleano, valore predefinito false).
• Ottieni argomenti delle conversazioni dell’agente - GET /v1/convai/agents/{agent_id}/topics
  • Aggiunto include_evaluation_criteria facoltativo (booleano, valore predefinito true).
  • Aggiunto frustration a sort_by.
  • Le risposte degli argomenti aggiungono success_rate nullable (numero), mentre la risposta complessiva aggiunge aggregated_run_count (intero, valore predefinito 0).
  • from_unix_secs viene arrotondato per difetto all’inizio del relativo giorno UTC. Un intervallo delimitato aggrega le esecuzioni di rilevamento giornaliere completate; omettendo entrambi i limiti viene restituita l’esecuzione più recente.
• Elenca procedure (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) e Ottieni procedura (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})
  • Aggiunto agent_version_id facoltativo nullable (stringa) per recuperare procedure da una versione specifica dell’agente.
• Crea test e Aggiorna test
  • Aggiunto environment facoltativo nullable (stringa) agli schemi di test unitari di risposta, simulazione e chiamata di strumento. Il valore seleziona URL, header e connessioni di autenticazione specifici dell’ambiente; il valore predefinito è production.
• Crea documento da URL, Crea job di crawling e Crea cartella
  • Aggiunto minimum_frequency_days facoltativo nullable (intero, 1–180) per la sincronizzazione automatica. Il valore predefinito è 7 e ha la precedenza una frequenza più rigorosa della cartella principale.

Musica

• Elenca Finetune musicali - GET /v1/music/finetunes
  • Aumentato il valore massimo di page_size da 100 a 150. Il valore predefinito rimane 50.

Modifiche allo schema

ElevenAgents

• Le richieste di aggiornamento degli agenti aggiungono procedures facoltativo nullable (object<string, ProcedureVersionRef>). Ogni valore richiede procedure_id e version_id (stringhe). Un oggetto vuoto rimuove tutte le procedure.
• La configurazione di avvio della conversazione aggiunge enable_procedure_ids_from_client (booleano, valore predefinito false). I dati di avvio aggiungono procedure_ids facoltativo nullable (array di stringhe); un array vuoto disabilita tutte le procedure per l’agente iniziale.
• ClientEvent aggiunge context_usage.
• Gli override del soft timeout aggiungono additional_soft_timeout_messages facoltativo nullable (array di stringhe).
• I valori costanti nei modelli di override dell’analisi e dello schema ora accettano null.
• I valori predefiniti della configurazione del widget per mic_muting_enabled e transcript_enabled sono cambiati da false a true. Impostali esplicitamente su false per mantenere il comportamento precedente.

Workspace

• Le risposte di Ottieni utente hanno rimosso xi_api_key da UserResponseModel.
• ResourceMetadataResponseModel.role_to_group_ids ora accetta ID di ruolo personalizzati come chiavi, anziché limitare le chiavi a admin, editor, commenter e viewer.
• Le risposte di pubblicazione diretta aggiungono restricted_to_user_email_domains facoltativo nullable (array di stringhe).
• Le risposte al cambio di abbonamento in attesa aggiungono go a next_tier.