> ## Documentation Index > Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt > Use this file to discover all available pages before exploring further. # Failproof Cloud CLI > fp를 사용한 Failproof AI Cloud 조회 및 관리 전체 참조 가이드. `fp`를 사용하여 Cloud 텔레메트리를 검사하고 감사(audit), 발견 사항(finding), 이슈, 알림, 키, 사용자, 쿼리, 설정을 관리하세요. 로컬 훅, 정책, 캡처, 머신 등록에는 [`failproofai`](/ko/reference/failproof-cli)를 사용하세요. 릴리스된 Cloud CLI를 독립 도구로 설치하세요: ```bash theme={null} uv tool install fp-cli fp version ``` ## 로그인 ```bash theme={null} fp login fp whoami ``` ## 문법 ```text theme={null} fp [GLOBAL_OPTIONS] COMMAND [SUBCOMMAND] [ARGUMENTS] [OPTIONS] ``` 글로벌 옵션은 명령어 앞에 작성해야 합니다: ```bash theme={null} fp --json sessions --since 24h ``` 터미널 도움말은 `fp COMMAND --help` 또는 `fp COMMAND SUBCOMMAND --help`를 실행하세요. ## CLI 명령어 ### 인증 | 명령어 | 목적 | 옵션 | | ------------ | --------------------------------- | ----------------------------------- | | `fp login` | 이메일로 전송된 일회용 코드로 로그인하고 조직을 선택합니다. | `--email`, `-e`; `--org`; `--force` | | `fp logout` | 저장된 사용자 세션을 취소하고 제거합니다. | — | | `fp whoami` | 현재 ID, 인증 모드, 조직, 권한을 표시합니다. | — | | `fp version` | 설치된 CLI 버전을 표시합니다. | — | | `fp help` | 최상위 명령어 도움말을 표시합니다. | — | ```bash theme={null} fp login --email you@example.com --org reliability-team fp whoami ``` ### 이벤트 ```text theme={null} fp events [OPTIONS] ``` 개별 에이전트 이벤트를 나열합니다. 기본 경량 피드는 원시 페이로드를 제외합니다. `--full`은 범위가 한정된 조사에만 사용하세요. | 옵션 | 설명 | | ----------------------------------------- | ----------------------------------------- | | `--limit`, `-n ` | 최대 전체 행 수. 기본값: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h`, 또는 `7d`. | | `--from ` / `--to ` | ISO 8601 UTC 범위; `--since`를 덮어씁니다. | | `--env ` | 환경 필터; 반복하거나 쉼표로 구분된 값 사용. | | `--event-type ` | 이벤트 유형 필터; 반복하거나 쉼표로 구분된 값 사용. | | `--agent-id ` | 에이전트 필터; 반복하거나 쉼표로 구분된 값 사용. | | `--session-id ` | 세션 필터; 반복하거나 쉼표로 구분된 값 사용. | | `--search ` | 페이로드 텍스트 검색; 반복 가능하며 조건 중 하나라도 일치하면 반환. | | `--order asc\|desc` | 시간 정렬 순서. 기본값: 최신 항목 먼저. | | `--all` | `--limit`까지 자동 페이지네이션. | | `--cursor ` | 불투명 커서에서 재개. | | `--page-size ` | `--all` 사용 시 요청당 행 수; 최대 `200`. | | `--full` | 더 무거운 이벤트 엔드포인트를 통해 원시 페이로드 포함. | | `--fields ` | 선택한 필드만 반환; `payload` 요청 시 전체 모드 활성화. | ```bash theme={null} fp events --session-id --order asc --all fp --json events --full --session-id --all ``` ### 세션 ```text theme={null} fp sessions [OPTIONS] ``` | 옵션 | 설명 | | ----------------------------------------- | -------------------------------------------------- | | `--limit`, `-n ` | 최대 전체 행 수. 기본값: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h`, 또는 `7d`. | | `--from ` / `--to ` | ISO 8601 UTC 범위; `--since`를 덮어씁니다. | | `--env ` | 환경 필터; 반복하거나 쉼표로 구분된 값 사용. | | `--status ` | `done`, `error`, 또는 `timeout`; 반복하거나 쉼표로 구분된 값 사용. | | `--agent-id ` | 선택한 에이전트가 포함된 세션을 매칭. | | `--session-id ` | 세션 필터; 반복하거나 쉼표로 구분된 값 사용. | | `--all` | `--limit`까지 자동 페이지네이션. | | `--cursor ` | 불투명 커서에서 재개. | | `--page-size ` | `--all` 사용 시 요청당 행 수; 최대 `200`. | | `--fields ` | 선택한 필드만 반환. | | `--full-ids` | 터미널 출력에서 세션 ID를 단축하지 않음. | | `--agents` | 멀티 에이전트 세션의 에이전트 목록 펼침. | ### 평가 ```text theme={null} fp evals [OPTIONS] ``` | 옵션 | 설명 | | ------------------------------------------------- | ----------------------------- | | `--aggregate` | 개별 평가 대신 전체 합계 및 점수별 통계 표시. | | `--limit`, `-n ` | 최대 목록 행 수. 기본값: `50`. | | `--since`, `--from`, `--to` | 시간 범위 선택. | | `--env`, `--status`, `--agent-id`, `--session-id` | 필터당 정확히 하나의 값으로 범위 좁히기. | | `--score KEY:MIN..MAX` | 점수 범위; 반복 가능하며 모든 범위가 일치해야 함. | | `--all`, `--cursor`, `--page-size` | 목록 페이지네이션 제어. | | `--fields ` | 선택한 필드만 반환. | | `--full-ids` | 완전한 세션 ID 표시. | | `--scores-full` | 터미널 출력에서 모든 점수 표시. | ### 오류 ```text theme={null} fp errors [OPTIONS] ``` | 옵션 | 설명 | | --------------------------------------------------------------------- | --------------------- | | `--aggregate` | 행 목록 대신 일치하는 오류 요약. | | `--limit`, `-n ` | 최대 목록 행 수. 기본값: `50`. | | `--since`, `--from`, `--to` | 시간 범위 선택. | | `--env`, `--error-type`, `--event-type`, `--agent-id`, `--session-id` | 오류 범위 좁히기. | | `--search ` | 페이로드 텍스트 검색; 반복 가능. | | `--order asc\|desc` | 시간 정렬 순서. | | `--all`, `--cursor`, `--page-size` | 목록 페이지네이션 제어. | | `--fields ` | 선택한 필드만 반환. | | `--full-ids` | 완전한 세션 ID 표시. | ### 사용량 및 필터 값 | 명령어 | 목적 | | ----------------------- | ------------------- | | `fp usage` | 현재 미터링 윈도우의 사용량 표시. | | `fp list envs` | 관찰된 환경 목록. | | `fp list agents` | 관찰된 에이전트 ID 목록. | | `fp list event_types` | 이벤트 유형 목록. | | `fp list score_filters` | 평가 점수 키 목록. | | `fp list models` | 모델 이름 목록. | | `fp list hooks` | 훅 이름 목록. | | `fp list tools` | 도구 이름 목록. | | `fp list error_types` | 오류 유형 목록. | ### 조직 | 명령어 | 목적 | | ----------------------- | ----------------------- | | `fp orgs list` | 접근 가능한 조직 목록. | | `fp orgs switch [SLUG]` | 활성 조직 저장; 생략 시 프롬프트 표시. | | `fp orgs current` | 활성 조직 표시. | | `fp orgs perms` | 활성 조직에서의 권한 표시. | ### API 키 | 명령어 | 목적 | 옵션 | | ------------------------- | ---------------------- | ------------------------------------------------------ | | `fp keys list` | 조직 키 목록. | `--show-id`; `--fields ` | | `fp keys show NAME` | 키 하나와 해당 권한 표시. | — | | `fp keys create NAME` | 키를 생성하고 비밀을 한 번 공개. | `--permission-set`; `--add`; `--remove` | | `fp keys update NAME` | 권한 세트를 교체하거나 권한 조정. | `--permission-set`; `--add`; `--remove`; `--yes`, `-y` | | `fp keys regenerate NAME` | 비밀을 교체하고 대체 값을 한 번 공개. | `--yes`, `-y` | | `fp keys disable NAME` | 키를 영구적으로 취소. | `--yes`, `-y` | 권한 토큰은 `events:add`와 같이 `resource:action` 형식을 사용합니다. `--add`를 반복하거나, 쉼표로 구분된 토큰을 사용하거나, `events:read.add`와 같이 점으로 연결된 액션을 사용하세요. ### 쿼리 | 명령어 | 목적 | 옵션 | | ------------------------- | --------------------------- | ------------------------------------------------- | | `fp query list` | 저장된 쿼리 목록. | `--show-id`; `--fields ` | | `fp query show NAME` | 쿼리 하나 표시. | — | | `fp query create NAME` | 쿼리 저장. | `--sql `; `--description` | | `fp query update NAME` | 쿼리 업데이트 또는 이름 변경. | `--name`; `--sql`; `--description`; `--yes`, `-y` | | `fp query delete NAME` | 저장된 쿼리 삭제. | `--yes`, `-y` | | `fp query run [NAME]` | 저장된 쿼리 또는 임시 SQL 실행. | `--sql`; `--limit`; `--all`; `--arg`, `--param` | | `fp query schema [TABLE]` | 조회 가능한 테이블 목록 또는 테이블 하나 검사. | — | ### 사용자 | 명령어 | 목적 | 옵션 | | ------------------------ | -------------- | ------------------------------------------------------ | | `fp users list` | 조직 구성원 목록. | `--active-only`; `--show-id` | | `fp users show EMAIL` | 구성원과 해당 권한 표시. | — | | `fp users create EMAIL` | 구성원 추가. | `--permission-set`; `--add`; `--remove` | | `fp users update EMAIL` | 구성원 권한 변경. | `--permission-set`; `--add`; `--remove`; `--yes`, `-y` | | `fp users disable EMAIL` | 로그인 비활성화. | `--yes`, `-y` | | `fp users enable EMAIL` | 로그인 재활성화. | `--yes`, `-y` | ### 설정 | 명령어 | 목적 | 옵션 | | --------------------- | ---------------- | --------------------------------------------------------------- | | `fp settings list` | 조직 설정 및 현재 값 목록. | — | | `fp settings schema` | 허용 값 및 설명 표시. | — | | `fp settings set KEY` | 기존 설정 변경. | `--value`, `--json-value`, `--file` 중 정확히 하나; 선택적 `--yes`, `-y` | ### 알림 | 명령어 | 목적 | 옵션 | | ----------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | `fp alerts list` | 알림 규칙 목록. | `--show-id` | | `fp alerts show NAME` | 알림 하나 표시. | — | | `fp alerts create NAME` | 알림 생성. | `--file`; `--description`; `--severity`; `--trigger-kind`; `--trigger-spec`; `--channels`; `--eval-interval-secs`; `--min-breaches`; `--eval-window` | | `fp alerts update NAME` | 알림 업데이트 또는 이름 변경. | 생성 옵션에 `--name`; `--yes`, `-y` 추가 | | `fp alerts delete NAME` | 알림 삭제. | `--yes`, `-y` | | `fp alerts test NAME` | 테스트 알림 전송. | `--channels`; `--yes`, `-y` | 알림 심각도는 `info`, `warning`, `critical`입니다. 트리거 종류는 `metric_threshold`, `custom_sql`, `evaluation_score`, `eval_compound`, `per_event`입니다. 평가 간격은 30\~86,400초 사이여야 합니다. ### 감사 | 명령어 | 목적 | 옵션 | | -------------------------------- | ----------------------------- | --------------------------------------------------------------------------- | | `fp audits list` | 감사 목록. | `--enabled-only`; `--show-id` | | `fp audits show NAME` | 감사 정의 및 상태 하나 표시. | — | | `fp audits create NAME` | 감사를 생성하고 즉시 첫 번째 실행을 대기열에 추가. | [생성 옵션](#audit-create-options) 참조. | | `fp audits edit NAME` | 미지정 값을 유지하면서 감사 설정 교체. | 감사 정의 생성 옵션; `--name`; `--yes`, `-y` | | `fp audits delete NAME` | 감사, 발견 사항, 실행 기록 삭제. | `--yes`, `-y` | | `fp audits run NAME` | 수동 실행 대기열에 추가. | — | | `fp audits runs NAME` | 실행 기록 목록. | `--limit`, `-n`; `--show-id` | | `fp audits context-show NAME` | 브리핑 및 참조 URL 가져오기 상태 표시. | — | | `fp audits context-set NAME` | 브리핑 또는 참조 URL 변경. | `--text`; `--text-file`; `--url`; `--clear-urls` | | `fp audits context-refresh NAME` | 참조 URL 재가져오기. | — | | `fp audits findings` | 발견 사항 목록. | `--audit`; `--run-id`; `--status`; `--limit`, `-n`; `--offset`; `--show-id` | | `fp audits finding FINDING_ID` | 발견 사항 하나와 증거 표시. | — | | `fp audits ack FINDING_ID` | 발견 사항 확인. | `--reason` | | `fp audits mute FINDING_ID` | 반복 패턴 억제. | `--reason`; `--yes`, `-y` | | `fp audits dismiss FINDING_ID` | 패턴을 조치 불필요로 표시하고 억제. | `--reason`; `--yes`, `-y` | | `fp audits resolve FINDING_ID` | 향후 억제 없이 발견 사항을 수정됨으로 표시. | `--yes`, `-y` | | `fp audits reopen FINDING_ID` | 발견 사항을 활성 대기열로 되돌리고 억제 해제. | — | | `fp audits assign FINDING_ID` | 발견 사항 담당자 설정. | 필수 `--to ` | #### 감사 생성 옵션 ```bash theme={null} fp audits create checkout-reliability \ --description "Find checkout failures that agents do not recover from" \ --scope '{"environments":["production"],"agent_ids":["checkout-agent"]}' \ --schedule-interval-secs 86400 \ --window-mode since_last \ --sensitivity medium \ --text-file ./checkout-audit-brief.txt \ --url https://runbooks.example.com/checkout ``` | 옵션 | 설명 | | --------------------------------- | --------------------------------------------------------------- | | `--file ` | JSON을 기반으로 정의하거나 stdin에는 `-` 사용. 명시적 플래그가 파일 값을 덮어씁니다. | | `--description ` | 실패 질문 또는 목적 기술. | | `--enabled` / `--disabled` | 스케줄링을 활성 또는 비활성으로 시작. 기본값: 활성. | | `--schedule-interval-secs ` | `3600`–`604800`. 기본값: `86400`. | | `--schedule-anchor ` | ISO 8601 형식의 고정 UTC 단계. 기본값: 다음 09:00 UTC. | | `--window-mode since_last\|fixed` | 마지막으로 완전히 분석된 윈도우 이후 계속하거나 롤링 윈도우를 반복적으로 검사. 기본값: `since_last`. | | `--lookback-window-secs ` | `3600`–`7776000`. 기본값: `604800`. | | `--scope ''` | `environments`, `agent_ids` 또는 기타 지원되는 범위 필드로 필터링. | | `--ignore-error-type ` | 오류 유형 제외; 반복하거나 쉼표로 구분. | | `--llm` / `--no-llm` | 에이전틱 분석 활성화 또는 비활성화. 기본값: 활성. | | `--top-k ` | `1`–`500` 발견 사항 유지. 기본값: `50`. | | `--sensitivity low\|medium\|high` | 보고 민감도 설정. 기본값: `medium`. | | `--channels ''` | 알림 채널 배열. | | `--text ` | 인라인 브리핑, 최대 8,192자. | | `--text-file ` | 파일에서 브리핑 읽기; `--text`와 상호 배타적. | | `--url ` | 공개 HTTPS 참조 추가; 최대 다섯 번 반복 가능. | 첫 번째 실행에 컨텍스트가 필요한 경우 생성 시 포함하세요. 생성은 대기열에 추가된 실행이 시작되기 전에 정의와 컨텍스트를 함께 커밋합니다. `fp audits run`은 비동기입니다. 발견 사항을 읽기 전에 `fp audits runs NAME`을 폴링하여 최신 실행이 성공하거나 실패할 때까지 기다리세요. ### 이슈 | 명령어 | 목적 | 옵션 | | ------------------------------------------------- | ------------------------- | --------------------------------------------------------- | | `fp issues list` | 이슈 목록. | `--state`; `--alert-id`; `--limit`, `-n`; `--show-id` | | `fp issues count` | 열린 이슈 또는 선택한 이슈 상태 수 계산. | `--state` | | `fp issues show INCIDENT_ID` | 이슈 세부 정보, 댓글, 구독자, 활동 표시. | — | | `fp issues open` | 수동 또는 알림 연결 이슈 열기. | 필수 `--summary`; 선택적 `--title`, `--alert-id`, `--severity` | | `fp issues ack INCIDENT_ID` | 이슈 확인. | — | | `fp issues assign INCIDENT_ID` | 담당자 교체; 옵션 생략 시 초기화. | 반복 가능 `--assignee` | | `fp issues resolve INCIDENT_ID` | 이슈 해결. | `--yes`, `-y` | | `fp issues comment-list INCIDENT_ID` | 댓글 목록. | — | | `fp issues comment-add INCIDENT_ID` | 댓글 추가. | `--body`, `--file` 중 정확히 하나 | | `fp issues comment-delete INCIDENT_ID COMMENT_ID` | 댓글 삭제. | `--yes`, `-y` | | `fp issues subscribers INCIDENT_ID` | 구독자 목록. | — | | `fp issues subscribe INCIDENT_ID` | 본인 또는 다른 운영자 구독. | `--email` | | `fp issues unsubscribe INCIDENT_ID` | 구독 제거. | `--email` | 유효한 이슈 상태는 `firing`, `acknowledged`, `resolved`입니다. 독립 이슈 심각도는 `info`, `warning`, `critical`입니다. ### Cloud 어시스턴트 | 명령어 | 목적 | 옵션 | | ------------------------- | --------------------------------- | ------------------------------------- | | `fp agent health` | 어시스턴트 가용성 및 구성 확인. | — | | `fp agent models` | 사용 가능한 어시스턴트 모델 목록. | — | | `fp agent chats` | 저장된 채팅 목록. | — | | `fp agent ask [MESSAGE]` | 채팅 시작 또는 계속; 메시지 생략 시 stdin에서 읽음. | `--chat`; `--model`; `--page-context` | | `fp agent show CHAT_ID` | 저장된 대화 표시. | — | | `fp agent rename CHAT_ID` | 대화 이름 변경. | 필수 `--title` | | `fp agent delete CHAT_ID` | 대화 삭제. | `--yes`, `-y` | ## 글로벌 플래그 | 플래그 | 설명 | | ------------------------- | ----------------------------- | | `--json` | 기계가 읽을 수 있는 JSON 출력. | | `--base-url ` | 자체 호스팅 또는 개발 대시보드 사용. | | `--org ` | 이번 호출에 사용할 조직 선택. | | `--token ` | 저장된 사용자 세션 토큰 재정의. | | `--api-key ` | API 키로 자동화 인증; 저장되지 않음. | | `--timeout ` | HTTP 타임아웃; 양수여야 함. 기본값: `30`. | | `--quiet`, `-q` | stderr의 상태 출력 억제. | | `--no-color` | 색상 출력 비활성화. | | `--insecure` / `--secure` | TLS 인증서 검증 비활성화 또는 복원. | | `--version` | 버전을 출력하고 종료. | | `--help`, `-h` | 도움말 표시. | `--api-key`는 자동화용입니다. 로그인, 조직 전환, 어시스턴트 명령어는 사용자 세션이 필요합니다. ## 환경 변수 | 변수 | 동등한 옵션 또는 목적 | | ----------------------------------------------- | --------------------- | | `AGENTEYE_DASHBOARD_URL` | `--base-url` | | `AGENTEYE_ORG` | `--org` | | `AGENTEYE_CLI_TOKEN` | `--token` | | `AGENTEYE_CLI_API_KEY` | `--api-key` | | `AGENTEYE_CLI_JSON` | `--json` | | `AGENTEYE_INSECURE` | `--insecure` | | `AGENTEYE_HOME` | 현재 CLI 구성 디렉토리 위치 변경. | | `AGENTEYE_ANALYTICS_DISABLED` 또는 `DO_NOT_TRACK` | 익명 CLI 분석 비활성화. | | `NO_COLOR` | 색상 출력 비활성화. | 명시적 플래그는 환경 변수를 재정의하고, 환경 변수는 저장된 구성을 재정의합니다. API 키 모드에서는 `--org` 또는 `AGENTEYE_ORG`로 테넌트를 명시적으로 선택하세요. 삭제, 취소, 억제, 해결 또는 구성 교체 명령어는 기본적으로 확인을 요청합니다. 활성 조직과 대상을 확인한 후에만 `--yes`를 사용하세요.