> 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
Die [ElevenLabs CLI v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0) ist jetzt verfügbar. Jede ElevenLabs-API-Operation steht als Unterbefehl bereit – mit JSON-, Tabellen-, YAML- und CSV-Ausgabe, automatischer Paginierung und Shell-Vervollständigung.
Die CLI bietet auch lokale Konfigurations-Workflows für ElevenAgents. Speichern Sie Agenten-, Tool- und Testkonfigurationen als Dateien, synchronisieren Sie sie mit Push- und Pull-Befehlen, verwalten Sie Branches, führen Sie Tests aus, installieren Sie ElevenLabs-UI-Komponenten und wählen Sie eine Datenresidenzregion.
Installieren Sie die CLI, authentifizieren Sie sich und verwalten Sie Agenten als Code.
### Verfahren
Verfahren sind jetzt allgemein in ElevenAgents verfügbar. Ein Verfahren enthält aufgabenspezifische Anweisungen und einen Auslöser, der bestimmt, wann sie gelten. Während eines Gesprächs lädt der Agent das relevante Verfahren. So kann ein Agent unterschiedliche Aufgaben bearbeiten, ohne jede Anweisung in seinen System-Prompt aufzunehmen.
Verwenden Sie Freiform-Verfahren, wenn der Agent die Formulierung oder Reihenfolge der Anweisungen anpassen kann. Verwenden Sie strukturierte Verfahren, wenn Schritte in einer definierten Reihenfolge ausgeführt werden müssen. Beide Typen können beim selben Agenten zusammen mit Workflows verwendet werden.
Erfahren Sie, wann Sie Verfahren einsetzen und wie sie sich von Prompts und Workflows unterscheiden.
Schreiben Sie Anweisungen in natürlicher Sprache, die der Agent an das Gespräch anpassen kann.
Definieren Sie typisierte Schritte, die der Agent in einer konsistenten Reihenfolge befolgt.
### ElevenAgents
- **Tickets zur Gesprächstriage**: APIs zum Erstellen von Tickets zur Agentenleistung, manuellen Follow-up-Tickets, Auflisten von Tickets, Zuweisen von Workspace-Mitgliedern, Aktualisieren von Status und zuständiger Person sowie Hinzufügen von Kommentaren auf Ticket- oder Turn-Ebene hinzugefügt.
- **Gesprächsbeobachtbarkeit**: Echtzeit-Clients können nach jedem abgeschlossenen Agenten-Turn ein `context_usage`-Ereignis erhalten. Das Ereignis meldet das Modell, die Anzahl der Prompt-Tokens und das Kontextlimit des Modells.
### SDK-Releases
#### JavaScript SDK
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - Clients und Typen für Gesprächstriage-Tickets und kompakte Gesprächszusammenfassungen hinzugefügt. Gesprächs-APIs ergänzen Filter für Verfahren, ungültige Tool-Aufrufe und Sortierung; Verfahrens-APIs ergänzen die Auswahl der Agentenversion; Themen-APIs ergänzen Steuerelemente für Bewertungsdetails und Sortierung nach Frustration. Das Release ergänzt außerdem Felder für Aktualisierungshäufigkeit der Wissensdatenbank, Testumgebung und Alerting-Integration sowie Echtzeit-Nachrichtentypen für Synchronisation.
#### Python SDK
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - Clients und Typen für Gesprächstriage-Tickets und kompakte Gesprächszusammenfassungen hinzugefügt. Gesprächs-APIs ergänzen Filter für Verfahren, ungültige Tool-Aufrufe und Sortierung; Verfahrens-APIs ergänzen die Auswahl der Agentenversion; Themen-APIs ergänzen Steuerelemente für Bewertungsdetails und Sortierung nach Frustration. Das Release ergänzt außerdem Felder für Aktualisierungshäufigkeit der Wissensdatenbank, Testumgebung und Alerting-Integration und erhält wiederholte Multipart-Felder für Speech to Text `keyterms` und Synchronisation `webhook_ids`.
#### Swift SDK
- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Typisierte Client-Fehleranalyse, Verarbeitung von `expects_response` und typsichere Tool-Ergebnisse hinzugefügt. Der WebRTC-Start ist jetzt bereit, sobald der Agent beitritt, statt auf das Abonnement des Audiotracks zu warten. Das Release verbessert außerdem die URL-Verarbeitung, unterdrückt Rauschen durch unbekannte Ereignisse und entfernt die Echtzeit-Thread-Allokation aus der Verarbeitung der Software-Stummschaltung.
#### Pakete
- [@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) und [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - Die WebRTC-Ausgabeerfassung verwendet jetzt selbst gehostete AudioWorklet-Pfade unter strikten Content-Security-Policies. Das Worklet-Caching umfasst die angeforderte Quelle, damit eine frühere Inline-URL keinen selbst gehosteten Pfad ersetzt. React-Native-Einrichtungsfehler verweisen jetzt auf `@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) und [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Optionales `webRtc.iceTransportPolicy` hinzugefügt. Setzen Sie es auf `relay`, um WebRTC-ICE-Kandidaten in Netzwerken, die direkten UDP-Datenverkehr blockieren, auf TURN-Relays zu beschränken.
- [@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) und [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - Den Callback `onContextUsage` und den Typ `ContextUsageEvent` hinzugefügt. React stellt den Callback über `useConversation` bereit. React Native löst jetzt über seine Paketexport-Bedingung statt über die Erkennung globaler Browser-Objekte auf.
- [@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) und [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Rich Content für die erste Nachricht mit zugeordneten Button-Antworten, `onExternalAgentDisconnected` und `onMCPToolApprovalRequest` hinzugefügt. WebRTC verwendet jetzt das ausgewählte Eingabegerät, behält den Stummschaltungsstatus beim Mikrofonwechsel bei und bricht die Einrichtung ab, wenn Initialisierungsdaten nicht gesendet werden können. Das Widget ergänzt den Status der Nebenläufigkeitswarteschlange, eine optionale Sprachauswahl im eingeklappten Auslöser und die Darstellung der ersten Nachricht für Agenten, die Text und Stimme unterstützen.
### API
## Neue Endpunkte
### ElevenAgents
- Neun Endpunkte für Gesprächstriage-Tickets hinzugefügt:
- [Gesprächsticket erstellen](/docs/de/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. Die Anfrage erfordert `conversation_id` (String) und akzeptiert `qa_comment` (nullable String, 1–10.000 Zeichen) sowie bis zu 200 Turn-Kommentare.
- [Tickets auflisten](/docs/de/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, mit Cursor-Paginierung.
- [Manuelles Ticket erstellen](/docs/de/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. Die Anfrage erfordert `qa_comment` (String, 1–10.000 Zeichen).
- [Zuweisbare Benutzer auflisten](/docs/de/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`. Die Antwort listet Workspace-Mitglieder ohne Service-Account und gibt an, ob jedes Mitglied Zugriff auf den Agenten hat.
- [Ticket abrufen](/docs/de/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Ticket aktualisieren](/docs/de/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. Die Anfrage akzeptiert optional `status` und nullable `assignee_user_id`.
- [Ticket löschen](/docs/de/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Kommentar hinzufügen](/docs/de/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. Die Anfrage erfordert `comment` (String, 1–10.000 Zeichen).
- [Turn-Kommentar hinzufügen](/docs/de/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. Die Anfrage erfordert den nullbasierten `turn_index` (Integer) und `comment` (String, 1–10.000 Zeichen).
## Aktualisierte Endpunkte
### ElevenAgents
- [Signierte URL abrufen](/docs/de/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
- Optionales `debug_events_request` (Boolean, Standardwert `false`) hinzugefügt. Debug-Ereignisse erfordern Editor-Zugriff auf den Agenten.
- [WebRTC-Token abrufen](/docs/de/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- Optionales `debug_events_request` (Boolean, Standardwert `false`) hinzugefügt. Die Legacy-Route `GET /v1/convai/conversation/get_signed_url` akzeptiert denselben Parameter.
- [Gespräche auflisten](/docs/de/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Optionales `triggered_procedure_ids` (nullable String-Array, maximal 50) hinzugefügt, um Gespräche abzugleichen, in denen eines der angegebenen Verfahren ausgeführt wurde.
- Optionales `include_invalid_tool_calls` (Boolean, Standardwert `false`) hinzugefügt, um Tool-Aufrufe einzuschließen, die nicht ausgeführt wurden.
- Optionales `sort_direction` (`asc` oder `desc`, Standardwert `desc`) für die Startzeit des Anrufs hinzugefügt.
- [Textsuche in Gesprächsnachrichten](/docs/de/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Optionales `triggered_procedure_ids` (nullable String-Array, maximal 50) hinzugefügt.
- Optionales `include_invalid_tool_calls` (Boolean, Standardwert `false`) hinzugefügt.
- [Themen von Agentengesprächen abrufen](/docs/de/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Optionales `include_evaluation_criteria` (Boolean, Standardwert `true`) hinzugefügt.
- `frustration` zu `sort_by` hinzugefügt.
- Themenantworten ergänzen nullable `success_rate` (Zahl), während die Gesamtantwort `aggregated_run_count` (Integer, Standardwert `0`) ergänzt.
- `from_unix_secs` wird auf den Beginn seines UTC-Tags abgerundet. Ein begrenzter Bereich aggregiert abgeschlossene tägliche Ermittlungsläufe; ohne beide Grenzen wird der neueste Lauf zurückgegeben.
- [Verfahren auflisten](/docs/de/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) und [Verfahren abrufen](/docs/de/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
- Optionales nullable `agent_version_id` (String) hinzugefügt, um Verfahren aus einer bestimmten Agentenversion abzurufen.
- [Test erstellen](/docs/de/api-reference/tests/create) und [Test aktualisieren](/docs/de/api-reference/tests/update)
- Optionales nullable `environment` (String) zu den Schemata für Antwort-, Simulations- und Tool-Aufruf-Unit-Tests hinzugefügt. Der Wert wählt umgebungsspezifische URLs, Header und Auth-Verbindungen aus; Standard ist `production`.
- [URL-Dokument erstellen](/docs/de/api-reference/knowledge-base/create-from-url), [Crawl-Job erstellen](/docs/de/api-reference/knowledge-base/create-crawl-job) und [Ordner erstellen](/docs/de/api-reference/knowledge-base/create-folder)
- Optionales nullable `minimum_frequency_days` (Integer, 1–180) für die automatische Synchronisierung hinzugefügt. Der Standardwert ist `7`, und eine strengere Häufigkeit des übergeordneten Ordners hat Vorrang.
### Musik
- [Music-Finetunes auflisten](/docs/de/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- Die maximale `page_size` wurde von 100 auf 150 erhöht. Der Standardwert bleibt 50.
## Schemaänderungen
### ElevenAgents
- Anfragen zur Agentenaktualisierung ergänzen optionales nullable `procedures` (`object`). Jeder Wert erfordert `procedure_id` und `version_id` (Strings). Ein leeres Objekt entfernt alle Verfahren.
- Die Konfiguration für die Gesprächsinitiierung ergänzt `enable_procedure_ids_from_client` (Boolean, Standardwert `false`). Initialisierungsdaten ergänzen optionales nullable `procedure_ids` (String-Array); ein leeres Array deaktiviert alle Verfahren für den startenden Agenten.
- `ClientEvent` ergänzt `context_usage`.
- Soft-Timeout-Overrides ergänzen optionales nullable `additional_soft_timeout_messages` (String-Array).
- Konstante Werte in Analyse- und Schema-Override-Modellen akzeptieren jetzt `null`.
- Die Standardwerte der Widget-Konfiguration für `mic_muting_enabled` und `transcript_enabled` wurden von `false` auf `true` geändert. Setzen Sie sie explizit auf `false`, um das bisherige Verhalten beizubehalten.
### Workspace
- Antworten von [Benutzer abrufen](/docs/de/api-reference/user/get) haben `xi_api_key` aus `UserResponseModel` entfernt.
- `ResourceMetadataResponseModel.role_to_group_ids` akzeptiert jetzt benutzerdefinierte Rollen-IDs als Schlüssel, statt Schlüssel auf `admin`, `editor`, `commenter` und `viewer` zu beschränken.
- Antworten für direktes Veröffentlichen ergänzen optionales nullable `restricted_to_user_email_domains` (String-Array).
- Antworten für ausstehende Abonnementwechsel ergänzen `go` zu `next_tier`.