Bevor du startest
- Agents API: Dies ist die Agents API mit nativer Vercel AI SDK Kompatibilität.
Überblick
Der Migrationsprozess umfasst zwei Hauptschritte:- Export: Abrufen der Agenten-Konfiguration aus dem Quell-Workspace mit der Agent Get API
- Import: Erstellen eines neuen Agenten im Ziel-Workspace mit der Agent Create API
Voraussetzungen
Bevor du beginnst, stelle sicher, dass du folgendes hast:- Zwei API-Schlüssel mit Agenten API Berechtigung:
- Einen API-Schlüssel für den Quell-Workspace (wo der Agent aktuell existiert)
- Einen API-Schlüssel für den Ziel-Workspace (wohin du den Agenten migrieren möchtest)
- Zugriff auf den Agenten: Dein Quell-Workspace API-Schlüssel muss Zugriff auf den Agenten 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 Agent benutzerdefinierte Aktionen verwendet, müssen diese Integrationen im Ziel-Workspace aktiviert sein
- Anhänge müssen separat hochgeladen werden (sie werden nicht automatisch übertragen)
- Skills müssen im Ziel-Workspace existieren. Skill-UUIDs aus dem Quell-Workspace werden nicht übertragen
- Sub-Agenten und Workflows müssen im Ziel-Workspace existieren. Ihre UUIDs aus dem Quell-Workspace werden nicht übertragen
- Wenn der Ziel-Workspace keinen Zugriff auf dasselbe Modell hat, setze
Schritt 1: Agent aus dem Quell-Workspace exportieren
Verwende die Agent Get API, um die verfügbaren Einstellungen deines Agenten abzurufen:Die Antwort verstehen
Die Get API gibt die folgenden Agenten-Einstellungen zurück:name,description,instruction- Die Identität und der System-Prompt des AgentenemojiIcon- Das Emoji-Icon, das für den Agenten angezeigt wirdmodel- Kennung des verwendeten Modellstemperature- Kreativitätseinstellung (0-1)conversationStarters- Vorgeschlagene Prompts für BenutzerinputType- Der konfigurierte EingabetypinputFields- Formularfelder, inklusiveslug,options,fileTypesundemailDomainwebSearchEnabled,imageGenerationEnabled,canvasEnabled- Fähigkeits-FlagsextendedThinking- Ob Extended Thinking aktiviert istactions- Benutzerdefinierte Integrations-Aktionenattachments- UUIDs der angehängten DateienknowledgeFolderIds- UUIDs der verbundenen OrdnerskillIds- UUIDs der angehängten SkillssubAgents- Angehängte Sub-Agenten, jeweils mitagentIdundrequiresConfirmationworkflowIds- UUIDs der angehängten Workflowsowner- aktueller Eigentümer ({ id, name, email }), odernullwenn nicht zugewiesenaccess- aktuelle Freigabe, wenn der Schlüssel eine direkte Editor- oder Eigentümerfreigabe hat. Siehe Agent Get API
canvasEnabled ist in diesen Endpoints schreibgeschützt und wird bei dieser Migration nicht übertragen. owner wird ebenfalls nicht übertragen. access nutzt IDs aus dem Quell-Workspace und wird nicht kopiert. Der User, dem der API-Schlüssel gehört, wird Eigentümer im Ziel-Workspace.
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: Agent im Ziel-Workspace erstellen
Verwende die Agent Create API, um den Agenten im Ziel-Workspace zu erstellen:Vollständiges Migrations-Skript
Hier ist ein vollständiges Skript, das alle Schritte kombiniert:Spezialfälle behandeln
Formularfelder
Jedes Feld enthältslug, options, fileTypes und emailDomain. Kopiere inputFields in die Create API Anfrage und lass description weg, wenn der Wert null ist. Die Create API lehnt null für diese Eigenschaft ab. options ist [], wenn ein Feld keine Auswahl hat, und fileTypes und emailDomain dürfen null sein.
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 Agenten mit den neuen Anhangs-UUIDs
Skills
Erstelle oder importiere die Skills im Ziel-Workspace mit der Skills API und setze danachskillIds am neuen Agenten. Skill-IDs aus dem Quell-Workspace werden nicht wiederverwendet.
Sub-Agenten und Workflows
Erstelle die Sub-Agenten und Workflows im Ziel-Workspace und setze danachsubAgents und workflowIds am neuen Agenten. IDs aus dem Quell-Workspace werden nicht wiederverwendet. requiresConfirmation kannst du an jedem Sub-Agenten übernehmen. Ein Agent mit Nur direkt lässt sich nicht anhängen, und jeder Workflow muss aktiv sein.
OAuth-Verbindungen
Mehrere Agenten migrieren
Um mehrere Agenten zu migrieren, durchlaufe einfach eine Liste von Agenten-IDs:Checkliste nach der Migration
Überprüfe nach der Migration eines Agenten folgendes im Ziel-Workspace:- Agent erscheint in der Agenten-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 sind richtig konfiguriert (für STRUCTURED Eingabetyp)
- OAuth-Verbindungen manuell über die Oberfläche konfigurieren
- Erforderliche Dateien erneut hochladen und anhängen
- Skills mit IDs aus dem Ziel-Workspace anhängen
- Sub-Agenten und Workflows mit IDs aus dem Ziel-Workspace anhängen
- Benutzerdefinierte Aktionen/Integrationen bei Bedarf konfigurieren
- Agent 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 Agenten-Konfiguration wird übertragen
- Skills werden nicht übertragen - Erstelle die Skills im Ziel-Workspace und hänge sie mit
skillIdsan - Sub-Agenten und Workflows werden nicht übertragen - Erstelle sie im Ziel-Workspace und hänge sie mit
subAgentsundworkflowIdsan
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.