> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### ElevenLabs CLI
De [ElevenLabs CLI v1.0.0](https://github.com/elevenlabs/cli/releases/tag/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.
Installeer de CLI, verifieer je identiteit en beheer agents als code.
### 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.
Lees wanneer je procedures gebruikt en hoe ze zich verhouden tot prompts en workflows.
Schrijf instructies in natuurlijke taal die de agent kan aanpassen aan het gesprek.
Definieer getypeerde stappen die de agent in een consistente volgorde volgt.
### 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](https://github.com/elevenlabs/elevenlabs-js/releases/tag/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](https://github.com/elevenlabs/elevenlabs-python/releases/tag/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 `keyterms` en Dubbing `webhook_ids`.
#### Swift SDK
- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Getypeerde parsing van clientfouten, verwerking van `expects_response` en 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](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) en [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.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](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) en [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Optionele `webRtc.iceTransportPolicy` toegevoegd. Stel deze in op `relay` om WebRTC ICE-kandidaten te beperken tot TURN-relays op netwerken die direct UDP-verkeer blokkeren.
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) en [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - De callback `onContextUsage` en het type `ContextUsageEvent` toegevoegd. React biedt de callback via `useConversation`. React Native wordt nu opgelost via de exportconditie van het package in plaats van detectie van browserglobals.
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) en [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Rich content voor het eerste bericht toegevoegd met toegeschreven knopreacties, `onExternalAgentDisconnected` en `onMCPToolApprovalRequest`. 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
## Nieuwe endpoints
### ElevenAgents
- Negen endpoints voor tickets voor gesprekstriage toegevoegd:
- [Gespreksticket maken](/docs/nl/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. De request vereist `conversation_id` (string) en accepteert `qa_comment` (nullable string, 1–10.000 tekens) en maximaal 200 turnopmerkingen.
- [Tickets weergeven](/docs/nl/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, met cursorpaginering.
- [Handmatig ticket maken](/docs/nl/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. De request vereist `qa_comment` (string, 1–10.000 tekens).
- [Toewijsbare gebruikers weergeven](/docs/nl/api-reference/triage-tickets/get-assignable-users-route) - `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](/docs/nl/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Ticket bijwerken](/docs/nl/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. De request accepteert optionele `status` en nullable `assignee_user_id`.
- [Ticket verwijderen](/docs/nl/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Opmerking toevoegen](/docs/nl/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. De request vereist `comment` (string, 1–10.000 tekens).
- [Turnopmerking toevoegen](/docs/nl/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. De request vereist een op nul gebaseerde `turn_index` (integer) en `comment` (string, 1–10.000 tekens).
## Bijgewerkte endpoints
### ElevenAgents
- [Ondertekende URL ophalen](/docs/nl/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
- Optionele `debug_events_request` toegevoegd (boolean, standaard `false`). Debug-events vereisen editortoegang tot de agent.
- [WebRTC-token ophalen](/docs/nl/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- Optionele `debug_events_request` toegevoegd (boolean, standaard `false`). De verouderde route `GET /v1/convai/conversation/get_signed_url` accepteert dezelfde parameter.
- [Gesprekken weergeven](/docs/nl/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Optionele `triggered_procedure_ids` toegevoegd (nullable stringarray, maximaal 50) om gesprekken te matchen waarin een opgegeven procedure is uitgevoerd.
- Optionele `include_invalid_tool_calls` toegevoegd (boolean, standaard `false`) om tool calls op te nemen die niet zijn uitgevoerd.
- Optionele `sort_direction` toegevoegd (`asc` of `desc`, standaard `desc`) voor de starttijd van het gesprek.
- [Gespreksberichten doorzoeken op tekst](/docs/nl/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Optionele `triggered_procedure_ids` toegevoegd (nullable stringarray, maximaal 50).
- Optionele `include_invalid_tool_calls` toegevoegd (boolean, standaard `false`).
- [Gesprekstopics van agent ophalen](/docs/nl/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Optionele `include_evaluation_criteria` toegevoegd (boolean, standaard `true`).
- `frustration` toegevoegd aan `sort_by`.
- Topicresponses voegen nullable `success_rate` (number) toe, terwijl de volledige response `aggregated_run_count` toevoegt (integer, standaard `0`).
- `from_unix_secs` wordt 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.
- [Procedures weergeven](/docs/nl/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) en [Procedure ophalen](/docs/nl/api-reference/agents/procedures/get) (`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.
- [Test maken](/docs/nl/api-reference/tests/create) en [Test bijwerken](/docs/nl/api-reference/tests/update)
- 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 dit `production`.
- [URL-document maken](/docs/nl/api-reference/knowledge-base/create-from-url), [Crawljob maken](/docs/nl/api-reference/knowledge-base/create-crawl-job) en [Map maken](/docs/nl/api-reference/knowledge-base/create-folder)
- Optionele nullable `minimum_frequency_days` toegevoegd (integer, 1–180) voor automatische synchronisatie. De standaardwaarde is `7` en een strengere frequentie van een bovenliggende map heeft voorrang.
### Muziek
- [Music Finetunes weergeven](/docs/nl/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- De maximale `page_size` verhoogd van 100 naar 150. De standaardwaarde blijft 50.
## Schemawijzigingen
### ElevenAgents
- Requests voor het bijwerken van agents voegen optionele nullable `procedures` toe (`object`). Elke waarde vereist `procedure_id` en `version_id` (strings). Een leeg object verwijdert alle procedures.
- De configuratie voor gespreksinitiatie voegt `enable_procedure_ids_from_client` toe (boolean, standaard `false`). Initiatiegegevens voegen optionele nullable `procedure_ids` toe (stringarray); een lege array schakelt alle procedures voor de startende agent uit.
- `ClientEvent` voegt `context_usage` toe.
- Overschrijvingen voor soft time-outs voegen optionele nullable `additional_soft_timeout_messages` toe (stringarray).
- Constante waarden in modellen voor analyse- en schemaoverschrijvingen accepteren nu `null`.
- De standaardwaarden voor widgetconfiguratie van `mic_muting_enabled` en `transcript_enabled` zijn gewijzigd van `false` naar `true`. Stel ze expliciet in op `false` om het eerdere gedrag te behouden.
### Workspace
- Responses van [Gebruiker ophalen](/docs/nl/api-reference/user/get) hebben `xi_api_key` verwijderd uit `UserResponseModel`.
- `ResourceMetadataResponseModel.role_to_group_ids` accepteert nu aangepaste rol-ID's als keys, in plaats van keys te beperken tot `admin`, `editor`, `commenter` en `viewer`.
- Responses voor direct publiceren voegen optionele nullable `restricted_to_user_email_domains` toe (stringarray).
- Responses voor een in behandeling zijnde abonnementswissel voegen `go` toe aan `next_tier`.