Referencia de IDE Artifacts
Configure registros digest-first de archivos, comandos, lecturas y respuestas de agentes en equipos de desarrollo.
La página Artifacts registra efectos de actividad de agentes en equipos de desarrollo. Muestra qué escribió, leyó y ejecutó un agente, sin convertir el gateway en un almacén de contenido sin límites.
Activar el registro#
Abra AI Firewall -> Agent Config -> Integrations -> IDE Artifacts.
| Ajuste | Predeterminado | Significado |
|---|---|---|
| Record Artifacts (aifw_artifacts_enabled) | Off | Activa filas de artefactos para efectos de agentes. |
| Kinds (aifw_artifacts_kinds) | Todos si no se selecciona ninguno | Escrituras, eliminaciones, lecturas, comandos o respuestas. |
| Content (aifw_artifacts_content) | digest | Solo metadatos y digest. store también conserva contenido limitado donde la política lo permite. |
| Content cap | 4096 caracteres | Límite del contenido guardado. La salida de comandos nunca se almacena. |
| Raw retention | 30 días | Las filas sin procesar se eliminan tras la retención; contadores diarios conservan tendencias. |
El registro está apagado de forma predeterminada. Cuando se desactiva, Artifacts indica explícitamente que no escribe datos.
Usar la página Artifacts#
Abra Artifacts en la navegación de AI Firewall. Puede filtrar por:
| Filtro | Valores o uso |
|---|---|
| Kind | file_write, file_delete, read, command_output o response. |
| Source | cursor o cursor-tab. |
| Agent | Etiqueta o identidad del agente. |
| Session | Conversation ID para rastrear una sesión. |
| Path | Ruta o texto del comando. |
Cada fila incluye hora, tipo, origen, ruta/comando, digest, tamaño, decisión, veredicto, agente, sesión y estado del contenido. Expanda para más detalles.
Sesiones y tendencias#
Conversation ID agrupa efectos de una sesión. La vista muestra efectos registrados, llamadas y rechazos de herramientas, archivos afectados, duración, agentes, skills y rutas.
Los contadores diarios resumen cantidades, elementos marcados/denegados y bytes por tipo y área de ruta. Las filas sin procesar siguen la retención configurada.
Privacidad y exportación#
Artifacts prioriza digests. Rutas, SHA-256, tamaños, decisiones y veredictos permanecen disponibles aunque se desactive el contenido. El contenido guardado está sujeto a límite, retención, reglas no-log y política de datos sensibles.
La salida de comandos nunca se guarda como contenido porque puede incluir secretos. Exportaciones y registros syslog contienen metadatos y digests, no contenido bruto.
Documentación relacionada#
- Cursor Agent Hooks
- Gobernanza de Skills and Tools
- Registros de auditoría y exportación
- Administración de Compliance