CLI

pipx install agenteye
agenteye --base-url https://agenteye.example.com login --email you@example.com   # 이메일로 6자리 코드 발송
agenteye whoami                                                                  # 현재 사용자 + 활성 조직 확인
agenteye --json sessions --since 24h                                             # 에이전트 실행 기록, 최근 24시간

{
  "sessions": [
    {
      "session_id": "run-8f2a",
      "agent_id": "checkout-bot",
      "environment": "prod",
      "status": "error",
      "scores": { "helpfulness": 0.42, "tool_efficiency": 0.55 },
      "event_count": 37,
      "started_at": "2026-07-16T09:14:02Z",
      "last_event_at": "2026-07-16T09:14:48Z"
    }
  ],
  "next_cursor": null
}

pipx install agenteye
# 또는
uv tool install agenteye

agenteye --version
agenteye --help

agenteye login --email you@example.com
# 이메일로 6자리 코드가 전송됩니다; 프롬프트에 붙여 넣으세요.

agenteye whoami     # 현재 사용자, 활성 조직, 권한 표시
agenteye logout     # 세션을 취소하고 저장된 토큰 삭제

agenteye login --org acme           # 인증과 활성 테넌트 설정을 한 번에
agenteye orgs list                  # 접근 가능한 조직 목록 (활성 조직 표시됨)
agenteye orgs switch globex         # 저장된 기본 조직 변경
agenteye --org globex sessions      # 단일 커맨드에서 조직 재정의

export AGENTEYE_DASHBOARD_URL=https://agenteye.example.com

agenteye --base-url https://agenteye.internal --insecure login

agenteye login --email you@example.com [--org acme]   # 이메일 일회용 코드; 세션 저장
agenteye logout                                       # 이 기기의 저장된 세션 삭제
agenteye whoami                                       # 현재 사용자, 활성 조직, 권한
agenteye version                                      # CLI 버전 출력 (--version과 동일)
agenteye help                                         # 최상위 도움말 (--help와 동일)

agenteye orgs list        # 내 조직 + 각 역할 (활성 조직 표시됨)
agenteye orgs switch acme # 저장된 활성 조직 변경 (슬러그 생략 시 TTY에서 목록 선택)
agenteye orgs current     # 활성 조직의 정보
agenteye orgs perms       # 활성 조직에서의 권한 (리소스별 그룹화)

# events (별칭: 단계별 원시 추적 데이터), 최신순
agenteye --json events --session-id run-001 --event-type tool_use,tool_result --all --limit 1000
agenteye --json events --since 1h --search timeout --all | jq '.events[].payload'

# sessions: 에이전트 실행 기록 한 줄씩 (시간/환경/에이전트/세션/상태; 점수 필터링 없음)
agenteye --json sessions --since 24h --status error
agenteye --json sessions --agent-id checkout-bot --env prod --all --limit 1000

# evals: 평가 결과 + 점수; --score는 메트릭 필터, --aggregate는 집계
agenteye --json evals --score helpfulness:0.5..0.8 --score tool_efficiency:..0.3
agenteye --json evals --aggregate --since 7d --env prod        # 상태 분포 + 키별 점수 통계

# errors: 오류 이벤트만; --aggregate로 카운트/세션/에이전트/마지막 발생 시간 확인
agenteye --json errors --since 24h --aggregate
agenteye --json errors --since 24h --error-type timeout --all --limit 1000

# list: 필터링 전에 유효한 필터값 탐색
agenteye list envs        # 또한: agents event_types score_filters models hooks tools error_types

agenteye --json events --session-id run-001 --all --limit 1000 | jq '.events[] | {ts, event_type}'
agenteye --json evals  --session-id run-001                       # 해당 세션의 점수 + 상태

agenteye keys list                                   # 활성 키 먼저, 그 다음 취소된 키
agenteye keys show ci-bot
agenteye keys create ci-bot --add events:read.add    # 필요한 범위만 지정; 시크릿은 한 번만 출력
agenteye keys create ops --permission-set standard --remove queries:run   # 프리셋으로 시작 후 조정
agenteye keys update ci-bot --add evaluations:read --yes
agenteye keys regenerate ci-bot --yes                # 시크릿 교체 (이전 시크릿은 즉시 무효화)
agenteye keys disable ci-bot --yes                   # 취소

agenteye users list [--active-only]
agenteye users show dev@corp.com
agenteye users create dev@corp.com --permission-set standard
agenteye users update dev@corp.com --add alerts:write --remove queries:delete   # 예측 + 확인
agenteye users disable dev@corp.com --yes            # 보호된 계정/본인 계정 보호 기능 있음
agenteye users enable dev@corp.com

agenteye settings list                               # 키 · 값 · 타입 · 업데이트 시간 (시크릿 마스킹)
agenteye settings schema                             # 각 키가 허용하는 값 (타입 · 범위 · 설명)
agenteye settings set session_ttl_secs --value 86400 --yes

agenteye alerts list
agenteye alerts show high-errors
agenteye alerts create high-errors --file alert.json          # NAME은 필수 (위치 인수)
agenteye alerts update high-errors --severity critical --yes
agenteye alerts test high-errors --yes                        # 테스트 알림 발송
agenteye alerts delete high-errors --yes

agenteye incidents list --state firing                # 또한: acknowledged, resolved
agenteye incidents count
agenteye incidents show <id>
agenteye incidents ack <id>
agenteye incidents assign <id> you@corp.com           # 담당자는 운영자여야 함
agenteye incidents resolve <id> --yes
agenteye incidents open --alert-id <id> --severity critical    # 알림에 대해 수동으로 생성
agenteye incidents comment-add <id> "root cause: upstream 5xx"
agenteye incidents comment-list <id> ; agenteye incidents comment-delete <id> <comment-id>
agenteye incidents subscribe <id> ; agenteye incidents unsubscribe <id> ; agenteye incidents subscribers <id>

agenteye query schema [TABLE]                         # 분석 뷰의 컬럼 레이아웃
agenteye query run --sql "select count(*) from analytics.events"
agenteye query run errs --arg prod --limit 100        # 저장된 쿼리 실행 + 위치 인수 $1
agenteye query list ; agenteye query show errs
agenteye query create errs --sql @errs.sql --description "errored events (24h)"
agenteye query update errs --sql @errs.sql --yes ; agenteye query delete errs --yes

agenteye agent health                                 # AI 어시스턴트 설정/접근 가능 여부 확인
agenteye agent models                                 # --model에 전달할 수 있는 모델 목록 (기본값 표시)
agenteye agent ask "which agents errored most in the last day?"    # 채팅 시작; 짧은 id 출력
agenteye agent ask --chat <short-id> "and which tools did they call?"   # 이어서 대화
agenteye agent chats ; agenteye agent show <short-id>
agenteye agent rename <short-id> --title "error triage" ; agenteye agent delete <short-id>