Runway Dev — Characters

Companion : Utilise +runway-dev pour la configuration partagée quand disponible. Sinon, connecte Dev MCP, sélectionne un projet avec list_projects, lis la documentation Characters depuis llms.txt, et conserve RUNWAYML_API_SECRET côté serveur.

Objectif

Maintenir une intégration Characters et son cycle de vie Session en direct corrects dans le backend et l'interface de l'application. Vérifie les modifications bout en bout quand c'est sûr.

Terminologie

• Characters Dev Portal = avatars API (list_avatars, get_avatar).
• Character ID = UUID avatar.
• live Session = conversation en temps réel via POST /v1/realtime_sessions.
• Preset par défaut quand l'utilisateur en veut un : influencer ({ type: 'runway-preset', presetId: 'influencer' }).

Aucun character spécifié

1. Demande si l'utilisateur veut un character existant, un preset, ou un character personnalisé à partir d'une image. Ne bifurque pas vers la génération avatar-vidéo sauf demande explicite.
2. Pour un character personnalisé, demande à l'utilisateur de fournir l'image et utilise create_avatar selon le schéma de son outil MCP en direct. Si l'utilisateur préfère un preset, utilise influencer.
3. Implémente le cycle de vie Session derrière la limite du serveur : création une fois, interroge NOT_READY jusqu'à READY, consomme les identifiants de connexion une fois, et retourne seulement les champs de connexion dont le client a besoin.
4. Connecte l'interface d'appel de l'application avec le Avatar SDK actuel, puis termine ou annule la Session lors du teardown pour qu'elle ne continue pas de tourner.
5. Pour la vérification bout en bout, connecte une Session avec succès et termine-la proprement.

Character spécifié

1. get_avatar pour l'état et les IDs des documents de connaissance attachés.
2. Utilise cet ID de character ; ne substitue pas un autre avatar.
3. Si l'état est PROCESSING, interroge jusqu'à READY ou arrête sur FAILED.

Outils MCP

• list_avatars / get_avatar — inspecte les avatars personnalisés du projet.
• create_avatar / update_avatar / delete_avatar — gère les characters personnalisés ; confirme les changements destructifs avant de les appliquer.
• list_avatar_knowledge_documents / get_avatar_knowledge_document — inspecte la connaissance attachée.
• create_avatar_knowledge_document / update_avatar_knowledge_document / delete_avatar_knowledge_document — gère la connaissance métier sur demande ; confirme la suppression d'abord.

Docs

• https://docs.dev.runwayml.com/llms.txt
• Characters : https://docs.dev.runwayml.com/_llms-txt/characters.txt
• Avatar SDK : https://github.com/runwayml/avatar-sdk-react