Auditoria de agentes

O que permite fazer?

• Ver, por agente, cada ferramenta que chamou, se correu bem, falhou ou foi rejeitada, se modificava dados, sobre que ids e quanto demorou.
• Ver as operações longas em curso de um agente e um resumo das últimas 24 horas.
• Saber se um agente está trabalhando agora mesmo (atividade nos últimos 2 minutos).
• Ler o histórico de comandos de shell de um VPS: quem os correu e que humano autorizou o agente.
• Encontrar no registro de atividade do VPS e do projeto o que fez um agente, em seu nome e no do seu humano.

Quando convém usar?

• Rever o que um agente fez enquanto ninguém o via.
• Entender porque é que um agente diz que não conseguiu fazer algo (as rejeições ficam registradas com o motivo).
• Detetar um agente esquecido que continua a renovar a sessão sem trabalhar.

Como funciona na ArduMaker?

Registro de chamadas

Cada chamada a uma ferramenta (salvo ping, que não tem autenticação) é escrita uma vez, ao terminar, com tudo o que se sabe dela. A auditoria envolve as outras proteções: uma rejeição por só leitura ou pelo limite de chamadas também fica escrita.

Comandos em um VPS

• Cada ejecutar_comando_vps deixa uma linha genérica no registro de atividade do VPS (“Shell command executed”) e o detalhe no histórico de comandos.
• O histórico guarda o comando (com os segredos etiquetados, como password= ou PGPASSWORD=, tapados), o diretório, o código de saída, a duração, o início da saída, quem o correu e, se foi um agente, que humano o autorizou. Também os comandos que uma proteção rejeitou.
• Conserva-se 30 dias, de propósito: o tapado não reconhece uma credencial solta sem etiqueta, por isso encurta-se o tempo em que poderia ficar guardada.

Em nome de quem

Um agente age com um usuário próprio ligado à pessoa que o autorizou. No registro de atividade do VPS e do projeto, as suas ações aparecem em nome do agente com o seu humano ao lado. As ferramentas dedicadas deixam o detalhe que importa: apagar um usuário Linux anota o nome apagado, e revelar uma credencial de uma app fica auditado sem o valor.

O que muda realmente?

Consultar a atividade não escreve nada novo: lê o que já foi registrado.

Esquema

Resultado esperado

• Em /me, a atividade de um agente devolve llamadas (30 por página, até 100, paginadas para trás), e na primeira página operaciones, resumen_24h (total, ok, error, rechazo, escrituras), trabajando, esta_activa e ultima_actividad.
• Cada link mostra refresh_count e ultima_actividad: um número alto de renovações com atividade antiga denuncia um agente esquecido.
• reuse_detected_at com data indica que se reutilizou um refresh token já trocado; a sessão já foi revogada sozinha.

Erros e resolução

• Uma chamada muito curta não aparece enquanto corre (dura milissegundos); o que demora de verdade aparece em operaciones.
• O estado de uma operação na lista é o último conhecido: para o atual, ver_operacion.
• Chamadas registradas antes de o campo existir têm modifica_datos: null: não se sabe, não significa “leitura”.
• Ver a atividade de uma link alheia responde 404, não 403.

Relação com MCP

A atividade dos agentes vê-se em /me; não há uma ferramenta MCP para ler o registro de chamadas. A partir de um agente podem ler-se:

• ver_historial_comandos_vps: comandos de um VPS (leitura, até 200 por página; serve para não repetir algo já tentado).
• ver_logs_proyecto: histórico de atividade de um projeto (leitura).
• ver_operacion: o estado e o resultado de uma operação longa.

Referência em /mcp/docs.

Funcionalidades relacionadas

• Servidor MCP
• Permissões do agente MCP
• Monitoramento
• Usuários Linux
• Auditoria de ações