Überblick
Der Migrationsprozess umfasst zwei Hauptschritte:- Export: Abrufen der Assistenten-Konfiguration aus dem Quell-Workspace mit der Assistant Get API
- Import: Erstellen eines neuen Assistenten im Ziel-Workspace mit der Assistant Create API
Voraussetzungen
Bevor du beginnst, stelle sicher, dass du folgendes hast:Zwei API-Schlüssel mit AGENT_API Berechtigung:- Einen API-Schlüssel für den Quell-Workspace (wo der Assistent aktuell existiert)
- Einen API-Schlüssel für den Ziel-Workspace (wohin du den Assistenten migrieren möchtest)
- Zugriff auf den Assistenten: Dein Quell-Workspace API-Schlüssel muss Zugriff auf den Assistenten haben, den du migrieren möchtest
- Übereinstimmende Ressourcen im Ziel-Workspace (falls zutreffend):
- Wenn der Ziel-Workspace keinen Zugriff auf dasselbe Modell hat, setze
modelim Skript vor der Migration auf einen verfügbaren Deployment-Namen - Wenn der Assistent benutzerdefinierte Aktionen verwendet, müssen diese Integrationen im Ziel-Workspace aktiviert sein
- Anhänge müssen separat hochgeladen werden (sie werden nicht automatisch übertragen)
- Wenn der Ziel-Workspace keinen Zugriff auf dasselbe Modell hat, setze
Schritt 1: Assistent aus dem Quell-Workspace exportieren
Verwende die Assistant Get API, um die verfügbaren Einstellungen deines Assistenten abzurufen:Die Antwort verstehen
Die Get API gibt die folgenden Assistenten-Einstellungen zurück:name,description,instruction- Die Identität und der System-Prompt des AssistentenemojiIcon- Das Emoji-Icon, das für den Assistenten angezeigt wirdmodel- Kennung des verwendeten Modellstemperature- Kreativitätseinstellung (0-1)conversationStarters- Vorgeschlagene Prompts für BenutzerinputType- Der konfigurierte EingabetypinputFields- Anzeigeeigenschaften der Formularfelder. Die Antwort enthält nicht die zum erneuten Erstellen benötigten Werteslug,options,fileTypesoderemailDomainwebSearchEnabled,imageGenerationEnabled,canvasEnabled- Fähigkeits-FlagsextendedThinking- Ob Extended Thinking aktiviert istactions- Benutzerdefinierte Integrations-Aktionenattachments- UUIDs der angehängten DateienknowledgeFolderIds- UUIDs der verbundenen Ordner
canvasEnabled ist in diesen Endpoints schreibgeschützt und wird bei dieser Migration nicht übertragen.
Schritt 2: Konfiguration transformieren
Die Get API-Antwort verwendet etwas andere Feldnamen als die Create API erwartet. Du musst die Felder mappen:Feld-Mapping Referenz
Schritt 3: Assistent im Ziel-Workspace erstellen
Verwende die Assistant Create API, um den Assistenten im Ziel-Workspace zu erstellen:Vollständiges Migrations-Skript
Hier ist ein vollständiges Skript, das alle Schritte kombiniert:Spezialfälle behandeln
Formularfelder
Die Get API Antwort enthält nicht die von der Create API benötigten Werteslug, options, fileTypes oder emailDomain. Erstelle Formularfelder im Ziel-Workspace manuell neu.
Aktionen (Benutzerdefinierte Integrationen)
Aktionen referenzieren Integrationen, die im Ziel-Workspace aktiviert sein müssen. Aktions-UUIDs sind spezifisch für das Integrations-Setup jedes Workspaces.Anhänge
Anhangs-UUIDs referenzieren Dateien, die im Quell-Workspace gespeichert sind. Diese Dateien werden nicht automatisch übertragen. Um Anhänge zu migrieren:- Lade die Dateien aus dem Quell-Workspace herunter
- Lade sie erneut in den Ziel-Workspace mit der Upload Attachment API hoch
- Aktualisiere den Assistenten mit den neuen Anhangs-UUIDs
OAuth-Verbindungen
Mehrere Assistenten migrieren
Um mehrere Assistenten zu migrieren, durchlaufe einfach eine Liste von Assistenten-IDs:Checkliste nach der Migration
Überprüfe nach der Migration eines Assistenten folgendes im Ziel-Workspace:- Assistent erscheint in der Assistenten-Liste mit korrektem Namen und Emoji
- Beschreibung und Anweisungen wurden korrekt übertragen
- Gesprächsstarter sind vorhanden
- Fähigkeiten (Websuche, Bildgenerierung, etc.) sind korrekt aktiviert
- Eingabefelder wurden manuell neu erstellt (für STRUCTURED Eingabetyp)
- OAuth-Verbindungen manuell über die Oberfläche konfigurieren
- Erforderliche Dateien erneut hochladen und anhängen
- Benutzerdefinierte Aktionen/Integrationen bei Bedarf konfigurieren
- Assistent testen, indem eine Nachricht gesendet wird
Einschränkungen
Behalte diese Einschränkungen bei der Planung deiner Migration im Hinterkopf:
- Anhänge werden nicht übertragen - Dateien müssen im Ziel-Workspace erneut hochgeladen werden
- Aktionen müssen möglicherweise neu konfiguriert werden - Integrations-Aktions-UUIDs sind workspace-spezifisch
- OAuth-Verbindungen erfordern manuelle Einrichtung - Können nicht über die API konfiguriert werden
- Modellzugriff muss übereinstimmen - Die Create API lehnt ein Modell ab, das im Ziel-Workspace nicht verfügbar ist. Setze vor der Migration einen verfügbaren Deployment-Namen
- Gesprächsverlauf wird nicht migriert - Nur die Assistenten-Konfiguration wird übertragen
Migration zur Agents API
Die neue Agents API bietet verbesserte Kompatibilität mit modernen AI SDKs. Der Migrationsprozess ist ähnlich, mit aktualisierten Parameternamen. Sieh dir die entsprechende Anleitung in der Agents API an:- Agent Migrations-Anleitung - Verwendet
agentIdanstelle vonassistantId
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.