failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/ko/agenteye/cli-recipes.mdx

@@ -0,0 +1,179 @@
+---
+title: "에이전트를 위한 CLI 레시피"
+description: "세션, 이벤트, 평가 데이터를 스크립트나 코딩 에이전트가 자동화할 수 있는 형태로 변환하는 복사-붙여넣기 쿼리 패턴과 jq 레시피를 소개합니다."
+---
+
+
+스크립트나 코딩 에이전트에서 세션, 이벤트, 평가 데이터를 직접 가져오고(재평가 트리거 포함) `jq`로 바로 파이프할 수 있는 깔끔한 JSON을 stdout으로 출력합니다. 이 레시피들은 Failproof AI Observability의 데이터를 터미널 사용자나 AI 코딩 에이전트(Claude Code, Cursor)가 대시보드를 클릭하지 않고도 쿼리하고 자동화할 수 있도록 해줍니다.
+
+아래 패턴들은 Failproof AI Observability CLI(`agenteye`)에서 바로 복사-붙여넣기하여 사용할 수 있습니다. 설치, 인증, 전체 옵션 목록은 [CLI](/ko/agenteye/cli)를 참고하세요. 내장 도움말은 `agenteye -h` 또는 `agenteye <command> -h`로 확인할 수 있습니다.
+
+## 기본 원칙
+
+1. **전역 옵션은 명령어 *앞에* 위치합니다.** `agenteye --json sessions`는 올바르지만 `agenteye sessions --json`은 올바르지 않습니다. 전역 옵션은 `--json`, `--base-url`, `--org`, `--token`, `--insecure`/`--secure`, `--timeout`, `--quiet`, `--no-color`입니다.
+2. **출력을 파싱할 때는 반드시 `--json`을 전달하세요.** 데이터는 **stdout**으로 JSON 형태로 출력되고, 사람이 읽는 상태 메시지와 오류는 **stderr**로 출력되므로 stdout을 `jq`로 깔끔하게 파이프할 수 있습니다.
+3. **stderr 텍스트가 아닌 종료 코드로 분기하세요.** `0` 정상 · `1` 예기치 않은 오류 · `2` 잘못된 인수 · `3` 대시보드에 연결할 수 없음 · `4` 로그인되지 않았거나 만료됨 · `5` 권한 없음 · `6` 리소스를 찾을 수 없음.
+4. **`-h`로 탐색하세요.** 모든 명령어는 필터, 값 형식, JSON 구조를 문서화하고 있습니다.
+
+## 최초 설정
+
+```bash
+export AGENTEYE_DASHBOARD_URL=https://agenteye.example.com   # --base-url을 반복 입력하지 않아도 됩니다
+agenteye login --email you@example.com                       # 이메일로 받은 코드를 붙여넣기; 약 24시간 유효
+```
+
+## 작업 전 인증 확인
+
+`whoami`는 세션이 없거나 만료된 경우에도 오류를 발생시키지 않고 `logged_in:false`를 반환하므로, 에이전트가 인증 상태를 안전하게 확인할 수 있습니다. (base URL이 설정되지 않았거나 대시보드에 연결할 수 없는 경우에는 여전히 non-zero로 종료될 수 있습니다.)
+
+```bash
+if [ "$(agenteye --json whoami | jq -r .logged_in)" != "true" ]; then
+  echo "Not authenticated. Run: agenteye login" >&2; exit 1
+fi
+```
+
+## 실패하거나 점수가 낮은 세션 찾기
+
+```bash
+# 최근 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}'
+```
+
+점수 필터링은 `sessions`가 아닌 **`evals`**에서 수행됩니다. `--score KEY:MIN..MAX`는 반복 사용 가능하며 AND로 결합됩니다. 양쪽 경계는 선택 사항입니다(`..0.5`는 ≤ 0.5, `0.9..`는 ≥ 0.9를 의미). 요청당 최대 20개의 점수 필터를 전달할 수 있으며, 초과 시 HTTP 400을 반환합니다. `sessions`는 `evals`와 `--env`, `--status`, `--agent-id`, `--session-id`, 시간 범위 필터를 공유하지만 `--score`는 없습니다.
+
+## 세션 전체 읽기
+
+단일 `session show` 명령어는 없습니다. 이벤트 내역과 세션 평가를 조합하여 사용하세요:
+
+```bash
+# 세션의 최신 평가 (상태 + 점수)
+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'
+```
+
+> **참고:** 기본적으로 `events`는 페이로드가 없는 빠른 피드를 읽습니다. 각 이벤트에는 서버에서 계산된 한 줄 `summary`와 `is_error`, 토큰 수 같은 플래그가 포함되지만 `payload`는 `{}`로 반환됩니다. raw 페이로드를 가져오려면 `--full`(또는 `--fields payload`)을 추가하세요. 전체 피드는 대규모에서 느리므로 범위를 제한하세요. `--full`과 단일 `--session-id`를 함께 사용하는 것을 권장합니다.
+
+## 전체 데이터 가져오기 (페이지네이션)
+
+결과는 최신순으로 정렬되며 커서 기반 페이지네이션을 사용합니다.
+
+```bash
+# 한 번에: 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"
+```
+
+## --fields로 출력 줄이기
+
+에이전트가 읽어야 하는 내용을 줄이기 위해 키를 제한합니다 (테이블과 `--json` 모두 적용).
+
+```bash
+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
+```
+
+알 수 없는 필드 이름은 유효한 목록과 함께 거부됩니다(종료 코드 `2`). 필드 이름을 확인하는 간편한 방법입니다.
+
+## 유효한 필터 값 탐색
+
+```bash
+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
+```
+
+## 조직 선택 (멀티 테넌트)
+
+둘 이상의 조직에 속해 있다면 로그인 시 활성 테넌트를 선택할 수 있습니다 (저장됨):
+
+```bash
+agenteye login --org acme --email you@corp.com   # 로그인과 동시에 테넌트 설정
+agenteye --json orgs list | jq -r '.orgs[].org_slug'
+agenteye --org globex --json sessions --since 24h   # 단일 명령어에서 재정의
+```
+
+`--org` 없이 다중 조직 로그인을 시도하면 non-zero로 종료되며 선택 가능한 조직 목록이 출력됩니다.
+
+## SDK/컬렉터용 API 키 발급
+
+```bash
+# 시크릿은 한 번만 출력됩니다. --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
+```
+
+## 저장된 쿼리 또는 임시 쿼리 실행
+
+```bash
+agenteye --json query run --sql "select count(*) from analytics.events" | jq '.rows'
+agenteye --json query run errs --arg prod | jq '.rows'   # 저장된 쿼리 + 위치 인수 $1
+```
+
+## 인시던트 비대화형 트리아지
+
+```bash
+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
+```
+
+> **참고:** 변경 작업은 `--json`이 있거나 stdin이 TTY가 아닌 경우 확인 프롬프트를 자동으로 건너뛰므로 에이전트가 중단되지 않습니다. 다른 곳에서는 `--yes`/`-y`를 명시적으로 전달하여 건너뛰세요.
+
+## 스크립트에서 종료 코드 처리
+
+```bash
+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
+```
+
+## JSON 출력 구조
+
+| 명령어 | stdout JSON (`--json` 사용 시) |
+|---|---|
+| `whoami` | `{"logged_in": true, "id", "email", "is_instance_admin", "active_org", "permissions": [...], "memberships": [...]}` 또는 `{"logged_in": false}` |
+| `orgs list` | `{"active_org", "orgs": [{"org_slug","org_name","permission_set","permissions"}]}` |
+| `events` | `{"events": [...], "next_cursor": <cursor or null>}` |
+| `evals` | `{"evaluations": [...], "next_cursor": <cursor or null>}` |
+| `sessions` | `{"sessions": [...], "next_cursor": <cursor or null>}` |
+| `errors` | `{"errors": [...], "next_cursor": <cursor or null>}` |
+| `list <kind>` | `{"kind", "values": [...]}` |
+| `keys list` / `keys create` | `{"keys": [...]}` / `{id, name, permissions, created_at, key}` (`key`는 한 번만 표시) |
+| `query run` | `{columns: [{name,type}], rows: [[...]], truncated, elapsed_ms}` |
+| `users list` / `settings list` | `{"users": [...]}` / `{"settings": [...]}` |
+| `alerts list` / `incidents list` | `{"alerts": [...]}` / `{"incidents": [...]}` |
+| create/update/delete (모두) | 리소스 객체, 삭제 시 `{"deleted": true, "id"}` |
+| 실패 (모두, `--json` 사용 시) | stdout에 `{"error": "...", "exit_code": <n>, "status"?: <http>, "hint"?: "..."}` |
+
+- 각 **이벤트** 항목(`events`): `id, session_id, agent_id, event_type, ts, payload, environment, summary, is_error, error_type, output_tokens, context_window, context_fill`. `--full`(또는 `--fields payload`)로 전체 피드를 요청하지 않으면 `payload`는 `{}`입니다.
+- 각 **평가** 항목(`evals`): `id, session_id, agent_id, environment, status, scores, reasoning, summary, error, attempt_count, duration_ms, completed_at, created_at`.
+- 각 **세션** 항목(`sessions`): `session_id, agent_id, environment, status, scores, event_count, started_at, last_event_at, first_event_id, last_event_id, latest_evaluation`.
+
+각 명령어의 `--fields`는 해당 항목의 필드 이름만 허용합니다. `sessions`와 `evals`의 필드 집합이 다르므로 한쪽에서 유효한 이름이 다른 쪽에서 거부될 수 있습니다.
+
+## 다음 단계
+
+- [CLI](/ko/agenteye/cli): 모든 명령어의 설치, 인증, 전체 옵션 레퍼런스.
+- [CLI 에이전트 스킬](/ko/agenteye/cli-skill): 이 레시피들을 코딩 에이전트가 로드할 수 있는 스킬로 패키징하기.
+- [API 키](/ko/agenteye/api-keys): CLI, SDK, 컬렉터가 인증에 사용하는 키 생성 및 범위 설정.
+- [Python SDK](/ko/agenteye/python-sdk): Failproof AI Observability로 이벤트를 전송하여 이 레시피가 쿼리할 데이터를 만들기.

package/.next/standalone/docs-old/ko/agenteye/cli-skill.mdx

@@ -0,0 +1,159 @@
+---
+title: "Failproof AI Observability CLI 에이전트 스킬"
+description: "코딩 에이전트에게 '오늘 뭔가 고장났나요?'라고 물어보면, 명령어를 외울 필요 없이 실시간 Failproof AI Observability 데이터를 바탕으로 답을 받을 수 있습니다."
+---
+
+
+코딩 에이전트에게 *"오늘 뭔가 고장났나요?"* 라고 물어보면, 명령어를 외울 필요 없이 실시간 Failproof AI Observability 데이터를 바탕으로 답을 받을 수 있습니다. **Failproof AI Observability CLI 스킬** (`agenteye-cli`)은 *에이전트 스킬*입니다. Claude Code나 Codex 같은 코딩 에이전트가 필요할 때 불러오는 작은 인스트럭션 폴더로, *"CI에 이벤트만 푸시할 수 있는 키를 만들어줘"* 나 *"발생 중인 인시던트를 ack하고 나한테 할당해줘"* 같은 자연어 요청을 통해 [`agenteye` CLI](/ko/agenteye/cli)로 Observability 배포 환경을 조작하는 방법을 에이전트에게 가르쳐줍니다.
+
+이것은 **서비스나 별도의 바이너리가 아닙니다**. 배포할 것이 없습니다. 이미 설치된 CLI 위에서 동작하며, 에이전트가 `agenteye --json …`을 실행하고 깔끔한 JSON을 파싱한 뒤 산문 형태로 답변해줍니다. 에이전트가 할 수 있는 모든 것은 여러분이 직접 같은 명령어를 입력해도 할 수 있는 것들입니다.
+
+---
+
+## 다른 Failproof AI Observability 인터페이스와의 관계
+
+Failproof AI Observability는 동일한 데이터와 컨트롤에 접근할 수 있는 네 가지 방법을 제공합니다. 이들은 서로 보완적입니다.
+
+| 인터페이스 | 설명 | 실행 위치 | 사용 시점 |
+|---|---|---|---|
+| **[CLI](/ko/agenteye/cli)** | `agenteye` 명령어/플래그 레퍼런스 | 터미널 | 특정 명령어를 직접 실행하거나 스크립트로 만들 때 |
+| **[CLI 레시피](/ko/agenteye/cli-recipes)** | `jq`/파이프라인 패턴 복붙 모음 | 터미널 / 스크립트 | CLI를 자동화에 연결할 때 |
+| **CLI 스킬** (이 문서) | CLI에 자연어로 접근하는 진입점 | 워크스테이션의 코딩 에이전트 | 그냥 물어보고 에이전트가 명령어를 선택하게 하고 싶을 때 |
+| **[Evaluator 스킬](/ko/agenteye/evaluator-skill)** | 스코어링 서비스를 설계하고 구축하는 형제 스킬 | 워크스테이션의 코딩 에이전트 | eval 점수를 *읽는* 게 아니라 *생성*하고 싶을 때 |
+| **[Python SDK 스킬](/ko/agenteye/python-sdk-skill)** | 에이전트가 텔레메트리를 내보내도록 계측하는 형제 스킬 | 워크스테이션의 코딩 에이전트 | 이 스킬이 읽는 이벤트를 에이전트가 *생성*하게 하고 싶을 때 |
+| **[대시보드 내 AI 어시스턴트](/ko/agenteye/assistant)** | 대시보드에 내장된 채팅 | 서버 사이드 (대시보드 내) | 대시보드에서 데이터를 Q&A 방식으로 조회하고 싶을 때 |
+
+스킬 자체에는 아무런 권한이 없습니다. 여러분의 말을 CLI 호출로 변환해줄 뿐이며, 호출은 여러분 권한으로 실행됩니다.
+
+```mermaid
+flowchart TD
+    YOU["you: 'ack the firing incident'"] --> AGENT["coding agent (Claude Code / Codex)<br/>loads the agenteye-cli skill"]
+    AGENT --> CLI["agenteye --json incidents ack ..."]
+    CLI -->|your authenticated CLI session| API["Observability dashboard API"]
+```
+
+### 대시보드 내 AI 어시스턴트와의 차이: 중요한 구분
+
+이 둘은 영향 범위가 매우 다른 별개의 도구입니다.
+
+- **대시보드 내 AI 어시스턴트** ([AI 어시스턴트](/ko/agenteye/assistant))는 에이전트 서비스를 기반으로 대시보드에 내장된 채팅입니다. **읽기 전용 + 승인 게이트 방식의 저작**: 저장된 쿼리와 대시보드를 초안으로 작성할 수 있지만, 모든 쓰기 작업은 사용자의 명시적 클릭 승인이 필요하며 절대 삭제하지 않습니다. `agent:use` 권한으로 게이트되어 있으며, 현재 보고 있는 조직의 데이터만 접근할 수 있습니다.
+- **CLI 스킬**은 *여러분의* 워크스테이션에서 *여러분의* 코딩 에이전트 안에서 실행되며, `agenteye` CLI를 **여러분** 권한으로 구동합니다. API 키 생성/교체/비활성화, 조직 설정 변경, 인시던트 해결, 저장된 쿼리 삭제 등 **뮤테이션을 포함한 CLI의 전체 기능**을 수행할 수 있으며, CLI 로그인의 권한 범위 내에서만 제한됩니다. 해당 명령어를 직접 입력하는 것과 동일한 수준의 주의를 기울여 다루세요.
+
+---
+
+## 사전 요구사항
+
+1. **`agenteye` CLI 설치** 및 `PATH` 등록 ([CLI](/ko/agenteye/cli) 레퍼런스 참고: `pipx install agenteye`)
+2. **대시보드 URL 설정** (`AGENTEYE_DASHBOARD_URL` 환경 변수 또는 에이전트가 `--base-url` 전달)
+3. **로그인된 세션**: 먼저 직접 `agenteye login`을 실행하세요. 스킬은 이메일로 전송되는 일회용 코드 로그인을 대신 완료할 수 **없습니다**. 세션이 없거나 만료된 경우 (CLI 종료 코드 `4`) `agenteye login`을 실행하라고 안내합니다.
+
+---
+
+## 다운로드 위치
+
+스킬은 Failproof AI의 공개 스킬 컬렉션에 게시되어 있습니다.
+
+**[github.com/FailproofAI/skills](https://github.com/FailproofAI/skills)** → [`skills/agenteye-cli/`](https://github.com/FailproofAI/skills/tree/main/skills/agenteye-cli)
+
+접근에 아무런 제한이 없습니다. 저장소는 공개되어 있고, 스킬은 자체 자격 증명이 필요 없습니다. *여러분이* 로그인한 세션을 사용해 **공개** `agenteye` CLI를 *여러분의* 대시보드에 연결할 뿐이기 때문입니다. 별도로 요청할 필요가 없습니다.
+
+스킬은 별도 폴더로 제공되며, `pipx install agenteye` 패키지 **내부에 포함되어 있지 않으므로** 거기서 찾지 마세요.
+
+## 스킬 설치
+
+가장 빠른 방법은 [`skills`](https://skills.sh) CLI를 사용하는 것입니다. 폴더를 가져와서 에이전트가 찾는 위치에 저장해줍니다.
+
+```bash
+# Claude Code, 현재 프로젝트에만 적용
+npx skills add FailproofAI/skills --skill agenteye-cli -a claude-code
+
+# 모든 프로젝트에 적용 (~/.claude/skills/에 설치)
+npx skills add FailproofAI/skills --skill agenteye-cli -a claude-code -g --copy
+
+# Codex 사용 시
+npx skills add FailproofAI/skills --skill agenteye-cli -a codex
+```
+
+이후 다른 스킬과 동일하게 관리할 수 있습니다.
+
+```bash
+npx skills list -a claude-code      # 설치된 스킬 목록
+npx skills update agenteye-cli      # 최신 버전으로 업데이트
+npx skills remove agenteye-cli      # 제거
+```
+
+직접 설치하고 싶으신가요? 에이전트 스킬은 `SKILL.md`(와 선택적 레퍼런스 파일)가 들어 있는 폴더일 뿐이므로, 복사해서 사용해도 됩니다.
+
+- **Claude Code**: `agenteye-cli/` 폴더를 `~/.claude/skills/`(모든 프로젝트) 또는 `<your-repo>/.claude/skills/`(해당 저장소만)에 넣으세요. Claude Code가 자동으로 감지합니다. `/skills` 목록으로 확인하거나, 설명과 일치하는 질문을 직접 해보세요.
+- **Codex (OpenAI)**: Codex도 동일한 `SKILL.md`를 읽습니다. 번들로 제공되는 `agents/openai.yaml`에 `allow_implicit_invocation: true`가 설정되어 있어 작업이 일치하면 Codex가 자동으로 스킬을 선택합니다. 명시적으로 호출하려면 `$agenteye-cli`를 사용하세요.
+
+---
+
+## 안전 주의사항: 에이전트가 CLI를 실행할 때 뮤테이션은 확인 프롬프트가 나타나지 않습니다
+
+> **경고:** 에이전트가 변경 작업을 수행하도록 허용하기 전에 반드시 읽으세요.
+
+`agenteye` CLI는 일반적으로 파괴적 작업 전에 *"정말 하시겠습니까?"* 라고 물어봅니다. 그러나 **터미널에 연결되어 있지 않을 때(코딩 에이전트가 실행하는 방식이 정확히 이 경우입니다)는 해당 확인을 자동으로 건너뛰며, `--json`도 마찬가지로 건너뜁니다.** 따라서 에이전트에게는 안전 프롬프트가 **표시되지 않습니다**.
+
+스킬은 이를 보완하도록 작성되어 있습니다. 실행할 정확한 명령어를 명시하고, 상태를 변경하기 전에 반드시 명시적으로 **OK를 받도록** 지시받았습니다. 이 규칙을 지켜주세요. 에이전트를 통해 Failproof AI Observability를 조작할 때는, *여러분이* 확인 단계입니다. 주의해야 할 상태 변경 명령어들:
+
+- `keys create` / `update` / `disable` / `regenerate`
+- `users create` / `update` / `disable` / `enable`
+- `settings set`
+- `alerts create` / `update` / `delete` / `test`
+- 쓰기 `incidents` 서브커맨드: `ack` / `assign` / `resolve` / `open` / `comment-add` / `comment-delete` / `subscribe` / `unsubscribe`
+- `query create` / `update` / `delete`
+- `agent rename` / `delete`
+- `orgs switch`
+
+**Observe** 하위의 모든 것(`events`, `sessions`, `evals`, `errors`, `list`, `whoami`, `orgs list/current/perms`)은 읽기 전용이며 아무것도 변경하지 않습니다.
+
+에이전트는 **여러분** 권한으로 동작하므로, 여러분의 로그인이 허용된 작업만 수행할 수 있습니다. 권한은 **조직별로** 확인됩니다 ([API 키](/ko/agenteye/api-keys) 참고). 권한이 없는 명령어는 정확한 권한 이름과 함께 종료 코드 `5`를 반환하므로, 에이전트가 불명확하게 실패하는 대신 어드민에게 무엇을 요청해야 하는지 정확히 알려줄 수 있습니다.
+
+---
+
+## 요청 예시
+
+실제 대화 흐름의 예시입니다. 읽기 작업과 확인을 기다리는 변경 작업이 포함되어 있습니다.
+
+```text
+you   ▸ Is anything broken in the last day?
+
+agent ▸ Running: agenteye --json errors --since 24h --aggregate
+        3 error types in the last 24h. The biggest is TimeoutError
+        (18 hits, all on the checkout-agent), then RateLimited (5).
+        Want the failing sessions for TimeoutError?
+
+you   ▸ Give CI a key that can only push events.
+
+agent ▸ This creates an API key. I'll run:
+          agenteye keys create ci --add events:add
+        OK to proceed?
+
+you   ▸ yes
+
+agent ▸ Done. Key "ci" created with events:add only.
+        The secret is shown only once, so store it now. I can't reprint it.
+```
+
+스킬은 자연어 의도를 적절한 `agenteye` 명령어로 매핑하고, 추측하지 않기 위해 먼저 유효한 값을 조회(`list <kind>`, `whoami`)한 뒤, 변경 전에 정확한 명령어를 명시합니다. 더 많은 예시:
+
+- *"최근 24시간 동안 고장났거나 실패한 게 있나요?"* → `errors --since 24h --aggregate` 후 세부 분석
+- *"세션 `run-001`이 왜 실패했나요?"* → `events --session-id run-001 --all` + `evals --session-id run-001`
+- *"이번 주 품질 트렌드는 어떤가요?"* → `evals --aggregate --since 7d` 후 낮은 점수의 실행 드릴다운
+- *"CI에 이벤트만 푸시할 수 있는 키를 만들어줘."* → `keys create ci --add events:add` (명령어를 명시한 뒤 생성하고 일회성 시크릿 캡처)
+- *"누가 접근 권한이 있나요? Dana를 읽기 전용으로 변경해줘."* → `users list` → 여러분에게 확인 후 `users update dana@… --permission-set read-only`
+- *"발생 중인 인시던트를 ack하고 나한테 할당해줘."* → `incidents list --state firing` → `incidents ack <id>` / `incidents assign <id> you@…`
+
+이 작업들 뒤에 있는 정확한 명령어, 플래그, JSON 형태는 [CLI](/ko/agenteye/cli) 레퍼런스와 [에이전트를 위한 CLI 레시피](/ko/agenteye/cli-recipes)를 참고하세요.
+
+---
+
+## 다음 단계
+
+- **[CLI](/ko/agenteye/cli)**: `agenteye`의 전체 명령어 및 플래그 레퍼런스
+- **[에이전트를 위한 CLI 레시피](/ko/agenteye/cli-recipes)**: `jq` 패턴 복붙 모음 및 종료 코드 처리
+- **[Evaluator 에이전트 스킬](/ko/agenteye/evaluator-skill)**: `agenteye evals`가 읽는 점수를 생성하는 evaluator를 구축하는 형제 스킬
+- **[Python SDK 에이전트 스킬](/ko/agenteye/python-sdk-skill)**: `agenteye`가 읽는 텔레메트리를 에이전트가 내보내도록 계측하는 형제 스킬
+- **[AI 어시스턴트](/ko/agenteye/assistant)**: 대시보드 내 어시스턴트 (이 터미널 스킬과 혼동하지 마세요)
+- **[API 키](/ko/agenteye/api-keys)**: 스킬이 수행할 수 있는 작업 범위를 결정하는 조직별 권한 모델