Vai alla navigazione

ElevenAgents

  • Override di branch e ambiente per WhatsApp: i messaggi WhatsApp in uscita e le chiamate in uscita ora rispettano branch_id e environment passati in conversation_initiation_client_data. Gli override vengono convalidati prima di inviare qualsiasi cosa: un branch o ambiente sconosciuto viene rifiutato con un errore e gli override persistono per tutta la conversazione, quindi la risposta di un cliente riprende nel branch e nell’ambiente richiesti. Consulta la guida a WhatsApp per alcuni esempi.
  • API delle procedure: aggiunte otto operazioni pubbliche con ambito di branch per gestire le procedure. Puoi creare, elencare, recuperare e rimuovere procedure; creare, recuperare o scartare modifiche in bozza; e compilare bozze di procedure in un workflow dell’agente. La creazione di procedure accetta name, content, type e trigger. Un trigger vuoto crea una sottoprocedura, mentre un trigger omesso o null viene derivato dal contenuto della procedura.
  • Job di crawl della knowledge base: aggiunte API per creare, elencare, ispezionare e annullare job di crawl. Le richieste di creazione richiedono url (stringa) e supportano profondità di crawl, limiti di pagine, pattern URL, URL delle sitemap, inserimento in cartelle, sincronizzazione automatica e rimozione dei documenti non disponibili.
  • Gestione in blocco della knowledge base: aggiunti controlli delle dipendenze in blocco e eliminazione in blocco per 1–20 ID univoci di documenti o cartelle. I controlli delle dipendenze supportano la paginazione e dependent_type; l’eliminazione restituisce un risultato di successo o errore indipendente per ogni ID. Impostando force: true rimuovi anche le dipendenze ed elimini ricorsivamente le cartelle non vuote.
  • Esportazione dei risultati delle chiamate batch: aggiunto Esporta risultati delle chiamate batch per scaricare come CSV i destinatari e i risultati delle conversazioni di un batch terminato.
  • Filtri delle conversazioni e dati di analisi: Elenca conversazioni e Ricerca testuale nei messaggi delle conversazioni aggiungono i filtri facoltativi con array visited_agent_ids e visited_agent_branch_ids, ciascuno limitato a 50 valori. Le richieste di elenco accettano anche data_collection_ids e evaluation_criteria_ids per includere i risultati corrispondenti in ogni riepilogo della conversazione. I riepiloghi aggiungono data_collection_results, evaluation_criteria_results e tag_ids facoltativi.
  • Configurazione dell’analisi referenziata: le impostazioni della piattaforma dell’agente aggiungono il campo facoltativo e nullable analysis_items, di tipo AgentAnalysisItems, per collegare elementi di valutazione e raccolta dati per riferimento. Un valore null indica che l’agente utilizza ancora i campi inline legacy; un valore vuoto indica un agente migrato senza elementi collegati.
  • Metadati delle dipendenze delle procedure: i riferimenti alle procedure aggiungono trigger (stringa) e array per referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids e referenced_dynamic_variables.
  • Risposta del token WebRTC: le risposte di Ottieni token WebRTC ora richiedono conversation_id (stringa) oltre a token. Si tratta di una modifica incompatibile dello schema per i client che convalidano o deserializzano la struttura della risposta.
  • Risultati RAG della knowledge base: KnowledgeBaseRagToolResultModel aggiunge chunks (KnowledgeBaseRagChunkModel[]) per la modalità risultato RAG nel risultato dello strumento.

Studio

  • Stato del progetto in bozza: ProjectCreationMetaResponseModel.status aggiunge draft. Il tipo di creazione del progetto ora utilizza l’enum condiviso ProjectCreationMetaType con gli stessi valori esistenti.

Voci

  • Accenti vocali: aggiunto GET /v1/voices/accents per elencare gli accenti disponibili nella libreria vocale condivisa. I risultati possono essere filtrati in base a language e model_id, e ogni accento restituisce accent, language, code e name leggibile. Il valore accent può essere passato al parametro query accent in Ottieni voci condivise per filtrare le voci condivise.

Workspace

  • Report sull’utilizzo dei webhook: WebhookUsageType aggiunge Flows.

Rilasci SDK

SDK JavaScript

  • v2.60.0 - Aggiunto voices.accents.get per elencare gli accenti vocali nella libreria vocale condivisa, insieme alle API per procedure di ElevenAgents, job di crawl della knowledge base e gestione in blocco, nonché alla configurazione dell’analisi referenziata dello schema più recente.

SDK Python

  • v2.60.0 - Aggiunte le API per accenti vocali, procedure di ElevenAgents, job di crawl della knowledge base e gestione in blocco dello schema più recente. Corretto anche l’avvio di AsyncConversation, che non blocca più, e i campi multipart con elenchi di primitive, che ora vengono inviati come campi del form ripetuti.

Pacchetti

API

Nuovi endpoint

ElevenAgents

  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Crea una procedura e restituisce il relativo procedure_id (stringa)
    • Accetta name facoltativo (stringa, massimo 200 caratteri), content (stringa), type (ProcedureType, predefinito free_form) e trigger (stringa nullable)
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Elenca le procedure del branch con procedure_id, version_id, name, type, trigger e has_draft
    • Esclude il contenuto delle procedure; recupera una singola procedura per leggerne il contenuto
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Accetta version_id facoltativo (stringa); altrimenti restituisce la versione alla testa del branch
    • Restituisce name, content, type e trigger
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Rimuove la procedura dal set di lavoro in bozza del branch
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Restituisce la bozza corrente della procedura
  • PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Crea o aggiorna una bozza
    • Richiede name (stringa, massimo 200 caratteri), content (stringa, massimo 50.000 caratteri) e type (ProcedureType); accetta trigger facoltativo (stringa nullable)
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Scarta le modifiche alla bozza e ripristina la procedura alla versione salvata
  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
    • Compila le bozze delle procedure in un AgentWorkflowResponseModel
  • Crea job di crawl - POST /v1/convai/knowledge-base/crawl
    • Richiede url (stringa)
    • Accetta max_depth facoltativo (intero, 1–5, predefinito 3), max_pages (intero, 1–10.000, predefinito 1000), pattern (stringa), sitemap_urls (array di stringhe), parent_folder_id (stringa), enable_auto_sync (booleano, predefinito false) e auto_remove (booleano, predefinito false)
  • Elenca job di crawl - GET /v1/convai/knowledge-base/crawl
    • Accetta include_job_ids facoltativo (array di stringhe), page_size (intero, 1–100, predefinito 30) e cursor (stringa)
  • Ottieni job di crawl - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
  • Annulla job di crawl - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
  • Ottieni agenti dipendenti per più documenti - POST /v1/convai/knowledge-base/dependent-agents
    • Richiede document_ids (array di 1–20 stringhe univoche)
    • Accetta dependent_type facoltativo (KnowledgeBaseDependentType, predefinito all), page_size (intero, 1–100, predefinito 30) e cursor (stringa)
  • Elimina in blocco documenti della knowledge base - POST /v1/convai/knowledge-base/bulk-delete
    • Richiede document_ids (array di 1–20 stringhe univoche)
    • Accetta force facoltativo (booleano, predefinito false)
    • Restituisce un risultato di successo o errore per ogni ID documento
  • Esporta risultati delle chiamate batch - GET /v1/convai/batch-calling/{batch_id}/export
    • Restituisce come CSV i destinatari e i risultati delle conversazioni del batch terminato

Voci

  • GET /v1/voices/accents
    • Elenca gli accenti disponibili nella libreria vocale condivisa
    • Accetta parametri query facoltativi language (stringa) e model_id (stringa)
    • Ogni accento restituisce accent, language, code e name

Endpoint aggiornati

ElevenAgents

  • Elenca conversazioni - GET /v1/convai/conversations
    • Aggiunti i filtri facoltativi con array di stringhe visited_agent_ids e visited_agent_branch_ids, ciascuno limitato a 50 valori
    • Aggiunti gli array di stringhe facoltativi data_collection_ids e evaluation_criteria_ids per selezionare i risultati di analisi per ogni riepilogo
    • I riepiloghi delle risposte aggiungono i campi oggetto facoltativi data_collection_results e evaluation_criteria_results, oltre all’array di stringhe tag_ids
  • Ricerca testuale nei messaggi delle conversazioni - GET /v1/convai/conversations/messages/text-search
    • Aggiunti i filtri facoltativi con array di stringhe visited_agent_ids e visited_agent_branch_ids, ciascuno limitato a 50 valori
  • Ottieni token WebRTC - GET /v1/convai/conversation/token
    • Le risposte ora richiedono conversation_id (stringa)
    • Modifica incompatibile: i validatori e deserializzatori di risposta rigorosi devono accettare il nuovo campo obbligatorio

Modifiche allo schema

ElevenAgents

  • Le impostazioni di richiesta e risposta della piattaforma dell’agente aggiungono il campo facoltativo e nullable analysis_items, di tipo AgentAnalysisItems, per la configurazione di valutazione e raccolta dati referenziata
  • I riferimenti alle procedure aggiungono trigger (stringa), referenced_tool_ids (array di stringhe), referenced_kb_ids (array di stringhe), referenced_procedure_ids (array di stringhe) e referenced_dynamic_variables (array di stringhe)
  • KnowledgeBaseRagToolResultModel aggiunge chunks (KnowledgeBaseRagChunkModel[])

Studio

  • ProjectCreationMetaResponseModel.status aggiunge draft
  • ProjectCreationMetaResponseModel.type ora fa riferimento all’enum condiviso ProjectCreationMetaType

Workspace

  • WebhookUsageType aggiunge Flows