Công thức CLI cho agents

export AGENTEYE_DASHBOARD_URL=https://agenteye.example.com   # để bạn không lặp lại --base-url
agenteye login --email you@example.com                       # dán mã được gửi qua email; hợp lệ ~24h

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

# phiên trong 24h qua có đánh giá bị lỗi
agenteye --json sessions --since 24h --status error | jq -r '.sessions[].session_id'

# đánh giá với điểm <= 0.5 về tính hữu ích, cho một agent
agenteye --json evals --agent-id checkout-bot --score helpfulness:..0.5 \
  | jq '.evaluations[] | {session_id, scores}'

# đánh giá mới nhất của phiên (trạng thái + điểm)
agenteye --json evals --session-id run-001 | jq '.evaluations[0] | {status, scores}'

# mọi sự kiện trong lần chạy (nâng --limit để quét đầy đủ)
agenteye --json events --session-id run-001 --all --limit 1000 | jq '.events[] | {ts, event_type}'

# chỉ các cuộc gọi công cụ trong phiên (--full được yêu cầu để lấy payload thô)
agenteye --json events --full --session-id run-001 --event-type tool_use,tool_result --all \
  | jq '.events[].payload'

# một lần: lấy tối đa 500 hàng trong các trang 200 hàng
agenteye --json events --session-id run-001 --limit 500 --all > events.json

# phân trang thủ công: đưa next_cursor trở lại
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[]'           # giá trị cho --env
agenteye --json list tools | jq -r '.values[]'          # tên công cụ; cũng agents, models, event_types, …
agenteye --json list score_filters | jq -r '.values[]'  # KEY hợp lệ cho --score KEY:MIN..MAX

agenteye login --org acme --email you@corp.com   # đặt tenant trong cùng bước với đăng nhập
agenteye --json orgs list | jq -r '.orgs[].org_slug'
agenteye --org globex --json sessions --since 24h   # ghi đè cho một lệnh

# bí mật được in MỘT LẦN, với --json nó là trường .key
key=$(agenteye --json keys create ci-bot --add events:read.add | jq -r '.key')
agenteye keys regenerate ci-bot --yes    # xoay vòng; agenteye keys disable ci-bot --yes để thu hồi

agenteye --json query run --sql "select count(*) from analytics.events" | jq '.rows'
agenteye --json query run errs --arg prod | jq '.rows'   # một truy vấn đã lưu + positional $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