> ## 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.

# 피드백

> 답에 대한 평가와 다운스트림 비즈니스 결과, 두 의도는 분리

피드백 메서드는 둘, 둘 다 그 Flow의 **트리거 시크릿**으로 인증합니다. 의도가 다릅니다. 섞지 마세요.

## `feedback(traceId, {...})`

답 자체에 대한 평가: 👍 / 👎, 코멘트, `before → after` 정정. 기존 end-user 피드백 엔드포인트를 앱에서 그대로 전달하도록 노출한 것입니다.

* `dislike`는 그 트레이스의 **확정 human 신호**로 승격됩니다.
* `like`는 그 트레이스에 붙어 있던 미결 신호를 회수합니다.

`traces.feedback` 별칭도 있습니다. 같은 호출이고, 스펙의 정식 이름입니다.

```ts theme={null}
await nora.feedback(r.traceId, {
  rating: "dislike",
  comment: "보장 범위를 반대로 안내",
  correction: { before: "…", after: "…" },
});
```

옵션:

* `rating` (필수) `"like"` 또는 `"dislike"`.
* `comment` 자유 텍스트. 트레이스와 군집 검수에 노출됩니다.
* `correction` `{ before, after }` 짝. `after`는 사용자가 답이 어떻게 되었어야 한다고 말한 것. 개선 루프에 candidate fix 내용으로 들어갑니다.

## `signals.report(traceId, {...})`

답 품질 탐지기가 볼 수 없는 외부 결과: 환불됨, 재오픈, 상담사 개입, 해결됨. **candidate 신호**로 `origin=sdk_report`를 달고 들어가 탐지 신호와 같은 군집/데이터셋 경로를 탑니다.

```ts theme={null}
await nora.signals.report(r.traceId, {
  outcome: "resolved",
  reason: "사용자 확인",
});
```

옵션:

* `outcome` (필수) 자유 문자열. 흔한 어휘: `resolved`, `reopened`, `escalated`, `refunded`, `abandoned`. 한 세트로 정하고 일관되게 쓰세요. 그게 군집이 묶이는 축입니다.
* `reason` 자유 텍스트.

## 왜 둘을 분리하나

`feedback`와 `signals.report`를 섞으면 탐지기와 군집이 시끄러워집니다.

* `feedback`은 **답이 옳았는지**를 말합니다. 답 품질 지표에 실립니다.
* `signals.report`는 **다운스트림에서 실제로 무슨 일이 있었는지**를 말합니다. 결과 지표와, 답 품질 탐지기가 놓친 실패를 드러냅니다.

기술적으로 옳은 답(👍 `feedback`)인데도 사용자가 이탈하는(`escalated` 신호) 일이 있습니다. 둘 다 담아야 하고, 서로 다른 트랙에 실려야 합니다.

```ts theme={null}
// 답 품질: 사용자가 답을 어떻게 봤는지
await nora.feedback(traceId, { rating: "dislike", correction: { before, after } });

// 비즈니스 결과: 실제로 다운스트림에서 무슨 일이 있었는지
await nora.signals.report(traceId, { outcome: "reopened", reason: "다음 날 다시 문의" });
```

## `traceId`는 어디서 오나

* **`flows.run` 반환값** `r.traceId`. 기본값이고, 그 자리에서 씁니다.
* **앱 로그** 나중에 로그에 남긴 `traceId`로 피드백을 붙여도 됩니다.
* **[`newTraceRef`](/ko/sdk/execution#newtraceref) 상관관계** 실행 전 앱 로그에 상관 id를 심어 둘 때.

## MCP · CLI로 같은 일

MCP 툴과 CLI로 같은 작업이 됩니다.

```bash theme={null}
# CLI
nora feedback submit <trace-id> --like            # 또는 --dislike
nora feedback submit <trace-id> --dislike --comment "…" --correction-before "…" --correction-after "…"
```

전체 CLI 모양은 [`nora feedback`](/ko/cli/feedback)을 참고하세요.