Ozor Vidéothèque

Que fait Ozor Vidéothèque ?

Gérez les vidéos Ozor.ai existantes via le MCP : listez, inspectez, réexportez, intégrez ou envoyez des modifications de suivi à l'agent vidéo. Cette compétence est la surface « tout sauf la création à partir de zéro » pour mcp__ozor__*.

Quand l'utiliser

Utilisez cette compétence lorsque l'utilisateur souhaite opérer sur des vidéos qui existent déjà dans son compte Ozor. Indices :

• « Lister / Afficher mes vidéos »
• « Quel est le statut de ... »
• « Obtenir le lien de partage / le téléchargement / l'intégration pour ... »
• « Réexporter cette vidéo au format 9:16 »
• « Envoyer une modification de suivi : changer la scène 2 pour ... »
• « Montre-moi le plan de cette vidéo »
• « Est-ce que le travail est fini ? » / « Vérifier l'export »

N'utilisez PAS cette compétence quand :

• Créer une nouvelle vidéo à partir de texte → ozor-generate
• Créer à partir d'un document/fichier → ozor-document-video
• Créer à partir d'une URL → ozor-url-to-video

Outils MCP requis

Tâche	Outil
Lister les vidéos récentes	mcp__ozor__list_videos
Obtenir les détails d'une vidéo	mcp__ozor__get_video
Vérifier le statut d'un travail de construction	mcp__ozor__get_job
Bloquer jusqu'à la fin d'un travail	mcp__ozor__wait_for_job
Récupérer le plan à partir duquel une vidéo a été construite	mcp__ozor__get_plan
Modifier un plan	mcp__ozor__update_plan
Déclencher une (nouvelle) exportation	mcp__ozor__export_video
Bloquer jusqu'à ce que l'export soit prêt	mcp__ozor__wait_for_export
Obtenir le <iframe> pour l'intégration	mcp__ozor__get_embed_code
Envoyer un message de modification de suivi à l'agent	mcp__ozor__send_message
Lister les voix disponibles	mcp__ozor__list_voices

Si le MCP n'est pas connecté, informez l'utilisateur et arrêtez-vous.

Flux de travail courants

A. Lister les vidéos récentes

mcp__ozor__list_videos({ limit?: 10 })

Présentez sous forme de tableau :

| # | Titre | Statut | Format | Mis à jour | videoId |
|---|-------|--------|--------|------------|---------|
| 1 | ...   | exporté | 16:9 | il y a 2h | abc...  |

Proposez 2 à 3 actions suivantes évidentes : « Voulez-vous des liens de partage pour l'un d'eux ? Un code d'intégration ? Réexporter l'un d'eux au format 9:16 ? »

B. Obtenir les détails d'une vidéo spécifique

Si l'utilisateur nomme une vidéo ou donne un ID :

mcp__ozor__get_video({ videoId })

Affichez : le titre, le statut actuel (brouillon / en construction / exporté / échoué), le format, la durée, la dernière mise à jour et toutes les URL existantes (partage, éditeur, téléchargement).

C. « Quel est le statut de ma dernière vidéo ? »

1. list_videos({ limit: 1 }) pour trouver la plus récente.
2. Si status est building, appelez également get_job (ou wait_for_job si l'utilisateur souhaite bloquer jusqu'à la fin) pour obtenir la progression.
3. Si status est exporté, affichez les URL.

D. Obtenir le code d'intégration

mcp__ozor__get_embed_code({ videoId })

Si la vidéo n'a pas encore été exportée, lancez d'abord l'exportation (flux F ci-dessous).

E. Obtenir l'URL de partage / téléchargement

Si la vidéo est déjà exportée, get_video renvoie les URL. Sinon :

mcp__ozor__export_video({ videoId })
mcp__ozor__wait_for_export({ videoId })

F. Réexporter (par exemple, l'utilisateur veut un rendu frais après des modifications, ou l'URL a expiré)

mcp__ozor__export_video({ videoId })
mcp__ozor__wait_for_export({ videoId })   // -> nouveau shareUrl, editorUrl, downloadUrl
mcp__ozor__get_embed_code({ videoId })    // -> nouvel iframe

G. Rerendre à un format différent (par exemple, paysage → portrait)

Les changements de format passent par le plan :

1. mcp__ozor__get_plan({ videoId }) — récupérez le plan actuel
2. mcp__ozor__update_plan({ planId, format: "9:16" }) — appliquez la modification
3. mcp__ozor__generate_from_plan({ planId }) fait partie du chemin de création à partir d'un plan — si l'utilisateur souhaite que le même projet soit mis à jour, préférez send_message à la place (flux H). S'il souhaite un nouveau projet au nouveau format, passez à generate_from_plan, puis exportez.

Remarque : generate_from_plan se trouve dans ozor-document-video / ozor-url-to-video car elle crée un nouveau projet. Informez l'utilisateur lorsque vous êtes sur le point de lancer un nouveau projet plutôt que de modifier le projet existant.

H. Envoyer une modification de suivi à l'agent

Pour des retouches de texte/visuel/scène sur une vidéo existante sans repartir de zéro :

mcp__ozor__send_message({
  videoId,
  message: "<la modification de l'utilisateur, par ex. 'Dans la scène 2, change le titre en X et rends le fond plus clair'>"
})

Cela renvoie généralement un nouveau jobId. Ensuite :

mcp__ozor__wait_for_job({ videoId, jobId })
mcp__ozor__export_video({ videoId })
mcp__ozor__wait_for_export({ videoId })

Affichez les nouvelles URL par la suite.

I. Inspecter / modifier un plan

mcp__ozor__get_plan({ videoId | planId })

Rendez les scènes sous forme de liste numérotée à l'utilisateur. S'il souhaite des modifications :

mcp__ozor__update_plan({ planId, ... })

Puis récupérez pour confirmer. Les modifications de plan seules ne changent pas la vidéo rendue — elles doivent être suivies d'une régénération (send_message pour une modification sur place, generate_from_plan pour un nouveau projet) et d'une exportation.

J. Lister les voix

Lorsque l'utilisateur choisit ou change une voix :

mcp__ozor__list_voices()

Présentez une liste compacte (nom, langue, style). Pour changer, update_plan({ planId, voice: "<id de la voix>" }) puis régénérez.

Désambiguïsation de « cette vidéo » / « ma dernière vidéo »

Si l'utilisateur dit « cette vidéo » ou « ma dernière » sans ID :

1. list_videos({ limit: 5 }).
2. Si exactement une correspond à la description, utilisez-la.
3. Si plusieurs correspondances plausibles, affichez la liste courte et demandez laquelle.

Ne choisissez pas une vidéo au hasard en silence.

Présentation des URL

Présentez toujours les URL disponibles avec des étiquettes :

**Partage :** <shareUrl>
**Éditeur :** <editorUrl>
**Téléchargement :** <downloadUrl>
**Intégration :** (dans un bloc de code)

Si une URL n'existe pas encore (par ex. vidéo jamais exportée), n'en inventez pas — dites à l'utilisateur ce qui manque et proposez de lancer l'exportation.

Erreurs et récupération

• videoId introuvable → listez les vidéos récentes et demandez laquelle ils voulaient dire.
• Travail échoué → transmettez le message d'échec textuellement ; proposez send_message avec une correction ou une réexportation.
• Exportation échouée → réessayez une fois ; si elle échoue à nouveau, affichez l'erreur et recommandez d'ouvrir l'URL de l'éditeur pour inspecter.
• Plan / vidéo désynchronisés (plan modifié mais pas régénéré) → dites à l'utilisateur que les modifications sont en attente mais pas rendues, et proposez de régénérer.

Règles

1. N'inventez jamais d'ID de vidéo, d'URL de partage ou de statut. Tout provient du MCP.
2. Pour les modifications sur place, préférez send_message à la création d'un nouveau projet via generate_from_plan. L'utilisateur souhaite presque toujours que la vidéo existante soit mise à jour, pas un doublon.
3. Les réexportations sont peu coûteuses et sûres — si l'utilisateur veut des URL fraîches, relancez simplement l'exportation.
4. Quand l'utilisateur est vague sur quelle vidéo, demandez — affichez une liste courte, ne devinez pas.
5. Affichez chaque URL après chaque régénération ou réexportation. Les URL obsolètes datant de plus tôt dans la conversation peuvent avoir expiré.