에이전트를 위한 CLI 레시피

export AGENTEYE_DASHBOARD_URL=https://agenteye.example.com   # --base-url을 반복 입력하지 않아도 됩니다
agenteye login --email you@example.com                       # 이메일로 받은 코드를 붙여넣기; 약 24시간 유효

if [ "$(agenteye --json whoami | jq -r .logged_in)" != "true" ]; then
  echo "Not authenticated. Run: agenteye login" >&2; exit 1
fi

# 최근 24시간 내에 평가 오류가 발생한 세션
agenteye --json sessions --since 24h --status error | jq -r '.sessions[].session_id'

# 특정 에이전트에서 helpfulness 점수가 0.5 이하인 평가
agenteye --json evals --agent-id checkout-bot --score helpfulness:..0.5 \
  | jq '.evaluations[] | {session_id, scores}'

# 세션의 최신 평가 (상태 + 점수)
agenteye --json evals --session-id run-001 | jq '.evaluations[0] | {status, scores}'

# 실행의 모든 이벤트 (전체 조회를 위해 --limit 값을 높이세요)
agenteye --json events --session-id run-001 --all --limit 1000 | jq '.events[] | {ts, event_type}'

# 세션의 도구 호출만 조회 (raw 페이로드를 얻으려면 --full이 필요합니다)
agenteye --json events --full --session-id run-001 --event-type tool_use,tool_result --all \
  | jq '.events[].payload'

# 한 번에: 200행씩 페이지를 나눠 최대 500행을 가져옵니다
agenteye --json events --session-id run-001 --limit 500 --all > events.json

# 수동 페이징: 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[]'           # --env에 사용할 값
agenteye --json list tools | jq -r '.values[]'          # 도구 이름; agents, models, event_types 등도 사용 가능
agenteye --json list score_filters | jq -r '.values[]'  # --score KEY:MIN..MAX의 유효한 KEY

agenteye login --org acme --email you@corp.com   # 로그인과 동시에 테넌트 설정
agenteye --json orgs list | jq -r '.orgs[].org_slug'
agenteye --org globex --json sessions --since 24h   # 단일 명령어에서 재정의

# 시크릿은 한 번만 출력됩니다. --json 사용 시 .key 필드에 있습니다
key=$(agenteye --json keys create ci-bot --add events:read.add | jq -r '.key')
agenteye keys regenerate ci-bot --yes    # 교체; 폐기하려면 agenteye keys disable ci-bot --yes

agenteye --json query run --sql "select count(*) from analytics.events" | jq '.rows'
agenteye --json query run errs --arg prod | jq '.rows'   # 저장된 쿼리 + 위치 인수 $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 "Session expired - run 'agenteye login'." >&2 ;;
  5) echo "Missing permission (ask an admin for evaluations:read)." >&2 ;;
  3) echo "Dashboard unreachable - check the URL." >&2 ;;
  *) echo "Unexpected error (exit ${code})." >&2 ;;
esac