Skip to navigation

ElevenLabs CLI

De ElevenLabs CLI 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.

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.

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 - 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 - 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 - 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

API

Nieuwe endpoints

ElevenAgents

  • Negen endpoints voor tickets voor gesprekstriage toegevoegd:
    • Gespreksticket maken - 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 - GET /v1/convai/agents/{agent_id}/triage-tickets, met cursorpaginering.
    • Handmatig ticket maken - POST /v1/convai/agents/{agent_id}/triage-tickets. De request vereist qa_comment (string, 1–10.000 tekens).
    • Toewijsbare gebruikers weergeven - 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 - GET /v1/convai/triage-tickets/{agentqa_ticket_id}.
    • Ticket bijwerken - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. De request accepteert optionele status en nullable assignee_user_id.
    • Ticket verwijderen - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}.
    • Opmerking toevoegen - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. De request vereist comment (string, 1–10.000 tekens).
    • Turnopmerking toevoegen - 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 - 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 - 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 - 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 - 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 - 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 (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) en Procedure ophalen (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 en Test bijwerken
    • 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, Crawljob maken en Map maken
    • 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 - 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<string, ProcedureVersionRef>). 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 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.