ElevenLabs CLI
ElevenLabs CLI 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.
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.
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 - 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 - 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
keytermsoch Dubbingwebhook_ids.
Swift SDK
- v3.3.0 - Lade till typad parsning av klientfel, hantering av
expects_responseoch 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, @elevenlabs/react@1.12.3, @elevenlabs/react-native@1.2.21, @elevenlabs/convai-widget-core@0.16.2 och @elevenlabs/convai-widget-embed@0.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, @elevenlabs/react@1.12.4, @elevenlabs/react-native@1.2.22, @elevenlabs/convai-widget-core@0.16.3 och @elevenlabs/convai-widget-embed@0.16.3 - Lade till valfria
webRtc.iceTransportPolicy. Ange den tillrelayför att begränsa WebRTC ICE-kandidater till TURN-reläer i nätverk som blockerar direkt UDP-trafik. - @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 och @elevenlabs/convai-widget-embed@0.16.4 - Lade till återanropet
onContextUsageoch typenContextUsageEvent. React exponerar återanropet viauseConversation. React Native löses nu via paketets exportvillkor i stället för identifiering av globala webbläsarobjekt. - @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 och @elevenlabs/convai-widget-embed@0.17.0 - Lade till rikt innehåll i första meddelandet med attributerade knapprespons,
onExternalAgentDisconnectedochonMCPToolApprovalRequest. 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
Visa API-ändringar
Nya slutpunkter
ElevenAgents
- Lade till nio slutpunkter för ärenden för samtalstriage:
- Skapa samtalsärende -
POST /v1/convai/triage-tickets. Begäran kräverconversation_id(sträng) och accepterarqa_comment(nullbar sträng, 1–10 000 tecken) samt upp till 200 turkommentarer. - Lista ärenden -
GET /v1/convai/agents/{agent_id}/triage-tickets, med markörpaginering. - Skapa manuellt ärende -
POST /v1/convai/agents/{agent_id}/triage-tickets. Begäran kräverqa_comment(sträng, 1–10 000 tecken). - Lista tilldelningsbara användare -
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 -
GET /v1/convai/triage-tickets/{agentqa_ticket_id}. - Uppdatera ärende -
PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. Begäran accepterar valfriastatusoch nullbaraassignee_user_id. - Ta bort ärende -
DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}. - Lägg till kommentar -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. Begäran krävercomment(sträng, 1–10 000 tecken). - Lägg till turkommentar -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. Begäran kräver nollbaseradeturn_index(heltal) ochcomment(sträng, 1–10 000 tecken).
- Skapa samtalsärende -
Uppdaterade slutpunkter
ElevenAgents
- Hämta signerad URL -
GET /v1/convai/conversation/get-signed-url- Lade till valfria
debug_events_request(boolean, standardvärdefalse). Felsökningshändelser kräver redaktörsåtkomst till agenten.
- Lade till valfria
- Hämta WebRTC-token -
GET /v1/convai/conversation/token- Lade till valfria
debug_events_request(boolean, standardvärdefalse). Den äldre ruttenGET /v1/convai/conversation/get_signed_urlaccepterar samma parameter.
- Lade till valfria
- Lista samtal -
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ärdefalse) för att inkludera verktygsanrop som inte kördes. - Lade till valfria
sort_direction(ascellerdesc, standardvärdedesc) för samtalsstarttid.
- Lade till valfria
- Textsök i samtalsmeddelanden -
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ärdefalse).
- Lade till valfria
- Hämta ämnen för agentsamtal -
GET /v1/convai/agents/{agent_id}/topics- Lade till valfria
include_evaluation_criteria(boolean, standardvärdetrue). - Lade till
frustrationisort_by. - Ämnessvar lägger till nullbara
success_rate(tal), medan det övergripande svaret lägger tillaggregated_run_count(heltal, standardvärde0). from_unix_secsavrundas 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.
- Lade till valfria
- Lista procedurer (
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) och Hämta procedur (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.
- Lade till valfria nullbara
- Skapa test och Uppdatera test
- 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 ärproduction.
- Lade till valfria nullbara
- Skapa URL-dokument, Skapa crawljobb och Skapa mapp
- Lade till valfria nullbara
minimum_frequency_days(heltal, 1–180) för automatisk synkronisering. Standardvärdet är7, och en striktare frekvens för överordnad mapp har företräde.
- Lade till valfria nullbara
Musik
- Lista Music Finetunes -
GET /v1/music/finetunes- Ökade maximala
page_sizefrån 100 till 150. Standardvärdet är fortfarande 50.
- Ökade maximala
Schemaändringar
ElevenAgents
- Begäranden om agentuppdatering lägger till valfria nullbara
procedures(object<string, ProcedureVersionRef>). Varje värde kräverprocedure_idochversion_id(strängar). Ett tomt objekt tar bort alla procedurer. - Konfiguration för samtalsinitiering lägger till
enable_procedure_ids_from_client(boolean, standardvärdefalse). Initieringsdata lägger till valfria nullbaraprocedure_ids(strängarray); en tom array inaktiverar alla procedurer för startagenten. ClientEventlägger tillcontext_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_enabledochtranscript_enabledhar ändrats frånfalsetilltrue. Ange dem uttryckligen somfalseför att behålla det tidigare beteendet.
Arbetsyta
- Svar från Hämta användare tog bort
xi_api_keyfrånUserResponseModel. ResourceMetadataResponseModel.role_to_group_idsaccepterar nu anpassade roll-ID:n som nycklar i stället för att begränsa nycklar tilladmin,editor,commenterochviewer.- 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
goinext_tier.