Receitas de CLI para agentes

export AGENTEYE_DASHBOARD_URL=https://agenteye.example.com   # para não repetir --base-url
agenteye login --email you@example.com                       # cole o código enviado por e-mail; válido por ~24h

if [ "$(agenteye --json whoami | jq -r .logged_in)" != "true" ]; then
  echo "Não autenticado. Execute: agenteye login" >&2; exit 1
fi

# sessões nas últimas 24h cujas avaliações retornaram erro
agenteye --json sessions --since 24h --status error | jq -r '.sessions[].session_id'

# avaliações com pontuação <= 0.5 em helpfulness, para um agente específico
agenteye --json evals --agent-id checkout-bot --score helpfulness:..0.5 \
  | jq '.evaluations[] | {session_id, scores}'

# a avaliação mais recente da sessão (status + pontuações)
agenteye --json evals --session-id run-001 | jq '.evaluations[0] | {status, scores}'

# todos os eventos da execução (aumente --limit para uma varredura completa)
agenteye --json events --session-id run-001 --all --limit 1000 | jq '.events[] | {ts, event_type}'

# apenas as chamadas de ferramenta em uma sessão (--full é obrigatório para obter o payload bruto)
agenteye --json events --full --session-id run-001 --event-type tool_use,tool_result --all \
  | jq '.events[].payload'

# de uma vez: busca até 500 linhas em páginas de 200
agenteye --json events --session-id run-001 --limit 500 --all > events.json

# paginação manual: repasse o next_cursor
page=$(agenteye --json events --limit 100)
cursor=$(echo "$page" | jq -r '.next_cursor // empty')
[ -n "$cursor" ] && agenteye --json events --limit 100 --cursor "$cursor"

agenteye --json sessions --since 7d --fields session_id,status,scores | jq -c '.sessions[]'
agenteye --json events --session-id run-001 --fields ts,event_type --all

agenteye --json list envs | jq -r '.values[]'           # valores para --env
agenteye --json list tools | jq -r '.values[]'          # nomes de ferramentas; também agents, models, event_types, …
agenteye --json list score_filters | jq -r '.values[]'  # KEY válida para --score KEY:MIN..MAX

agenteye login --org acme --email you@corp.com   # define o tenant na mesma etapa do login
agenteye --json orgs list | jq -r '.orgs[].org_slug'
agenteye --org globex --json sessions --since 24h   # sobrescreve para um único comando

# o segredo é exibido UMA ÚNICA VEZ; com --json, ele fica no campo .key
key=$(agenteye --json keys create ci-bot --add events:read.add | jq -r '.key')
agenteye keys regenerate ci-bot --yes    # rotacionar; agenteye keys disable ci-bot --yes para revogar

agenteye --json query run --sql "select count(*) from analytics.events" | jq '.rows'
agenteye --json query run errs --arg prod | jq '.rows'   # uma consulta salva + um argumento posicional $1

id=$(agenteye --json incidents list --state firing | jq -r '.incidents[0].id')
agenteye incidents ack "$id"
agenteye incidents assign "$id" --assignee you@corp.com
agenteye incidents resolve "$id" --yes

out=$(agenteye --json sessions --since 1h) || code=$?
case "${code:-0}" in
  0) echo "$out" | jq '.sessions | length' ;;
  4) echo "Sessão expirada - execute 'agenteye login'." >&2 ;;
  5) echo "Permissão ausente (peça ao administrador a permissão evaluations:read)." >&2 ;;
  3) echo "Dashboard inacessível - verifique a URL." >&2 ;;
  *) echo "Erro inesperado (saída ${code})." >&2 ;;
esac