실험의 메타데이터와 집계
Experiment는 모델 학습 실행의 매개변수, 지표와 산출물을 추적하며 부모 Model에 연결됩니다. 생성 출처는 Code Workspace, 작성 저장소 또는 SDK입니다. 모델 버전의 생성 출처 구조와 필드가 다르므로 구분합니다.
매개변수와 시계열
매개변수 값은 datetime, boolean, string, double, integer의 다섯 분기입니다. datetime의 값은 날짜시각 문자열이고 integer의 값은 long 형식의 정수입니다. 원시 시계열 포인트의 timestamp가 Unix epoch 밀리초인 것과 구분합니다.
series는 원시 포인트 목록이 아니라 시계열별 집계 정보입니다. 요약 지표에서 만든 집계라면 length가 없을 수 있으며, 아직 계산하지 않은 min, max, last도 생략될 수 있습니다. 없는 지표를 0으로 바꾸지 않습니다.
원시 값은 시계열 JSON 또는 Parquet으로 조회합니다. 테이블 산출물의 내용은 메타데이터와 별도로 JSON 또는 Parquet에서 받습니다.
전체 필드
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
rid | string | 필수 | 실험의 RID입니다. | ri.models.main.experiment.abc123 |
modelRid | string | 필수 | 모델의 RID입니다. | ri.models.main.model.f351c142-0e4c-4b12-adc2-6e1539737ae9 |
createdTime | string (date-time) | 필수 | 리소스 생성 시각입니다. | 2003-05-06T12:34:56.789Z |
createdBy | string | 필수 | 리소스를 생성한 Foundry 사용자입니다. | f05f8da4-b84c-4fca-9c77-8af0b13d11de |
source | union<codeWorkspace, authoring, sdk> | 필수 | 실험이 생성된 경로입니다. | 응답 예시 참조 |
status | enum | 필수 | 실험의 현재 상태입니다. 허용값: RUNNING, SUCCEEDED, FAILED. | RUNNING |
statusMessage | string | 선택 | ||
branch | string | 필수 | 브랜치 이름입니다. | master |
parameters | list<Parameter> | 선택 | ||
series | list<SeriesAggregations> | 선택 | ||
summaryMetrics | list<SummaryMetric> | 선택 | ||
artifacts | map<ExperimentArtifactName, ExperimentArtifactMetadata> | 선택 | ||
tags | list<ExperimentTagText> | 선택 | ||
linkedModelVersion | string | 선택 | 모델 버전의 RID입니다. | ri.models.main.model-version.adf94926-c3ac-41ea-beb2-4946699d08ee |
jobRid | string | 선택 | 실행 작업의 RID입니다. | ri.foundry.main.job.aaf94076-d773-4732-a1df-3b638eb50448 |
source의 구조
분기 codeWorkspace
Code Workspace에서 생성한 실험입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: codeWorkspace. | codeWorkspace |
containerRid | string | 필수 | ||
deploymentRid | string | 선택 |
분기 authoring
작성 저장소에서 생성한 실험입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: authoring. | authoring |
stemmaRid | string | 필수 |
분기 sdk
SDK에서 생성한 실험입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: sdk. | sdk |
parameters의 구조
배열 항목은 Parameter이며 자료형은 object입니다.
이름과 값을 갖는 매개변수입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
name | string | 필수 | 매개변수 이름입니다. | learning_rate |
value | union<datetime, boolean, string, double, integer> | 필수 | 매개변수 값입니다. | 응답 예시 참조 |
value의 구조
분기 datetime
날짜와 시각 매개변수 값입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: datetime. | datetime |
value | string (date-time) | 필수 |
분기 boolean
boolean 매개변수 값입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: boolean. | boolean |
value | boolean | 필수 |
분기 string
문자열 매개변수 값입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: string. | string |
value | string | 필수 |
분기 double
double 매개변수 값입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: double. | double |
value | double | 필수 |
분기 integer
정수 매개변수 값입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: integer. | integer |
value | long | 필수 | 정수 매개변수의 값입니다. |
series의 구조
배열 항목은 SeriesAggregations이며 자료형은 object입니다.
미리 계산한 집계값을 포함하는 시계열 정보입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
name | string | 필수 | 시계열 이름입니다. | loss |
length | long | 선택 | 시계열 값의 개수입니다. 전체 시계열이 아닌 요약 지표에서 집계 정보를 만든 경우 이 값이 없을 수 있습니다. | |
value | union<double> | 필수 | 해당 시계열의 집계값입니다. | 응답 예시 참조 |
value의 구조
분기 double
수치 시계열의 집계 통계입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: double. | double |
min | double | 선택 | 최소값입니다. 계산되지 않은 지표이면 값이 없습니다. | |
max | double | 선택 | 최대값입니다. 계산되지 않은 지표이면 값이 없습니다. | |
last | double | 선택 | 가장 최근 값입니다. 계산되지 않은 지표이면 값이 없습니다. |
summaryMetrics의 구조
배열 항목은 SummaryMetric이며 자료형은 object입니다.
시계열 이름, 집계 종류와 계산값을 갖는 요약 지표입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
seriesName | string | 필수 | 이 지표가 속한 시계열 이름입니다. | loss |
aggregation | enum | 필수 | 집계 종류입니다. 허용값: MIN, MAX, LAST. | MIN |
value | double | 필수 | 계산된 값입니다. |
artifacts의 구조
맵의 키는 ExperimentArtifactName(string), 값은 ExperimentArtifactMetadata(object)입니다.
키: 실험 산출물의 이름입니다.
실험 산출물의 메타데이터입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
name | string | 필수 | 실험 산출물의 이름입니다. | predictions_table |
description | string | 선택 | ||
sizeBytes | long | 필수 | 파일 또는 첨부파일의 바이트 크기입니다. | 72526847 |
details | union<table> | 필수 | 실험 산출물의 상세 정보입니다. | {"type":"table","rowCount":100} |
details의 구조
분기 table
테이블 산출물의 상세 정보입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: table. | table |
rowCount | long | 필수 | 행 수입니다. |
tags의 구조
배열 항목은 ExperimentTagText이며 자료형은 string입니다.
실험에 붙인 태그입니다.