O que custodian faz?
Custodian: monitor de operações autônomo — detecta, classifica e repara falhas em plataformas de agentes durante horários de baixa atividade.
Visão Geral
Custodian é uma skill projetada para executar monitoramento autônomo e manutenção corretiva em plataformas de agentes de IA durante períodos de silêncio (quiet hours). Seu objetivo é minimizar o tempo de inatividade e reduzir a carga operacional sobre engenheiros, identificando e resolvendo problemas comuns antes que impactem os usuários.
Funcionalidades
- Detecção automática de falhas: Varre logs e métricas em busca de anomalias.
- Classificação de incidentes: Categoriza falhas por severidade (crítica, alta, média, baixa).
- Reparo autônomo: Executa ações corretivas predefinidas (ex.: reinicialização de serviços, limpeza de cache).
- Relatórios pós-execução: Gera um resumo do que foi detectado e reparado durante a execução.
Como Funciona
- A skill é ativada durante um período configurado (ex.: janela noturna).
- Conecta-se às APIs de monitoramento da plataforma alvo (logs, métricas, alertas).
- Analisa os dados em busca de padrões de falha conhecidos.
- Para cada falha detectada:
- Classifica a severidade.
- Tenta aplicar um reparo automático da biblioteca de ações.
- Registra sucesso ou falha.
- Ao final, produz um relatório consolidado.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
- (Outras plataformas de agentes via API customizada)
Configuração
Variáveis de ambiente necessárias:
CUSTODIAN_LOG_SOURCE=<caminho ou endpoint dos logs>
CUSTODIAN_ACTION_DIR=<diretório com scripts de reparo>
CUSTODIAN_SILENT_HOURS_START=00:00
CUSTODIAN_SILENT_HOURS_END=06:00
Exemplo de Uso
# Executar Custodian manualmente para um ciclo de verificação
custodian run
# Visualizar relatório da última execução
custodian report
Mais Informações
Consulte a documentação oficial para exemplos avançados e guia de extensão de ações de reparo.