Intramedial befindet sich in der eingeschränkten Beta. Bei der Registrierung oder Anmeldung müssen Sie das erhaltene Beta-Tester-Passwort angeben oder unter preview@intramedial.com eines anfordern. Vielen Dank.
Wird geladen…
previews.listModul 46
Plane-Modul
Pull request preview arenas
Erhalten Sie je Pull Request eine Wegwerf-Arena, mit versteckten Teilnehmern und einer Datenstichprobe geforkt, von selbst entfernt, auch wenn es ihr niemand sagt.
previews.list liest die aktiven und kürzlich abgeräumten Vorschauen dieses Workspace. previews.open forkt eine aus einem Quell-Yard, schwärzt Teilnehmer-DIDs und zieht standardmäßig ein Viertel seiner Daten, unter einer verpflichtenden Frist. Eine Vorschau ist ein echter Yard, als ephemeral markiert, damit sie nie zurückbefördert wird.
Agenten handeln, wenn die Ebene Ja sagt – und das Protokoll sagt, warum.
Leiten Sie Agent-Aktionen, Inhalts-Hashes, API-Checks, DNS-Abfragen, Webhooks, LLM-Aufrufe und Git-Commits über Intramedial – für einen signierten Beleg, den jeder prüft, ohne uns zu vertrauen.
Die aus dem Fork entfernten Felder, standardmäßig participantDids.
sampleRate
Der Anteil der Daten des Quell-Yards, der in den Fork gezogen wird, standardmäßig 0,25.
expiresAt
Wann die TTL der Vorschau sie von selbst abräumen würde.
hoursRemaining
Stunden bis expiresAt, beim Lesen berechnet und in jede gelistete Vorschau eingemischt.
summary
Zahlen über alle Vorschauen: live, reaped, expiringWithin24h und der oldestLiveKey.
Mechanismus
Schritt für Schritt
So funktioniert es
Eine Vorschau öffnet sich bei der ersten Anfrage
open mit repo und number forkt den Quell-Yard mit redact und sampleRate, standardmäßig participantDids verbergend und ein Viertel der Daten ziehend.
Eine zweite Anfrage frischt sie auf
Ein späteres open für dasselbe repo/number frischt die Frist der bestehenden Vorschau auf, statt eine zweite zu forken; ein Wettlauf zweier Builds baut den Fork des Verlierers ab.
Eine Frist ist nie optional
Jede Vorschau erhält eine TTL, standardmäßig 72 Stunden und auf 14 Tage begrenzt; eine ungültige oder fehlende TTL fällt auf den Standard zurück, statt unbegrenzt zu laufen.
Zwei Wege führen zur Entfernung
close räumt eine Vorschau ab, wenn ihr Pull Request schließt, was die Uhr auch sagt. sweep räumt bei abgelaufener TTL oder geschlossenem Pull Request ab, unabhängig voneinander.
Ausprobieren
Live-Demo
Direkt auf dieser Seite ausführen
GET/api/v1/acp/previews/list
// Kein Body: Das ist ein GET. Klicken Sie auf Ausführen.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates. Doku zu previews.list
Antworten
Klicken Sie auf Ausführen, um die Anfrage links an den gemeinsamen Demo-Workspace zu senden.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates.
Code
Live-Beispiel
Eine echte Anfrage
Eine Anfrage in der Form, die die API akzeptiert, und eine Beispielantwort in der Form, die das Modul liefert.
api.intramedial.com/api/v1/acp/previews/listGET
GET/api/v1/acp/previews/listAuthorization: Bearer av_workspace_••••→ 200 { previews, summary } (summary carries live, reaped, expiringWithin24h and oldestLiveKey counts, left out of the catalogue sample)
Ein Pull Request forkt eine gezogene, teilnehmergeschwärzte Kopie des Produktions-Yards, sodass Prüfer realistisches Verhalten sehen, ohne offenzulegen, wer tatsächlich beteiligt war.
Sich nicht allein auf einen Webhook verlassen
Trifft ein Pull-Request-geschlossen-Webhook nie ein, räumt sweep die Vorschau dennoch ab, sobald ihre TTL abläuft, sodass vergessene Vorschauen sich nicht unbegrenzt anhäufen.
Einen doppelten Build-Trigger überstehen
Zwei Builds wetteifern darum, dieselbe Vorschau zu öffnen; der Fork des Verlierers wird automatisch abgebaut, und die Anfrage fällt auf die eine bestehende Vorschau zurück.
Beobachten, was gleich abläuft
Ein Betreiber liest summary.expiringWithin24h, um zu sehen, wie viele Vorschauen gleich abgeräumt werden, bevor jemand je Schlüssel suchen muss.
Wann etwas anderes passt
Eine langlebige Umgebung. Eine Vorschau ist immer ephemeral und kann nie in den Yard befördert werden, aus dem sie geforkt wurde.
Standardmäßig die ganze Besetzungsliste eines Yards kopieren. Schwärzung und ein Viertel Stichprobe sind die Standards; ein Aufrufer muss sich für mehr entscheiden.
Mit eigenem Zähler abrechnen. Eine Vorschau ist ein Yard, und die Yard-Erstellung bemisst sie bereits über yards.instances.
Nachweis
Garantien
Was es leistet und was nicht
Ein Modul ist eine starke Aussage über etwas Enges. Verlassen Sie sich genau darauf.
Es leistet
Eine Vorschau wird standardmäßig mit geschwärzten participantDids und einer 0,25-Stichprobe geforkt, nicht als volle Kopie des Quell-Yards.
Jede Vorschau trägt eine begrenzte TTL; keine kann unbegrenzt laufen, da eine ungültige oder fehlende auf 72 Stunden zurückfällt.
Eine zum Fork-Zeitpunkt als ephemeral markierte Vorschau kann danach nie in ihren Quell-Yard befördert werden.
Es leistet nicht
Dass eine Vorschau tatsächlich geprüft wurde. Stichprobe und Schwärzung beschreiben, welche Daten sie hält, nicht was jemand damit tat.
Dass ein Abräumen immer sauber läuft. Scheitert der zugrunde liegende Abbau, bleibt die Vorschau live und unmarkiert, damit der nächste Sweep es erneut versucht.
Dass der Pull-Request-Zustand einer Vorschau sicher bekannt ist. Eine nicht erreichbare API gilt als unbekannt, und ein unbekannter Zustand wird dennoch bei TTL abgeräumt.
Details
Bauhinweise
Bevor Sie bauen
Keine neue Aktion, kein neuer Zähler
Eine Vorschau ist unter der Haube ein Yard, daher fügt dieses Modul dem eingefrorenen Aktionskatalog nichts hinzu und keinen Billing-Zähler über den hinaus, den die Yard-Erstellung bereits nutzt.
Eine Vorschau je Schlüssel, per Auffrischen durchgesetzt
open prüft zuerst immer auf eine bestehende aktive Vorschau unter demselben repo#number; es frischt auf, statt ein zweites Mal zu forken.
Schwärzung geschieht beim Fork
Ein geschwärztes Feld wird beim Bau des Forks entfernt, nicht nachträglich maskiert, und jeder daraus abgeleitete Schlüssel wird durch ein opakes Handle ersetzt, damit der Wert nicht über seinen eigenen Schlüssel lecken kann.
Limits und Bemessung
Keine Aktion hier hat eine MCP- oder Vertrags-Aktions-ID; Vorschauen sind nur über REST erreichbar.
Die TTL-Obergrenze beträgt 14 Tage; durch weiteres Anheben lässt sich eine Vorschau nicht länger betreiben.
sweep nimmt eine Map bekannter Pull-Request-Zustände; alles nicht Gelieferte gilt als unbekannt, was bei abgelaufener TTL dennoch abräumt.
Zugriff
API & MCP
REST und MCP
Authentifizieren Sie sich mit einem Workspace-API-Schlüssel als Bearer-Token. Die Basis-URL ist https://api.intramedial.com.
REST-Endpunkte
GET/api/v1/acp/previews/listAktive und kürzlich abgeräumte Vorschauen mit einer Zusammenfassung auflisten.
GET/api/v1/acp/previews/statusNur die Zusammenfassungszahlen lesen.
MCP-Aktionen
Dieses Modul hat keine MCP-Aktion. Rufen Sie es über REST von jedem Agenten oder Programm auf.
Plane-Modul
