Saltar al contenido

Referencia

Herramientas

Lo que un agente puede llamar. SPREVA ofrece 49 herramientas, y las del Studio y las imágenes con IA necesitan un plan que incluya el Studio.

Todas las herramientas

  • fetch

    Leer un elemento completo

    Lee una publicación, un archivo, una campaña, una cola, una cuenta o un proyecto del Studio a partir de su enlace o su ID, o una página de la referencia de SPREVA.

    Riesgo
    Bajo
    Solo lectura
  • overview

    Resumen del espacio de trabajo

    La primera llamada de una conversación: la zona horaria y la hora, lo que necesita atención, lo próximo que se publica, las cuentas, las colas y las campañas, y lo que permite el plan.

    Riesgo
    Bajo
    Solo lectura
  • list_workspaces

    Tus espacios de trabajo

    Lista los espacios de trabajo en los que puede actuar esta conexión, con tu rol y la zona horaria de cada uno, e indica en cuál se hacen ahora las llamadas.

    Riesgo
    Bajo
    Solo lectura
  • switch_workspace

    Cambiar de espacio de trabajo

    Lleva la conversación a otro de tus espacios de trabajo, por nombre o enlace, cuando la conexión se permitió en todos. Las llamadas siguientes usan las cuentas, los archivos y los permisos de agente de ese espacio.

    Riesgo
    Bajo
  • save_workspace

    Cambiar los ajustes del espacio de trabajo

    Cambia el nombre del espacio de trabajo, su zona horaria, el idioma en que se escriben las descripciones de los archivos y si los archivos nuevos se describen solos. Pueden hacerlo el Propietario y los Administradores. Una zona horaria nueva no mueve las publicaciones ya programadas.

    Riesgo
    Medio
  • list_members

    Las personas del espacio de trabajo

    Lista los miembros con su correo y su rol, y las invitaciones que siguen pendientes, con cuándo caduca cada enlace.

    Riesgo
    Bajo
    Solo lectura
  • invite_member

    Invitar a alguien

    Invita a una persona por correo con un rol, siempre tras una vista previa que hay que confirmar, porque le envía un correo y puede ocupar una plaza del plan. Quien ya tiene una cuenta de SPREVA con esa dirección entra al momento. Pueden hacerlo el Propietario y los Administradores; un Administrador no puede invitar a un Propietario.

    Riesgo
    Alto
  • save_post

    Crear o editar una publicación

    Escribe una publicación para una o varias cuentas, con lo que cambia en cada cuenta, y fija cuándo sale: a una hora, en la próxima franja de una cola o como borrador. En un espacio de trabajo que exige aprobación, una hora o una cola la envía a revisión, y sale cuando una persona la aprueba.

    Riesgo
    Medio, Alto cuando sale en menos de una hora.
  • publish_post

    Publicar una publicación ahora

    Publica una publicación en todas sus cuentas, o de nuevo solo donde falló. Lo que ya salió nunca se publica dos veces. En un espacio de trabajo que exige aprobación, se rechaza una publicación que nadie aprobó: envíala a revisión con save_post y una hora o una cola.

    Riesgo
    Alto
  • delete_post

    Eliminar una publicación

    Quita de SPREVA un borrador, una publicación programada o una ya publicada. Una publicación ya publicada sigue visible en las redes.

    Riesgo
    Medio, Alto para una publicación ya publicada.
  • import_media

    Importar un archivo a la biblioteca

    Trae una imagen o un vídeo a la biblioteca desde un enlace público o desde los bytes que sube el agente.

    Riesgo
    Medio
  • update_media

    Renombrar, etiquetar, mover a una carpeta o describir un archivo de la biblioteca

    Cambia el nombre, las etiquetas, la carpeta o el texto alternativo de un archivo, y puede escribir el texto alternativo a partir de lo que muestra la imagen.

    Riesgo
    Medio, Alto cuando escribe el texto alternativo con IA.
  • delete_media

    Eliminar archivos de la biblioteca

    Elimina uno o varios archivos (imágenes, vídeos, audio) de la biblioteca, tras una vista previa y una confirmación que muestran dónde se usa cada uno y el espacio que libera. Los archivos usados por publicaciones sin publicar o por proyectos del Studio se rechazan, salvo que el agente fuerce la eliminación.

    Riesgo
    Alto
  • share_media

    Compartir un archivo o una carpeta con otros espacios de trabajo

    Presta un archivo de la biblioteca o una carpeta entera a tus otros espacios de trabajo como referencias de solo lectura: no se copia nada, y pueden usarlo en vídeos y publicaciones, pero no cambiarlo ni eliminarlo. Retirarlo pide confirmación si hay vídeos o publicaciones que lo usan.

    Riesgo
    Medio, Alto al retirar un archivo que usan vídeos o publicaciones de otro espacio de trabajo.
  • save_campaign

    Crear o editar una campaña

    Crea o cambia una campaña, y le añade publicaciones o las quita.

    Riesgo
    Medio
  • save_queue

    Crear o editar una cola

    Crea o cambia un calendario de publicación: su nombre, su zona horaria y sus franjas semanales.

    Riesgo
    Medio
  • analytics

    Cómo les fue a las publicaciones

    Totales frente al periodo anterior, las mejores publicaciones, el desglose por red y comparaciones con el tamaño de sus muestras, para el espacio de trabajo, una campaña, una cuenta o una publicación.

    Riesgo
    Bajo
    Solo lectura
  • refresh_metrics

    Actualizar los números

    Lee ahora mismo en las redes los números de una publicación o los seguidores de una cuenta, sin esperar al calendario habitual, y deja ese calendario como está. La misma publicación o cuenta se puede volver a actualizar pasados cinco minutos.

    Riesgo
    Bajo
  • list_clippers

    Tus clippers y sus visualizaciones

    Las cuentas asociadas a tu programa de clippers, ordenadas por visualizaciones en un periodo, con la red, el @handle y el enlace de cada una, y primero las que esperan tu decisión.

    Riesgo
    Bajo
    Solo lectura
  • clipper_posts

    Las publicaciones de la cuenta de un clipper

    Lo que una cuenta asociada ha publicado desde que se unió, de la más reciente a la más antigua, con visualizaciones, enlaces y fechas. Acepta el nombre, el @handle, el enlace o el id de la cuenta.

    Riesgo
    Bajo
    Solo lectura
  • clipper_calendar

    Lo que tus clippers tienen programado

    Las publicaciones que tus clippers programaron en SPREVA para los próximos días, y las que salieron así, de la más próxima a la más lejana, con la cuenta, la red y el enlace cuando ya han salido. Las publicaciones hechas directamente en una red no están aquí.

    Riesgo
    Bajo
    Solo lectura
  • create_video

    Crear un vídeo en el Studio

    Inicia un proyecto vacío del Studio en un formato, que luego construye el agente. Si ya existe un proyecto con ese nombre, responde con ese en lugar de crear una copia.

    Riesgo
    Medio
    Necesita un plan que incluya el Studio
  • narrate_video

    Narrar un vídeo del Studio

    Pone voz al guion que escribió el agente y coloca cada palabra en la línea de tiempo. Usa créditos de IA, 1 por cada 100 caracteres.

    Riesgo
    Alto
    Necesita un plan que incluya el Studio
  • compose_video

    Crear un vídeo del Studio desde un guion en markdown

    Construye un vídeo explicativo completo a partir de un guion en markdown: lo que se dice y lo que aparece en pantalla en cada palabra. Pone voz a la narración, el estilo fija los colores, las entradas, las transiciones y los sonidos, la cámara se acerca a lo que aparece y se añaden subtítulos y música. El resultado es un proyecto normal y editable del Studio. Usa créditos de IA, 1 por cada 100 caracteres de narración, y responde primero con una vista previa. Al reconstruir un proyecto con un guion modificado, solo se vuelve a poner voz si cambió la narración.

    Riesgo
    Alto
    Necesita un plan que incluya el Studio
  • match_media

    Emparejar archivos de la biblioteca con un guion

    Para cada línea de un guion, enumera los archivos de la biblioteca que mejor encajan, por lo que muestran, las palabras que llevan, lo que se dice en ellos y su calidad, con el momento de un clip que encaja. No cambia nada ni gasta nada.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
    Solo lectura
  • find_sfx

    Encontrar un efecto de sonido por lo que hace

    Lista los tres mejores efectos de sonido de la biblioteca para un momento de un vídeo, por intención, emoción y energía en lugar del nombre del archivo, con el motivo de cada uno y el más suave primero. Cuando nada encaja bien, o si se pide, crea un sonido nuevo con el sintetizador de Spreva, lo guarda en la biblioteca y lo lista primero. No gasta créditos de IA.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
  • find_music

    Encontrar música por su sensación, con variedad entre vídeos

    Lista las tres mejores pistas de música de la biblioteca para un vídeo, por ánimo, género, energía y lo bien que quedan bajo una voz en lugar del nombre del archivo, con el motivo de cada una. Las pistas que usaron los vídeos recientes del espacio de trabajo puntúan menos y las que el proyecto ya tiene se dejan fuera, para que los vídeos no compartan la misma música. Las pistas aún sin clasificar se ponen en cola para clasificarse. No cambia nada y no gasta nada.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
    Solo lectura
  • find_icon

    Encontrar un icono por lo que significa

    Lista los iconos de Lucide que mejor encajan con unas pocas palabras en inglés, como phone, security o growth chart, con sus etiquetas y la mejor coincidencia primero, e indica cómo colocar uno en un gráfico en movimiento: el bloque icon, que se dibuja solo, o nodos de trazado en una escena sin plantilla. No cambia nada y no gasta nada.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
    Solo lectura
  • create_sfx

    Crear un efecto de sonido

    Crea un efecto de sonido nuevo con el sintetizador propio de Spreva, a partir de unas pocas palabras en inglés o portugués, o de una receta que escribe el agente para tener control total. Se guarda en la biblioteca, en la carpeta «Generated sounds», y se clasifica como cualquier otro sonido, así que se puede encontrar y colocar en un vídeo. No gasta créditos de IA.

    Riesgo
    Medio
    Necesita un plan que incluya el Studio
  • score_video

    Componer la música de un vídeo del Studio

    Compone música instrumental hecha a medida del vídeo: una introducción tranquila, una subida, el «drop» justo en la revelación y un cierre. Entra en la biblioteca como música y va bajo el proyecto como fondo, bajando bajo la voz. Usa créditos de IA, 30 por cada 30 segundos de vídeo empezados, y responde primero con una vista previa.

    Riesgo
    Alto
    Necesita un plan que incluya el Studio
  • plan_edit

    Planificar la edición de un vídeo del Studio

    Lee un vídeo del Studio (qué se dice, los planos y los cortes, qué hay ya) y los sonidos clasificados de la biblioteca, elige la receta del tipo de vídeo (teoría, lista, noticia, tutorial, anuncio, pódcast, vlog, historia, mejores momentos) y aplica una edición completa de una sola vez, como una única versión guardada: cada corte seco o con una transición y su sonido, el aspecto, subtítulos, un gancho, música que baja bajo la voz, zooms, texto y B-roll. Recortar el fondo de una imagen usa créditos de IA, así que se ofrece y nunca se aplica solo. Sin aplicar no cambia nada y solo describe el plan.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
  • find_moments

    Encontrar momentos en un vídeo largo

    Muestra lo que dice un vídeo largo, frase a frase con sus tiempos, dónde sube el volumen, qué se ve en la imagen y los clips que sugeriría, para que el agente elija las partes que vale la pena cortar. No cambia nada ni gasta nada.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
  • read_transcript

    Leer un archivo palabra por palabra

    Lee la transcripción de un archivo de vídeo o audio como lo haría un editor: frases con sus tiempos y hablantes, muletillas (eh, mmm) conservadas y marcadas, y los silencios listados. Se pueden leer varios archivos a la vez para comparar tomas, y un tramo se puede listar palabra por palabra con el inicio y el final de cada una. No cambia nada y no gasta nada.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
    Solo lectura
  • make_clips

    Crear clips cortos de un vídeo largo

    Corta las partes elegidas de un vídeo largo en proyectos verticales cortos del Studio, uno por parte, con subtítulos a partir de lo que se dice. Cada uno es un proyecto para editar y exportar.

    Riesgo
    Medio
    Necesita un plan que incluya el Studio
  • edit_video

    Cambiar un vídeo del Studio

    Edita textos, tiempos, cortes, imágenes, clips, efectos y sonido, y añade elementos nuevos, con las propias operaciones de edición del Studio.

    Riesgo
    Medio
    Necesita un plan que incluya el Studio
  • save_video

    Renombrar o archivar un proyecto del Studio

    Cambia el nombre de un proyecto y/o lo archiva en una carpeta del Studio, o lo saca de su carpeta; se pueden archivar varios proyectos a la vez. Renombrar exige la revisión del proyecto; archivar no cambia el vídeo. También puede copiar un proyecto a otro de tus espacios de trabajo: sus archivos se comparten con ese espacio en solo lectura y sus fuentes de marca se añaden allí.

    Riesgo
    Medio
    Necesita un plan que incluya el Studio
  • delete_video

    Eliminar proyectos del Studio

    Elimina uno o más proyectos del Studio, tras una vista previa y una confirmación. Los archivos exportados desde ellos se quedan en la biblioteca.

    Riesgo
    Alto
    Necesita un plan que incluya el Studio
  • preview_video

    Ver fotogramas de un vídeo de Studio

    Dibuja los fotogramas en los momentos que indica el agente, tal como saldrán en la exportación, para comprobar qué tapa qué antes de exportar. No cambia nada ni gasta nada.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
    Solo lectura
  • inspect_media

    Mirar un tramo de un archivo original

    Dibuja una imagen de un tramo de un vídeo o audio subido: fotogramas repartidos por igual, la onda de su sonido con las pausas sombreadas y las palabras dichas donde se dicen. No cambia nada y no gasta nada.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
    Solo lectura
  • compare_video

    Comparar dos versiones de un vídeo del Studio

    Enumera lo que cambió entre dos versiones de un proyecto: cada elemento añadido, quitado o cambiado, y qué cambió en él. También puede mostrar las dos versiones en el mismo momento. No cambia nada.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
    Solo lectura
  • restore_video

    Restaurar una versión de un vídeo del Studio

    Devuelve un proyecto a una de sus versiones. El resultado se guarda como una versión nueva, así que la restauración también se puede deshacer.

    Riesgo
    Medio
    Necesita un plan que incluya el Studio
  • review_video

    Revisar un vídeo del Studio

    Revisa un proyecto igual que el editor de IA del propio Studio revisa su trabajo, y enumera lo que hay que corregir, empezando por lo más grave. Marca lo que la exportación corregirá por sí sola.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
    Solo lectura
  • render_video

    Exportar un vídeo del Studio

    Exporta un proyecto a un MP4 o un PNG en la biblioteca, listo para usar en una publicación. Antes lleva el proyecto al nivel mínimo de calidad por sí mismo (subtítulos, un gancho, la música bajo la voz, transiciones dentro de sus límites) y lo guarda como una versión llamada Quality pass; nunca toca lo que hiciste a mano.

    Riesgo
    Alto
    Necesita un plan que incluya el Studio
  • generate_image

    Generar una imagen

    Crea una imagen nueva a partir de una descripción, en uno de los estilos del espacio de trabajo si se pide. Usa 10 créditos de IA. Si la petición trata de imágenes que la biblioteca ya tiene, las lista primero y no gasta nada.

    Riesgo
    Alto
    Necesita un plan que incluya el Studio
  • mascot

    Elegir la mascota

    Lee o define la mascota del espacio de trabajo: un presentador SVG animado que habla, parpadea y adopta poses en un vídeo. Gratis, sin créditos de IA. Elige una incluida, tíñela con los colores de la marca o usa tu propio dibujo.

    Riesgo
    Medio
    Necesita un plan que incluya el Studio
  • use_skill

    Leer las habilidades de edición del espacio de trabajo

    Lista las habilidades de edición del espacio de trabajo (las guías de un creador: un estilo, un ritmo, una receta) o lee una entera, para que el agente la siga al crear o editar un vídeo.

    Riesgo
    Bajo
    Necesita un plan que incluya el Studio
    Solo lectura
  • save_skill

    Guardar una habilidad de edición

    Crea, cambia, importa desde un SKILL.md o elimina una habilidad de edición del espacio de trabajo. Su descripción decide cuándo se usa.

    Riesgo
    Medio
    Necesita un plan que incluya el Studio

El recorrido habitual

Un agente empieza con overview para conocer la zona horaria, la hora y las cuentas, encuentra cosas con search, lee una completa con fetch y la cambia con save_post u otra herramienta. Cada respuesta indica qué se puede hacer a continuación.

Nombres, no ID

Las herramientas aceptan lo que diría una persona: el nombre exacto de un archivo, un @usuario, el nombre de una campaña o un enlace a cualquier cosa de SPREVA, pegado desde el navegador o desde una respuesta anterior. Buscar es flexible y cambiar no lo es: un nombre que coincide con varias cosas vuelve como una elección, y no se guarda nada hasta que se elige una.

Referencia para agentes

Un agente lee la referencia de SPREVA con fetch cuando la necesita, en lugar de llevarla en cada llamada:

  • spreva://docs/platforms/tiktok, y una página por red: qué acepta, longitudes y opciones.
  • spreva://docs/queues: horas, zonas horarias y colas.
  • spreva://docs/agent-permissions: niveles de riesgo, confirmaciones, revisiones e ID de solicitud.
  • spreva://docs/studio/making y spreva://docs/studio/editing: crear un vídeo, solo en SPREVA.