Aller au contenu

Référence

Outils

Ce qu’un agent peut appeler. SPREVA propose 49 outils, et ceux du Studio et des images générées par l’IA nécessitent un forfait qui inclut le Studio.

Tous les outils

  • fetch

    Lire un élément en entier

    Lit une publication, un fichier, une campagne, une file d’attente, un compte ou un projet Studio à partir de son lien ou de son identifiant, ou une page de la référence de SPREVA.

    Risque
    Faible
    Lecture seule
  • overview

    Vue d’ensemble de l’espace de travail

    Le premier appel d’une conversation : le fuseau horaire et l’heure, ce qui demande votre attention, les prochaines publications, les comptes, les files d’attente et les campagnes, et ce que permet le forfait.

    Risque
    Faible
    Lecture seule
  • list_workspaces

    Vos espaces de travail

    Liste les espaces de travail où cette connexion peut agir, avec votre rôle et le fuseau horaire de chacun, et indique dans lequel les appels sont faits maintenant.

    Risque
    Faible
    Lecture seule
  • switch_workspace

    Changer d’espace de travail

    Déplace la conversation vers un autre de vos espaces de travail, par son nom ou son lien, lorsque la connexion a été autorisée dans tous. Les appels suivants utilisent les comptes, les fichiers et les autorisations d’agent de cet espace.

    Risque
    Faible
  • save_workspace

    Modifier les paramètres de l’espace de travail

    Renomme l’espace de travail ou change son fuseau horaire, la langue des descriptions des fichiers et la description automatique des nouveaux fichiers. Le Propriétaire et les Administrateurs peuvent le faire. Un nouveau fuseau horaire ne déplace pas les publications déjà programmées.

    Risque
    Moyen
  • list_members

    Les personnes de l’espace de travail

    Liste les membres avec leur e-mail et leur rôle, ainsi que les invitations en attente et la date d’expiration de chaque lien.

    Risque
    Faible
    Lecture seule
  • invite_member

    Inviter quelqu’un

    Invite une personne par e-mail avec un rôle, toujours après un aperçu à confirmer, car elle reçoit un e-mail et peut occuper une place de l’offre. Une personne qui a déjà un compte SPREVA à cette adresse rejoint l’espace aussitôt. Le Propriétaire et les Administrateurs peuvent le faire ; un Administrateur ne peut pas inviter un Propriétaire.

    Risque
    Élevé
  • save_post

    Créer ou modifier une publication

    Rédige une publication pour un ou plusieurs comptes, avec ce qui diffère d’un compte à l’autre, et fixe quand elle part : une heure, le prochain créneau d’une file d’attente ou un brouillon. Dans un espace de travail qui exige une approbation, une heure ou une file d’attente l’envoie plutôt en relecture, et elle part dès qu’une personne l’approuve.

    Risque
    Moyen, Élevé quand elle part dans moins d’une heure.
  • publish_post

    Mettre en ligne une publication maintenant

    Met en ligne une publication sur tous ses comptes, ou de nouveau uniquement là où elle a échoué. Ce qui est déjà parti n’est jamais publié deux fois. Dans un espace de travail qui exige une approbation, une publication que personne n’a approuvée est refusée : envoyez-la en relecture avec save_post et une heure ou une file d’attente.

    Risque
    Élevé
  • delete_post

    Supprimer une publication

    Retire de SPREVA un brouillon, une publication programmée ou une publication publiée. Une publication publiée reste en ligne sur les réseaux.

    Risque
    Moyen, Élevé pour une publication publiée.
  • import_media

    Importer un fichier dans la médiathèque

    Ajoute une image ou une vidéo à la médiathèque à partir d’un lien public, ou à partir des octets que l’agent importe.

    Risque
    Moyen
  • update_media

    Renommer, étiqueter, classer ou décrire un fichier de la médiathèque

    Modifie le nom, les étiquettes, le dossier ou le texte alternatif d’un fichier, et peut rédiger le texte alternatif d’après ce que montre l’image.

    Risque
    Moyen, Élevé quand il rédige le texte alternatif avec l’IA.
  • delete_media

    Supprimer des fichiers de la médiathèque

    Supprime un ou plusieurs fichiers (images, vidéos, audio) de la médiathèque, après un aperçu et une confirmation qui montrent où chacun est utilisé et l’espace libéré. Les fichiers utilisés par des publications non publiées ou des projets Studio sont refusés, sauf si l’agent force la suppression.

    Risque
    Élevé
  • share_media

    Partager un fichier ou un dossier avec d'autres espaces de travail

    Prête un fichier de la bibliothèque ou un dossier entier à vos autres espaces de travail comme références en lecture seule : rien n'est copié, ils peuvent l'utiliser dans des vidéos et des publications, mais pas le modifier ni le supprimer. Le reprendre demande une confirmation lorsque des vidéos ou des publications l'utilisent.

    Risque
    Moyen, Élevé pour reprendre un fichier utilisé par des vidéos ou des publications d'un autre espace de travail.
  • save_campaign

    Créer ou modifier une campagne

    Crée ou modifie une campagne, et y ajoute des publications ou les en retire.

    Risque
    Moyen
  • save_queue

    Créer ou modifier une file d’attente

    Crée ou modifie des horaires de publication : leur nom, leur fuseau horaire et leurs créneaux hebdomadaires.

    Risque
    Moyen
  • analytics

    Résultats des publications

    Les totaux comparés à la période précédente, les meilleures publications, la répartition par réseau et des comparaisons avec la taille de leurs échantillons, pour l’espace de travail, une campagne, un compte ou une publication.

    Risque
    Faible
    Lecture seule
  • refresh_metrics

    Actualiser les chiffres

    Lit tout de suite auprès des réseaux les chiffres d’une publication ou les abonnés d’un compte, sans attendre le calendrier habituel, et laisse ce calendrier intact. La même publication ou le même compte peut être actualisé de nouveau au bout de cinq minutes.

    Risque
    Faible
  • list_clippers

    Vos clippeurs et leurs vues

    Les comptes associés à votre programme de clippeurs, classés par vues sur une période, avec le réseau, le @handle et le lien de chacun, et d’abord ceux qui attendent votre décision.

    Risque
    Faible
    Lecture seule
  • clipper_posts

    Les publications du compte d’un clippeur

    Ce qu’un compte associé a publié depuis son arrivée, de la plus récente à la plus ancienne, avec les vues, les liens et les dates. Accepte le nom, le @handle, le lien ou l’id du compte.

    Risque
    Faible
    Lecture seule
  • clipper_calendar

    Ce que vos clippeurs ont programmé

    Les publications que vos clippeurs ont programmées dans SPREVA pour les prochains jours, et celles sorties ainsi, de la plus proche à la plus lointaine, avec le compte, le réseau et le lien une fois sorties. Les publications faites directement sur un réseau n’y figurent pas.

    Risque
    Faible
    Lecture seule
  • create_video

    Créer une vidéo dans le Studio

    Crée un projet Studio vide dans un format donné, que l’agent construit ensuite. Si un projet portant ce nom existe déjà, il renvoie celui-ci au lieu d’en faire une copie.

    Risque
    Moyen
    Nécessite un forfait qui inclut le Studio
  • narrate_video

    Ajouter une voix off à une vidéo du Studio

    Fait lire à voix haute le script rédigé par l’agent et place chaque mot sur la timeline. Utilise des crédits IA, 1 pour 100 caractères.

    Risque
    Élevé
    Nécessite un forfait qui inclut le Studio
  • compose_video

    Créer une vidéo du Studio à partir d’un script en markdown

    Construit une vidéo explicative complète à partir d’un script en markdown : ce qui est dit et ce qui s’affiche à l’écran à chaque mot. La narration est lue à voix haute, le style fixe les couleurs, les entrées, les transitions et les sons, la caméra s’approche de ce qui apparaît, et les sous-titres et la musique sont ajoutés. Le résultat est un projet du Studio normal et modifiable. Utilise des crédits IA, 1 pour 100 caractères de narration, et répond d’abord par un aperçu. Quand un projet est reconstruit à partir d’un script modifié, la voix n’est refaite que si la narration a changé.

    Risque
    Élevé
    Nécessite un forfait qui inclut le Studio
  • match_media

    Associer des fichiers de la médiathèque à un script

    Pour chaque ligne d’un script, liste les fichiers de la médiathèque qui lui conviennent le mieux, d’après ce qu’ils montrent, les mots qu’ils contiennent, ce qui y est dit et leur qualité, avec le moment d’un clip qui convient. Ne modifie rien et ne dépense rien.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
    Lecture seule
  • find_sfx

    Trouver un effet sonore d’après son rôle

    Liste les trois meilleurs effets sonores de la bibliothèque pour un moment d'une vidéo, selon l'intention, l'émotion et l'énergie plutôt que le nom du fichier, avec la raison de chacun et le plus doux en premier. Quand rien ne convient bien, ou sur demande, il crée un nouveau son avec le synthétiseur de Spreva, l'enregistre dans la bibliothèque et le place en tête de liste. Ne dépense aucun crédit d'IA.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
  • find_music

    Trouver une musique d’après son ambiance, variée d’une vidéo à l’autre

    Liste les trois meilleurs morceaux de la médiathèque pour une vidéo, d’après l’ambiance, le genre, l’énergie et leur discrétion sous une voix plutôt que le nom du fichier, en expliquant pourquoi chacun convient. Les morceaux utilisés par les vidéos récentes de l’espace de travail sont classés plus bas et ceux que le projet a déjà sont écartés, pour que les vidéos ne partagent pas la même musique. Les morceaux pas encore classifiés sont mis en file pour classification. Ne modifie rien et ne dépense rien.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
    Lecture seule
  • find_icon

    Trouver une icône d’après son sens

    Liste les icônes Lucide qui correspondent le mieux à quelques mots en anglais, comme phone, security ou growth chart, avec leurs étiquettes et la meilleure correspondance en premier, et explique comment en placer une dans un graphisme animé : le bloc icon, qui se dessine tout seul, ou des nœuds de tracé dans une scène brute. Ne modifie rien et ne dépense rien.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
    Lecture seule
  • create_sfx

    Créer un effet sonore

    Crée un nouvel effet sonore avec le synthétiseur propre à Spreva, à partir de quelques mots en anglais ou en portugais, ou d'une recette que l'agent écrit pour garder le contrôle total. Il est enregistré dans la bibliothèque, dans le dossier « Generated sounds », et classé comme n'importe quel autre son, donc on peut le retrouver et le placer dans une vidéo. Ne dépense aucun crédit d'IA.

    Risque
    Moyen
    Nécessite un forfait qui inclut le Studio
  • score_video

    Composer la musique d'une vidéo du Studio

    Compose une musique instrumentale faite sur mesure pour la vidéo : une intro calme, une montée, le drop exactement sur la révélation puis une résolution. Elle rejoint la bibliothèque comme musique et se place sous le projet comme fond, baissée sous la voix. Utilise des crédits d'IA, 30 par tranche de 30 secondes de vidéo entamée, et répond d'abord par un aperçu.

    Risque
    Élevé
    Nécessite un forfait qui inclut le Studio
  • plan_edit

    Planifier le montage d’une vidéo du Studio

    Lit une vidéo du Studio (ce qui est dit, les plans et les coupes, ce qui s’y trouve déjà) et les sons classés de la médiathèque, choisit la recette adaptée à son type de vidéo (théorie, liste, actualité, tutoriel, promo, podcast, vlog, histoire, temps forts) et applique un montage complet en une seule étape, enregistré comme une seule version : chaque coupe franche ou avec une transition et son son, le rendu visuel, les sous-titres, une accroche, une musique qui s’atténue sous la voix, des zooms, du texte et des plans de coupe. Détourer une image de son arrière-plan utilise des crédits IA : c’est donc proposé, jamais appliqué. Sans apply, il ne modifie rien et se contente de décrire le plan.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
  • find_moments

    Trouver des moments dans une longue vidéo

    Montre ce que dit une longue vidéo, phrase par phrase avec les horodatages, où le son monte, ce que montre l’image et les clips qu’il suggérerait, pour que l’agent choisisse les passages qui méritent d’être coupés. Ne modifie rien et ne dépense rien.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
  • read_transcript

    Lire un fichier mot à mot

    Lit la transcription d'un fichier vidéo ou audio comme le ferait un monteur : des phrases avec leurs temps et leurs intervenants, les hésitations (euh, hum) conservées et marquées, et les silences listés. Plusieurs fichiers peuvent être lus ensemble pour comparer des prises, et un passage peut être listé mot à mot avec le début et la fin de chacun. Ne modifie rien et ne coûte rien.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
    Lecture seule
  • make_clips

    Créer des clips courts à partir d’une longue vidéo

    Découpe les passages choisis d’une longue vidéo en projets Studio courts et verticaux, un par passage, sous-titrés à partir de ce qui est dit. Chacun est un projet à modifier et à exporter.

    Risque
    Moyen
    Nécessite un forfait qui inclut le Studio
  • edit_video

    Modifier une vidéo du Studio

    Modifie le texte, le minutage, les coupes, les images, les clips, les effets et le son, et ajoute de nouveaux éléments, avec les opérations de montage du Studio lui-même.

    Risque
    Moyen
    Nécessite un forfait qui inclut le Studio
  • save_video

    Renommer ou classer un projet du Studio

    Renomme un projet et/ou le classe dans un dossier du Studio, ou le sort de son dossier ; plusieurs projets peuvent être classés d'un coup. Renommer demande la révision du projet ; classer ne change pas la vidéo. Il peut aussi copier un projet vers un autre de vos espaces de travail : ses fichiers y sont partagés en lecture seule et ses polices de marque y sont ajoutées.

    Risque
    Moyen
    Nécessite un forfait qui inclut le Studio
  • delete_video

    Supprimer des projets du Studio

    Supprime un ou plusieurs projets du Studio, après un aperçu et une confirmation. Les fichiers exportés depuis eux restent dans la bibliothèque.

    Risque
    Élevé
    Nécessite un forfait qui inclut le Studio
  • preview_video

    Voir les images d’une vidéo du Studio

    Dessine les images aux moments indiqués par l’agent, exactement comme le fera l’export, pour vérifier ce qui recouvre quoi avant d’exporter. Ne modifie rien et ne dépense rien.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
    Lecture seule
  • inspect_media

    Regarder un passage d'un fichier source

    Dessine une image d'un passage d'une vidéo ou d'un audio importé : des images réparties à intervalles égaux, la forme d'onde du son avec les pauses ombrées et les mots dits à l'endroit où ils sont dits. Ne change rien et ne dépense rien.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
    Lecture seule
  • compare_video

    Comparer deux versions d’une vidéo du Studio

    Liste ce qui a changé entre deux versions d’un projet : chaque élément ajouté, supprimé ou modifié, et ce qui a changé dans chacun. Peut aussi montrer les deux versions au même moment. Ne modifie rien.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
    Lecture seule
  • restore_video

    Restaurer une version d’une vidéo du Studio

    Ramène un projet à l’une de ses versions. Le résultat est conservé comme une nouvelle version, si bien que la restauration peut elle aussi être annulée.

    Risque
    Moyen
    Nécessite un forfait qui inclut le Studio
  • review_video

    Vérifier une vidéo du Studio

    Vérifie un projet comme l’éditeur IA du Studio vérifie son propre travail, et liste ce qu’il faut corriger, du plus grave au moins grave. Il signale ce que l’export corrigera de lui-même.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
    Lecture seule
  • render_video

    Exporter une vidéo du Studio

    Exporte un projet en MP4 ou en PNG dans la médiathèque, prêt à être ajouté à une publication. Il amène d’abord le projet de lui-même au niveau de qualité minimal (sous-titres, une accroche, une musique sous la voix, des transitions dans leurs limites) et le conserve comme une version appelée Quality pass ; il ne touche jamais à ce que vous avez fait à la main.

    Risque
    Élevé
    Nécessite un forfait qui inclut le Studio
  • generate_image

    Générer une image

    Crée une nouvelle image à partir d’une description, dans l’un des styles de l’espace de travail si la demande le précise. Utilise 10 crédits IA. Si la demande porte sur des images que la médiathèque contient déjà, il les liste d’abord et ne dépense rien.

    Risque
    Élevé
    Nécessite un forfait qui inclut le Studio
  • mascot

    Choisir la mascotte

    Lit ou définit la mascotte de l’espace de travail : un présentateur SVG animé qui parle, cligne des yeux et prend des poses dans une vidéo. Gratuit, sans crédits d’IA. Choisissez-en une intégrée, teintez-la aux couleurs de la marque ou utilisez votre dessin.

    Risque
    Moyen
    Nécessite un forfait qui inclut le Studio
  • use_skill

    Lire les compétences de montage de l’espace de travail

    Liste les compétences de montage de l’espace de travail (les méthodes d’un créateur : un style, un rythme, une recette) ou en lit une en entier, pour que l’agent la suive quand il crée ou monte une vidéo.

    Risque
    Faible
    Nécessite un forfait qui inclut le Studio
    Lecture seule
  • save_skill

    Enregistrer une compétence de montage

    Crée, modifie, importe depuis un SKILL.md ou supprime une compétence de montage de l’espace de travail. Sa description décide quand elle est utilisée.

    Risque
    Moyen
    Nécessite un forfait qui inclut le Studio

Le parcours habituel

Un agent commence par overview pour le fuseau horaire, l’heure et les comptes, trouve les éléments avec search, en lit un en entier avec fetch et le modifie avec save_post ou un autre outil. Chaque réponse indique ce qu’il est possible de faire ensuite.

Des noms, pas des identifiants

Les outils acceptent ce qu’une personne dirait : un nom de fichier exact, un @identifiant, le nom d’une campagne, ou un lien vers n’importe quel élément de SPREVA, collé depuis le navigateur ou depuis une réponse précédente. La recherche est tolérante, la modification ne l’est pas : un nom qui correspond à plusieurs éléments revient sous forme de choix, et rien n’est enregistré tant qu’aucun n’est choisi.

Référence pour les agents

Un agent lit la référence de SPREVA avec fetch quand il en a besoin, plutôt que de la transporter à chaque appel :

  • spreva://docs/platforms/tiktok, et une page par réseau : ce qu’il accepte, les longueurs et les options.
  • spreva://docs/queues : heures, fuseaux horaires et files d’attente.
  • spreva://docs/agent-permissions : niveaux de risque, confirmations, révisions et identifiants de requête.
  • spreva://docs/studio/making et spreva://docs/studio/editing : créer une vidéo, sur SPREVA uniquement.