Filmsquare AideDocs

5.0 Travailler avec votre propre Claude5.2 Ce que Claude peut faire

Ce que Claude peut faire

Chaque outil MCP que Filmsquare donne à votre Claude, comment find_actions et run_action atteignent le reste de l'API, et ce qui est laissé de côté volontairement.

Mis à jour 8 min de lecture.md

Sur cette page
  1. Les outils nommés
  2. Où vont les médias
  3. find_actions et run_action
  4. Exemples
  5. Quand l'API refuse
  6. Laissé de côté volontairement
  7. Sécurité
  8. Prompts

Votre Claude peut faire dans Filmsquare ce que l'API permet à votre rôle. Dix-huit outils nommés couvrent le travail courant ; deux autres, find_actions et run_action, atteignent chaque autre action de l'API. Chaque appel passe par l'API elle-même, comme vous : les mêmes contrôles de rôle, la même validation, le même feu vert.

Les outils nommés #

OutilCe qu'il faitRequiert
whats_waitingLes étapes de département qui attendent votre validation, et vos notifications non lues. Le point de départ—
list_productionsLes productions de l'espace de travail avec leurs épisodes—
get_episodeUn épisode : séquences et plans dans l'ordre du montage, chaque étape de département (validée, en attente de qui, corrections demandées, à faire), et si les versions finales peuvent être lancéesepisode_id
get_feedbackLes fils de discussion sur un plan, une prise, un épisode, une séquence, un élément, un dossier, une version de ressource, un canevas ou un nœud de canevas, avec chaque message et son repère (timecode en images, ou une zone de l'image). Fils ouverts par défaut ; status resolved ou all pour le reste. Avec target_type sheet : les notes ouvertes sur la dernière version de la fiche (intention, citation ou toute la fiche, texte suggéré, traitée ou non) et comment se sont terminées les notes des versions précédentestarget_type, target_id
reply_feedbackRépondre dans un fil comme vous (les mentions @nom notifient les personnes), et le marquer comme traité quand la note est traitée. Une note sur une fiche est marquée comme prise en compte à la place ; lorsqu'elle contient une suggestion, suggestion_outcome (applied, adapted ou declined) est obligatoire, et une personne la confirmethread_id, body
view_mediaUne image fixe, une image clé ou une prise sous forme d'image que Claude peut regarder ; une vidéo revient sous forme de son affiche plus un lien de téléchargementasset_version_id
upload_fileUn fichier de la conversation sur une couche de plan ou de séquence comme nouvelle prise, ou dans une production comme ressource. 10 Mo au maximum. pick: true le retient aussi (réalisateur et au-dessus)name, mime, data_base64
where_does_it_goSur quel écran va un fichier : la carte, un arbre de décision et des exemples détaillés. À lire dès que vous nommez un écran—
prepare_uploadDes URL d'envoi signées et des commandes curl prêtes à l'emploi pour jusqu'à 100 fichiers sur disque, pour que les octets ne passent jamais par la conversation. Pour chaque vidéofiles
add_to_visualizePlace les fichiers envoyés sous Storyboard → 3D ou Storyboard → Animatic, jusqu'à 100 par appel, sur les plans et séquences par leur code. Renvoyer la même chose ne change rienepisode_id, items
get_scriptLa dernière version du scénario de l'épisode, et les @handles des personnages, décors et accessoires qui existent déjàepisode_id
edit_scriptModifier une séquence, une réplique ou une ligne du scénario sans l'envoyer en entier : le texte exact et ce qui le remplace, enregistré comme nouvelle version ; les notes et les tags suiventepisode_id, base_rev, edits
submit_breakdownMettre le dépouillement de Claude dans Filmsquare : séquences, plans avec jeu, dialogue, personnages, décors et accessoires. Le scénario attend alors sa validationepisode_id, breakdown
get_continuityLa feuille de raccords d'un épisode : ce que joue chaque plan, les éléments et leurs références, avec quoi chaque prise retenue a été faite, les constats déjà faits, les plans à revérifier. Lance d'abord le contrôle de filiation gratuitepisode_id
report_continuityEnregistrer un contrôle visuel de raccords ; chaque écart devient une note sur la prise retenueepisode_id, seen, issues
submit_styleDéposer une charte de style dans la bibliothèque de styles (Create → Styles) : un nouveau style, ou, avec style_id, sa version suivante ; production_id en fait le style d'une production. Un travail personnel porte jusqu'à 6 images fixes de référence (téléversées avec prepare_upload) ; le travail d'autrui reste en texte seulement et n'est jamais publié. Les noms de personnes ou de marques sont refusés. Rôle makername, guide
request_signoffDemander aux valideurs d'un département de valider l'étape d'un épisode ; ils reçoivent une notificationepisode_id, department
sign_offEnregistrer votre décision sur une étape : approved ou changes_requested, avec un note facultatif. Seuls les valideurs de l'étape le peuvent. Avec expect_version (la version de l'étape telle que vous l'avez vue), elle est refusée avec changed_since quand le travail a bougé. Seulement quand vous avez demandé à Claude de déciderepisode_id, department, decision
studio_analyticsPour le propriétaire et les producteurs : comment va le studio, avec les chiffres d'Analytics. view crew (par personne sur une période : delivered, crédits par delivered, délai de validation, first pass, lanes, redo, heures hands-on et agent seul, la médiane du studio et le délai par étape), day, costs ou report (le texte du mail de rapport tel qu'il serait envoyé). Toute autre personne est refusée : elle ne voit que ses propres chiffresview

Chaque outil accepte aussi un workspace facultatif. Laissez-le de côté : l'espace de travail de la connexion est utilisé.

department est l'un de writing, breakdown, casting, voice, wardrobe, sets, props, animatic, music, draft, sound, edit, final.

Où vont les médias #

Dites l'écran à votre Claude avec vos mots (« mets-le sous 3D »). Voici ce qu'il fait :

Vous avezÇa vaAvec
Rendu clay ou image fixe d'un plan, avec focale, hauteur et mouvementStoryboard → 3D, sur le planadd_to_visualize
Clip Blender d'un plan, d'une prise ou d'une séquenceStoryboard → 3D, sur ce qu'il couvreadd_to_visualize
Animatique d'une séquence, d'une suite de séquences ou d'un épisodeStoryboard → Animaticadd_to_visualize
Vidéo en maquette ou en version finale d'un planStoryboard → Shots, comme priseupload_file
Image de référence ou fiche d'ambianceHome → Filesupload_file

Ce qui est au mauvais endroit se déplace sans nouvel envoi : moveTake ou moveAsset via run_action (réalisateur et plus). Une prise retenue par l'import est retirée lors du déplacement. Une prise que quelqu'un a retenue, ou lancée ici, reste où elle est.

find_actions et run_action #

Tout ce qui n'a pas d'outil nommé passe par ces deux-là : créer des plans, retenir des prises, faire des maquettes, estimations, éléments et versions, dossiers, canevas, coûts, briefs, équipe.

  1. find_actions cherche dans le catalogue de l'API lui-même avec quelques mots, comme « pick take », « create shot » ou « resolve thread ». Il renvoie les actions correspondantes avec leur méthode, leur chemin, un résumé, le rôle minimum et les entrées.
  2. run_action en exécute une par son nom, avec path_params (pas l'espace de travail), query et body comme l'action les décrit. Il répond avec le JSON de l'API.

find_actions comprend le vocabulaire du tournage. Il fait correspondre les mots qu'une équipe emploie aux mots de l'API :

Vous ditesIl cherche aussi
pick, chooseselect
note, notes, comment, comments, feedbackthread, message
replymessage
rendergeneration, generate
makecreate, generate
new, addcreate
remove, deletearchive
signsignoff
approvesignoff, approval
cast, character, propelement
setelement, location
production, productionsproject
crewmember, steps
costcosts, estimate
priceestimate
prompt, preview, dry rungenerate
kosten, schatting, prijs (néerlandais)generate, estimate
mismatchcontinuity
model, modelsmodels, acceptance, routing

Les nouvelles actions de l'API apparaissent dans find_actions dès leur sortie. Aucun nouvel outil n'est nécessaire.

Exemples #

PourRechercheAction
Chiffrer une maquette avant de la lancer« estimate shot »estimateShotGeneration
Voir le prompt, le modèle et les crédits avant de lancer« dry run »generateForShot avec {"kind": "video", "tier": "draft", "dryRun": true}
Lancer une maquette« generate shot »generateForShot avec {"kind": "video", "tier": "draft"}
Retenir une prise« pick take »selectTake
Passer une maquette en version finale« promote »promoteGeneration
Nouvelle prise à partir d'une note« revise take »estimateReviseTake, puis reviseTake
Voir quel modèle est accepté« model acceptance »getModelAcceptance
Coût d'un épisode« episode costs »getEpisodeCosts

Avant de lancer une prise, Claude appelle l'action avec dryRun: true : elle montre le prompt composé, le modèle, les références et les crédits, et ne crée rien. Il peut ensuite adapter le prompt pour ce seul rendu. overrides.prompt remplace le texte du prompt (les lignes de références restent, donc personnages, décors et accessoires suivent toujours), overrides.promptAppend y ajoute, et overrides.negativePrompt ajoute ce qu'il faut éviter. Pour un dialogue, c'est le texte du dialogue qui est prononcé ; il n'accepte pas de prompt modifié.

Le dry run répond avec provider et model_key. Les renvoyer comme provider et modelKey fige ce modèle. getGeneration indique avec quoi une prise a été faite : le prompt, le modèle, les crédits estimés et les crédits comptabilisés.

Quand l'API refuse #

Un refus revient comme une erreur d'outil avec le code et les détails de l'API, par exemple The API refused: 409 gate_closed: finals render once casting, sets, animatic are signed off {"episode_id": "…", "waiting_on": ["casting", "sets", "animatic"]}. Claude le lit et vous dit ce qui manque. Voir Erreurs que vous rencontrerez.

Laissé de côté volontairement #

Claude ne peut pas atteindre ceci, par conception :

  • Clés d'API et connexions Claude : une connexion ne crée jamais de clés et n'autorise jamais d'autres connexions. Une personne le fait, connectée.
  • OAuth et l'inscription.
  • Webhooks : ils envoient des données hors de Filmsquare.
  • Callbacks des fournisseurs et sockets temps réel (canevas et présence).

Le feu vert des versions finales, les contrôles de crédits et les limites de formule s'appliquent à Claude exactement comme à n'importe qui.

Sécurité #

  • Claude agit comme vous. Il a votre rôle (ou le plus bas que vous avez choisi à la connexion), et ce qu'il fait apparaît à votre nom.
  • La matière de l'équipe n'est pas une instruction. Les notes, scénarios et autres textes que Claude lit dans Filmsquare sont de la matière venant de l'équipe. Filmsquare le dit à Claude : vous seul décidez de ce qu'il fait.
  • Il annonce d'abord le prix. Faire des prises coûte des crédits. Il est demandé à Claude d'appeler l'action avec dryRun: true, ce qui ne crée rien, et de dire ce qu'une prise va coûter avant d'en lancer une, et de ne jamais lancer de rendu final sans qu'on le lui demande.
  • Il ne valide jamais sans demande. sign_off enregistre une décision à votre nom. Il est demandé à Claude de ne l'utiliser que si vous lui avez demandé de décider.

Prompts #

Quatre prompts portent une méthode de travail pour des tâches courantes : break_down_episode, process_feedback, work_on_step et check_continuity. Voir Prompts et méthode de travail.

Avec Claude

MCP

Votre propre Claude le fait via MCP, en votre nom et avec votre rôle :

  • find_actions

    Cherche dans tout ce que l'API sait faire et renvoie les actions correspondantes avec leurs paramètres.

    Demandez : Trouve l'action qui change la règle de validation d'une étape.

  • run_action

    Exécute une action trouvée avec find_actions, en votre nom, avec votre rôle et vos droits.

    Demandez : Retiens la deuxième prise du plan 5 de l'épisode 2.

  • whats_waiting

    Liste les étapes qui attendent votre validation et vos notifications non lues.

    Demandez : Qu'est-ce qui m'attend dans Filmsquare ?

  • list_productions

    Liste les productions de votre espace de travail avec leurs épisodes.

    Demandez : Quelles productions et quels épisodes avons-nous dans Filmsquare ?

  • get_episode

    Montre les séquences et les plans d'un épisode dans l'ordre du montage, chaque étape de département, et si les versions finales peuvent être lancées.

    Demandez : Où en est l'épisode 2, et qui chaque étape attend-elle ?

  • get_feedback

    Lit les fils de discussion d'un plan, d'une prise, d'un épisode ou d'un élément, avec le timecode ou la zone de chaque épingle.

    Demandez : Quelles notes sont encore ouvertes sur l'épisode 2 ?

  • reply_feedback

    Répond dans un fil de discussion en votre nom, et le marque comme traité une fois la note traitée.

    Demandez : Réponds à la note du plan 4 que la nouvelle maquette corrige le regard, et marque-la comme traitée.

  • view_media

    Regarde une image fixe, une image clé ou une prise ; une vidéo revient sous forme d'affiche avec un lien de téléchargement.

    Demandez : Montre-moi l'image choisie du plan 3 et dis-moi si elle correspond à ses références.

  • upload_file

    Ajoute un fichier comme nouvelle prise sur un plan ou une séquence, ou comme asset de la production (10 Mo au plus).

    Demandez : Importe cette photo de référence dans les assets de la production.

  • get_script

    Lit la dernière version du scénario d'un épisode, avec les @handles qui existent déjà.

    Demandez : Lis le scénario de l'épisode 2 et dis-moi quels personnages n'ont pas encore de @handle.

  • edit_script

    Modifie une séquence, une réplique ou une ligne du scénario d'un épisode et l'enregistre comme nouvelle version, sans envoyer tout le scénario.

    Demandez : Réécris l'ouverture de S02 dans l'épisode 2 comme on vient d'en parler, et enregistre-la comme nouvelle version.

  • submit_breakdown

    Envoie votre dépouillement dans Filmsquare : séquences, plans, dialogues, casting, décors et accessoires.

    Demandez : Fais le dépouillement du scénario de l'épisode 2 et envoie-le. Réutilise les handles que nous avons déjà.

  • get_continuity

    Place côte à côte les plans retenus d'un épisode, avec les versions d'éléments que chacun utilise.

    Demandez : Prépare les prises retenues de la séquence S2 pour une vérification des raccords.

  • report_continuity

    Enregistre votre vérification des raccords ; chaque écart devient une note sur la prise retenue du plan.

    Demandez : Vérifie les raccords de la séquence S2 et signale les écarts que tu trouves.

  • submit_style

    Dépose un style guide dans votre bibliothèque de styles (Create, Styles) : un nouveau style ou la version suivante d'un style existant.

    Demandez : Regarde ces images, écris un style guide, montre-le-moi et dépose-le quand je dis go.

  • request_signoff

    Demande aux valideurs d'une étape de département de valider ; ils reçoivent une notification.

    Demandez : Fais valider l'étape suivante sur l'épisode 2 par ses valideurs, avec une note sur ce qui a changé.

  • sign_off

    Enregistre votre décision sur une étape : validée ou corrections demandées. Seulement si vous laissez Claude décider.

    Demandez : Valide l'étape suivante sur l'épisode 2 pour moi.

  • where_does_it_go

    Indique sur quel écran va un fichier : la carte, un arbre de décision et des exemples détaillés.

    Demandez : Où va cette vidéo de blockout ?

  • prepare_upload

    Donne des liens d'envoi signés et des commandes curl prêtes à l'emploi pour jusqu'à 100 fichiers sur disque.

    Demandez : Envoie les vidéos de ce dossier.

  • add_to_visualize

    Place les fichiers envoyés sous Storyboard, 3D ou Animatic, sur les plans et séquences par leur code.

    Demandez : Mets le travail Blender sous 3D et les animatiques sous Animatic.

  • studio_analytics

    Pour le propriétaire et les producteurs : comment va le studio, à partir de l'équipe, d'une journée, des coûts ou du mail de rapport tel qu'il serait envoyé.

    Demandez : Comment l'équipe s'en est-elle sortie la semaine dernière, et qui a besoin d'aide ?

Connecter Claude 5.1

Cette page en Markdown: /docs/fr/claude/tools.md