Agents IA

Partir de votre projet

Collez ce prompt dans votre agent de codage depuis la racine du projet. Il amène l’agent à examiner votre stack avant de choisir un SDK, MCP ou des Skills, et garde la première modification facile à relire :

Set up the smallest safe Transloadit integration for this repository.

1. Inspect the project’s language, runtime, package manager, existing upload/media code, tests, and agent configuration before changing files.
2. Choose the narrowest integration that fits: an official SDK for application code, MCP for agent-executed runtime tools, the CLI (npx -y @transloadit/node) for scripts and CI jobs, and Agent Skills for repeatable workflow guidance. Reuse an existing integration when present.
3. Before editing, summarize what you found, which path you chose, and the files and commands you expect to change. Use the project’s existing package manager.
4. For interactive hosted MCP, add the hosted URL https://api2.transloadit.com/mcp to the client configuration without any token or key, and have the user approve browser OAuth. For CI or headless hosted MCP, mint an mcp-audience Bearer token at run time in a trusted environment, mint a new one when it expires, and supply it through secret storage or an environment variable.
5. Use TRANSLOADIT_KEY and TRANSLOADIT_SECRET only in a trusted server, CLI, CI, or self-hosted MCP process. When signing with an Auth Key, match its signature algorithm: for the Node CLI or self-hosted MCP, set TRANSLOADIT_SIGNATURE_ALGORITHM; in Node SDK code, pass the signatureAlgorithm option. Console keys with Smart CDN signing on (the default) use sha256; the Console’s snippet for the key shows the value.
6. Never expose TRANSLOADIT_SECRET to browser, mobile, or other client code. Give client code a public Auth Key and a Template ID; for production, generate the params and signature on a trusted backend with Signature Authentication. Use unsigned client params only with test credentials.
7. Never hardcode, print, commit, or overwrite credentials, including minted Bearer tokens. Keep secrets out of committed MCP configuration. If required credentials are unavailable, scaffold placeholders and stop before account operations.
8. Create one minimal, typed workflow and validate its Assembly Instructions. Prefer an existing small media fixture. Without an account, validate inline instructions locally with npx -y @transloadit/node assemblies lint --steps <file>. Linting against a Template ID needs credentials. Do not create an account, change a plan, or modify production Templates.
9. Run the repository’s checks. If authenticated Transloadit access (an approved hosted MCP connection or credentials in a trusted process) and a suitable fixture are available and the user has authorized a live test, run one Assembly, wait for completion, and report its Assembly ID, status, and result URL. Otherwise, report the exact command or MCP tool call the maintainer can run. Credentials or an approved connection alone do not authorize a live run.
10. Summarize every changed file, verification result, and any remaining manual step.

Le résultat attendu est une petite modification du dépôt, pas seulement un exemple de code généré. Vérifiez la limite proposée par l’agent pour les informations d’identification avant d’autoriser une Assembly réelle.

Ce que l’agent doit choisir

Serveur MCP

Le Model Context Protocol⁠ (MCP) donne aux agents un accès direct, à l’exécution, aux outils Transloadit.

Il existe trois modes de connexion. Choisissez le premier qui convient à votre client :

Se connecter par URL

Ajoutez l’URL MCP hébergée à votre client MCP :

https://api2.transloadit.com/mcp

Approuvez l’accès OAuth dans votre navigateur et choisissez le Workspace que le client peut utiliser. Aucun serveur local à installer, aucune Auth Key ni aucun Auth Secret à copier. L’approbation crée une Auth Key dédiée pour l’application, limitée aux autorisations affichées ; révoquez l’accès dans Applications connectées.

CI et clients sans interface

Lorsque personne ne peut approuver l’accès dans un navigateur, envoyez un jeton avec l’audience mcp au point de terminaison hébergé sous la forme Authorization: Bearer <token>. Générez-le dans un environnement de confiance qui détient une Auth Key et son Auth Secret (TRANSLOADIT_KEY et TRANSLOADIT_SECRET pour la CLI) :

npx -y @transloadit/node auth token --aud mcp

La commande affiche du JSON. Récupérez uniquement sa valeur access_token et transmettez-la à l’environnement d’exécution de l’agent via un stockage de secrets ou une variable d’environnement ; n’affichez pas la réponse dans les journaux ni dans la transcription de l’agent.

• Expiration : les jetons expirent après l’intervalle expires_in renvoyé (une semaine par défaut pour MCP). Générez-en un par tâche ou par session, et générez-en un nouveau si le travail dure plus longtemps que cet intervalle.
• Portée : utilisez --scope pour restreindre l’accès ; sinon, le jeton hérite des portées de l’Auth Key.
• Révocation : supprimez l’Auth Key à partir de laquelle un jeton a été généré pour couper l’accès avant son expiration. Utilisez une Auth Key dédiée pour la CI.

Consultez CI et clients sans interface pour des exemples de configuration de clients.

Mode stdio auto-hébergé

Configurez le serveur comme commande stdio dans votre client MCP ; la plupart des clients le lancent pour vous. La documentation des Robots et le linting fonctionnent sans compte :

npx -y @transloadit/mcp-server stdio

Pour les opérations liées au compte, comme la création d’Assemblies, fournissez TRANSLOADIT_KEY et TRANSLOADIT_SECRET via l’environnement du processus serveur, et définissez TRANSLOADIT_SIGNATURE_ALGORITHM en fonction de l’Auth Key. Les clés créées dans la Console avec la signature Smart CDN activée (par défaut) utilisent sha256, tandis que le serveur utilise sha384 par défaut ; l’extrait de code de la Console pour la clé indique la valeur à définir. Consultez la configuration de l’algorithme de signature.

Le processus stdio détient ces informations d’identification sur la machine de l’agent : utilisez donc une Auth Key dédiée disposant uniquement des portées nécessaires, et gardez les informations d’identification hors des fichiers de configuration MCP versionnés.

Pour des exemples de configuration de clients (Claude, Cursor, VS Code/Copilot), les détails d’authentification, la documentation des outils, les limites et les différences entre les modes hébergé et auto-hébergé, consultez la documentation du serveur MCP.

Voies d’automatisation

L’outillage d’agent de Transloadit combine des outils d’exécution avec des conseils de flux de travail et un contexte documentaire. La CLI et MCP exécutent les flux de travail ; les Agent Skills et llms.txt aident les agents à utiliser ces outils :

• CLI : utilisez @transloadit/node lorsqu’un humain ou une tâche CI a besoin d’une commande reproductible pour créer une Assembly, attendre la fin de son exécution et récupérer les résultats.
• MCP : exposez les outils Transloadit aux agents intégrés ou hébergés. L’agent peut consulter la documentation des Robots, linter les Assembly Instructions, créer des Assemblies et suivre les mises à jour de statut. Pour les fichiers transmis directement à transloadit_create_assembly, utilisez des URL publiques, de petits fichiers intégrés ou des pièces jointes que le client transmet. Le téléversement de fichiers locaux ou du bac à sable via la commande de téléversement renvoyée nécessite un shell ; consultez les entrées prises en charge.
• Agent Skills : conservez dans le contrôle de version les guides de flux de travail média propres à votre équipe, destinés aux agents qui disposent déjà d’outils utiles, comme un accès au terminal, MCP, la CLI ou des SDK. Les Skills indiquent à l’agent quels Templates, étapes de vérification et solutions de repli utiliser, mais n’accordent pas à eux seuls de nouvelles capacités.
• llms.txt : donnez à n’importe quel LLM une carte à jour des produits, solutions, intégrations, ressources pour développeurs et contenus d’apprentissage de Transloadit avant qu’il ne propose une Assembly.

Utilisez le MCP hébergé avec OAuth dans le navigateur lorsqu’une personne connecte un client d’agent interactif. Pour une automatisation sans surveillance, conservez les informations d’identification dans un environnement de confiance : envoyez un jeton Bearer avec l’audience mcp au MCP hébergé, ou fournissez une Auth Key et son Auth Secret au mode stdio auto-hébergé, à la CLI ou à votre propre backend.

Agent Skills

Les Agent Skills⁠ sont des fichiers Markdown (SKILL.md) qui apprennent aux agents à accomplir des tâches étape par étape.

Concrètement, un serveur MCP est une surface d’API qu’un agent peut appeler à l’exécution (via un processus MCP local ou hébergé), tandis que les Skills sont des guides versionnés qui indiquent à un agent quoi faire, dans quel ordre et comment le vérifier. Les Skills n’ajoutent pas à eux seuls de nouvel accès aux outils. Ils codifient la manière dont vous souhaitez que l’agent utilise, de façon cohérente, les outils disponibles dans votre environnement (MCP, CLI, SDK).

• Utilisez MCP pour une exécution intégrée et reproductible (création d’Assemblies, interrogation périodique, résultats).
• Utilisez les Skills comme guides réutilisables pilotés par des humains pour des tâches telles que la configuration, la génération de squelettes de code, les Templates et les migrations.

Les deux approches sont également complémentaires. Un Skill peut standardiser un flux de travail, puis demander à l’agent d’utiliser MCP (ou une CLI locale en solution de repli) pour l’exécution proprement dite.

Installer avec la CLI Skills

npx skills add transloadit/skills

Cette commande installe l’ensemble des 19 Skills Transloadit dans votre projet :

• docs-transloadit-robots

  Consultation hors ligne des Robots Transloadit, de la documentation de leurs paramètres et des exemples associés via la CLI transloadit. Utilisez ce Skill pour rédiger ou valider du JSON steps sans deviner les noms ni les paramètres des Robots.

• integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs

  Ajouter à un projet Next.js App Router la signature côté serveur des URL de Transloadit Smart CDN pour une ressource explicitement configurée.

• integrate-uppy-transloadit-s3-uploading-to-nextjs

  Ajouter les téléversements avec Uppy Dashboard + Transloadit à une application Next.js (App Router), avec génération de signatures côté serveur et exportation facultative via /s3/store.

• transform-build-mosaic-collage-with-transloadit

  Collage photo ponctuel en mosaïque justifiée (de N images locales à une seule image) avec la CLI officielle @transloadit/node. Ce Skill utilise l’effet mosaic du Robot /image/merge pour créer une disposition justifiée en mosaïque avec des photos recadrées au centre, et télécharge le résultat vers un chemin de sortie explicite via --output.

• transform-build-polaroid-collage-with-transloadit

  Collage photo ponctuel en pile de polaroids (de N images locales à une seule image) avec la CLI officielle @transloadit/node. Ce Skill utilise l’effet polaroid-stack du Robot /image/merge et télécharge le résultat vers un chemin de sortie explicite via --output.

• transform-caption-video-with-transloadit

  Ajouter des sous-titres simples incrustés à une vidéo locale et télécharger la vidéo sous-titrée ainsi que les repères de sous-titrage SRT à l’aide du Builtin caption-video et de la CLI officielle de Transloadit.

• transform-capture-webpage-with-transloadit

  Capturer une page web publique ou du HTML local sous forme d’image ou de PDF à l’aide du Builtin capture-webpage et de la CLI officielle de Transloadit.

• transform-convert-markdown-to-pdf-with-transloadit

  Convertir un document Office local ou un fichier HTML, Markdown ou texte local en PDF à l’aide du Builtin convert-to-pdf et de la CLI officielle de Transloadit. Inclut le flux de travail existant de conversion de Markdown en PDF.

• transform-describe-image-with-transloadit

  Description ponctuelle d’image avec la CLI officielle @transloadit/node. Utilisez image describe --fields labels pour obtenir des étiquettes d’objets, ou image describe --for wordpress pour obtenir un JSON structuré contenant un texte alternatif, un titre, une légende et une description.

• transform-encode-hls-video-with-transloadit

  Encodage HLS ponctuel (d’une vidéo locale à des variantes HLS et une liste de lecture) avec Transloadit via la CLI transloadit. Privilégiez les Builtin Templates (builtin/encode-hls-video@latest) et téléchargez les sorties en local via -o.

• transform-encode-video-with-transloadit

  Encoder une vidéo locale au format MP4 ou WebM pour la lecture sur le web à l’aide du Builtin encode-video et de la CLI officielle de Transloadit.

• transform-extract-text-with-transloadit

  Extraire du texte lisible ou du JSON à partir de PDF, de documents numérisés, de photos et de documents Office locaux à l’aide du Builtin extract-text et de la CLI officielle de Transloadit.

• transform-generate-image-with-transloadit

  Génération ponctuelle d’image (d’une invite à un fichier image) avec Transloadit via la CLI transloadit. Privilégiez image generate pour la génération à partir de texte uniquement et pour la génération guidée par une entrée, et utilisez --output lorsque vous avez besoin d’un chemin déterministe.

• transform-make-video-covers-with-transloadit

  Créer des images de couverture à partir d’une vidéo locale, en prélevant des images à intervalles réguliers, à des positions temporelles exactes ou par sélection intelligente, à l’aide du Builtin video-covers et de la CLI officielle de Transloadit.

• transform-prepare-image-with-transloadit

  Préparer des images locales pour un site web avec correction de l’orientation, redimensionnement, compression et conversion de format à l’aide du Builtin prepare-image et de la CLI officielle de Transloadit.

• transform-remove-background-with-transloadit

  Supprimer l’arrière-plan d’une photo locale et télécharger un PNG transparent à l’aide du Builtin remove-background et de la CLI officielle de Transloadit.

• transform-transcribe-audio-with-transloadit

  Transcrire un fichier audio ou vidéo local en texte, en JSON horodaté, en SRT ou en WebVTT à l’aide du Builtin transcribe et de la CLI officielle de Transloadit.

• transform-upscale-image-with-transloadit

  Agrandissement ponctuel d’image par IA (d’une image locale à une image agrandie) avec Transloadit via la CLI transloadit. Privilégiez l’intention image upscale et utilisez --output pour obtenir un chemin déterministe.

• transloadit

  Skill servant de point d’entrée principal pour Transloadit. Orientez-vous vers le Skill integrate-*, transform-* ou docs-* approprié et privilégiez l’exécution via npx -y @transloadit/node ... (CLI) pour un comportement déterministe.

Découverte automatique

Le catalogue des Skills est également découvrable à l’adresse transloadit.com/.well-known/skills/index.json, conformément à la RFC Agent Skills Discovery⁠. Vous pouvez donc aussi installer les Skills avec :

npx skills add https://transloadit.com

Installation manuelle

Clonez le dépôt transloadit/skills⁠ ou créez un lien symbolique vers celui-ci dans le répertoire des Skills de votre agent :

llms.txt

Transloadit publie un fichier llms.txt, un index de routage compact couvrant l’ensemble du site et conforme au standard llms.txt⁠. Il couvre les produits et services, les solutions, les intégrations, les index de médias et de tâches, les ressources pour développeurs et d’apprentissage, ainsi que le support.

Pour la découverte propre aux Robots, utilisez /docs/robots/llms.txt. L’ancien fichier de compatibilité llms-full.txt inclut directement les schémas complets des paramètres des Robots, mais il est volumineux. Privilégiez llms.txt pour la découverte et ne récupérez que les pages Markdown liées pertinentes pour la tâche.

Quelle approche choisir ?

Ces approches sont complémentaires. Commencez par le MCP hébergé avec OAuth dans le navigateur pour un accès interactif aux outils. Pour les outils d’agent sans surveillance, envoyez un jeton Bearer au MCP hébergé ou fournissez une Auth Key et son Auth Secret au mode stdio auto-hébergé. Utilisez un SDK officiel pour le code applicatif, ou la CLI pour les scripts et les tâches CI. Installez les Skills pour vous guider dans vos flux de travail, et orientez votre LLM vers llms.txt pour le contexte documentaire.