> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 검색·필터

> 어느 트레이스든 찾습니다. 내용, 비용, 결과, 무엇으로든

트레이스 페이지는 소방 호스입니다. 검색과 필터가 그걸 겨냥한 결과로 바꿔 줍니다.

## 빠른 필터

트레이스 페이지 맨 위에 있습니다.

* **Time range** 최근 1시간, 하루, 한 주, 커스텀.
* **Status** success / errored / stopped / running.
* **Feedback** 👍 / 👎 / 피드백 없음.
* **Verification** passed / warned / blocked.
* **Cost bucket** cheap / normal / expensive.

필터는 AND로 묶입니다.

## 구조화 검색

검색 바가 쿼리 언어를 받습니다.

```
cost:>0.10 AND status:success AND feedback:down
```

```
duration:>5s AND has_tool:refund_charge
```

```
citations:0 AND answer_length:>500
```

지원하는 필드는 이렇습니다.

* `cost`(USD)
* `duration`(단위 `ms`, `s`, `m`)
* `status`, `feedback`, `verification`
* `flow`, `version`(Flow slug / 버전 ID)
* `user_id`, `tenant`, `session`(Trigger의 스코프 필드)
* `has_tool`(실행이 부른 도구)
* `tool_error`(에러를 낸 도구)
* `model`(모델 이름)
* `answer_length`(문자 수)
* `citations`(개수)
* `groundedness_score`
* 여러분이 더한 커스텀 태그나 기능

연산자는 `=`, `!=`, `>`, `<`, `>=`, `<=`, `AND`, `OR`, `NOT`, `IN [...]` 입니다.

## 전문 검색

프롬프트, 도구 인자, 도구 응답, 답변을 검색하려면 구절을 따옴표로 감쌉니다.

```
"refund policy" AND feedback:down
```

텍스트 검색은 트레이스 페이로드 전체에 돕니다. Flow의 페이로드 보존 설정을 따르므로, 페이로드 보존 기간이 지난 트레이스는 메타데이터만 남아 텍스트 쿼리에 안 걸립니다.

## 저장된 뷰

어떤 필터 조합이든 **뷰**로 저장합니다. 뷰는 사이드바에 뜨고 팀원과 공유할 수 있습니다.

흔히 이렇게 저장합니다.

* "어제의 downs" feedback:down, 최근 24시간.
* "비싼 지원 실행" cost:>0.5, flow:support-agent.
* "이번 주 검증 블록" verification:blocked, 최근 7일.

## 내보내기

어떤 필터 결과든 내보낼 수 있습니다.

* **CSV** 트레이스마다 한 줄, 요약 지표 포함.
* **JSONL** 전체 트레이스 페이로드, 한 줄에 하나.
* **Dataset** Reliable → Datasets에 데이터셋을 만듭니다([데이터셋](/ko/reliable/datasets/create) 참고).

내보내기는 비동기입니다. 큰 내보내기(트레이스 1만 개 초과)는 다운로드 링크를 이메일로 보냅니다.

## 프로그램으로 접근

API `GET /traces?query=...`가 같은 쿼리 언어를 받습니다. 커스텀 대시보드나 오프라인 분석을 만들 때 좋습니다.

요율 제한이 걸립니다. API 레퍼런스를 참고하세요.

## Insights 뷰

낱개 실행이 아니라 많은 트레이스에 걸친 패턴은 **Insights** 페이지가 미리 만든 차트로 보여줍니다.

* 시간에 따른 비용.
* 시간에 따른 피드백률.
* 실패가 잦은 의도.
* 리트리벌 적중률.
* 모델 비용 나눔.
* 가장 느린 도구.

모든 차트를 같은 쿼리 언어로 거를 수 있습니다.
