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…
portmind.memoryModul 51
Plane-Modul
Agent memory snapshots
Prüfen Sie, was ein Agent sich merkt, und erstellen Sie einen signierten, Merkle-verankerten Snapshot seines Gedächtnisses, mit einem versionierten, workspace-bezogenen Store.
portmind.memory liest und schreibt einen agentenbezogenen Gedächtnisspeicher, und snapshot verankert seine Einträge in einem Merkle-Baum und signiert die Root als memory-attestation mit dem Ledger-Bundle-Schlüssel der Region. Das Gateway erreicht den Store in jeder Region über ein Service-Binding.
Intralock · Leases · Parley · Fleet Map
A Trustvice Product
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.
Das Gateway leitet /api/v1/portmind/* an die Portmind-Runtime der jeweiligen Region weiter. Das Gedächtnis ist auf den aufrufenden Workspace begrenzt und in der Workspace-Datenbank dieser Region gespeichert.
Protokoll
Das Protokoll
Was erfasst wird
agentRef
Der Agent, zu dessen Gedächtnis der Eintrag gehört; bei jedem Lesen und Schreiben erforderlich.
key
Der eigene Schlüssel des Gedächtniseintrags, unterschieden vom Agenten, zu dem er gehört.
entry
Ein Gedächtniseintrag, vom Einzelschlüssel-Lesen geliefert.
Jeder aktive Eintrag eines Agenten, vom Listen-Lesen ohne Schlüssel geliefert.
version
Wird bei jedem Upsert auf denselben Schlüssel erhöht, sodass ein Schreibvorgang nie stillschweigend einen früheren Wert verliert.
merkleRoot
Die Root, die snapshot in diesem Moment über das aktuelle Gedächtnis des Agenten berechnet.
Mechanismus
Schritt für Schritt
So funktioniert es
Ein Eintrag wird geschrieben
POST /api/v1/portmind/memory führt für einen agentRef und einen key ein Upsert eines Eintrags aus und versioniert ihn bei Konflikt, statt stillschweigend zu überschreiben.
Ein Eintrag wird per Schlüssel gelesen
GET /api/v1/portmind/memory/<key> mit agentRef liefert diesen einen Eintrag als entry, oder ein Tombstone-Ergebnis, wenn er gelöscht wurde.
Das gesamte Gedächtnis wird gelistet
GET /api/v1/portmind/memory mit agentRef und optionalem limit liefert jeden aktiven Eintrag dieses Agenten als entries.
Ein Snapshot verankert und signiert das Gedächtnis
POST /api/v1/portmind/snapshot baut eine Merkle-Root über die sortierten Blätter {key, contentSha256} des aktuellen Gedächtnisses eines Agenten und liefert sie als signierte memory-attestation.
Ausprobieren
Live-Demo
Direkt auf dieser Seite ausführen
GET/api/v1/portmind/memory/billing-agent
// Kein Body: Das ist ein GET. Klicken Sie auf Ausführen.
Die Aufrufe dieses Moduls verändern echten Zustand oder erreichen externe Dienste, daher führt die gemeinsame Demo sie nicht aus. Melden Sie sich an, um es in Ihrem eigenen Workspace auszuführen. Doku zu portmind.memory
Antworten
Die Aufrufe dieses Moduls verändern echten Zustand oder erreichen externe Dienste, daher führt die gemeinsame Demo sie nicht aus. Melden Sie sich an, um es in Ihrem eigenen Workspace auszuführen.
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.
GET/api/v1/portmind/memory/billing-agentAuthorization: Bearer av_workspace_••••→ 200 { entry: { agentRef, key, value, contentSha256, tags, version, createdAt, updatedAt } } for one key (add ?agentRef=); 404 if no live entry. The no-key list route returns { entries }
Eine signierte Gedächtnis-Attestierung zeigt genau, was das Gedächtnis eines Agenten in diesem Moment enthielt, nicht, was es jetzt enthält.
Einen veralteten Gedächtniseintrag korrigieren
Ein Betreiber entfernt oder aktualisiert einen Schlüssel im Gedächtnis eines Agenten, statt dessen gesamten Store zu leeren, da Einträge einzeln adressiert und versioniert sind.
Einen Gedächtnis-Export offline verifizieren
Die Attestierung ist mit demselben Schlüssel je Region signiert wie Ledger-Bundles, sodass intramedial-verify sie gegen /.well-known/ledger-bundles-keys.json prüft, ohne Rückruf an Intramedial.
Der Dashboard-Browser gegen echte Daten
Die Memory-Browser-Konsole liest aus genau diesem Client ohne Demo-Daten-Fallback, sodass sie zeigt, was der Store tatsächlich enthält, nichts Inszeniertes.
Wann etwas anderes passt
Aufrufe ohne Workspace-Kontext. Jede Route antwortet 401, wenn das Gateway keinen Workspace aufgelöst hat.
Werte in der Attestierung speichern. Sie trägt nur Schlüssel und Inhalts-Hash jedes Eintrags; die Werte bleiben im Store.
{ entries } als Form eines Einzelschlüssel-Lesens behandeln. Dieses Lesen liefert entry, im Singular.
Nachweis
Garantien
Was es leistet und was nicht
Ein Modul ist eine starke Aussage über etwas Enges. Verlassen Sie sich genau darauf.
Es leistet
Der Store-Code, seine Upsert-mit-Versionierung-Logik und seine Merkle-Snapshot-Berechnung sind echter, getesteter Code, nicht nur ein Entwurfsdokument.
Ein fehlender Schlüssel ist ein sauberes 404 und ein fehlendes Feld ein sauberes 400, kein stiller Fehlschlag.
Die Merkle-Root eines Snapshots wird über die eigenen sortierten Einträge des Agenten in diesem Moment berechnet, nicht über eine zwischengespeicherte oder veraltete Kopie.
Es leistet nicht
Dass ein Snapshot existiert, wenn das Signieren nicht verfügbar ist. Ist in der Region kein Signaturschlüssel konfiguriert, antwortet snapshot 503 signing_unavailable und liefert nichts Unsigniertes.
Dass Gedächtnis Regionen überschreitet. Der Store jeder Region ist getrennt.
Dass ein exportierter Wert der attestierte ist. Hashen Sie jeden Wert neu und vergleichen Sie ihn mit seinem contentSha256 in der Attestierung.
Details
Bauhinweise
Bevor Sie bauen
Ein dedizierter Worker
runtime/portmind ist ein Cloudflare Worker mit eigenem Store, eigenen Tests und eigenem Dashboard-Client, nur über das Service-Binding des Gateways erreichbar.
Keine MCP- oder ACP-Dispatch-Anbindung
Portmind ist nicht Teil des Dispatch-Systems /api/v1/acp/* und hat keine coordination.*-Aktions-ID; es ist ein eigenständiger Worker, nur über das oben beschriebene Gateway-Binding erreichbar.
Der Schlüssel ist nicht der Agent
Das URL-Segment des Einzelschlüssel-Pfads nennt einen Gedächtnisschlüssel, keine Agenten-ID; der Agent wird immer separat als agentRef angegeben.
Limits und Bemessung
Gedächtniseinträge sind in der Größe begrenzt; ein zu großer Body ergibt 413.
Das Einzelschlüssel-Lesen liefert einen entry; nur das Listen-Lesen ohne Schlüssel liefert entries.
Für keine Portmind-Route existiert eine MCP- oder Vertrags-Aktions-ID.
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/portmind/memoryDie aktiven Gedächtniseinträge eines Agenten auflisten.
GET/api/v1/portmind/memory/:keyEinen Gedächtniseintrag per Schlüssel lesen.
POST/api/v1/portmind/memoryEinen Gedächtniseintrag schreiben oder versionieren.
MCP-Aktionen
Dieses Modul hat keine MCP-Aktion. Rufen Sie es über REST von jedem Agenten oder Programm auf.
Planen Sie, wo die Koordinationsdaten dieses Workspace liegen sollen, sehen Sie genau, was umzöge, und tragen Sie es dann auf Ihr eigenes Kommando in eine andere Region.
Plane-Modul
