> 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
[ElevenLabs CLI v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0) finns nu tillgänglig. Alla ElevenLabs API-åtgärder är tillgängliga som underkommandon, med utdata i JSON, tabell-, YAML- och CSV-format, automatisk paginering och shell completion.
CLI:t erbjuder även arbetsflöden för lokal konfiguration av ElevenAgents. Spara konfigurationer för agenter, verktyg och tester som filer, synkronisera dem med push- och pull-kommandon, hantera grenar, kör tester, installera UI-komponenter från ElevenLabs och välj en region för dataresidens.
Installera CLI:t, autentisera och hantera agenter som kod.
### Procedurer
Procedurer är nu allmänt tillgängliga i ElevenAgents. En procedur innehåller uppgiftsspecifika instruktioner och en utlösare som avgör när de ska tillämpas. Under ett samtal laddar agenten den relevanta proceduren, så att en agent kan hantera olika uppgifter utan att varje instruktion behöver ligga i dess systemprompt.
Använd fria procedurer när agenten kan anpassa formuleringen eller ordningen på instruktionerna. Använd strukturerade procedurer när steg måste köras i en bestämd ordning. Båda typerna kan användas tillsammans med workflows på samma agent.
Läs om när du ska använda procedurer och hur de skiljer sig från prompter och workflows.
Skriv instruktioner på naturligt språk som agenten kan anpassa till samtalet.
Definiera typade steg som agenten följer i en konsekvent ordning.
### ElevenAgents
- **Ärenden för samtalstriage**: Lade till API:er för att skapa ärenden om agentprestanda, skapa manuella uppföljningsärenden, lista ärenden, tilldela arbetsytemedlemmar, uppdatera status och ansvarig samt lägga till kommentarer på ärende- eller tur-nivå.
- **Samtalsobservabilitet**: Realtidsklienter kan ta emot en `context_usage`-händelse efter varje slutförd agenttur. Händelsen rapporterar modellen, antalet prompttoken och modellens kontextgräns.
### SDK-versioner
#### JavaScript SDK
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - Lade till klienter och typer för ärenden för samtalstriage och korta samtalssammanfattningar. Samtals-API:erna lägger till filter för procedur, ogiltiga verktygsanrop och sortering; procedur-API:erna lägger till val av agentversion; ämnes-API:erna lägger till kontroller för utvärderingsdetaljer och sortering efter frustration. Versionen lägger även till fält för uppdateringsfrekvens för kunskapsbasen, testmiljö och varningsintegrering samt meddelandetyper för dubbning i realtid.
#### Python SDK
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - Lade till klienter och typer för ärenden för samtalstriage och korta samtalssammanfattningar. Samtals-API:erna lägger till filter för procedur, ogiltiga verktygsanrop och sortering; procedur-API:erna lägger till val av agentversion; ämnes-API:erna lägger till kontroller för utvärderingsdetaljer och sortering efter frustration. Versionen lägger även till fält för uppdateringsfrekvens för kunskapsbasen, testmiljö och varningsintegrering, och bevarar upprepade multipart-fält för Speech to Text `keyterms` och Dubbing `webhook_ids`.
#### Swift SDK
- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Lade till typad parsning av klientfel, hantering av `expects_response` och typsäkra verktygsresultat. WebRTC-start blir nu redo när agenten ansluter i stället för att vänta på prenumeration på ljudspåret. Versionen förbättrar även URL-hanteringen, undertrycker brus från okända händelser och tar bort allokering av realtidstrådar från bearbetning av programvarudämpning.
#### Paket
- [@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) och [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - WebRTC-utdatainsamling använder nu självhostade AudioWorklet-sökvägar under strikta innehållssäkerhetspolicyer. Cachning av worklets inkluderar den begärda källan, vilket förhindrar att en tidigare infogad URL ersätter en självhostad sökväg. Konfigurationsfel i React Native pekar nu på `@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) och [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Lade till valfria `webRtc.iceTransportPolicy`. Ange den till `relay` för att begränsa WebRTC ICE-kandidater till TURN-reläer i nätverk som blockerar direkt UDP-trafik.
- [@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) och [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - Lade till återanropet `onContextUsage` och typen `ContextUsageEvent`. React exponerar återanropet via `useConversation`. React Native löses nu via paketets exportvillkor i stället för identifiering av globala webbläsarobjekt.
- [@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) och [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Lade till rikt innehåll i första meddelandet med attributerade knapprespons, `onExternalAgentDisconnected` och `onMCPToolApprovalRequest`. WebRTC använder nu den valda inmatningsenheten, behåller dämpningsläget vid byte av mikrofon och misslyckar med konfigurationen om initieringsdata inte kan skickas. Widgeten lägger till status för samtidighetskö, valfritt språkval i den hopfällda utlösaren och rendering av första meddelandet för agenter som stöder både text och röst.
### API
## Nya slutpunkter
### ElevenAgents
- Lade till nio slutpunkter för ärenden för samtalstriage:
- [Skapa samtalsärende](/docs/sv/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. Begäran kräver `conversation_id` (sträng) och accepterar `qa_comment` (nullbar sträng, 1–10 000 tecken) samt upp till 200 turkommentarer.
- [Lista ärenden](/docs/sv/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, med markörpaginering.
- [Skapa manuellt ärende](/docs/sv/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. Begäran kräver `qa_comment` (sträng, 1–10 000 tecken).
- [Lista tilldelningsbara användare](/docs/sv/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`. Svaret listar arbetsytemedlemmar som inte är tjänstkonton och om varje medlem har åtkomst till agenten.
- [Hämta ärende](/docs/sv/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Uppdatera ärende](/docs/sv/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. Begäran accepterar valfria `status` och nullbara `assignee_user_id`.
- [Ta bort ärende](/docs/sv/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Lägg till kommentar](/docs/sv/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. Begäran kräver `comment` (sträng, 1–10 000 tecken).
- [Lägg till turkommentar](/docs/sv/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. Begäran kräver nollbaserade `turn_index` (heltal) och `comment` (sträng, 1–10 000 tecken).
## Uppdaterade slutpunkter
### ElevenAgents
- [Hämta signerad URL](/docs/sv/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
- Lade till valfria `debug_events_request` (boolean, standardvärde `false`). Felsökningshändelser kräver redaktörsåtkomst till agenten.
- [Hämta WebRTC-token](/docs/sv/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- Lade till valfria `debug_events_request` (boolean, standardvärde `false`). Den äldre rutten `GET /v1/convai/conversation/get_signed_url` accepterar samma parameter.
- [Lista samtal](/docs/sv/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Lade till valfria `triggered_procedure_ids` (nullbar strängarray, högst 50) för att matcha samtal där någon av de angivna procedurerna kördes.
- Lade till valfria `include_invalid_tool_calls` (boolean, standardvärde `false`) för att inkludera verktygsanrop som inte kördes.
- Lade till valfria `sort_direction` (`asc` eller `desc`, standardvärde `desc`) för samtalsstarttid.
- [Textsök i samtalsmeddelanden](/docs/sv/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Lade till valfria `triggered_procedure_ids` (nullbar strängarray, högst 50).
- Lade till valfria `include_invalid_tool_calls` (boolean, standardvärde `false`).
- [Hämta ämnen för agentsamtal](/docs/sv/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Lade till valfria `include_evaluation_criteria` (boolean, standardvärde `true`).
- Lade till `frustration` i `sort_by`.
- Ämnessvar lägger till nullbara `success_rate` (tal), medan det övergripande svaret lägger till `aggregated_run_count` (heltal, standardvärde `0`).
- `from_unix_secs` avrundas nedåt till början av dess UTC-dag. Ett begränsat intervall aggregerar slutförda dagliga identifieringskörningar; om båda gränserna utelämnas returneras den senaste körningen.
- [Lista procedurer](/docs/sv/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) och [Hämta procedur](/docs/sv/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
- Lade till valfria nullbara `agent_version_id` (sträng) för att hämta procedurer från en specifik agentversion.
- [Skapa test](/docs/sv/api-reference/tests/create) och [Uppdatera test](/docs/sv/api-reference/tests/update)
- Lade till valfria nullbara `environment` (sträng) i scheman för svar, simulering och enhetstest av verktygsanrop. Värdet väljer miljöspecifika URL:er, headers och autentiseringsanslutningar; standardvärdet är `production`.
- [Skapa URL-dokument](/docs/sv/api-reference/knowledge-base/create-from-url), [Skapa crawljobb](/docs/sv/api-reference/knowledge-base/create-crawl-job) och [Skapa mapp](/docs/sv/api-reference/knowledge-base/create-folder)
- Lade till valfria nullbara `minimum_frequency_days` (heltal, 1–180) för automatisk synkronisering. Standardvärdet är `7`, och en striktare frekvens för överordnad mapp har företräde.
### Musik
- [Lista Music Finetunes](/docs/sv/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- Ökade maximala `page_size` från 100 till 150. Standardvärdet är fortfarande 50.
## Schemaändringar
### ElevenAgents
- Begäranden om agentuppdatering lägger till valfria nullbara `procedures` (`object`). Varje värde kräver `procedure_id` och `version_id` (strängar). Ett tomt objekt tar bort alla procedurer.
- Konfiguration för samtalsinitiering lägger till `enable_procedure_ids_from_client` (boolean, standardvärde `false`). Initieringsdata lägger till valfria nullbara `procedure_ids` (strängarray); en tom array inaktiverar alla procedurer för startagenten.
- `ClientEvent` lägger till `context_usage`.
- Åsidosättningar av mjuk timeout lägger till valfria nullbara `additional_soft_timeout_messages` (strängarray).
- Konstanta värden i modeller för analys och schemaåsidosättning accepterar nu `null`.
- Standardvärdena i widgetkonfigurationen för `mic_muting_enabled` och `transcript_enabled` har ändrats från `false` till `true`. Ange dem uttryckligen som `false` för att behålla det tidigare beteendet.
### Arbetsyta
- Svar från [Hämta användare](/docs/sv/api-reference/user/get) tog bort `xi_api_key` från `UserResponseModel`.
- `ResourceMetadataResponseModel.role_to_group_ids` accepterar nu anpassade roll-ID:n som nycklar i stället för att begränsa nycklar till `admin`, `editor`, `commenter` och `viewer`.
- Svar för direktpublicering lägger till valfria nullbara `restricted_to_user_email_domains` (strängarray).
- Svar för väntande prenumerationsbyte lägger till `go` i `next_tier`.