Construire un site interactif
Un site à l'adresse https://{prefix}.interactive.vidmoat.com est un foyer pour les vidéos interactives de la personne, sans rien de notre part autour. Les vidéos sont l'essentiel ; le site est le cadre. Chaque page doit amener un visiteur vers un lecteur en un seul écran.
Les outils : get_interactive_site, edit_interactive_site, publish_interactive_site (MCP et API). Dans l'application, les mêmes appels passent par agentWorkspace avec action: "interactive_site" et site: {tool, ...arguments}.
Flux de travail
- Lire d'abord.
get_interactive_siteavecvideos: true. Cela indique si un site existe (canCreate), ses pages et chaquesectionId, sesproblemset sarev. Modifiez uniquement ce qui est demandé, parsectionId, et renvoyezrev. - Seulement des vidéos publiées et partagées. Un site affiche les vidéos interactives du compte dont les choix sont publiés et partagés ;
videos: trueliste exactement celles-ci, avec leurs identifiants. Une vidéo que la personne nomme et qui n'est pas dans la liste est d'abord publiée (publish_interactiveavecshare: true, quand elle est d'accord), jamais devinée ou échangée contre une autre. - Nommer une fois. Vérifiez un nom avec
get_interactive_siteetprefix: "nom"(limité : un ou deux essais, pas une boucle d'idées), puisedit_interactive_siteaveccreate: {prefix, title}. Utilisez le nom ou la marque de la personne ; un site par compte. - Un seul thème.
setTheme:tone(dark,light),palette(warm,neutral,cool,forest,plum),fontetheadingFont(system,serif,mono,rounded),corners(soft,round,square),density(comfortable,compact,airy),width(normal,narrow,wide),playerAccent(videoconserve l'apparence de chaque vidéo,siteutilise celle du site),accent#RRGGBB. Associez aux films : sombre pour des images cinématographiques ou nocturnes, clair pour des tutoriels et cours. Omettez un jeton pour conserver sa valeur par défaut. - Page d'accueil dans cet ordre : un
hero(titre, une ligne, la vidéo la plus forte en tant quevideo, un bouton), puis unegriddu reste, puis ce qui explique (storypour un film à embranchements,text,about), puis unctaoulinksen dernier. Une vidéo en vedette, pas trois. - Peu de pages. La page d'accueil seule suffit souvent. Ajoutez des pages
filmsouaboutseulement quand il y a plus d'un écran de contenu.setNavles liste ;setHeaderdonne le titre, un slogan et un logo depuisimages: true. - Traiter l'édition par lot. Un seul appel
edit_interactive_siteavec toutes lesops(appliquées tout ou rien), puis lisez lesproblemsde la réponse. - Montrer, puis publier. Donnez à la personne
previewUrl(son brouillon à son adresse réelle, pendant une heure). Publiez avecpublish_interactive_siteseulement quand elle le demande : c'est une page publique.publish: falsela retire immédiatement.
Exemples
{"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}}]}
Pièges
- Pas de code personnalisé. Pas de HTML, CSS, scripts, intégrations ou "style personnalisé" nulle part ; ne les proposez jamais. Une valeur refusée revient avec la liste autorisée : choisissez dedans.
- La page
""est la page d'accueil. Les autres pages sont des slugs (films,about) ; un slug renommé emporte ses liens avec lui. - Les boutons (
cta) sont{label, page}ou{label, href}avec une adressehttps. Leslinkssont https uniquement. textest du Markdown restreint :##et###, listes, gras, italique, liens https. Pas de HTML, pas d'images.aboutprend un identifiant d'image depuisimages: true, jamais une URL.- Un accent peut être refusé quand les mots dessus, ou lui sur la page, seraient difficiles à lire. Essayez un accent plus clair sur fond sombre, plus foncé sur fond clair.
- Les limites sont refusées, jamais coupées : 6 pages, 12 sections par page, 12 vidéos par grille, 6 liens de navigation, 10 liens ; un titre 90 caractères, un texte de corps 600. Raccourcissez les mots vous-même.
nullsupprime un champ optionnel dansupdateSection; l'omettre le conserve.- Les moteurs de recherche peuvent trouver un site publié (un plan du site et des données vidéo l'accompagnent). Rédigez le
titleet ladescriptionde chaque page pour un inconnu qui cherche ;setSettingsindexing: falsegarde un site privé quand la personne le souhaite. - Une carte d'histoire gâche les jeux. Par défaut, elle montre seulement l'ouverture et ses réponses, avec les scènes et fins comptées. Utilisez
reveal: "full"seulement pour une leçon ou un guide, jamais pour un jeu ou un mystère, et jamais à côté d'un texte qui promet un secret. - Les affiches comptent. Les lecteurs et les cartes de grille affichent l'affiche de la vidéo jusqu'à ce qu'elle soit jouée ; choisissez des vidéos dont l'affiche est une vraie carte de titre, pas une première image noire.
- Renommer l'adresse (
edit_interactive_siteavecprefix) conserve l'ancien nom et le redirige pendant un certain temps ; ne renommez pas à la légère. - Les comptes Hobby sont refusés avec la raison ; dites-le clairement, ne contournez pas.