Glorya-AI/glorya

¿Qué hace glorya?

Glorya es un agente de marketing con IA. Ya conoce la marca del usuario: logotipo, colores, fuentes, productos e idioma. Tú comienzas el trabajo, lo sigues y compartes los resultados. Glorya finaliza por su cuenta a menos que el usuario pida revisar.

Cada herramienta, entrada, estado, error y límite está en references/tools.md.

Cuándo usarlo

• El usuario solicita un anuncio de imagen, un anuncio de video, una página de aterrizaje o un sitio web.
• El usuario quiere cambiar, publicar o detener algo que Glorya creó.
• El usuario pregunta sobre sus imágenes y videos recientes de Glorya (list_assets), los estilos de video (list_video_formats) o su marca y productos (get_brand).

Conexión

Las herramientas provienen del servidor MCP de Glorya en https://platform.glorya.ai/mcp (HTTP streamable, OAuth con la cuenta de Glorya del usuario). Si faltan, pide al usuario que las conecte: https://glorya.ai/docs/mcp/quickstart. Al conectar, elige una marca predeterminada.

Reglas

• Usa la marca predeterminada: deja workspace vacío. Solo cuando el usuario nombre otra marca, llama a list_workspaces con query establecido en ese nombre y pasa el id coincidente como workspace.
• Empieza de inmediato. Pasa las propias palabras del usuario como brief. Si no dio detalles, pasa lo que pidió, por ejemplo "Crea un anuncio de imagen".
• No preguntes nada antes de empezar: ni el formato, tamaño, idioma, audiencia o estilo. Glorya los elige.
• Establece language, format o references solo cuando el usuario los haya proporcionado. references son enlaces https públicos.
• Deja review fuera; es falso, así que Glorya finaliza por su cuenta. Establece review: true solo cuando el usuario pida revisar o aprobar pasos ("déjame revisar", "muéstrame el concepto primero"). Nunca le preguntes al usuario al respecto.
• Nunca inventes productos, precios ni ofertas. Nunca inicies el mismo trabajo dos veces.

El bucle de trabajo

1. Llama a la herramienta de creación. Devuelve job_id y open_url. Informa al usuario que comenzó y comparte open_url.
2. Llama a get_job con job_id y wait_seconds: 30. Mientras status sea running, vuelve a llamarla. Ya espera cambios, así que no consultes más rápido.
3. needs_input: Glorya necesita una decisión. Muestra cada elemento en questions tal como está escrito, con sus choices exactos y preview_images. Espera al usuario. Luego llama a respond con job_id, el request_id de la pregunta y answer, y vuelve al paso 2.
   • decision y approve: answer es una etiqueta exacta de choices.
   • input, revise y clarify: las propias palabras del usuario funcionan.
   • No respondas por el usuario. No agregues preguntas propias. Si el usuario escribe en otro idioma, traduce la pregunta pero envía la etiqueta exacta.
4. completed: comparte los resultados (ver cada tipo más abajo) y open_url. Si progress le pregunta algo al usuario, transmítelo y envía la respuesta con refine.
5. failed: informa al usuario lo que dice error o progress. Ofrece refine con una instrucción modificada, o un nuevo trabajo.
6. cancelled: el trabajo se detuvo. Los archivos terminados permanecen en Glorya.

Cambios: llama a refine con el mismo job_id y las palabras del usuario como instruction, luego ejecuta el bucle nuevamente desde el paso 2. Los cambios consumen créditos.

Anuncio de imagen

• Inicia con create_image_ad.
• Glorya planifica el anuncio, redacta el texto y genera las imágenes. Con review: true se detiene para aprobar el plan (concepto y texto) y las imágenes terminadas.
• Cuando termina, assets contiene las imágenes. Comparte cada url y open_url. progress contiene el último mensaje de Glorya, como el texto del anuncio.
• Para cambios, usa refine: "Haz el titular más corto."

Anuncio de video

• Inicia con create_video_ad.
• Establece format solo si el usuario nombró un estilo de video. Llama a list_video_formats y pasa el id coincidente. De lo contrario, déjalo fuera; Glorya elige uno.
• Glorya escribe el guion, genera los fotogramas iniciales y renderiza el corte final. Con review: true se detiene para aprobar el formato, el guion, los fotogramas iniciales y el corte final.
• El renderizado toma minutos. Sigue llamando a get_job, e informa al usuario de vez en cuando que aún está trabajando.
• Cuando termina, assets lista el video primero, con url y poster_url. Comparte el enlace del video y open_url.
• Para cambios, usa refine: "Usa una voz más calmada." Para detenerlo, usa cancel_job.

Página de aterrizaje

• Inicia con create_landing_page.
• El constructor puede hacer una pregunta aclaratoria (clarify). Transmítela como cualquier otra.
• Cuando termina, comparte site.preview_url y open_url. La página aún no está en vivo.
• Para cambios, usa refine: "Agrega una sección de precios."
• Publica solo cuando el usuario lo indique ("publícalo", "ponlo en vivo"): llama a publish_site con job_id. slug es opcional (letras minúsculas, dígitos y guiones).
• Después de publicar, llama a get_job hasta que site.live_url esté configurado, luego compártelo. Si site.publish_status muestra un error, informa al usuario; publish_site puede ejecutarse nuevamente.
• Una vez que comienza la compilación, no se puede cancelar.

Sitio web

• Inicia con create_website. Construye un sitio con varias páginas.
• Todo lo demás funciona como la página de aterrizaje: una posible pregunta aclaratoria, site.preview_url, refine para cambios, publish_site solo cuando el usuario lo solicite, luego site.live_url.

Cuando algo falla

Los errores de herramienta vienen con un mensaje, un código y a veces un enlace. Transmite el mensaje y el enlace. No reintentes en un bucle. La lista completa está en references/tools.md.

• plan_required: comparte checkout_url (Plan Starter de $99/mes). Vuelve a intentarlo después de que el usuario lo inicie.
• setting_up: la marca aún se está configurando. Vuelve a intentarlo en unos minutos.
• Marca incorrecta, workspace_required o workspace_not_found: llama a list_workspaces con query establecido en la marca que nombró el usuario, luego llama a la herramienta nuevamente con ese id como workspace.
• limit_reached: hasta 3 trabajos se ejecutan simultáneamente por marca y 30 inicios por hora por persona. Espera a que uno termine, o detén un anuncio de imagen o video con cancel_job.
• no_credits: comparte billing_url para que el usuario pueda recargar.

Nunca

• Iniciar o modificar campañas publicitarias. Glorya no puede hacerlo desde aquí. Indica al usuario que visite https://platform.glorya.ai
• Publicar una página o sitio sin una solicitud explícita.

Ejemplos

• "Crea un anuncio de imagen para nuestras rebajas de verano" → create_image_ad con esa frase como brief.
• "Anuncio de video UGC para el nuevo suero, y déjame revisar el guion" → list_video_formats, luego create_video_ad con el id de UGC como format y review: true.
• "Página de aterrizaje para mi otra marca, Lumi Coffee" → list_workspaces con query: "Lumi Coffee", luego create_landing_page con ese id como workspace.
• "Haz el fondo más oscuro" → refine en el último trabajo.
• "Publícalo" → publish_site, luego comparte site.live_url.