ElevenLabs CLI
De ElevenLabs CLI v1.0.0 is nu beschikbaar. Elke ElevenLabs API-bewerking is beschikbaar als subcommand, met uitvoer in JSON, tabel-, YAML- en CSV-indeling, automatische paginering en shell completion.
De CLI biedt ook lokale configuratieworkflows voor ElevenAgents. Sla configuraties voor agents, tools en tests op als bestanden, synchroniseer ze met push- en pull-commands, beheer branches, voer tests uit, installeer ElevenLabs UI-componenten en selecteer een dataresidencyregio.
Procedures
Procedures zijn nu algemeen beschikbaar in ElevenAgents. Een procedure bevat taakspecifieke instructies en een trigger die bepaalt wanneer deze van toepassing zijn. Tijdens een gesprek laadt de agent de relevante procedure, waardoor één agent verschillende taken kan uitvoeren zonder elke instructie in de systeemprompt te plaatsen.
Gebruik vrije procedures wanneer de agent de formulering of volgorde van instructies kan aanpassen. Gebruik gestructureerde procedures wanneer stappen in een vaste volgorde moeten worden uitgevoerd. Beide typen kunnen naast workflows op dezelfde agent worden gebruikt.
ElevenAgents
- Tickets voor gesprekstriage: API’s toegevoegd voor het maken van tickets over agentprestaties, het maken van handmatige opvolgtickets, het weergeven van tickets, het toewijzen van workspaceleden, het bijwerken van status en toegewezene, en het toevoegen van opmerkingen op ticket- of turnniveau.
- Gespreksobservatie: Realtime clients kunnen na elke voltooide agentturn een
context_usage-event ontvangen. Het event rapporteert het model, het aantal prompttokens en de contextlimiet van het model.
SDK-releases
JavaScript SDK
- v2.65.0 - Clients en typen toegevoegd voor tickets voor gesprekstriage en beknopte gesprekssamenvattingen. Gespreks-API’s voegen filters voor procedure, ongeldige tool calls en sortering toe; procedure-API’s voegen selectie van agentversie toe; topic-API’s voegen instellingen voor evaluatiedetails en sortering op frustratie toe. De release voegt ook velden toe voor vernieuwingsfrequentie van de kennisbank, testomgeving en alertingintegratie, plus berichttypen voor realtime Dubbing.
Python SDK
- v2.65.0 - Clients en typen toegevoegd voor tickets voor gesprekstriage en beknopte gesprekssamenvattingen. Gespreks-API’s voegen filters voor procedure, ongeldige tool calls en sortering toe; procedure-API’s voegen selectie van agentversie toe; topic-API’s voegen instellingen voor evaluatiedetails en sortering op frustratie toe. De release voegt ook velden toe voor vernieuwingsfrequentie van de kennisbank, testomgeving en alertingintegratie, en behoudt herhaalde multipartvelden voor Speech to Text
keytermsen Dubbingwebhook_ids.
Swift SDK
- v3.3.0 - Getypeerde parsing van clientfouten, verwerking van
expects_responseen typeveilige toolresultaten toegevoegd. Het opstarten van WebRTC is nu gereed wanneer de agent deelneemt, in plaats van te wachten op een audiotrackabonnement. De release maakt URL-verwerking robuuster, onderdrukt ruis van onbekende events en verwijdert allocatie van realtime-threads uit de verwerking van softwarematig dempen.
Packages
- @elevenlabs/client@1.19.1, @elevenlabs/react@1.12.3, @elevenlabs/react-native@1.2.21, @elevenlabs/convai-widget-core@0.16.2 en @elevenlabs/convai-widget-embed@0.16.2 - WebRTC-uitvoercapture gebruikt nu zelfgehoste AudioWorklet-paden onder strikte content security policies. Workletcaching omvat de aangevraagde bron, waardoor een eerdere inline-URL een zelfgehost pad niet kan vervangen. Installatiefouten van React Native verwijzen nu naar
@elevenlabs/react-native. - @elevenlabs/client@1.20.0, @elevenlabs/react@1.12.4, @elevenlabs/react-native@1.2.22, @elevenlabs/convai-widget-core@0.16.3 en @elevenlabs/convai-widget-embed@0.16.3 - Optionele
webRtc.iceTransportPolicytoegevoegd. Stel deze in oprelayom WebRTC ICE-kandidaten te beperken tot TURN-relays op netwerken die direct UDP-verkeer blokkeren. - @elevenlabs/client@1.21.0, @elevenlabs/react@1.13.0, @elevenlabs/types@0.21.1, @elevenlabs/react-native@1.2.23, @elevenlabs/convai-widget-core@0.16.4 en @elevenlabs/convai-widget-embed@0.16.4 - De callback
onContextUsageen het typeContextUsageEventtoegevoegd. React biedt de callback viauseConversation. React Native wordt nu opgelost via de exportconditie van het package in plaats van detectie van browserglobals. - @elevenlabs/client@1.22.0, @elevenlabs/react@1.14.0, @elevenlabs/types@0.22.0, @elevenlabs/react-native@1.2.24, @elevenlabs/convai-widget-core@0.17.0 en @elevenlabs/convai-widget-embed@0.17.0 - Rich content voor het eerste bericht toegevoegd met toegeschreven knopreacties,
onExternalAgentDisconnectedenonMCPToolApprovalRequest. WebRTC gebruikt nu het geselecteerde invoerapparaat, behoudt de dempstatus bij het wisselen van microfoon en laat de installatie mislukken als initiatiegegevens niet kunnen worden verzonden. De widget voegt status van de concurrencywachtrij toe, optionele taalselectie bij de ingeklapte trigger en rendering van het eerste bericht voor agents die zowel tekst als spraak ondersteunen.
API
API-wijzigingen bekijken
Nieuwe endpoints
ElevenAgents
- Negen endpoints voor tickets voor gesprekstriage toegevoegd:
- Gespreksticket maken -
POST /v1/convai/triage-tickets. De request vereistconversation_id(string) en accepteertqa_comment(nullable string, 1–10.000 tekens) en maximaal 200 turnopmerkingen. - Tickets weergeven -
GET /v1/convai/agents/{agent_id}/triage-tickets, met cursorpaginering. - Handmatig ticket maken -
POST /v1/convai/agents/{agent_id}/triage-tickets. De request vereistqa_comment(string, 1–10.000 tekens). - Toewijsbare gebruikers weergeven -
GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users. De response geeft workspaceleden zonder serviceaccount weer en of elk lid toegang heeft tot de agent. - Ticket ophalen -
GET /v1/convai/triage-tickets/{agentqa_ticket_id}. - Ticket bijwerken -
PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. De request accepteert optionelestatusen nullableassignee_user_id. - Ticket verwijderen -
DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}. - Opmerking toevoegen -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. De request vereistcomment(string, 1–10.000 tekens). - Turnopmerking toevoegen -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. De request vereist een op nul gebaseerdeturn_index(integer) encomment(string, 1–10.000 tekens).
- Gespreksticket maken -
Bijgewerkte endpoints
ElevenAgents
- Ondertekende URL ophalen -
GET /v1/convai/conversation/get-signed-url- Optionele
debug_events_requesttoegevoegd (boolean, standaardfalse). Debug-events vereisen editortoegang tot de agent.
- Optionele
- WebRTC-token ophalen -
GET /v1/convai/conversation/token- Optionele
debug_events_requesttoegevoegd (boolean, standaardfalse). De verouderde routeGET /v1/convai/conversation/get_signed_urlaccepteert dezelfde parameter.
- Optionele
- Gesprekken weergeven -
GET /v1/convai/conversations- Optionele
triggered_procedure_idstoegevoegd (nullable stringarray, maximaal 50) om gesprekken te matchen waarin een opgegeven procedure is uitgevoerd. - Optionele
include_invalid_tool_callstoegevoegd (boolean, standaardfalse) om tool calls op te nemen die niet zijn uitgevoerd. - Optionele
sort_directiontoegevoegd (ascofdesc, standaarddesc) voor de starttijd van het gesprek.
- Optionele
- Gespreksberichten doorzoeken op tekst -
GET /v1/convai/conversations/messages/text-search- Optionele
triggered_procedure_idstoegevoegd (nullable stringarray, maximaal 50). - Optionele
include_invalid_tool_callstoegevoegd (boolean, standaardfalse).
- Optionele
- Gesprekstopics van agent ophalen -
GET /v1/convai/agents/{agent_id}/topics- Optionele
include_evaluation_criteriatoegevoegd (boolean, standaardtrue). frustrationtoegevoegd aansort_by.- Topicresponses voegen nullable
success_rate(number) toe, terwijl de volledige responseaggregated_run_counttoevoegt (integer, standaard0). from_unix_secswordt naar beneden afgerond op het begin van de UTC-dag. Een begrensd bereik aggregeert voltooide dagelijkse discoverysessies; als beide grenzen worden weggelaten, wordt de meest recente sessie geretourneerd.
- Optionele
- Procedures weergeven (
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) en Procedure ophalen (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})- Optionele nullable
agent_version_id(string) toegevoegd om procedures van een specifieke agentversie op te halen.
- Optionele nullable
- Test maken en Test bijwerken
- Optionele nullable
environment(string) toegevoegd aan schema’s voor response-, simulatie- en tool-call-unittests. De waarde selecteert omgevingsspecifieke URL’s, headers en authverbindingen; standaard is ditproduction.
- Optionele nullable
- URL-document maken, Crawljob maken en Map maken
- Optionele nullable
minimum_frequency_daystoegevoegd (integer, 1–180) voor automatische synchronisatie. De standaardwaarde is7en een strengere frequentie van een bovenliggende map heeft voorrang.
- Optionele nullable
Muziek
- Music Finetunes weergeven -
GET /v1/music/finetunes- De maximale
page_sizeverhoogd van 100 naar 150. De standaardwaarde blijft 50.
- De maximale
Schemawijzigingen
ElevenAgents
- Requests voor het bijwerken van agents voegen optionele nullable
procedurestoe (object<string, ProcedureVersionRef>). Elke waarde vereistprocedure_idenversion_id(strings). Een leeg object verwijdert alle procedures. - De configuratie voor gespreksinitiatie voegt
enable_procedure_ids_from_clienttoe (boolean, standaardfalse). Initiatiegegevens voegen optionele nullableprocedure_idstoe (stringarray); een lege array schakelt alle procedures voor de startende agent uit. ClientEventvoegtcontext_usagetoe.- Overschrijvingen voor soft time-outs voegen optionele nullable
additional_soft_timeout_messagestoe (stringarray). - Constante waarden in modellen voor analyse- en schemaoverschrijvingen accepteren nu
null. - De standaardwaarden voor widgetconfiguratie van
mic_muting_enabledentranscript_enabledzijn gewijzigd vanfalsenaartrue. Stel ze expliciet in opfalseom het eerdere gedrag te behouden.
Workspace
- Responses van Gebruiker ophalen hebben
xi_api_keyverwijderd uitUserResponseModel. ResourceMetadataResponseModel.role_to_group_idsaccepteert nu aangepaste rol-ID’s als keys, in plaats van keys te beperken totadmin,editor,commenterenviewer.- Responses voor direct publiceren voegen optionele nullable
restricted_to_user_email_domainstoe (stringarray). - Responses voor een in behandeling zijnde abonnementswissel voegen
gotoe aannext_tier.