Hoppa till navigering

ElevenAgents

  • Åsidosättningar för WhatsApp-gren och -miljö: Utgående WhatsApp-meddelanden och utgående samtal respekterar nu branch_id och environment som skickas i conversation_initiation_client_data. Åsidosättningar valideras innan något skickas — en okänd gren eller miljö avvisas med ett fel — och gäller under hela konversationen, så att en kunds svar återupptas i den begärda grenen och miljön. Se WhatsApp-guiden för exempel.
  • API:er för procedurer: Lade till åtta offentliga, grenspecifika åtgärder för att hantera procedurer. Du kan skapa, lista, hämta och ta bort procedurer; skapa, hämta eller kassera utkaständringar; och kompilera procedurutkast till ett agentarbetsflöde. När du skapar procedurer kan du ange name, content, type och trigger. En tom trigger skapar en delprocedur, medan en utelämnad eller null-trigger härleds från procedurinnehållet.
  • Crawljobb för kunskapsbaser: Lade till API:er för att skapa, lista, granska och avbryta crawljobb. Begäranden om att skapa jobb kräver url (sträng) och stöder crawldjup, sidgränser, URL-mönster, webbplatskartans URL:er, mappplacering, automatisk synkronisering och borttagning av otillgängliga dokument.
  • Masshantering av kunskapsbaser: Lade till kontroller av beroenden i bulk och massborttagning för 1–20 unika dokument- eller mapp-ID:n. Beroendekontroller stöder paginering och dependent_type; borttagning returnerar separat lyckat eller misslyckat resultat för varje ID. Att ange force: true tar även bort beroenden och raderar icke-tomma mappar rekursivt.
  • Export av batchsamtalsresultat: Lade till Exportera batchsamtalsresultat för att ladda ner mottagare och konversationsresultat från en avslutad batch som CSV.
  • Konversationsfilter och analysdata: Lista konversationer och Textsök i konversationsmeddelanden lägger till valfria matrisfilter för visited_agent_ids och visited_agent_branch_ids, begränsade till 50 värden vardera. Listbegäranden accepterar även data_collection_ids och evaluation_criteria_ids för att inkludera motsvarande resultat i varje konversationssammanfattning. Sammanfattningar lägger till valfria data_collection_results, evaluation_criteria_results och tag_ids.
  • Refererad analyskonfiguration: Agentplattformens inställningar lägger till det valfria, nullbara fältet analysis_items, typat som AgentAnalysisItems, för att bifoga utvärderings- och datainsamlingsobjekt via referens. Värdet null innebär att agenten fortfarande använder de äldre inbäddade fälten; ett tomt värde innebär en migrerad agent utan bifogade objekt.
  • Metadata för procedurberoenden: Procedurreferenser lägger till trigger (sträng) och matriser för referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids och referenced_dynamic_variables.
  • Svar för WebRTC-token: Svar från Hämta WebRTC-token kräver nu conversation_id (sträng) utöver token. Detta är en inkompatibel schemaändring för klienter som validerar eller deserialiserar svarsformatet.
  • RAG-resultat för kunskapsbaser: KnowledgeBaseRagToolResultModel lägger till chunks (KnowledgeBaseRagChunkModel[]) för läget RAG-resultat-i-verktygsresultat.

Studio

  • Status för projektutkast: ProjectCreationMetaResponseModel.status lägger till draft. Projektskapandetypen använder nu den delade enumen ProjectCreationMetaType med samma befintliga värden.

Röster

  • Röstaccenter: Lade till GET /v1/voices/accents för att lista accenterna som finns i det delade röstbiblioteket. Resultat kan filtreras efter language och model_id, och varje accent returnerar accent, language, code och det läsbara name. Värdet accent kan skickas till frågeparametern accent för Hämta delade röster för att filtrera delade röster.

Arbetsytor

  • Användningsrapportering för webhooks: WebhookUsageType lägger till Flows.

SDK-utgåvor

JavaScript SDK

  • v2.60.0 - Lade till voices.accents.get för att lista röstaccenter i det delade röstbiblioteket, tillsammans med ElevenAgents API:er för procedurer, crawljobb för kunskapsbaser och masshantering samt den refererade analyskonfigurationen från det senaste schemat.

Python SDK

  • v2.60.0 - Lade till API:erna för röstaccenter, ElevenAgents-procedurer, crawljobb för kunskapsbaser och masshantering från det senaste schemat. Åtgärdade även uppstarten av AsyncConversation så att den inte längre blockerar, och korrigerade multipart-fält med listor av primitiver så att de skickas som upprepade formulärfält.

Paket

API

Nya slutpunkter

ElevenAgents

  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Skapar en procedur och returnerar dess procedure_id (sträng)
    • Accepterar valfria name (sträng, högst 200 tecken), content (sträng), type (ProcedureType, standardvärde free_form) och trigger (nullbar sträng)
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Listar grenprocedurer med procedure_id, version_id, name, type, trigger och has_draft
    • Utesluter procedurinnehåll; hämta en enskild procedur för att läsa innehållet
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Accepterar valfri version_id (sträng); annars returneras versionen vid grenens huvud
    • Returnerar name, content, type och trigger
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Tar bort proceduren från grenens arbetsuppsättning för utkast
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Returnerar det aktuella procedurutkastet
  • PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Skapar eller uppdaterar ett utkast
    • Kräver name (sträng, högst 200 tecken), content (sträng, högst 50 000 tecken) och type (ProcedureType); accepterar valfri trigger (nullbar sträng)
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Kasserar utkaständringar och återställer proceduren till dess sparade version
  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
    • Kompilerar procedurutkast till en AgentWorkflowResponseModel
  • Skapa crawljobb - POST /v1/convai/knowledge-base/crawl
    • Kräver url (sträng)
    • Accepterar valfria max_depth (heltal, 1–5, standardvärde 3), max_pages (heltal, 1–10 000, standardvärde 1000), pattern (sträng), sitemap_urls (strängmatris), parent_folder_id (sträng), enable_auto_sync (booleskt värde, standardvärde false) och auto_remove (booleskt värde, standardvärde false)
  • Lista crawljobb - GET /v1/convai/knowledge-base/crawl
    • Accepterar valfria include_job_ids (strängmatris), page_size (heltal, 1–100, standardvärde 30) och cursor (sträng)
  • Hämta crawljobb - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
  • Avbryt crawljobb - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
  • Hämta beroende agenter för flera dokument - POST /v1/convai/knowledge-base/dependent-agents
    • Kräver document_ids (matris med 1–20 unika strängar)
    • Accepterar valfria dependent_type (KnowledgeBaseDependentType, standardvärde all), page_size (heltal, 1–100, standardvärde 30) och cursor (sträng)
  • Massradera dokument i kunskapsbasen - POST /v1/convai/knowledge-base/bulk-delete
    • Kräver document_ids (matris med 1–20 unika strängar)
    • Accepterar valfri force (booleskt värde, standardvärde false)
    • Returnerar lyckat eller misslyckat resultat för varje dokument-ID
  • Exportera batchsamtalsresultat - GET /v1/convai/batch-calling/{batch_id}/export
    • Returnerar mottagare och konversationsresultat för avslutade batcher som CSV

Röster

  • GET /v1/voices/accents
    • Listar accenterna som finns i det delade röstbiblioteket
    • Accepterar valfria frågeparametrar language (sträng) och model_id (sträng)
    • Varje accent returnerar accent, language, code och name

Uppdaterade slutpunkter

ElevenAgents

  • Lista konversationer - GET /v1/convai/conversations
    • Lade till valfria strängmatrisfilter för visited_agent_ids och visited_agent_branch_ids, begränsade till 50 värden vardera
    • Lade till valfria strängmatriser data_collection_ids och evaluation_criteria_ids för att välja analysresultat för varje sammanfattning
    • Svarssammanfattningar lägger till de valfria objektfälten data_collection_results och evaluation_criteria_results, samt strängmatrisen tag_ids
  • Textsök i konversationsmeddelanden - GET /v1/convai/conversations/messages/text-search
    • Lade till valfria strängmatrisfilter för visited_agent_ids och visited_agent_branch_ids, begränsade till 50 värden vardera
  • Hämta WebRTC-token - GET /v1/convai/conversation/token
    • Svar kräver nu conversation_id (sträng)
    • Inkompatibelt: strikta svarsvaliderare och deserialiserare måste acceptera det nya obligatoriska fältet

Schemaändringar

ElevenAgents

  • Inställningar för agentplattformens begäran och svar lägger till det valfria, nullbara fältet analysis_items, typat som AgentAnalysisItems, för refererad utvärderings- och datainsamlingskonfiguration
  • Procedurreferenser lägger till trigger (sträng), referenced_tool_ids (strängmatris), referenced_kb_ids (strängmatris), referenced_procedure_ids (strängmatris) och referenced_dynamic_variables (strängmatris)
  • KnowledgeBaseRagToolResultModel lägger till chunks (KnowledgeBaseRagChunkModel[])

Studio

  • ProjectCreationMetaResponseModel.status lägger till draft
  • ProjectCreationMetaResponseModel.type refererar nu till den delade enumen ProjectCreationMetaType

Arbetsytor

  • WebhookUsageType lägger till Flows