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

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

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

version
AgentVersionMeta · object | null

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