ElevenAgents

  • WhatsApp-Überschreibungen für Branches und Umgebungen: Ausgehende WhatsApp-Nachrichten und ausgehende Anrufe berücksichtigen jetzt branch_id und environment, die in conversation_initiation_client_data übergeben werden. Überschreibungen werden vor dem Versand validiert — eine unbekannte Branch oder Umgebung wird mit einem Fehler abgelehnt — und bleiben für die Unterhaltung bestehen. So wird die Antwort eines Kunden in der angeforderten Branch und Umgebung fortgesetzt. Beispiele finden Sie im WhatsApp-Leitfaden.
  • Procedure-APIs: Acht öffentliche, branch-spezifische Operationen zur Verwaltung von Procedures hinzugefügt. Sie können Procedures erstellen, auflisten, abrufen und entfernen, Entwurfsänderungen erstellen, abrufen oder verwerfen sowie Procedure-Entwürfe in einen Agent-Workflow kompilieren. Das Erstellen von Procedures akzeptiert name, content, type und trigger. Ein leerer trigger erstellt eine Sub-Procedure, während ein ausgelassener oder null-Trigger aus dem Procedure-Inhalt abgeleitet wird.
  • Crawl-Jobs für die Wissensdatenbank: APIs zum Erstellen, Auflisten, Prüfen und Abbrechen von Crawl-Jobs hinzugefügt. Erstellungsanfragen erfordern url (String) und unterstützen Crawl-Tiefe, Seitenlimits, URL-Muster, Sitemap-URLs, Ordnerplatzierung, automatische Synchronisierung und das Entfernen nicht verfügbarer Dokumente.
  • Massenverwaltung der Wissensdatenbank: Massenprüfungen von Abhängigkeiten und Massenlöschung für 1–20 eindeutige Dokument- oder Ordner-IDs hinzugefügt. Abhängigkeitsprüfungen unterstützen Paginierung und dependent_type; die Löschung liefert für jede ID einen unabhängigen Erfolgs- oder Fehlerstatus. Mit force: true werden auch Abhängigkeiten entfernt und nicht leere Ordner rekursiv gelöscht.
  • Export von Batch-Anrufergebnissen: Batch-Anrufergebnisse exportieren hinzugefügt, um Empfänger und Unterhaltungsergebnisse eines abgeschlossenen Batches als CSV herunterzuladen.
  • Unterhaltungsfilter und Analysedaten: Unterhaltungen auflisten und Unterhaltungsnachrichten per Text durchsuchen ergänzen die optionalen Array-Filter visited_agent_ids und visited_agent_branch_ids, jeweils mit maximal 50 Werten. Listenanfragen akzeptieren außerdem data_collection_ids und evaluation_criteria_ids, um entsprechende Ergebnisse in jede Unterhaltungszusammenfassung aufzunehmen. Zusammenfassungen ergänzen optional data_collection_results, evaluation_criteria_results und tag_ids.
  • Referenzierte Analysekonfiguration: Einstellungen der Agent-Plattform ergänzen das optionale, nullable Feld analysis_items vom Typ AgentAnalysisItems, um Evaluierungs- und Datenerfassungselemente per Referenz anzuhängen. Ein Wert von null bedeutet, dass der Agent weiterhin die bisherigen Inline-Felder verwendet; ein leerer Wert weist auf einen migrierten Agenten ohne angehängte Elemente hin.
  • Metadaten zu Procedure-Abhängigkeiten: Procedure-Referenzen ergänzen trigger (String) sowie Arrays für referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids und referenced_dynamic_variables.
  • WebRTC-Token-Antwort: Antworten von WebRTC-Token abrufen erfordern jetzt zusätzlich zu token die conversation_id (String). Dies ist eine nicht abwärtskompatible Schemaänderung für Clients, die das Antwortformat validieren oder deserialisieren.
  • RAG-Ergebnisse der Wissensdatenbank: KnowledgeBaseRagToolResultModel ergänzt chunks (KnowledgeBaseRagChunkModel[]) für den Modus RAG-Ergebnis-in-Tool-Ergebnis.

Studio

  • Entwurfsstatus für Projekte: ProjectCreationMetaResponseModel.status ergänzt draft. Der Projekterstellungstyp verwendet jetzt das gemeinsame Enum ProjectCreationMetaType mit denselben vorhandenen Werten.

Stimmen

  • Stimmakzente: GET /v1/voices/accents hinzugefügt, um die in der gemeinsamen Stimmbibliothek verfügbaren Akzente aufzulisten. Ergebnisse können nach language und model_id gefiltert werden, und jeder Akzent liefert accent, language, code und den lesbaren name. Der Wert accent kann an den Abfrageparameter accent von Gemeinsame Stimmen abrufen übergeben werden, um gemeinsame Stimmen zu filtern.

Workspaces

  • Nutzungsberichte für Webhooks: WebhookUsageType ergänzt Flows.

SDK-Releases

JavaScript SDK

  • v2.60.0 - voices.accents.get hinzugefügt, um Stimmakzente in der gemeinsamen Stimmbibliothek aufzulisten, zusammen mit den APIs für ElevenAgents-Procedures, Crawl-Jobs der Wissensdatenbank, Massenverwaltung und der referenzierten Analysekonfiguration aus dem neuesten Schema.

Python SDK

  • v2.60.0 - APIs für Stimmakzente, ElevenAgents-Procedures, Crawl-Jobs der Wissensdatenbank und Massenverwaltung aus dem neuesten Schema hinzugefügt. Außerdem wurde der Start von AsyncConversation korrigiert, sodass er nicht mehr blockiert, und Multipart-Felder mit Listen primitiver Werte werden nun korrekt als wiederholte Formularfelder gesendet.

Pakete

API

Neue Endpunkte

ElevenAgents

  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Erstellt eine Procedure und gibt ihre procedure_id (String) zurück
    • Akzeptiert optional name (String, maximal 200 Zeichen), content (String), type (ProcedureType, Standardwert free_form) und trigger (nullable String)
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Listet Branch-Procedures mit procedure_id, version_id, name, type, trigger und has_draft auf
    • Schließt Procedure-Inhalte aus; rufen Sie eine einzelne Procedure ab, um ihren Inhalt zu lesen
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Akzeptiert optional version_id (String); gibt andernfalls die Version am Head der Branch zurück
    • Gibt name, content, type und trigger zurück
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Entfernt die Procedure aus dem Entwurfsarbeitsbereich der Branch
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Gibt den aktuellen Procedure-Entwurf zurück
  • PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Erstellt oder aktualisiert einen Entwurf
    • Erfordert name (String, maximal 200 Zeichen), content (String, maximal 50.000 Zeichen) und type (ProcedureType); akzeptiert optional trigger (nullable String)
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Verwirft Entwurfsänderungen und setzt die Procedure auf ihre übertragene Version zurück
  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
    • Kompiliert Procedure-Entwürfe in ein AgentWorkflowResponseModel
  • Crawl-Job erstellen - POST /v1/convai/knowledge-base/crawl
    • Erfordert url (String)
    • Akzeptiert optional max_depth (Integer, 1–5, Standardwert 3), max_pages (Integer, 1–10.000, Standardwert 1000), pattern (String), sitemap_urls (String-Array), parent_folder_id (String), enable_auto_sync (Boolean, Standardwert false) und auto_remove (Boolean, Standardwert false)
  • Crawl-Jobs auflisten - GET /v1/convai/knowledge-base/crawl
    • Akzeptiert optional include_job_ids (String-Array), page_size (Integer, 1–100, Standardwert 30) und cursor (String)
  • Crawl-Job abrufen - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
  • Crawl-Job abbrechen - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
  • Abhängige Agenten für mehrere Dokumente abrufen - POST /v1/convai/knowledge-base/dependent-agents
    • Erfordert document_ids (Array aus 1–20 eindeutigen Strings)
    • Akzeptiert optional dependent_type (KnowledgeBaseDependentType, Standardwert all), page_size (Integer, 1–100, Standardwert 30) und cursor (String)
  • Wissensdatenbankdokumente massenweise löschen - POST /v1/convai/knowledge-base/bulk-delete
    • Erfordert document_ids (Array aus 1–20 eindeutigen Strings)
    • Akzeptiert optional force (Boolean, Standardwert false)
    • Gibt für jede Dokument-ID ein Erfolgs- oder Fehlerergebnis zurück
  • Batch-Anrufergebnisse exportieren - GET /v1/convai/batch-calling/{batch_id}/export
    • Gibt Empfänger und Unterhaltungsergebnisse eines abgeschlossenen Batches als CSV zurück

Stimmen

  • GET /v1/voices/accents
    • Listet die in der gemeinsamen Stimmbibliothek verfügbaren Akzente auf
    • Akzeptiert die optionalen Abfrageparameter language (String) und model_id (String)
    • Jeder Akzent gibt accent, language, code und name zurück

Aktualisierte Endpunkte

ElevenAgents

  • Unterhaltungen auflisten - GET /v1/convai/conversations
    • Optionale String-Array-Filter visited_agent_ids und visited_agent_branch_ids hinzugefügt, jeweils mit maximal 50 Werten
    • Optionale String-Arrays data_collection_ids und evaluation_criteria_ids hinzugefügt, um Analyseergebnisse für jede Zusammenfassung auszuwählen
    • Antwortzusammenfassungen ergänzen die optionalen Objektfelder data_collection_results und evaluation_criteria_results sowie das String-Array tag_ids
  • Unterhaltungsnachrichten per Text durchsuchen - GET /v1/convai/conversations/messages/text-search
    • Optionale String-Array-Filter visited_agent_ids und visited_agent_branch_ids hinzugefügt, jeweils mit maximal 50 Werten
  • WebRTC-Token abrufen - GET /v1/convai/conversation/token
    • Antworten erfordern jetzt conversation_id (String)
    • Nicht abwärtskompatibel: Strikte Antwortvalidatoren und Deserialisierer müssen das neue erforderliche Feld akzeptieren

Schemaänderungen

ElevenAgents

  • Anfrage- und Antworteinstellungen der Agent-Plattform ergänzen das optionale, nullable Feld analysis_items vom Typ AgentAnalysisItems für referenzierte Evaluierungs- und Datenerfassungskonfigurationen
  • Procedure-Referenzen ergänzen trigger (String), referenced_tool_ids (String-Array), referenced_kb_ids (String-Array), referenced_procedure_ids (String-Array) und referenced_dynamic_variables (String-Array)
  • KnowledgeBaseRagToolResultModel ergänzt chunks (KnowledgeBaseRagChunkModel[])

Studio

  • ProjectCreationMetaResponseModel.status ergänzt draft
  • ProjectCreationMetaResponseModel.type verweist jetzt auf das gemeinsame Enum ProjectCreationMetaType

Workspaces

  • WebhookUsageType ergänzt Flows