Skip to main content

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
Cada evento carrega um timestamp, ID de sessão, ID do agente, tipo de evento e ambiente. Os campos específicos do evento contêm dados de modelo, ferramenta, correlação, resultado, conteúdo, duração ou erro.

Inspecionar um contrato de evento

  1. Abra Observe → Events.
  2. Defina um intervalo de tempo curto e filtre por ambiente, agente e tipo de evento.
  3. Selecione um evento para inspecionar seus campos normalizados e payload bruto, depois abra a sessão correspondente 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 correlation ID.
Use o fluxo de Events para restringir os dados a uma execução de agente e inspecionar os campos de evento normalizados.O fluxo de Events ao vivo com filtros por ambiente, agente, sessão e tipo de evento.Em seguida, acesse a sessão a partir do evento. O trace mostra o que aconteceu imediatamente antes e depois dele, o que é essencial quando o payload por si só é ambíguo.O trace de sessão vinculado, usado para inspecionar o evento no contexto de execução.Compare correlation IDs e timestamps em ambas as visualizações quando um evento pareado ou duração estiver ausente.

Campos reservados do SDK

Não utilize timestamp, session_id, agent_id, type ou environment como campos personalizados do SDK Python. Durações de eventos pareados, como a duração do resultado de ferramenta, são calculadas pelo SDK e não podem ser fornecidas manualmente.

Limites locais

  • O estado do Failproof AI fica em ~/.failproofai, a menos que configurado explicitamente de outra forma.
  • failproofai-sdk sempre armazena em spool em ~/.failproofai/custom-agents. FAILPROOFAI_HOME reposiciona esse diretório home; o segmento custom-agents é sempre adicionado, de modo que o spool não pode ser colocado fora dele. Apenas o próprio configure(base_dir=...) do SDK grava em outro lugar. AGENTEYE_HOME é lido pelo agenteye-collector mais antigo para determinar o que monitorar, e não afeta mais onde o SDK grava.
  • Os rótulos de ambiente podem ser definidos por meio da configuração do SDK ou com AGENTEYE_ENVIRONMENT.
  • As credenciais do daemon são armazenadas separadamente das configurações não secretas.
Use nomes de ambiente estáveis e de baixa cardinalidade. Vírgulas não são suportadas nos rótulos de ambiente do daemon.

Alterar um rótulo de ambiente

Os rótulos de ambiente são atribuídos pelo SDK emissor ou pelo daemon Failproof. Após alterar um, abra Observe → Sessions e use o filtro de ambiente para confirmar que as novas sessões carregam o novo valor. As sessões existentes mantêm seu ambiente original.