Erstellen einer interaktiven Seite
Eine Seite unter https://{prefix}.interactive.vidmoat.com ist ein Zuhause für die eigenen interaktiven Videos, ohne dass etwas von uns herumsteht. Die Videos sind der Punkt; die Seite ist der Rahmen. Jede Seite sollte einen Besucher innerhalb eines Bildschirms zu einem Player führen.
Die Werkzeuge: get_interactive_site, edit_interactive_site, publish_interactive_site (MCP und die API). In der App gehen dieselben Aufrufe durch agentWorkspace mit action: "interactive_site" und site: {tool, ...arguments}.
Workflow
- Zuerst lesen.
get_interactive_sitemitvideos: true. Es sagt, ob eine Seite existiert (canCreate), ihre Seiten und jedesectionId, ihreproblemsund ihrerev. Ändere nur, wonach gefragt wurde, persectionId, und senderevzurück. - Nur veröffentlichte, geteilte Videos. Eine Seite zeigt die eigenen interaktiven Videos des Kontos, deren Auswahlmöglichkeiten veröffentlicht und geteilt sind;
videos: truelistet genau diese mit IDs auf. Ein vom Benutzer genanntes Video, das nicht auf der Liste steht, wird zuerst veröffentlicht (publish_interactivemitshare: true, wenn sie zustimmen), niemals erraten oder gegen ein anderes ausgetauscht. - Einmal benennen. Überprüfe einen Namen mit
get_interactive_siteundprefix: "name"(begrenzt: ein oder zwei Versuche, keine Schleife über Ideen), dannedit_interactive_sitemitcreate: {prefix, title}. Verwende den eigenen Namen oder die Marke der Person; eine Seite pro Konto. - Ein Thema.
setTheme:tone(dark,light),palette(warm,neutral,cool,forest,plum),fontundheadingFont(system,serif,mono,rounded),corners(soft,round,square),density(comfortable,compact,airy),width(normal,narrow,wide),playerAccent(videobehält das eigene Aussehen jedes Videos,siteverwendet das der Seite),accent#RRGGBB. Passe die Filme an: dunkel für filmisches oder Nachtmaterial, hell für Tutorials und Kurse. Lasse ein Token weg, um seinen Standardwert zu behalten. - Startseite in dieser Reihenfolge: ein
hero(Überschrift, eine Zeile, das stärkste Video alsvideo, ein Button), dann eingridder restlichen, dann was auch immer erklärt (storyfür einen verzweigten Film,text,about), dann einctaoderlinkszuletzt. Ein hervorgehobenes Video, nicht drei. - Wenige Seiten. Die Startseite allein reicht oft. Füge
films- oderabout-Seiten nur hinzu, wenn es mehr als einen Bildschirm davon gibt.setNavlistet sie auf;setHeadergibt den Titel, einen Untertitel und ein Logo vonimages: true. - Die Bearbeitung bündeln. Ein
edit_interactive_site-Aufruf mit allenops(alle oder keine angewendet), dann lies dieproblemsder Antwort. - Zeigen, dann veröffentlichen. Gib der Person
previewUrl(ihren Entwurf unter der echten Adresse, für eine Stunde). Veröffentliche mitpublish_interactive_sitenur, wenn sie darum bitten: Es ist eine öffentliche Seite.publish: falsenimmt sie sofort offline.
Beispiele
{"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}}]}
Fallstricke
- Kein benutzerdefinierter Code. Kein HTML, CSS, Skripte, Einbettungen oder „benutzerdefiniertes Styling“ irgendwo; biete sie niemals an. Ein abgelehnter Wert kommt mit der erlaubten Liste zurück: wähle daraus.
- Seite
""ist die Startseite. Andere Seiten sind Slugs (films,about); ein umbenannter Slug trägt seine Links mit sich. - Buttons (
cta) sind{label, page}oder{label, href}mit einerhttps-Adresse.linkssind nur https. textist eingeschränktes Markdown:##und###, Listen, fett, kursiv, https-Links. Kein HTML, keine Bilder.aboutnimmt eine Bild-ID vonimages: true, niemals eine URL.- Ein Akzent kann abgelehnt werden, wenn Wörter darauf oder die Seite darauf schwer lesbar wären. Versuche einen helleren Akzent auf dunklem, einen tieferen auf hellem.
- Grenzen werden abgelehnt, nicht abgeschnitten: 6 Seiten, 12 Abschnitte pro Seite, 12 Videos pro Grid, 6 Nav-Links, 10 Links; eine Überschrift 90 Zeichen, Fließtext 600. Kürze die Wörter selbst.
nullentfernt ein optionales Feld inupdateSection; es wegzulassen behält es.- Suchmaschinen können eine veröffentlichte Seite finden (eine Sitemap und Videodaten werden mitgeliefert). Schreibe
titleunddescriptionjeder Seite für einen Fremden, der sucht;setSettingsindexing: falsehält eine Seite draußen, wenn die Person sie privat haben möchte. - Eine Story-Map verdirbt Spiele. Standardmäßig zeigt sie nur den Anfang und seine Antworten, mit den Szenen und Enden gezählt. Verwende
reveal: "full"nur für eine Lektion oder einen Leitfaden, niemals für ein Spiel oder Geheimnis, und niemals neben Text, der ein Geheimnis verspricht. - Poster sind wichtig. Player und Grid-Karten zeigen das Poster des Videos, bis es abgespielt wird; wähle Videos, deren Poster eine echte Titelcard ist, kein schwarzer erster Frame.
- Die Adresse umbenennen (
edit_interactive_sitemitprefix) behält den alten Namen und leitet ihn eine Weile weiter; benenne nicht leichtfertig um. - Hobby-Konten werden mit dem Grund abgelehnt; sag es klar, umgehe es nicht.