Construindo um site interativo
Um site em https://{prefixo}.interactive.vidmoat.com é um lar para os próprios vídeos interativos da pessoa, sem nada nosso ao redor. Os vídeos são o ponto principal; o site é a moldura. Cada página deve levar um visitante a um player em uma única tela.
As ferramentas: get_interactive_site, edit_interactive_site, publish_interactive_site (MCP e a API). No aplicativo, as mesmas chamadas passam por agentWorkspace com action: "interactive_site" e site: {ferramenta, ...argumentos}.
Fluxo de trabalho
- Leia primeiro.
get_interactive_sitecomvideos: true. Ele informa se um site existe (canCreate), suas páginas e cadasectionId, seusproblemse seurev. Altere apenas o que foi solicitado, porsectionId, e envierevde volta. - Apenas vídeos publicados e compartilhados. Um site mostra os próprios vídeos interativos da conta cujas escolhas estão publicadas e compartilhadas;
videos: truelista exatamente esses, com ids. Um vídeo que a pessoa nomeia que não está na lista é publicado primeiro (publish_interactivecomshare: true, quando ela concordar), nunca adivinhado ou trocado por outro. - Nomeie uma vez. Verifique um nome com
get_interactive_siteeprefix: "nome"(limitado: uma ou duas tentativas, não um loop de ideias), depoisedit_interactive_sitecomcreate: {prefix, title}. Use o próprio nome ou marca da pessoa; um site por conta. - Um tema.
setTheme:tone(dark,light),palette(warm,neutral,cool,forest,plum),fonteheadingFont(system,serif,mono,rounded),corners(soft,round,square),density(comfortable,compact,airy),width(normal,narrow,wide),playerAccent(videomantém a aparência de cada vídeo,siteusa a do site),accent#RRGGBB. Combine com os filmes: escuro para filmagens noturnas ou de cinema, claro para tutoriais e cursos. Deixe um token de fora para manter seu padrão. - Página inicial nesta ordem: um
hero(título, uma linha, o vídeo mais forte comovideo, um botão), depois umagriddo restante, depois o que explica (storypara um filme ramificado,text,about), depois umctaoulinkspor último. Um vídeo em destaque, não três. - Poucas páginas. A página inicial sozinha geralmente é suficiente. Adicione páginas
filmsouaboutapenas quando houver mais de uma tela de conteúdo.setNavas lista;setHeaderfornece o título, uma tagline e um logotipo deimages: true. - Agrupe a edição. Uma chamada
edit_interactive_sitecom todas asops(aplicadas todas ou nenhuma), depois leia osproblemsda resposta. - Mostre, depois publique. Dê à pessoa
previewUrl(seu rascunho no endereço real, por uma hora). Publique compublish_interactive_siteapenas quando ela solicitar: é uma página pública.publish: falsea remove imediatamente.
Exemplos
{"create": {"prefix": "river-films", "title": "River Films"}}
{"rev": 3, "ops": [
{"op": "setTheme", "tone": "dark", "palette": "cool", "headingFont": "serif", "accent": "#4CC9F0"},
{"op": "setHeader", "title": "River Films", "tagline": "Short films you play"},
{"op": "addPage", "slug": "films", "title": "Films"},
{"op": "setNav", "links": [{"label": "Home", "page": ""}, {"label": "Films", "page": "films"}]},
{"op": "addSection", "page": "", "section": {"kind": "hero", "heading": "Films where you choose what happens next", "body": "Pick a path, then go back and take the other one.", "video": "<id from videos:true>", "cta": {"label": "See every film", "page": "films"}}},
{"op": "addSection", "page": "", "section": {"kind": "grid", "heading": "Play them all", "videos": ["<id>", "<id>"], "columns": 3}},
{"op": "addSection", "page": "", "section": {"kind": "story", "video": "<id>", "heading": "How it branches"}}
]}
{"rev": 4, "ops": [{"op": "updateSection", "sectionId": "<from the digest>", "set": {"heading": "New films every month", "body": null}}]}
Armadilhas
- Sem código personalizado. Sem HTML, CSS, scripts, incorporações ou "estilo personalizado" em lugar nenhum; nunca os ofereça. Um valor recusado retorna com a lista permitida: escolha dela.
- Página
""é a inicial. Outras páginas são slugs (films,about); um slug renomeado carrega seus links com ele. - Botões (
cta) são{label, page}ou{label, href}com um endereçohttps.linkssão apenas https. texté Markdown restrito:##e###, listas, negrito, itálico, links https. Sem HTML, sem imagens.aboutrecebe um id de imagem deimages: true, nunca uma URL.- Um acento pode ser recusado quando as palavras sobre ele, ou ele sobre a página, ficariam difíceis de ler. Tente um acento mais claro no escuro, um mais escuro no claro.
- Limites são recusados, nunca cortados: 6 páginas, 12 seções por página, 12 vídeos por grade, 6 links de navegação, 10 links; um título de 90 caracteres, texto do corpo de 600. Encurte as palavras você mesmo.
nullremove um campo opcional emupdateSection; deixá-lo de fora o mantém.- Mecanismos de busca podem encontrar um site publicado (um sitemap e dados de vídeo vêm com ele). Escreva o
titleedescriptionde cada página para um estranho pesquisando;setSettingsindexing: falsemantém um site fora quando a pessoa o quer privado. - Um mapa de história estraga jogos. Por padrão, ele mostra apenas a abertura e suas respostas, com as cenas e finais contados. Use
reveal: "full"apenas para uma lição ou guia, nunca para um jogo ou mistério, e nunca ao lado de texto que prometa um segredo. - Pôsteres são importantes. Players e cartões de grade mostram o pôster do vídeo até que seja reproduzido; escolha vídeos cujo pôster seja uma placa de título real, não um primeiro quadro preto.
- Renomear o endereço (
edit_interactive_sitecomprefix) mantém o nome antigo e o redireciona por um tempo; não renomeie casualmente. - Contas Hobby são recusadas com o motivo; diga claramente, não contorne.