Envoyer le contexte visuel à un agent

Pinar écrit du Markdown simple et du HTML dans le presse-papiers. Le texte inclut des annotations lisibles plus un bloc JSON pinar-visual-context délimité. Collez les deux comme une unité ; le bloc structuré est la source de vérité lisible par machine.

Si le paquet liste un chemin Screenshot absolu, l’agent local doit ouvrir cette image unique ; les badges numérotés sont des overlays. Des avertissements tels que screenshot_missing, helper_unavailable ou viewer_unavailable décrivent une livraison dégradée mais n’invalident pas les commentaires ni le contexte DOM.

L’extension Chrome ne tape jamais dans le composer de l’agent. En mode Prompt, après Command+Enter / Alt+Enter, collez vous-même le presse-papiers dans Cursor, Claude, Codex ou Grok. Le texte commence en indiquant que les notes des pins peuvent demander un changement ou une explication, et à traiter sélecteur et chemin DOM comme des localisateurs complémentaires, suivies d’un bloc JSON pinar-visual-context délimité. Si une URL Viewer est incluse, ne la récupérez que lorsque ces détails ne suffisent pas. En mode Lien, l’agent reçoit seulement le lien de la session et doit pouvoir accéder à ce .md (les liens Pinar Cloud sont privés et exigent une API key ou MCP) ; Désactivé enregistre sans copier.

Traitez captureId et pinId comme des identités, pas des libellés à réécrire. Visual Context encode actuellement schemaVersion 1 ; parseVisualCapture rejette un captureId manquant et tout schemaVersion autre que 1 ou l’héritage 0. Suivez seulement ce que les pins décrivent. Si la personne n’a jamais collé, demandez-lui de copier à nouveau depuis Pinar plutôt que de reconstruire les pins de mémoire.

• Collez tout le presse-papiers dans l’agent ; ne retapez pas les commentaires et n’inventez pas un nouveau captureId.
• Confirmez que le texte collé contient encore une clôture pinar-visual-context fermée avant de commencer à modifier le code.
• Si rien n’a été collé, demandez Command+Enter / Alt+Enter dans Pinar et suivez seulement les notes des pins.

Pinar expose aussi ses sessions stockées via le Model Context Protocol. Un client MCP peut lister projets, collections, lots, sessions, pins et commentaires de pins, et peut les créer, les commenter, les renommer, les déplacer, les réorganiser et les supprimer.

Le service Pinar local expose MCP sur votre propre machine, sans compte, connexion ni clé API. Pinar Cloud exige une clé API avec l’autorisation nécessaire, et le périmètre de ressources de la clé borne ce que l’agent peut lire, commenter ou modifier.

Pour la configuration du client, y compris le point d’accès, l’en-tête d’authentification et les détails du protocole, consultez le guide d’accès des agents dans le dépôt Pinar.

• Une session créée par un agent stocke les métadonnées de la page sans capture, et un pin d’agent stocke le commentaire avec un localisateur facultatif au lieu d’une géométrie mesurée.
• MCP ne réhydrate ni ne synchronise le brouillon du navigateur ; l’extension reste l’autrice du brouillon actif, et un enregistrement explicite ultérieur remplace la session stockée sous le même identifiant.
• Le partage reste explicite : publiez un partage depuis le workspace, ou laissez un agent doté de l’autorisation de partage le publier ou le révoquer.