Ozor Videobibliothek
Verwalten Sie vorhandene Ozor.ai-Videos über das MCP: auflisten, inspizieren, erneut exportieren, einbetten oder Nachbearbeitungen an den Video-Agenten senden. Diese Skill ist die „alles außer Neuerstellung von Grund auf”-Oberfläche für mcp__ozor__*.
Wann verwenden
Verwenden Sie diese Skill, wenn der Benutzer mit bereits vorhandenen Videos in seinem Ozor-Konto arbeiten möchte. Signalwörter:
- „Liste / Zeige meine Videos”
- „Was ist der Status von ...?”
- „Hole den Freigabe-Link / Download / Embed für ...”
- „Exportiere dieses Video erneut als 9:16”
- „Sende eine Nachbearbeitung: Ändere Szene 2 zu ...”
- „Zeige mir den Plan für dieses Video”
- „Ist der Job schon fertig?” / „Prüfe den Export”
Verwenden Sie diese Skill NICHT, wenn:
- Ein neues Video aus Text erstellt werden soll →
ozor-generate - Aus einem Dokument / einer Datei erstellt werden soll →
ozor-document-video - Aus einer URL erstellt werden soll →
ozor-url-to-video
Erforderliche MCP-Tools
| Aufgabe | Tool |
|---|---|
| Letzte Videos auflisten | mcp__ozor__list_videos |
| Details eines einzelnen Videos abrufen | mcp__ozor__get_video |
| Status eines Build-Jobs prüfen | mcp__ozor__get_job |
| Blockieren, bis ein Job abgeschlossen ist | mcp__ozor__wait_for_job |
| Plan abrufen, aus dem ein Video erstellt wurde | mcp__ozor__get_plan |
| Plan bearbeiten | mcp__ozor__update_plan |
| (Neuen) Export auslösen | mcp__ozor__export_video |
| Blockieren, bis Export fertig ist | mcp__ozor__wait_for_export |
<iframe> zum Einbetten abrufen | mcp__ozor__get_embed_code |
| Nachbearbeitungsnachricht an den Agenten senden | mcp__ozor__send_message |
| Verfügbare Stimmen auflisten | mcp__ozor__list_voices |
Wenn das MCP nicht verbunden ist, teilen Sie dem Benutzer dies mit und brechen Sie ab.
Häufige Workflows
A. Letzte Videos auflisten
mcp__ozor__list_videos({ limit?: 10 })
Als Tabelle darstellen:
| # | Titel | Status | Format | Aktualisiert | videoId |
|---|-------|--------|--------|-------------|---------|
| 1 | ... | exportiert | 16:9 | vor 2h | abc... |
2–3 naheliegende nächste Aktionen anbieten: „Möchten Sie Freigabe-Links für eines davon? Einen Embed-Code? Eines als 9:16 erneut exportieren?”
B. Details für ein bestimmtes Video abrufen
Wenn der Benutzer ein Video nennt oder eine ID angibt:
mcp__ozor__get_video({ videoId })
Anzeigen: Titel, aktueller Status (Entwurf / Build läuft / exportiert / fehlgeschlagen), Format, Dauer, letzte Aktualisierung sowie alle vorhandenen URLs (Freigabe, Editor, Download).
C. „Wie ist der Status meines letzten Videos?”
list_videos({ limit: 1 })um das aktuellste zu finden.- Wenn
status=buildingist, zusätzlichget_job(oderwait_for_job, wenn der Benutzer blockieren möchte) aufrufen, um den Fortschritt zu erhalten. - Wenn
status=exportiertist, die URLs anzeigen.
D. Embed-Code abrufen
mcp__ozor__get_embed_code({ videoId })
Wenn das Video noch nicht exportiert wurde, zuerst den Export ausführen (Workflow F unten).
E. Freigabe-/Download-URL abrufen
Wenn das Video bereits exportiert ist, gibt get_video die URLs zurück. Wenn nicht:
mcp__ozor__export_video({ videoId })
mcp__ozor__wait_for_export({ videoId })
F. Erneut exportieren (z. B. Benutzer möchte nach Bearbeitungen einen frischen Render oder die URL ist abgelaufen)
mcp__ozor__export_video({ videoId })
mcp__ozor__wait_for_export({ videoId }) // -> neue shareUrl, editorUrl, downloadUrl
mcp__ozor__get_embed_code({ videoId }) // -> neuer iframe
G. In einem anderen Format neu rendern (z. B. Querformat → Hochformat)
Formatänderungen erfolgen über den Plan:
mcp__ozor__get_plan({ videoId })– aktuellen Plan abrufenmcp__ozor__update_plan({ planId, format: "9:16" })– Änderung anwendenmcp__ozor__generate_from_plan({ planId })liegt auf dem Pfad „aus Plan erstellen” – wenn der Benutzer das gleiche Projekt aktualisiert haben möchte, stattdessensend_messageverwenden (Workflow H). Wenn er ein neues Projekt im neuen Format möchte, aufgenerate_from_planzurückfallen und dann exportieren.
Hinweis: generate_from_plan lebt in ozor-document-video / ozor-url-to-video, weil es ein neues Projekt erstellt. Teilen Sie dem Benutzer mit, wenn Sie ein neues Projekt starten, anstatt das bestehende zu mutieren.
H. Nachbearbeitung an den Agenten senden
Für Text-/Bild-/Szenenänderungen an einem bestehenden Video, ohne von vorne zu beginnen:
mcp__ozor__send_message({
videoId,
message: "<die Bearbeitung des Benutzers, z.B. 'Ändere in Szene 2 die Überschrift auf X und mache den Hintergrund heller'>"
})
Dies gibt in der Regel eine neue jobId zurück. Dann:
mcp__ozor__wait_for_job({ videoId, jobId })
mcp__ozor__export_video({ videoId })
mcp__ozor__wait_for_export({ videoId })
Anschließend die neuen URLs anzeigen.
I. Plan inspizieren / bearbeiten
mcp__ozor__get_plan({ videoId | planId })
Die Szenen als nummerierte Liste für den Benutzer darstellen. Wenn er Änderungen wünscht:
mcp__ozor__update_plan({ planId, ... })
Dann erneut abrufen, um zu bestätigen. Planänderungen allein verändern das gerenderte Video nicht – sie müssen von einer Neugenerierung (send_message für direkte Aktualisierung, generate_from_plan für ein neues Projekt) und einem Export gefolgt werden.
J. Stimmen auflisten
Wenn der Benutzer eine Stimme auswählt oder wechselt:
mcp__ozor__list_voices()
Eine kompakte Liste anzeigen (Name, Sprache, Stil). Bei einem Wechsel: update_plan({ planId, voice: "<Stimmen-ID>" }) und dann neu generieren.
„Dieses Video” / „Mein letztes Video” disambiguieren
Wenn der Benutzer ohne ID „dieses Video” oder „mein letztes” sagt:
list_videos({ limit: 5 }).- Wenn genau eines zur Beschreibung passt, verwenden.
- Bei mehreren plausiblen Treffern die Kurzliste zeigen und nachfragen.
Kein stilles Auswählen eines zufälligen Videos.
URLs präsentieren
Verfügbare URLs immer beschriftet präsentieren:
**Freigabe:** <shareUrl>
**Editor:** <editorUrl>
**Download:** <downloadUrl>
**Embed:** (in einem Code-Block)
Wenn eine URL noch nicht existiert (z. B. Video nie exportiert), keine erfinden – dem Benutzer mitteilen, was fehlt, und den Export anbieten.
Fehler und Wiederherstellung
videoIdnicht gefunden → letzte Videos auflisten und fragen, welches gemeint war.- Job fehlgeschlagen → die Fehlermeldung wörtlich weitergeben;
send_messagemit einem Fix oder einen erneuten Export anbieten. - Export fehlgeschlagen → einmal wiederholen; bei erneutem Fehlschlag den Fehler anzeigen und empfehlen, die Editor-URL zu öffnen, um zu prüfen.
- Plan / Video nicht synchron (Plan bearbeitet, aber nicht neu generiert) → dem Benutzer mitteilen, dass die Änderungen bereitstehen, aber nicht gerendert sind, und die Neugenerierung anbieten.
Regeln
- Nie Video-IDs, Freigabe-URLs oder Status erfinden. Alles kommt vom MCP.
- Für direkte Änderungen
send_messagevorziehen gegenüber der Erstellung eines neuen Projekts viagenerate_from_plan. Der Benutzer möchte fast immer das bestehende Video aktualisiert, kein Duplikat. - Erneute Exporte sind günstig und sicher – wenn der Benutzer frische URLs möchte, einfach den Export erneut ausführen.
- Wenn der Benutzer vage ist, welches Video gemeint ist, nachfragen – eine Kurzliste zeigen, nicht raten.
- Jede URL nach jeder Neugenerierung oder jedem erneuten Export anzeigen. Veraltete URLs aus früheren Unterhaltungen könnten abgelaufen sein.