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
searchBuscar en el espacio de trabajo
Encuentra publicaciones, archivos, campañas, cuentas, colas, guiones, proyectos del Studio y estilos, por palabras o por lo que muestra una imagen o un vídeo. Un nombre escrito de forma aproximada también se encuentra (mayúsculas, acentos, guiones, espacios, sin extensión) y, si nada coincide, responde con los nombres más parecidos.
- Riesgo
- Bajo
Solo lecturafetchLeer 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 lecturaoverviewResumen 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 lecturalist_workspacesTus 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 lecturaswitch_workspaceCambiar 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_workspaceCambiar 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_membersLas 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 lecturainvite_memberInvitar 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_postCrear 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_postPublicar 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_postEliminar 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_mediaImportar 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_mediaRenombrar, 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_mediaEliminar 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
save_campaignCrear o editar una campaña
Crea o cambia una campaña, y le añade publicaciones o las quita.
- Riesgo
- Medio
save_queueCrear o editar una cola
Crea o cambia un calendario de publicación: su nombre, su zona horaria y sus franjas semanales.
- Riesgo
- Medio
analyticsCó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 lecturarefresh_metricsActualizar 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_clippersTus 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 lecturaclipper_postsLas 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 lecturaclipper_calendarLo 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 lecturacreate_videoCrear 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 Studionarrate_videoNarrar 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 Studiocompose_videoCrear 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 Studiomatch_mediaEmparejar 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 StudioSolo lecturafind_sfxEncontrar 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 Studiofind_musicEncontrar 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 StudioSolo lecturafind_iconEncontrar 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 StudioSolo lecturacreate_sfxCrear 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 Studioscore_videoComponer 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 Studioplan_editPlanificar 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 Studiofind_momentsEncontrar 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 Studioread_transcriptLeer 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 StudioSolo lecturamake_clipsCrear 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 Studioclips_from_linkCrear clips cortos desde el enlace de un vídeo largo
Toma el enlace de un vídeo largo (YouTube, Twitch, Kick, Vimeo, X, TikTok o cualquier página pública), pide a la persona que confirme que puede usarlo e inicia un lote que lo descarga, lee lo que se dice, encuentra los mejores momentos y hace un proyecto vertical del Studio de cada uno. Responde al instante con el enlace del lote; fetch muestra el progreso y después cada clip con su puntuación y su motivo. Usa minutos de transcripción y puede usar créditos de IA.
- Riesgo
- Alto
Necesita un plan que incluya el Studioedit_videoCambiar 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 Studiosave_videoRenombrar 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 Studiodelete_videoEliminar 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 Studiopreview_videoVer 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 StudioSolo lecturainspect_mediaMirar 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 StudioSolo lecturacompare_videoComparar 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 StudioSolo lecturarestore_videoRestaurar 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 Studioreview_videoRevisar 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 StudioSolo lecturarender_videoExportar 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 Studiogenerate_imageGenerar 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 StudiomascotElegir 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 Studiouse_skillLeer 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 StudioSolo lecturasave_skillGuardar 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/makingyspreva://docs/studio/editing: crear un vídeo, solo en SPREVA.