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/unit 응답의 id를 사용합니다.

Body

application/json

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

name
string

테스트 이름입니다.

Required string length: 1 - 255
description
string | null

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

messages
(UnitTestUserMessage · object | UnitTestAgentMessage · object | UnitTestToolCallInvocation · object | UnitTestToolCallResult · object)[]

검사할 대화입니다. 통화 transcript와 같은 항목을 순서대로 쓰고 마지막 항목에 eval로 기대 행동을 지정합니다. 규칙에 맞지 않는 초안도 저장되며 validation에 문제가 표시되고 실행할 수 없습니다. 항목에 정의되지 않은 키는 저장하지 않고 무시하지만 eval 안에는 정의된 키만 쓸 수 있습니다. 보내면 대화 전체를 바꿉니다.

Minimum array length: 1
flow_agent_id
string<uuid> | null

저장된 flow_agent_id와 같은 값만 보낼 수 있습니다.

flow_start_node_id
string | null

Flow 유닛 테스트를 시작할 노드 id입니다. flow_agent_id와 함께 지정합니다.

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 형식입니다.

validation
EvalValidation · object
required

현재 규칙으로 본 실행 가능 여부와 고칠 점입니다.

messages
(UnitTestUserMessage · object | UnitTestAgentMessage · object | UnitTestToolCallInvocation · object | UnitTestToolCallResult · object)[]
required

검사할 대화입니다. 마지막 항목의 eval이 확인할 항목입니다. 규칙에 맞지 않는 항목도 저장된 그대로 보여 주고 validation에 표시합니다.

flow_agent_id
string<uuid> | null
required

Flow 유닛 테스트가 속한 Flow 에이전트 id입니다. 일반 에이전트용 테스트는 null입니다.

flow_start_node_id
string | null
required

Flow 유닛 테스트를 시작할 노드 id입니다. 일반 에이전트용 테스트는 null입니다.

dynamic_variables
Dynamic Variables · object | null
required

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

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

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

metadata
Metadata · object | null
required

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