Skip to navigation

ElevenAgents

  • WhatsApp-branch- en omgevingsoverschrijvingen: Uitgaande WhatsApp-berichten en uitgaande gesprekken houden nu rekening met branch_id en environment die zijn doorgegeven in conversation_initiation_client_data. Overschrijvingen worden gevalideerd voordat er iets wordt verstuurd — een onbekende branch of omgeving wordt met een fout afgewezen — en blijven behouden voor het gesprek, zodat het antwoord van een klant wordt hervat in de aangevraagde branch en omgeving. Bekijk de WhatsApp-handleiding voor voorbeelden.
  • Procedure-API’s: Acht openbare, branchgebonden bewerkingen toegevoegd voor het beheren van procedures. Je kunt procedures maken, weergeven, ophalen en verwijderen; conceptwijzigingen maken, ophalen of verwerpen; en procedureconcepten compileren tot een agentworkflow. Bij het maken van een procedure kun je name, content, type en trigger opgeven. Een lege trigger maakt een subprocedure, terwijl een weggelaten of null-trigger wordt afgeleid uit de procedure-inhoud.
  • Crawljobs voor de kennisbank: API’s toegevoegd om crawljobs te maken, weer te geven, te bekijken en te annuleren. Bij create-requests is url (string) vereist en worden crawldiepte, paginalimieten, URL-patronen, sitemap-URL’s, mapplaatsing, automatische synchronisatie en het verwijderen van niet-beschikbare documenten ondersteund.
  • Bulkbeheer van de kennisbank: Bulkafhankelijkheidscontroles en bulksgewijs verwijderen toegevoegd voor 1–20 unieke document- of map-ID’s. Afhankelijkheidscontroles ondersteunen paginering en dependent_type; verwijderen retourneert een onafhankelijke geslaagde of mislukte uitkomst voor elke ID. Met force: true worden ook afhankelijkheden verwijderd en niet-lege mappen recursief verwijderd.
  • Export van resultaten van batchgesprekken: Resultaten van batchgesprekken exporteren toegevoegd om ontvangers en gespreksresultaten van een voltooide batch als CSV te downloaden.
  • Gespreksfilters en analysedata: Gesprekken weergeven en Tekstzoeken in gespreksberichten voegen optionele arrayfilters visited_agent_ids en visited_agent_branch_ids toe, elk beperkt tot 50 waarden. Requests voor weergeven accepteren ook data_collection_ids en evaluation_criteria_ids om overeenkomstige resultaten in elke gesprekssamenvatting op te nemen. Samenvattingen voegen de optionele velden data_collection_results, evaluation_criteria_results en tag_ids toe.
  • Analyseconfiguratie via verwijzingen: Instellingen voor het agentplatform voegen het optionele veld analysis_items toe, dat nullable is en het type AgentAnalysisItems heeft, om evaluatie- en dataverzamelingsitems via verwijzingen te koppelen. De waarde null geeft aan dat de agent nog de verouderde inlinevelden gebruikt; een lege waarde geeft aan dat een gemigreerde agent geen gekoppelde items heeft.
  • Metagegevens van procedureafhankelijkheden: Procedureverwijzingen voegen trigger (string) en arrays toe voor referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids en referenced_dynamic_variables.
  • WebRTC-tokenrespons: Reacties van WebRTC-token ophalen vereisen nu naast token ook conversation_id (string). Dit is een brekende schemawijziging voor clients die de responsvorm valideren of deserialiseren.
  • RAG-resultaten voor de kennisbank: KnowledgeBaseRagToolResultModel voegt chunks (KnowledgeBaseRagChunkModel[]) toe voor de modus RAG-resultaat-in-toolresultaat.

Studio

  • Status van conceptprojecten: ProjectCreationMetaResponseModel.status voegt draft toe. Het projectcreatietype gebruikt nu de gedeelde enum ProjectCreationMetaType met dezelfde bestaande waarden.

Stemmen

  • Stemaccenten: GET /v1/voices/accents toegevoegd om de accenten weer te geven die beschikbaar zijn in de gedeelde stembibliotheek. Resultaten kunnen worden gefilterd op language en model_id, en elk accent retourneert de leesbare accent, language, code en name. De waarde accent kan worden doorgegeven aan de queryparameter accent bij Gedeelde stemmen ophalen om gedeelde stemmen te filteren.

Workspaces

  • Gebruiksrapportage via webhooks: WebhookUsageType voegt Flows toe.

SDK-releases

JavaScript SDK

  • v2.60.0 - voices.accents.get toegevoegd om stemaccenten in de gedeelde stembibliotheek weer te geven, samen met de ElevenAgents-API’s voor procedures, crawljobs voor de kennisbank en bulkbeheer, en de analyseconfiguratie via verwijzingen uit het nieuwste schema.

Python SDK

  • v2.60.0 - De API’s voor stemaccenten, ElevenAgents-procedures, crawljobs voor de kennisbank en bulkbeheer uit het nieuwste schema toegevoegd. Ook het opstarten van AsyncConversation opgelost, zodat dit niet langer blokkeert, en multipartvelden met lijsten van primitieve waarden gecorrigeerd zodat ze als herhaalde formuliervelden worden verstuurd.

Pakketten

API

Nieuwe endpoints

ElevenAgents

  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Maakt een procedure en retourneert de bijbehorende procedure_id (string)
    • Accepteert optionele name (string, maximaal 200 tekens), content (string), type (ProcedureType, standaard free_form) en trigger (nullable string)
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Geeft branchprocedures weer met procedure_id, version_id, name, type, trigger en has_draft
    • Sluit procedure-inhoud uit; haal een afzonderlijke procedure op om de inhoud te lezen
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Accepteert optionele version_id (string); retourneert anders de versie aan de head van de branch
    • Retourneert name, content, type en trigger
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Verwijdert de procedure uit de conceptwerkset van de branch
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Retourneert het huidige procedureconcept
  • PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Maakt of werkt een concept bij
    • Vereist name (string, maximaal 200 tekens), content (string, maximaal 50.000 tekens) en type (ProcedureType); accepteert optionele trigger (nullable string)
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Verwerpt conceptwijzigingen en zet de procedure terug naar de vastgelegde versie
  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
    • Compileert procedureconcepten tot een AgentWorkflowResponseModel
  • Crawljob maken - POST /v1/convai/knowledge-base/crawl
    • Vereist url (string)
    • Accepteert optionele max_depth (integer, 1–5, standaard 3), max_pages (integer, 1–10.000, standaard 1000), pattern (string), sitemap_urls (stringarray), parent_folder_id (string), enable_auto_sync (boolean, standaard false) en auto_remove (boolean, standaard false)
  • Crawljobs weergeven - GET /v1/convai/knowledge-base/crawl
    • Accepteert optionele include_job_ids (stringarray), page_size (integer, 1–100, standaard 30) en cursor (string)
  • Crawljob ophalen - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
  • Crawljob annuleren - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
  • Afhankelijke agents voor meerdere documenten ophalen - POST /v1/convai/knowledge-base/dependent-agents
    • Vereist document_ids (array van 1–20 unieke strings)
    • Accepteert optionele dependent_type (KnowledgeBaseDependentType, standaard all), page_size (integer, 1–100, standaard 30) en cursor (string)
  • Kennisbankdocumenten bulksgewijs verwijderen - POST /v1/convai/knowledge-base/bulk-delete
    • Vereist document_ids (array van 1–20 unieke strings)
    • Accepteert optionele force (boolean, standaard false)
    • Retourneert een geslaagd of mislukt resultaat voor elke document-ID
  • Resultaten van batchgesprekken exporteren - GET /v1/convai/batch-calling/{batch_id}/export
    • Retourneert ontvangers en gespreksresultaten van voltooide batches als CSV

Stemmen

  • GET /v1/voices/accents
    • Geeft de accenten weer die beschikbaar zijn in de gedeelde stembibliotheek
    • Accepteert optionele queryparameters language (string) en model_id (string)
    • Elk accent retourneert accent, language, code en name

Bijgewerkte endpoints

ElevenAgents

  • Gesprekken weergeven - GET /v1/convai/conversations
    • Optionele stringarrayfilters visited_agent_ids en visited_agent_branch_ids toegevoegd, elk beperkt tot 50 waarden
    • Optionele stringarrays data_collection_ids en evaluation_criteria_ids toegevoegd om analyseresultaten voor elke samenvatting te selecteren
    • Responssamenvattingen voegen de optionele objectvelden data_collection_results en evaluation_criteria_results toe, plus de stringarray tag_ids
  • Tekstzoeken in gespreksberichten - GET /v1/convai/conversations/messages/text-search
    • Optionele stringarrayfilters visited_agent_ids en visited_agent_branch_ids toegevoegd, elk beperkt tot 50 waarden
  • WebRTC-token ophalen - GET /v1/convai/conversation/token
    • Reacties vereisen nu conversation_id (string)
    • Brekende wijziging: strikte responsvalidators en deserializers moeten het nieuwe verplichte veld accepteren

Schemawijzigingen

ElevenAgents

  • Request- en responsinstellingen voor het agentplatform voegen het optionele veld analysis_items toe, dat nullable is en het type AgentAnalysisItems heeft, voor evaluatie- en dataverzamelingsconfiguratie via verwijzingen
  • Procedureverwijzingen voegen trigger (string), referenced_tool_ids (stringarray), referenced_kb_ids (stringarray), referenced_procedure_ids (stringarray) en referenced_dynamic_variables (stringarray) toe
  • KnowledgeBaseRagToolResultModel voegt chunks (KnowledgeBaseRagChunkModel[]) toe

Studio

  • ProjectCreationMetaResponseModel.status voegt draft toe
  • ProjectCreationMetaResponseModel.type verwijst nu naar de gedeelde enum ProjectCreationMetaType

Workspaces

  • WebhookUsageType voegt Flows toe