Hoppa till navigering

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 keyterms och Dubbing webhook_ids.

Swift SDK

  • 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

API

Nya slutpunkter

ElevenAgents

  • Lade till nio slutpunkter för ärenden för samtalstriage:
    • Skapa samtalsärende - 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 - 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äver qa_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 valfria status och nullbara assignee_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äver comment (sträng, 1–10 000 tecken).
    • Lägg till turkommentar - 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 - 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 - 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 - 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 - 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 - 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 (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.
  • 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 är production.
  • Skapa URL-dokument, Skapa crawljobb och Skapa mapp
    • 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 - 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<string, ProcedureVersionRef>). 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 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.