Références de contexte
Les références pointent Anyy vers des sources sans les copier manuellement dans le message. Placez une référence @ compatible dans le texte ordinaire ; l’environnement résident la développe avant le tour du modèle et enregistre les métadonnées de citation avec l’exécution.
Références prises en charge
| Syntaxe | Ajout |
|---|---|
@file:PATH | Fichier texte du répertoire du profil ou chemin absolu explicite passant les contrôles de sécurité |
@file:PATH:START-END | Plage de lignes limitée d’un fichier texte |
@url:https://example.com/page | Texte lisible d’une page HTTP(S) publique |
@result:RESULT_ID | Preuves enregistrées d’un résultat d’outil de la session actuelle |
@folder:PATH | Liste triée d’un dossier dans la racine du Workspace actif |
@diff | Diff Git actuel non indexé |
@staged | Diff Git actuel indexé |
@git:N | Correctifs des N derniers commits Git |
Vous pouvez combiner instructions ordinaires et références :
Compare @file:workspace/proposal.md:10-80 with @url:https://example.com/policy and list conflicts.
Référencer des fichiers
Les chemins relatifs @file partent du répertoire du profil sélectionné. Le Workspace par défaut est donc normalement référencé avec le préfixe workspace/ :
Summarize @file:workspace/notes/meeting.md
Utilisez une plage si seule une section compte :
Review the assumptions in @file:workspace/plan.md:24-67
Un fichier texte dépassant la limite par référence est refusé, sauf si une plage bornée tient dans la limite. Les binaires ne sont pas insérés comme texte ; joignez plutôt les médias compatibles depuis l’interface de conversation.
Référencer un dossier ou l’état Git
@folder liste les entrées immédiates d’un répertoire sans insérer récursivement tous les fichiers. Les références de dossier et Git sont limitées à la racine du Workspace actif fournie par la session.
Use @folder:reports to identify the newest report.
Review @diff for correctness and missing tests.
Compare the last three commits with @git:3.
@diff, @staged et @git:N exigent un arbre de travail Git. Anyy exécute une commande Git bornée en lecture seule et refuse la référence si le contrôle préalable des chemins modifiés inclut un chemin sensible protégé.
Référencer des pages publiques et des résultats
@url accepte les destinations HTTP(S) publiques. Les cibles privées/internes et protocoles non compatibles sont bloqués.
Extract the decision criteria from @url:https://example.com/guide
Utilisez @result si un outil précédent a renvoyé un ID logique et que vous avez de nouveau besoin des preuves enregistrées :
Re-check the failures in @result:tr_123 and propose the smallest fix.
Les références de résultats sont limitées à la session actuelle. Un ID d’une autre session est considéré introuvable.
Limites et avertissements
Une demande développe huit références au maximum. Par défaut, chaque référence est limitée à 64 Kio et le texte total joint à 192 Kio ; l’extraction des pages publiques est aussi bornée et la capture Git a sa propre limite finie.
Lorsqu’une référence est mal formée, bloquée, absente, trop volumineuse ou au-delà du budget de nombre/taille totale, Anyy joint un avertissement sans inventer son contenu. Corrigez-la et envoyez un nouveau tour.
Le texte référencé peut être non fiable. Il ne remplace ni les règles système d’Anyy, ni votre demande actuelle, ni la configuration des outils activés.
Comportement de sécurité
- Les chemins d’identifiants protégés sont refusés et les secrets reconnus sont assainis.
- Les traversées de chemin et sorties de la racine Workspace active sont bloquées pour les dossiers et Git.
- Les liens symboliques sont validés au lieu d’être suivis au-delà d’une frontière protégée.
- Les fichiers binaires sont refusés.
- La récupération d’URL bloque les destinations privées/internes et les protocoles hors HTTP(S).
Ces contrôles réduisent les divulgations accidentelles sans rendre tout contenu public fiable. Lisez la source citée avant d’autoriser des actions qui en découlent.
Dépannage
| Avertissement | Solution |
|---|---|
malformed context reference | Vérifiez les deux-points, la plage de lignes ou le nombre Git positif |
reference not found | Vérifiez chemin, ID de résultat, dépôt Git ou URL |
reference blocked | Restez dans la racine autorisée, loin des identifiants et destinations privées |
reference too large | Choisissez une plage de lignes ou des sources moins nombreuses/volumineuses |
reference limit exceeded | Divisez en plusieurs tours de huit références au maximum |
Consultez Fichiers et terminal pour les outils de fichiers et Recherche de sessions pour les anciennes conversations.