Skip to main content
PATCH
시나리오 테스트 수정

Authorizations

Authorization
string
header
required

워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

test_id
string<uuid>
required

시나리오 테스트 id입니다. GET /v3/evals/scenario 응답의 id를 사용합니다.

Body

application/json

이 엔드포인트의 요청 데이터입니다.

name
string

테스트 이름입니다.

Required string length: 1 - 255
description
string | null

테스트 설명입니다. null이면 설명이 없습니다.

user_prompt
string

AI 고객의 목표와 말투입니다.

Minimum string length: 1
rubric
string

대화 전체를 판정할 기준입니다.

Minimum string length: 1
max_turns
integer

대화 길이 상한입니다. 고객과 에이전트의 메시지를 각각 한 번으로 세며, 마지막 응답을 마치려고 한 번 넘길 수 있습니다. 기본 15, 3~30의 정수입니다.

Required range: 3 <= x <= 30
dynamic_variables
Dynamic Variables · object | null

실행할 때 에이전트에 넣을 동적 변수입니다.

tool_mocks
(EvalApiToolMock · object | EvalMcpToolMock · object | EvalFlowApiToolMock · object)[] | null

실행할 때 실제 도구 대신 돌려줄 도구 응답입니다. 같은 도구나 Flow 노드는 한 번만 지정합니다. null이면 정해 둔 응답이 없습니다.

metadata
Metadata · object | null

테스트에 붙여 두는 사용자 정의 정보입니다. 실행에는 쓰이지 않습니다.

Response

성공 응답

id
string<uuid>
required

테스트 id입니다.

name
string
required

테스트 이름입니다.

description
string | null
required

테스트 설명입니다. null이면 설명이 없습니다.

created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

user_prompt
string
required

AI 고객의 목표와 말투입니다.

rubric
string
required

대화 전체를 판정할 기준입니다.

max_turns
integer
required

대화 길이 상한입니다. 고객과 에이전트의 메시지를 각각 한 번으로 세며, 마지막 응답을 마치려고 한 번 넘길 수 있습니다.

dynamic_variables
Dynamic Variables · object | null
required

실행할 때 에이전트에 넣을 동적 변수입니다.

tool_mocks
(EvalApiToolMock · object | EvalMcpToolMock · object | EvalFlowApiToolMock · object)[] | null
required

실행할 때 실제 도구 대신 돌려줄 도구 응답입니다. 같은 도구나 Flow 노드는 한 번만 지정합니다. null이면 정해 둔 응답이 없습니다.

metadata
Metadata · object | null
required

테스트에 붙여 두는 사용자 정의 정보입니다. 실행에는 쓰이지 않습니다.