> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-workspaces-notebooks.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# EvaluationLogger

> TypeScript SDK 레퍼런스

export const GitHubLink = ({url, compact = false}) => <a href={url} target="_blank" rel="noopener noreferrer" className={compact ? "source-link" : "github-source-link"}>
    {compact ? "소스 보기" : <>
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub 소스 코드
      </>}
  </a>;

<GitHubLink url="https://github.com/wandb/weave/blob/7c9efdc9fe05ffcaf2430dd652ef9bc5b3ffdfaa/sdks/node/src/evaluationLogger.ts#L556" />

EvaluationLogger를 사용하면 예측과 점수를 점진적으로 로깅할 수 있습니다.

사전에 데이터셋을 준비하고 일괄 처리해야 하는 기존 Evaluation 클래스와 달리,
EvaluationLogger를 사용하면 예측이 발생하는 대로 유연하게 점수를 매기며 로깅할 수 있습니다.

<div id="example">
  ## 예시
</div>

```ts twoslash theme={null}
// @noErrors
const ev = new EvaluationLogger({name: 'my-eval', dataset: 'my-dataset'});

for (const example of streamingData) {
  const output = await myModel.predict(example);
  const pred = ev.logPrediction(example, output);

  if (shouldScore(output)) {
    pred.logScore("accuracy", calculateAccuracy(output));
  }
  pred.finish();
}

await ev.logSummary();
```

<div id="constructor">
  ## 생성자
</div>

> **new EvaluationLogger**(`options`): `EvaluationLogger`

<div id="parameters">
  ### 매개변수
</div>

<ParamField path="options" type="object" required>
  <Expandable title="속성" defaultOpen>
    <ParamField path="attributes" type="Record<string, any>" />

    <ParamField path="dataset" type="string | Dataset<DatasetRow>">
      [`Dataset`](./dataset)을 참조하세요.
    </ParamField>

    <ParamField path="description" type="string" />

    <ParamField path="model" type="WeaveObject | { name?: string; }">
      [`WeaveObject`](./weaveobject)를 참조하세요.
    </ParamField>

    <ParamField path="name" type="string" required />

    <ParamField path="scorers" type="string[]" />
  </Expandable>
</ParamField>

<div id="returns">
  ### 반환값
</div>

`EvaluationLogger`

<div id="methods">
  ## 방법
</div>

<div id="logprediction">
  ### logPrediction()
</div>

> **logPrediction**(`inputs`, `output`): [`ScoreLogger`](./scorelogger)

입력과 출력을 포함한 예측을 로깅합니다(동기 버전).
하위 predict call을 포함하는 predict\_and\_score call을 생성합니다.
점수를 추가할 수 있도록 즉시 ScoreLogger를 반환합니다.

이 방법은 ScoreLogger를 동기적으로 반환합니다. ScoreLogger에 대한 오퍼레이션(`logScore`, `finish`)은
큐에 들어가며 초기화가 완료되면 실행됩니다.

<div id="parameters-2">
  #### 매개변수
</div>

<ParamField path="inputs" type="Record<string, any>" required />

<ParamField path="output" type="any" required />

<div id="returns-2">
  #### 반환값
</div>

[`ScoreLogger`](./scorelogger)

<div id="example-2">
  #### 예시
</div>

```ts twoslash theme={null}
// @noErrors
// Fire-and-forget 방식
const scoreLogger = evalLogger.logPrediction({input: 'test'}, 'output');
scoreLogger.logScore('accuracy', 0.95);
scoreLogger.finish();
await evalLogger.logSummary(); // 모든 작업이 완료될 때까지 대기
```

***

<div id="logpredictionasync">
  ### logPredictionAsync()
</div>

> **logPredictionAsync**(`inputs`, `output`): `Promise`\<[`ScoreLogger`](./scorelogger)>

입력과 출력이 포함된 예측을 로깅합니다(비동기 버전).
logPrediction()과 유사하지만 prediction call이 완전히 초기화되면
resolve되는 Promise를 반환합니다.

계속 진행하기 전에 초기화가 완료될 때까지 await해야 하는 경우 이 방법을 사용하세요.

<div id="parameters-3">
  #### 매개변수
</div>

<ParamField path="inputs" type="Record<string, any>" required />

<ParamField path="output" type="any" required />

<div id="returns-3">
  #### 반환값
</div>

`Promise`\<[`ScoreLogger`](./scorelogger)>

<div id="example-3">
  #### 예시
</div>

```ts twoslash theme={null}
// @noErrors
// Awaitable 스타일
const scoreLogger = await evalLogger.logPredictionAsync({input: 'test'}, 'output');
await scoreLogger.logScore('accuracy', 0.95);
await scoreLogger.finish();
```

***

<div id="logsummary">
  ### logSummary()
</div>

> **logSummary**(`summary?`): `Promise`\<`void`>

summary를 로깅하고 evaluation을 마무리합니다.
summarize call을 생성하고 evaluate call을 마무리합니다.

이 방법은 await 없이도 호출할 수 있지만(fire-and-forget), 내부적으로는
대기 중인 모든 오퍼레이션이 완료될 때까지 기다립니다.

<div id="parameters-4">
  #### 매개변수
</div>

<ParamField path="summary" type="Record<string, any>" />

<div id="returns-4">
  #### 반환값
</div>

`Promise`\<`void`>
