Agentes de IA

Empieza desde tu proyecto

Pega este prompt en tu agente de programación desde la raíz del proyecto. De este modo, el agente inspecciona tu stack antes de elegir un SDK, MCP o skills, y mantiene el primer cambio fácil de revisar:

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, and Agent Skills for repeatable workflow guidance. Reuse an
   existing integration when one is already present.
3. Before editing, summarize what you found, which path you chose, and the files and commands you
   expect to change.
4. Use the project’s existing package manager. Match credentials to the execution boundary. Use
   TRANSLOADIT_KEY and TRANSLOADIT_SECRET only in a trusted server, CLI, CI, or self-hosted MCP
   process. Never expose TRANSLOADIT_SECRET to browser, mobile, or other client code; use a public
   Auth Key plus a Template ID and, when required, a signature from a trusted backend. Never
   hardcode, print, commit, or overwrite credentials. If required credentials are unavailable,
   scaffold placeholders and stop before any live request.
5. Create one minimal, typed workflow and validate its Assembly Instructions. Prefer an existing
   small media fixture. Do not create an account, change a plan, or modify production Templates.
6. Run the repository’s checks. If credentials and a suitable fixture are available and a live
   test is authorized, run one Assembly, wait for completion, and report its Assembly ID, status,
   and result URL. Otherwise, report the exact command the maintainer can run.
7. Summarize every changed file, verification result, and any remaining manual step.

El resultado esperado es un cambio pequeño en el repositorio, no solo una muestra de código generada. Revisa el límite de credenciales propuesto por el agente antes de permitir una Assembly real.

Qué debe seleccionar el agente

Servidor MCP

El Protocolo de Contexto de Modelo⁠ (MCP) proporciona a los agentes acceso directo durante la ejecución a las herramientas de Transloadit.

Para la mayoría de los equipos, el punto de partida recomendado es alojar MCP por cuenta propia mediante stdio:

TRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY npx -y @transloadit/mcp-server stdio

Si no puedes ejecutar npx en tu entorno, usa el endpoint alojado https://api2.transloadit.com/mcp con Authorization: Bearer <token>.

Genera el token en otro entorno de confianza (por ejemplo, tu backend, CI o shell local) y luego pásalo al entorno de ejecución de tu agente:

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

También puedes emitir tokens mediante POST /token o el SDK de Node.js.

Para consultar ejemplos de configuración de clientes (Claude, Cursor, VS Code/Copilot), detalles de autenticación, documentación de herramientas, límites y el comportamiento de las versiones alojada y autoalojada, consulta la página del SDK del servidor MCP.

Opciones de automatización

Las herramientas de Transloadit para agentes son útiles más allá de los agentes de programación basados en chat. Proporcionan a los equipos varias formas prácticas de ejecutar el mismo flujo de trabajo multimedia desde scripts locales, tareas de CI, consolas de operaciones y agentes autónomos:

• CLI: usa @transloadit/node cuando una persona o una tarea de CI necesite un comando repetible para crear una Assembly, esperar a que finalice y recopilar los resultados.
• MCP: expón un conjunto limitado de herramientas de Transloadit a agentes integrados o alojados que no deban obtener acceso al shell. El agente puede consultar la documentación de Robots, validar Assembly Instructions, crear Assemblies y seguir las actualizaciones de estado mediante el servidor MCP.
• Agent Skills: conserva en el control de versiones las guías de flujos de trabajo multimedia específicas de tu equipo para agentes que ya cuenten con herramientas útiles, como acceso a la terminal, MCP, la CLI o SDK. Las Skills indican al agente qué Templates, pasos de verificación y alternativas debe usar, pero por sí solas no conceden nuevas capacidades.
• llms.txt: proporciona a cualquier LLM un mapa actualizado de los productos, soluciones, integraciones, recursos para desarrolladores y contenido educativo de Transloadit antes de que proponga una Assembly.

Para la automatización en producción, mantén las credenciales en tu entorno de confianza y permite que los agentes llamen a un servidor MCP autoalojado o a tu propio backend. El MCP alojado resulta práctico cuando el entorno de ejecución del agente no puede iniciar procesos locales, mientras que la CLI sigue siendo la opción más sencilla para tareas deterministas en CI.

Agent Skills

Las Agent Skills⁠ son archivos Markdown (SKILL.md) que enseñan a los agentes a realizar tareas paso a paso.

En términos prácticos, un servidor MCP es una interfaz de API que un agente puede llamar durante la ejecución (mediante un proceso MCP local o alojado), mientras que las Skills son guías con control de versiones que indican a un agente qué hacer, en qué orden y cómo verificarlo. Por sí solas, las Skills no añaden acceso a nuevas herramientas. Codifican cómo quieres que el agente use de forma coherente las herramientas disponibles en tu entorno (MCP, CLI, SDK).

• Usa MCP para una ejecución integrada y repetible (subidas, Assemblies, consultas periódicas, resultados).
• Usa Skills como guías reutilizables y dirigidas por personas para tareas como configuración, estructura inicial, Templates y migraciones.

También se complementan entre sí. Una Skill puede estandarizar un flujo de trabajo y luego indicar al agente que use MCP (o una CLI local como alternativa) para la ejecución propiamente dicha.

Instala con la CLI de Skills

npx skills add transloadit/skills

Esto instala las 7 Skills de Transloadit en tu proyecto:

• docs-transloadit-robots: Consulta sin conexión de los Robots de Transloadit y de la documentación y los ejemplos de sus parámetros mediante la CLI transloadit. Úsala para redactar o validar el JSON de steps sin tener que adivinar nombres ni parámetros de Robots.
• integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs: Agregar la firma de URLs de Transloadit Smart CDN a un proyecto de Next.js con App Router (ruta de firma del lado del servidor y página de demostración opcional para el cliente).
• integrate-uppy-transloadit-s3-uploading-to-nextjs: Agregar Uppy Dashboard y subidas de Transloadit a una aplicación de Next.js con App Router, con generación de firmas del lado del servidor y exportación opcional mediante /s3/store.
• transform-encode-hls-video-with-transloadit: Encoding HLS puntual (video local -> variantes HLS + lista de reproducción) con Transloadit mediante la CLI transloadit. Es preferible usar Builtin Templates (builtin/encode-hls-video@latest) y descargar los resultados localmente mediante -o.
• transform-generate-image-with-transloadit: Generación puntual de imágenes (prompt -> archivo de imagen) con Transloadit mediante la CLI transloadit. Es preferible usar Builtin Templates (builtin/generate-image@latest) y descargar los resultados localmente mediante -o.
• transform-remove-background-with-transloadit: Eliminación puntual del fondo (imagen local -> PNG transparente) con Transloadit mediante la CLI transloadit. Usa un JSON de steps mínimo con /image/bgremove y descarga el resultado en una ruta .png explícita mediante -o.
• transloadit: Skill principal como punto de entrada para Transloadit. Dirige la tarea al skill integrate-*, transform-* o docs-* adecuado y, para obtener un comportamiento determinista, prioriza la ejecución mediante npx -y @transloadit/node ... (CLI).

Detección automática

El catálogo de Skills también está disponible en transloadit.com/.well-known/skills/index.json, de acuerdo con la RFC de detección de Agent Skills⁠. Esto significa que también puedes instalarlo con:

npx skills add https://transloadit.com

Instalación manual

Clona o crea un enlace simbólico al repositorio transloadit/skills⁠ en el directorio de Skills de tu agente:

llms.txt

Transloadit publica un archivo llms.txt, un índice de navegación compacto para todo el sitio que sigue el estándar llms.txt⁠. Incluye productos y servicios, soluciones, integraciones, índices por tipo de contenido y tarea, recursos para desarrolladores, contenido educativo y soporte.

Para buscar información específica sobre Robots, usa /docs/robots/llms.txt. El archivo de compatibilidad heredado llms-full.txt incluye directamente esquemas completos de parámetros de Robots, pero es grande. Usa llms.txt para descubrir la documentación y recupera solo las páginas Markdown enlazadas que sean relevantes para la tarea.

¿Qué opción debo usar?

Estas opciones se complementan entre sí. Usa MCP autoalojado para acceder a las herramientas en la mayoría de los entornos, o MCP alojado cuando el entorno de ejecución del agente no pueda iniciar procesos locales. Instala Skills para orientar los flujos de trabajo y dirige tu LLM a llms.txt cuando necesite documentación de Transloadit.