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
searchRechercher dans l’espace de travail
Trouve des publications, des fichiers, des campagnes, des comptes, des files d’attente, des scripts, des projets Studio et des styles, par mots ou d’après ce que montre une image ou une vidéo. Un nom écrit approximativement est quand même trouvé (majuscules, accents, tirets, espaces, sans extension), et quand rien ne correspond, il répond avec les noms les plus proches.
- Risque
- Faible
Lecture seulefetchLire 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 seuleoverviewVue 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 seulelist_workspacesVos 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 seuleswitch_workspaceChanger 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_workspaceModifier 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_membersLes 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 seuleinvite_memberInviter 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_postCré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_postMettre 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_postSupprimer 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_mediaImporter 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_mediaRenommer, é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_mediaSupprimer 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é
save_campaignCréer ou modifier une campagne
Crée ou modifie une campagne, et y ajoute des publications ou les en retire.
- Risque
- Moyen
save_queueCré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
analyticsRé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 seulerefresh_metricsActualiser 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_clippersVos 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 seuleclipper_postsLes 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 seuleclipper_calendarCe 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 seulecreate_videoCré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 Studionarrate_videoAjouter 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 Studiocompose_videoCré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 Studiomatch_mediaAssocier 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 StudioLecture seulefind_sfxTrouver 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 Studiofind_musicTrouver 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 StudioLecture seulefind_iconTrouver 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 StudioLecture seulecreate_sfxCré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 Studioscore_videoComposer 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 Studioplan_editPlanifier 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 Studiofind_momentsTrouver 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 Studioread_transcriptLire 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 StudioLecture seulemake_clipsCré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 Studioclips_from_linkCréer des clips courts à partir du lien d’une longue vidéo
Prend le lien d’une longue vidéo (YouTube, Twitch, Kick, Vimeo, X, TikTok ou toute page publique), demande à la personne de confirmer qu’elle peut l’utiliser et lance un lot qui la télécharge, lit ce qui est dit, trouve les meilleurs moments et crée un projet Studio vertical pour chacun. Répond tout de suite avec le lien du lot ; fetch montre la progression, puis chaque clip avec son score et sa raison. Utilise des minutes de transcription et peut utiliser des crédits d’IA.
- Risque
- Élevé
Nécessite un forfait qui inclut le Studioedit_videoModifier 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 Studiosave_videoRenommer 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 Studiodelete_videoSupprimer 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 Studiopreview_videoVoir 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 StudioLecture seuleinspect_mediaRegarder 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 StudioLecture seulecompare_videoComparer 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 StudioLecture seulerestore_videoRestaurer 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 Studioreview_videoVé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 StudioLecture seulerender_videoExporter 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 Studiogenerate_imageGé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 StudiomascotChoisir 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 Studiouse_skillLire 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 StudioLecture seulesave_skillEnregistrer 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/makingetspreva://docs/studio/editing: créer une vidéo, sur SPREVA uniquement.