Referência de IDE Artifacts
Configure registros digest-first de arquivos, comandos, leituras e respostas de agentes nos computadores de desenvolvimento.
A página Artifacts registra efeitos da atividade dos agentes nos computadores de desenvolvimento: o que escreveram, leram e executaram, sem transformar o gateway em um armazenamento irrestrito de conteúdo.
Habilitar registro#
Abra AI Firewall -> Agent Config -> Integrations -> IDE Artifacts.
| Configuração | Padrão | Significado |
|---|---|---|
| Record Artifacts (aifw_artifacts_enabled) | Off | Habilita linhas de artefatos para efeitos dos agentes. |
| Kinds (aifw_artifacts_kinds) | Todos se nada selecionado | Escritas, exclusões, leituras, comandos ou respostas. |
| Content (aifw_artifacts_content) | digest | Somente metadados e digest. store também retém conteúdo limitado quando a política permite. |
| Content cap | 4096 caracteres | Limite do conteúdo salvo. Saída de comandos nunca é armazenada. |
| Raw retention | 30 dias | Remove linhas brutas após o prazo; contadores diários preservam tendências. |
O registro começa desativado. Quando desligado, Artifacts informa claramente que nada está sendo gravado.
Usar Artifacts#
Abra Artifacts na navegação do AI Firewall. Filtros:
| Filtro | Valores ou finalidade |
|---|---|
| Kind | file_write, file_delete, read, command_output ou response. |
| Source | cursor ou cursor-tab. |
| Agent | Rótulo ou identidade do agente. |
| Session | Conversation ID para rastrear sessão. |
| Path | Filtro de caminho ou texto de comando. |
Cada linha inclui hora, tipo, origem, caminho/comando, digest, tamanho, decisão, veredito, agente, sessão e estado do conteúdo. Expanda para detalhes.
Sessões e tendências#
Conversation ID agrupa efeitos de uma sessão: efeitos registrados, chamadas/negações de ferramentas, arquivos tocados, duração, agentes, skills e caminhos.
Contadores diários mostram totais, itens sinalizados/negados e bytes por tipo e área de caminho. Linhas brutas seguem retenção; contadores mantêm tendências.
Privacidade e exportação#
Artifacts prioriza digests. Caminhos, SHA-256, tamanhos, decisões e vereditos continuam disponíveis sem conteúdo. Conteúdo salvo obedece limite, retenção, regras no-log e política de dados sensíveis.
Saída de comandos nunca é guardada como conteúdo porque pode conter segredos. Exportações e syslog incluem metadados e digests, não conteúdo bruto.
Documentação relacionada#
- Cursor Agent Hooks
- Governança de Skills and Tools
- Logs de auditoria e exportação
- Administração do módulo Compliance