Eventos e configuração

​

Famílias de eventos

• Início, fim, pausa e retomada do agente
• Requisição e resposta do modelo
• Uso de ferramenta e resultado
• Hook acionado e concluído
• Espera humana, entrada, pausa e interrupção
• Erros explícitos

​

Inspecionar um contrato de evento

• Dashboard
• CLI

1. Abra Observe → Events.
2. Defina uma janela de tempo curta e filtre por ambiente, agente e tipo de evento.
3. Selecione um evento para inspecionar seus campos normalizados e o payload bruto, depois abra sua sessão para ver o contexto de execução.
4. Se uma duração pareada estiver ausente, verifique se os eventos de início e conclusão usam o mesmo ID de correlação.

Use o stream de Events para restringir os dados a uma execução de agente e inspecionar os campos de evento normalizados.Em seguida, siga o evento até sua sessão. O trace mostra o que aconteceu imediatamente antes e depois dele, o que é necessário quando o payload por si só é ambíguo.Compare os IDs de correlação e timestamps nas duas visualizações quando um evento pareado ou duração estiver ausente.

Descubra valores de filtro válidos e depois busque payloads completos de eventos para uma sessão:

fp list event_types
fp list envs
fp events --since 1h \
  --env production \
  --event-type tool_use,tool_result \
  --session-id <session-id> \
  --full

Use fp --json events ... --fields ts,event_type,session_id,payload para inspeção legível por máquina.

​

Campos reservados do SDK

​

Limites locais

• O estado do Failproof AI fica em ~/.failproofai, salvo configuração explícita em contrário.
• O failproofai-sdk sempre cria o spool em ~/.failproofai/custom-agents. A variável FAILPROOFAI_HOME realoca esse diretório home; o segmento custom-agents é sempre acrescentado, portanto o spool não pode ser colocado fora dele. Apenas o próprio configure(base_dir=...) do SDK grava em outro local. A variável AGENTEYE_HOME é lida pelo agenteye-collector mais antigo para escolher o que monitorar, e não afeta mais onde o SDK escreve.
• Os rótulos de ambiente podem ser definidos por meio da configuração do SDK ou via AGENTEYE_ENVIRONMENT.
• As credenciais do daemon são armazenadas separadamente das configurações não secretas.

​

Alterar um rótulo de ambiente

export AGENTEYE_ENVIRONMENT=production-us-east
failproofai config
failproofai config --status
fp sessions --since 1h --env production-us-east