ElevenLabs CLI
Die ElevenLabs CLI 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.
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.
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 - 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 - 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
keytermsund Synchronisationwebhook_ids.
Swift SDK
- v3.3.0 - Typisierte Client-Fehleranalyse, Verarbeitung von
expects_responseund 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, @elevenlabs/react@1.12.3, @elevenlabs/react-native@1.2.21, @elevenlabs/convai-widget-core@0.16.2 und @elevenlabs/convai-widget-embed@0.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, @elevenlabs/react@1.12.4, @elevenlabs/react-native@1.2.22, @elevenlabs/convai-widget-core@0.16.3 und @elevenlabs/convai-widget-embed@0.16.3 - Optionales
webRtc.iceTransportPolicyhinzugefügt. Setzen Sie es aufrelay, um WebRTC-ICE-Kandidaten in Netzwerken, die direkten UDP-Datenverkehr blockieren, auf TURN-Relays zu beschränken. - @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 und @elevenlabs/convai-widget-embed@0.16.4 - Den Callback
onContextUsageund den TypContextUsageEventhinzugefügt. React stellt den Callback überuseConversationbereit. React Native löst jetzt über seine Paketexport-Bedingung statt über die Erkennung globaler Browser-Objekte auf. - @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 und @elevenlabs/convai-widget-embed@0.17.0 - Rich Content für die erste Nachricht mit zugeordneten Button-Antworten,
onExternalAgentDisconnectedundonMCPToolApprovalRequesthinzugefü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
API-Änderungen anzeigen
Neue Endpunkte
ElevenAgents
- Neun Endpunkte für Gesprächstriage-Tickets hinzugefügt:
- Gesprächsticket erstellen -
POST /v1/convai/triage-tickets. Die Anfrage erfordertconversation_id(String) und akzeptiertqa_comment(nullable String, 1–10.000 Zeichen) sowie bis zu 200 Turn-Kommentare. - Tickets auflisten -
GET /v1/convai/agents/{agent_id}/triage-tickets, mit Cursor-Paginierung. - Manuelles Ticket erstellen -
POST /v1/convai/agents/{agent_id}/triage-tickets. Die Anfrage erfordertqa_comment(String, 1–10.000 Zeichen). - Zuweisbare Benutzer auflisten -
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 -
GET /v1/convai/triage-tickets/{agentqa_ticket_id}. - Ticket aktualisieren -
PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. Die Anfrage akzeptiert optionalstatusund nullableassignee_user_id. - Ticket löschen -
DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}. - Kommentar hinzufügen -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. Die Anfrage erfordertcomment(String, 1–10.000 Zeichen). - Turn-Kommentar hinzufügen -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. Die Anfrage erfordert den nullbasiertenturn_index(Integer) undcomment(String, 1–10.000 Zeichen).
- Gesprächsticket erstellen -
Aktualisierte Endpunkte
ElevenAgents
- Signierte URL abrufen -
GET /v1/convai/conversation/get-signed-url- Optionales
debug_events_request(Boolean, Standardwertfalse) hinzugefügt. Debug-Ereignisse erfordern Editor-Zugriff auf den Agenten.
- Optionales
- WebRTC-Token abrufen -
GET /v1/convai/conversation/token- Optionales
debug_events_request(Boolean, Standardwertfalse) hinzugefügt. Die Legacy-RouteGET /v1/convai/conversation/get_signed_urlakzeptiert denselben Parameter.
- Optionales
- Gespräche auflisten -
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, Standardwertfalse) hinzugefügt, um Tool-Aufrufe einzuschließen, die nicht ausgeführt wurden. - Optionales
sort_direction(ascoderdesc, Standardwertdesc) für die Startzeit des Anrufs hinzugefügt.
- Optionales
- Textsuche in Gesprächsnachrichten -
GET /v1/convai/conversations/messages/text-search- Optionales
triggered_procedure_ids(nullable String-Array, maximal 50) hinzugefügt. - Optionales
include_invalid_tool_calls(Boolean, Standardwertfalse) hinzugefügt.
- Optionales
- Themen von Agentengesprächen abrufen -
GET /v1/convai/agents/{agent_id}/topics- Optionales
include_evaluation_criteria(Boolean, Standardwerttrue) hinzugefügt. frustrationzusort_byhinzugefügt.- Themenantworten ergänzen nullable
success_rate(Zahl), während die Gesamtantwortaggregated_run_count(Integer, Standardwert0) ergänzt. from_unix_secswird 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.
- Optionales
- Verfahren auflisten (
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) und Verfahren abrufen (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.
- Optionales nullable
- Test erstellen und Test aktualisieren
- 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 istproduction.
- Optionales nullable
- URL-Dokument erstellen, Crawl-Job erstellen und Ordner erstellen
- Optionales nullable
minimum_frequency_days(Integer, 1–180) für die automatische Synchronisierung hinzugefügt. Der Standardwert ist7, und eine strengere Häufigkeit des übergeordneten Ordners hat Vorrang.
- Optionales nullable
Musik
- Music-Finetunes auflisten -
GET /v1/music/finetunes- Die maximale
page_sizewurde von 100 auf 150 erhöht. Der Standardwert bleibt 50.
- Die maximale
Schemaänderungen
ElevenAgents
- Anfragen zur Agentenaktualisierung ergänzen optionales nullable
procedures(object<string, ProcedureVersionRef>). Jeder Wert erfordertprocedure_idundversion_id(Strings). Ein leeres Objekt entfernt alle Verfahren. - Die Konfiguration für die Gesprächsinitiierung ergänzt
enable_procedure_ids_from_client(Boolean, Standardwertfalse). Initialisierungsdaten ergänzen optionales nullableprocedure_ids(String-Array); ein leeres Array deaktiviert alle Verfahren für den startenden Agenten. ClientEventergänztcontext_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_enabledundtranscript_enabledwurden vonfalseauftruegeändert. Setzen Sie sie explizit auffalse, um das bisherige Verhalten beizubehalten.
Workspace
- Antworten von Benutzer abrufen haben
xi_api_keyausUserResponseModelentfernt. ResourceMetadataResponseModel.role_to_group_idsakzeptiert jetzt benutzerdefinierte Rollen-IDs als Schlüssel, statt Schlüssel aufadmin,editor,commenterundviewerzu 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
gozunext_tier.