Référence IDE Artifacts
Configurer des enregistrements digest-first de fichiers, commandes, lectures et réponses d’agents sur les postes développeurs.
La page Artifacts consigne les effets des agents sur les postes développeurs : ce qu’ils écrivent, lisent et exécutent, sans transformer la passerelle en stockage illimité de contenu.
Activer l’enregistrement#
Ouvrez AI Firewall -> Agent Config -> Integrations -> IDE Artifacts.
| Paramètre | Défaut | Signification |
|---|---|---|
| Record Artifacts (aifw_artifacts_enabled) | Off | Enregistre les effets des agents. |
| Kinds (aifw_artifacts_kinds) | Tous si rien n’est sélectionné | Écritures, suppressions, lectures, commandes ou réponses. |
| Content (aifw_artifacts_content) | digest | Métadonnées et digest uniquement. store conserve aussi un contenu plafonné si la politique l’autorise. |
| Content cap | 4096 caractères | Limite de contenu ; sortie de commande jamais stockée. |
| Raw retention | 30 jours | Purge les lignes brutes ; compteurs quotidiens gardent les tendances. |
Désactivé par défaut. Si la fonction est coupée, Artifacts indique qu’aucune donnée n’est écrite.
Utiliser Artifacts#
Ouvrez Artifacts dans la navigation AI Firewall. Filtres :
| Filtre | Valeurs ou usage |
|---|---|
| Kind | file_write, file_delete, read, command_output ou response. |
| Source | cursor ou cursor-tab. |
| Agent | Label ou identité. |
| Session | Conversation ID. |
| Path | Filtre de chemin ou commande. |
Chaque ligne affiche heure, type, source, chemin/commande, digest, taille, décision, verdict, agent, session et état du contenu. Développez la ligne pour les détails.
Sessions et tendances#
Conversation ID regroupe les effets d’une session : effets, appels/refus d’outils, fichiers touchés, durée, agents, skills et chemins.
Les compteurs quotidiens montrent nombres, éléments signalés/refusés et octets par type et zone de chemin. Les lignes brutes suivent la rétention ; les compteurs conservent les tendances.
Confidentialité et export#
Artifacts privilégie les digests. Chemins, SHA-256, tailles, décisions et verdicts restent disponibles sans contenu stocké. Le contenu conservé respecte plafond, rétention, règles no-log et politique de données sensibles.
La sortie des commandes n’est jamais stockée comme contenu car elle peut contenir des secrets. Exports et syslog ne contiennent que métadonnées et digests.
Documentation associée#
- Cursor Agent Hooks
- Gouvernance Skills and Tools
- Journaux d’audit et export
- Administration du module Compliance