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.

L’application Pinar locale offre la même surface Model Context Protocol aux agents qui s’exécutent sur le même ordinateur, et elle est ouverte par conception : aucun compte, connexion ni clé API n’est en cause. Pointez le client MCP de votre agent vers le point d’accès décrit dans la section d’accès des agents aux sessions du README Pinar.

La section des outils MCP locaux du README liste chaque outil avec ses arguments et sa valeur de retour. Les outils de liste paginent leurs résultats, jusqu’à 50 éléments par page, afin qu’un agent parcoure un grand workspace une page à la fois. Les outils de réorganisation attendent la liste complète des éléments et rejettent une liste partielle avant que quoi que ce soit ne bouge.

• Parce que la connexion est locale, l’agent ne travaille qu’avec les captures stockées sur cet ordinateur et n’a jamais besoin de Pinar Cloud.
• La plus grande partie de la surface d’outils cloud est disponible localement ; les extras réservés au cloud concernent les clés d’agents et la publication de partages.

Pinar Cloud permet aux comptes Pro d’émettre des clés d’agent dédiées. Ouvrez Paramètres → « Accès des agents » dans le workspace pour en créer une : donnez un nom à la clé, choisissez une autorisation — « Lecture », « Gestion », « Partage » ou « Complète » — et une expiration de 7, 30 ou 90 jours. Une clé « Lecture » peut se limiter à tout le compte ou à un projet, collection, session ou lot. Les autres autorisations agissent sur tout le compte.

La clé n’est affichée qu’une seule fois, juste après sa création, alors copiez-la avant que la boîte de dialogue ne se ferme — Pinar ne conserve qu’un court préfixe et ne peut pas afficher la clé à nouveau. Jusqu’à 20 clés actives peuvent exister à la fois. Chaque clé listée affiche son périmètre, son autorisation, son expiration et son dernier usage, et « Révoquer » la met fin immédiatement. Une demande d’une ressource hors du périmètre de la clé est répondue comme si la ressource n’existait pas, de sorte qu’une clé ne révèle jamais ce qui se trouve au-delà de son périmètre. Le guide d’accès des agents cloud documente la matrice d’autorisations et la surface complète d’outils derrière chaque clé.

• Donnez à chaque agent ou automatisation sa propre clé, afin que révoquer l’une ne dérange pas les autres.
• Les clés fonctionnent avec les clients MCP qui gèrent des en-têtes personnalisés et avec les liens Markdown privés ; le panneau « Accès des agents » explique comment la clé est utilisée.