Skip to main content
GET
에이전트 단건 조회

Authorizations

Authorization
string
header
required

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

Path Parameters

agent_id
string<uuid>
required

agent_id로 반환되는 에이전트 UUID입니다.

Query Parameters

version
string
default:current

조회할 버전 selector. "current" (default) · "production" · "v{n}".

Pattern: ^(current|production|v[1-9][0-9]*)$

Response

성공 응답

에이전트 단건 조회 응답. Summary + data·flow·flow_data·version.

create/update 응답은 AgentMutationResponse (validator 메시지 포함).

agent_id
string<uuid>
required

에이전트 UUID입니다.

name
string
required

에이전트 이름입니다. 버전 스냅샷을 조회하더라도 현재 최상위 이름을 반환합니다.

type
enum<string>
required

선택한 구성의 타입입니다. single_prompt 또는 flow입니다.

Available options:
single_prompt,
flow
created_at
integer
required

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

updated_at
integer
required

리소스 마지막 수정 시각입니다. unix milliseconds 형식입니다.

evaluate
boolean
default:false

현재 평가 설정입니다. 버전 스냅샷에는 포함되지 않습니다.

folder_id
string<uuid> | null

에이전트가 속한 폴더의 UUID입니다. 폴더에 속하지 않으면 null입니다.

folder_name
string | null

에이전트가 직접 속한 폴더의 이름입니다. 폴더에 속하지 않으면 null입니다.

folder_path
string | null

최상위 폴더부터 에이전트가 속한 폴더까지의 이름을 /로 이은 경로입니다(예: Sales / Outbound). 표시용이며 폴더를 식별할 때는 folder_id를 사용합니다. 폴더에 속하지 않으면 null입니다.

production_version
string | null

현재 게시된 production 버전입니다. 없으면 null입니다.

Pattern: ^v[1-9][0-9]*$
Example:

"v1"

data
AgentDataResponse · object

선택된 에이전트 설정 스냅샷입니다. 구조는 agent-schema/agent-data-response에 공개되어 있습니다.

flow_data
FlowData · object | null
deprecated

지원 종료 예정 필드입니다. 에이전트의 플로우 그래프를 예전 형식으로 담고 있으며, 기존 호환을 위해 유지됩니다. 읽기 전용이고, flow 에이전트에서는 값이 있고 single_prompt 에이전트에서는 null입니다. 새 통합은 flow를 사용하세요. 이 필드는 지원 종료 기간 이후 제거됩니다.

flow
Flow · object | null

에이전트의 플로우 그래프입니다. nodes를 edges로 연결하고, 각 edge가 분기 조건을 가집니다. flow 에이전트에서는 값이 있고 single_prompt 에이전트에서는 null입니다. 지원 종료 예정인 flow_data 대신 이 필드를 사용하세요. 정확한 형태는 flow-schema/flow-data 스키마 엔드포인트에 공개됩니다.

version
AgentVersionMeta · object | null

스냅샷 조회 시에만 populated (version=v{n} 또는 production).

head_revision
integer | null

현재 편집본의 리비전입니다. 고정 버전을 조회하면 null입니다.

flow_revision
integer | null

현재 Flow 리비전입니다. 프롬프트 에이전트이거나 고정 버전을 조회하면 null입니다.