Visuellen Kontext an einen Agenten senden
Füge das vollständige Pinar-Bundle ein, damit der Agent Kommentar, Ziel, Geometrie und das geteilte Bild zusammen sieht.
4 Min.In dieser Anleitung
Was einzufügen ist
Pinar schreibt reines Markdown und HTML in die Zwischenablage. Der Text enthält lesbare Annotationen plus einen abgegrenzten pinar-visual-context-JSON-Block. Füge beides als eine Einheit ein; der strukturierte Block ist die maschinenlesbare Quelle der Wahrheit.
Screenshot und Warnungen
Wenn das Bundle einen absoluten Screenshot-Pfad auflistet, sollte der lokale Agent dieses einzelne Bild öffnen; nummerierte Badges sind Overlays. Warnungen wie screenshot_missing, helper_unavailable oder viewer_unavailable beschreiben eine eingeschränkte Zustellung, machen die Kommentare und den DOM-Kontext jedoch nicht ungültig.
Wie das kopierte Bundle an einen Agenten geliefert wird
Die Chrome-Erweiterung tippt niemals in den Agent-Composer. Im Prompt-Modus füge die Zwischenablage nach Command+Enter / Alt+Enter selbst in Cursor, Claude, Codex oder Grok ein. Der Text beginnt damit, dass die Pin-Notizen eine Änderung oder eine Erklärung erbitten können, und Selektor und DOM-Pfad als ergänzende Locator zu behandeln, gefolgt von einem abgegrenzten pinar-visual-context-JSON-Block. Wenn eine Viewer-URL enthalten ist, rufe sie nur ab, wenn diese Details nicht ausreichen. Im Link-Modus erhält der Agent nur den Sitzungslink und braucht Zugriff auf diese .md (Pinar-Cloud-Links sind privat und erfordern API-Key oder MCP); Aus speichert nur.
Behandle captureId und pinId als Identität, nicht als Labels zum Umschreiben. Visual Context kodiert derzeit schemaVersion 1; parseVisualCapture lehnt eine fehlende captureId und jede schemaVersion außer 1 oder dem Legacy-Wert 0 ab. Folge nur dem, was die Pins beschreiben. Wenn die Person nichts eingefügt hat, bitte sie, erneut aus Pinar zu kopieren, statt Pins aus dem Gedächtnis zu rekonstruieren.
- Füge die gesamte Zwischenablage in den Agenten ein; tippe Kommentare nicht ab und erfinde keine neue
captureId. - Bestätige, dass der eingefügte Text noch einen geschlossenen pinar-visual-context-Fence enthält, bevor du Code bearbeitest.
- Wenn nichts eingefügt wurde, bitte um
Command+Enter/Alt+Enterin Pinar und folge nur den Pin-Notizen.
Einen Agenten mit Pinar über MCP arbeiten lassen
Pinar stellt seine gespeicherten Sitzungen außerdem über das Model Context Protocol bereit. Ein MCP-Client kann Projekte, Collections, Chargen, Sitzungen, Pins und Pin-Kommentare auflisten und sie anlegen, kommentieren, umbenennen, verschieben, neu anordnen oder löschen.
Der lokale Pinar-Dienst bietet MCP auf deinem eigenen Rechner an, ohne Konto, Login oder API-Schlüssel. Pinar Cloud verlangt einen API-Schlüssel mit der nötigen Berechtigung, und der Ressourcenumfang des Schlüssels begrenzt, was der Agent lesen, kommentieren oder ändern kann.
Für die Client-Konfiguration, einschließlich Endpunkt, Authentifizierungs-Header und Protokolldetails, siehe den Agenten-Zugangsleitfaden im Pinar-Repository.
- Eine vom Agenten angelegte Sitzung speichert die Seitendaten ohne Screenshot, und ein Agenten-Pin speichert den Kommentar mit einem optionalen Locator statt gemessener Geometrie.
- MCP rehydratisiert oder synchronisiert den Browser-Entwurf nicht; die Erweiterung bleibt die Schreibende des aktiven Entwurfs, und ein späteres explizites Speichern ersetzt die gespeicherte Sitzung unter derselben id.
- Teilen bleibt explizit: Veröffentliche einen Share aus dem Workspace oder lass einen Agenten mit der Teilen-Berechtigung ihn veröffentlichen oder widerrufen.