CLI

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 triggers 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                                 # 어시스턴트 설정/접근 가능 여부 확인
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>