Glorya-AI/glorya

O que glorya faz?

Glorya é um agente de marketing de IA. Ele já conhece a marca do usuário: logotipo, cores, fontes, produtos e idioma. Você inicia o trabalho, acompanha e compartilha os resultados. Glorya termina por conta própria, a menos que o usuário peça para revisar.

Toda ferramenta, entrada, status, erro e limite estão em references/tools.md.

Quando usar

• O usuário solicita um anúncio de imagem, anúncio em vídeo, landing page ou site.
• O usuário deseja alterar, publicar ou interromper algo que Glorya criou.
• O usuário pergunta sobre suas imagens e vídeos recentes do Glorya (list_assets), os estilos de vídeo (list_video_formats) ou sua marca e produtos (get_brand).

Conectar

As ferramentas vêm do servidor MCP do Glorya em https://platform.glorya.ai/mcp (HTTP streamable, OAuth com a conta Glorya do usuário). Se estiverem faltando, peça ao usuário para conectá-lo: https://glorya.ai/docs/mcp/quickstart. Ao conectar, ele escolhe uma marca padrão.

Regras

• Use a marca padrão: deixe workspace vazio. Apenas quando o usuário nomear outra marca, chame list_workspaces com query definido para esse nome e passe o id correspondente como workspace.
• Comece imediatamente. Passe as próprias palavras do usuário como brief. Se ele não forneceu detalhes, passe o que ele pediu, como "Criar um anúncio de imagem".
• Não pergunte nada antes de começar: nem formato, tamanho, idioma, público ou estilo. Glorya escolhe.
• Defina language, format ou references apenas quando o usuário os forneceu. references são links https públicos.
• Deixe review de fora; é falso, então Glorya termina por conta própria. Defina review: true apenas quando o usuário pedir para revisar ou aprovar etapas ("deixe-me revisar", "mostre-me o conceito primeiro"). Nunca pergunte ao usuário sobre isso.
• Nunca invente produtos, preços ou ofertas. Nunca inicie o mesmo trabalho duas vezes.

O loop do trabalho

1. Chame a ferramenta de criação. Ela retorna job_id e open_url. Informe ao usuário que foi iniciado e compartilhe open_url.
2. Chame get_job com job_id e wait_seconds: 30. Enquanto status for running, chame novamente. Ela já aguarda mudanças, então não faça polling mais rápido.
3. needs_input: Glorya precisa de uma decisão. Mostre cada item em questions como está escrito, com seus choices e preview_images exatos. Aguarde o usuário. Em seguida, chame respond com job_id, o request_id da pergunta e answer, e volte ao passo 2.
   • decision e approve: answer é um rótulo exato de choices.
   • input, revise e clarify: as próprias palavras do usuário funcionam.
   • Não responda pelo usuário. Não adicione perguntas próprias. Se o usuário escrever em outro idioma, traduza a pergunta, mas envie o rótulo exato.
4. completed: compartilhe os resultados (veja cada tipo abaixo) e open_url. Se progress perguntar algo ao usuário, repasse e envie a resposta com refine.
5. failed: informe ao usuário o que error ou progress dizem. Ofereça refine com uma instrução alterada, ou um novo trabalho.
6. cancelled: o trabalho parou. Arquivos finalizados permanecem no Glorya.

Alterações: chame refine com o mesmo job_id e as palavras do usuário como instruction, depois execute o loop novamente a partir do passo 2. Alterações usam créditos.

Anúncio de imagem

• Inicie com create_image_ad.
• Glorya planeja o anúncio, escreve o texto e cria as imagens. Com review: true, ele para para aprovar o plano (conceito e texto) e as imagens finalizadas.
• Quando terminar, assets contém as imagens. Compartilhe cada url e open_url. progress contém a mensagem mais recente da Glorya, como o texto do anúncio.
• Para alterações, use refine: "Deixe o título mais curto."

Anúncio em vídeo

• Inicie com create_video_ad.
• Defina format apenas se o usuário nomeou um estilo de vídeo. Chame list_video_formats e passe o id correspondente. Caso contrário, omita; Glorya escolhe um.
• Glorya escreve o roteiro, cria os frames iniciais e renderiza o corte final. Com review: true, ele para para aprovar o formato, o roteiro, os frames iniciais e o corte final.
• A renderização leva minutos. Continue chamando get_job e informe ao usuário de vez em quando que ainda está trabalhando.
• Quando terminar, assets lista o vídeo primeiro, com url e poster_url. Compartilhe o link do vídeo e open_url.
• Para alterações, use refine: "Use uma voz mais calma." Para interromper, use cancel_job.

Landing page

• Inicie com create_landing_page.
• O builder pode fazer uma pergunta de esclarecimento (clarify). Repasse como qualquer outra.
• Quando terminar, compartilhe site.preview_url e open_url. A página ainda não está no ar.
• Para alterações, use refine: "Adicione uma seção de preços."
• Publique apenas quando o usuário disser ("publique", "coloque no ar"): chame publish_site com job_id. slug é opcional (letras minúsculas, dígitos e traços).
• Após publicar, chame get_job até que site.live_url esteja definido e compartilhe. Se site.publish_status mostrar uma falha, informe ao usuário; publish_site pode ser executado novamente.
• Uma construção não pode ser cancelada depois de iniciada.

Site

• Inicie com create_website. Ele constrói um site com várias páginas.
• Todo o resto funciona como a landing page: uma possível pergunta de esclarecimento, site.preview_url, refine para alterações, publish_site apenas quando o usuário solicitar, depois site.live_url.

Quando algo falha

Erros de ferramenta vêm com uma mensagem, um código e às vezes um link. Repasse a mensagem e o link. Não tente novamente em loop. A lista completa está em references/tools.md.

• plan_required: compartilhe checkout_url (plano Starter de $99/mês). Tente novamente após o usuário iniciá-lo.
• setting_up: a marca ainda está sendo configurada. Tente novamente em alguns minutos.
• Marca errada, workspace_required ou workspace_not_found: chame list_workspaces com query definido para a marca que o usuário nomeou, depois chame a ferramenta novamente com esse id como workspace.
• limit_reached: até 3 jobs são executados simultaneamente por marca e 30 inícios por hora por pessoa. Aguarde até que um termine ou pare um anúncio de imagem ou vídeo com cancel_job.
• no_credits: compartilhe billing_url para que o usuário possa recarregar.

Nunca

• Inicie ou altere campanhas de anúncios. Glorya não pode fazer isso daqui. Direcione o usuário para https://platform.glorya.ai
• Publique uma página ou site sem uma solicitação explícita.

Exemplos

• "Crie um anúncio de imagem para nossa promoção de verão" → create_image_ad com essa frase como brief.
• "Anúncio em vídeo UGC para o novo sérum, e me deixe revisar o roteiro" → list_video_formats, depois create_video_ad com o id do UGC como format e review: true.
• "Landing page para minha outra marca, Lumi Coffee" → list_workspaces com query: "Lumi Coffee", depois create_landing_page com esse id como workspace.
• "Deixe o fundo mais escuro" → refine no último trabalho.
• "Publique" → publish_site, depois compartilhe site.live_url.