Agents Platform

  • Agent-Branches und Deployments: Ein vollständiges Versionskontrollsystem für Agents hinzugefügt, das Teams ermöglicht, Branches zu erstellen, Agentenkonfigurationen isoliert weiterzuentwickeln und Änderungen zusammenzuführen, wenn sie bereit sind. Neue Endpunkte umfassen POST /v1/convai/agents/{agent_id}/branches zum Erstellen von Branches, POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge zum Zusammenführen und POST /v1/convai/agents/{agent_id}/deployments zum Erstellen von Deployments. Entwürfe können auch über die neuen Entwurfsendpunkte erstellt und gelöscht werden. Weitere Informationen finden Sie in der Dokumentation zu Branches und Deployments.
  • Verwaltung von WhatsApp-Konten: Endpunkte PATCH und DELETE für WhatsApp-Business-Konten hinzugefügt, mit denen Sie verbundene WhatsApp-Konten bei Agents aktualisieren und entfernen können.
  • Name des Gesprächs-Agents: Der Endpunkt Gespräch abrufen gibt jetzt agent_name in der Antwort zurück, damit Sie leichter erkennen können, welcher Agent ein Gespräch geführt hat.
  • Nachverfolgung von Fehlertypen: Feld error_type zu Gesprächsereignismodellen hinzugefügt, um Debugging und Fehlerkategorisierung zu verbessern.

Wissensdatenbank

  • Ordnerverwaltung: Unterstützung zum Organisieren von Wissensdatenbankdokumenten in Ordnern hinzugefügt. Neue Endpunkte umfassen Ordner erstellen zum Erstellen von Ordnern, Dokument verschieben zum Verschieben einzelner Dokumente und Massenverschiebung zum gleichzeitigen Verschieben mehrerer Dokumente.

Tools

  • Erweiterte Tool-Auflistung: Der Endpunkt Tools abrufen unterstützt jetzt Filterung und Paginierung mit neuen Abfrageparametern wie search, page_size, types, sort_by, sort_direction und cursor. Die Antwort enthält jetzt die Felder next_cursor und has_more für die Paginierung.

Musik

  • Erweiterungen für Songmetadaten: Die Felder bpm und time_signature zu Songmetadaten hinzugefügt, um umfassendere Informationen zur Audioanalyse bereitzustellen.

ElevenCreative Studio

  • Vorlagen für Untertitelstile: Feld caption_style_template_overrides zu Projektmodellen hinzugefügt, um die Untertitelgestaltung pro Vorlage anzupassen.
  • Projekttyp für Videosynchronisation: dub_video zur Enumeration des Projekterstellungstyps hinzugefügt.
  • Veröffentlichungsmetadaten: Zeitstempel last_updated_from_project_unix zu Veröffentlichungs- und Projektmetadaten hinzugefügt.

Workspaces

  • Verwaltung von Platztypen: Neue Enumeration SeatType mit den Feldern seat_type und workspace_seat_type eingeführt. Die bisherigen Felder workspace_permission und workspace_role werden eingestellt.
  • Berechtigung für Workspace-Analysen: workspace_analytics_full_read zur Enumeration PermissionType für granulare Zugriffskontrolle auf Analysen hinzugefügt.

SDK-Releases

Python SDK

  • v2.32.0 - Endpunkte für Agent-Branching, Deployments und Entwürfe, Ordnerverwaltung für die Wissensdatenbank, erweiterte Tool-Auflistung mit Filterung und Paginierung sowie Verwaltung von Platztypen hinzugefügt

JavaScript SDK

  • v2.33.0 - Endpunkte für Agent-Branching, Deployments und Entwürfe, Ordnerverwaltung für die Wissensdatenbank, erweiterte Tool-Auflistung mit Filterung und Paginierung sowie Verwaltung von Platztypen hinzugefügt

API

Neue Endpunkte

  • Agent-Branches auflisten - GET /v1/convai/agents/{agent_id}/branches - Alle Branches eines Agents auflisten
  • Agent-Branch erstellen - POST /v1/convai/agents/{agent_id}/branches - Einen neuen Branch für einen Agent erstellen
  • Agent-Branch abrufen - GET /v1/convai/agents/{agent_id}/branches/{branch_id} - Einen bestimmten Branch abrufen
  • Agent-Branch aktualisieren - PATCH /v1/convai/agents/{agent_id}/branches/{branch_id} - Branch-Konfiguration aktualisieren
  • Agent-Branch zusammenführen - POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge - Einen Branch in einen Ziel-Branch zusammenführen
  • Deployment erstellen - POST /v1/convai/agents/{agent_id}/deployments - Agent-Deployments erstellen oder aktualisieren
  • Entwurf erstellen - POST /v1/convai/agents/{agent_id}/drafts - Einen Agent-Entwurf erstellen
  • Entwurf löschen - DELETE /v1/convai/agents/{agent_id}/drafts - Einen Agent-Entwurf löschen
  • Ordner erstellen - POST /v1/convai/knowledge-base/folder - Einen Ordner zum Gruppieren von Dokumenten erstellen
  • Dokument verschieben - POST /v1/convai/knowledge-base/{document_id}/move - Ein Dokument in einen Ordner verschieben
  • Massenverschiebung - POST /v1/convai/knowledge-base/bulk-move - Mehrere Dokumente in einen Ordner verschieben

Aktualisierte Endpunkte

Agents Platform

  • Tools abrufen
    • Abfrageparameter search (String, optional) zum Filtern von Tools nach Namenspräfix hinzugefügt
    • Abfrageparameter page_size (Ganzzahl, optional, maximal 100, Standardwert 30) hinzugefügt
    • Abfrageparameter show_only_owned_documents (boolesch, optional, Standardwert false) hinzugefügt
    • Abfrageparameter types (Array, optional) zum Filtern nach Tool-Typ hinzugefügt
    • Abfrageparameter sort_by (Enum, optional) zum Sortieren von Ergebnissen hinzugefügt
    • Abfrageparameter sort_direction (Enum, optional) für die Sortierreihenfolge hinzugefügt
    • Abfrageparameter cursor (String, optional) für die Paginierung hinzugefügt
    • Die Antwort enthält jetzt die Felder next_cursor (String) und has_more (boolesch, erforderlich)
  • Agent erstellen
    • Anfrageschema mit Unterstützung für Branching aktualisiert
  • Gespräch abrufen
    • agent_name (String, optional) zum Antwortmodell hinzugefügt
  • Agent-Entwurf erstellen
    • Feld tags optional gemacht und aus den erforderlichen Feldern entfernt

Aussprachewörterbücher

  • Regeln hinzufügen
    • Beschreibung aktualisiert, um klarzustellen, dass Regeln mit doppelten string_to_replace-Werten ersetzt werden

Workspaces

ElevenCreative Studio

  • Projekt erstellen
    • Feld create_publishing_read (boolesch, optional) hinzugefügt
    • dub_video zur Enumeration des Projekttyps hinzugefügt
  • Projekt abrufen, Projekt aktualisieren
    • caption_style_template_overrides (Objekt, optional) für benutzerdefinierte Untertitelgestaltung hinzugefügt

Schemaänderungen

Neue Schemas

  • AgentBranch, AgentBranchInput, AgentBranchOutput - Branch-Konfiguration für Agents
  • AgentDeployment, AgentDeploymentInput - Deployment-Konfiguration für Agents
  • AgentVersion - Informationen zur Agentenversion
  • BranchProtectionStatus - Einstellungen für den Branch-Schutz
  • SeatType - Enumeration für Workspace-Platztypen
  • ToolSortBy - Enumeration für Tool-Sortieroptionen
  • ToolTypeFilter - Enumeration zum Filtern von Tools nach Typ
  • CaptionStyleModel - Konfiguration des Untertitelstils

Geänderte Schemas

  • ToolsResponseModel - Felder next_cursor und has_more für die Paginierung hinzugefügt
  • SongMetadata - Felder bpm (Zahl) und time_signature (String) hinzugefügt
  • GetConversationResponseModel - Feld agent_name hinzugefügt
  • PermissionType - Enum-Wert workspace_analytics_full_read hinzugefügt
  • ProjectCreationType - Enum-Wert dub_video hinzugefügt
  • Mehrere Ereignismodelle - Feld error_type zur Fehlerkategorisierung hinzugefügt