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

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

agent_id
string<uuid>
required

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

manual_id
string<uuid>
required

메뉴얼 UUID입니다. GET /v3/agents/{agent_id}/manuals 응답의 manual_id를 사용합니다.

Response

성공 응답

메뉴얼 1건입니다. 본문의 참조와 진단을 함께 담습니다.

name
string
required

메뉴얼 이름입니다. 최대 128자입니다.

Maximum string length: 128
trigger
string
required

메뉴얼을 불러올 대화 상황입니다. 비워 두면 다른 메뉴얼이 참조할 때만 불러옵니다.

content
string
required

메뉴얼 본문입니다. 공백을 포함해 최대 8,096자이며 @tool:@manual: 참조를 담을 수 있습니다.

Maximum string length: 8096
agent_id
string
required

에이전트 UUID입니다.

manual_id
string
required

메뉴얼 UUID입니다.

head_revision
integer
required

현재 편집본의 리비전입니다. 다음 쓰기 요청의 expected_head_revision으로 보냅니다.

built_in_tools
(EndCallTool · object | TransferCallTool · object | TransferAgentTool · object | SendSmsTool · object | SendDtmfTool · object | SearchAddressTool · object | SkillTool · object)[]

이 메뉴얼의 빌트인 도구 목록입니다. 본문에서 @tool:{name}으로 참조합니다. 각 name은 고유한 식별자([a-zA-Z_][a-zA-Z0-9_]*)여야 합니다.

통화 종료 built-in 도구 설정입니다.

config
Config · object

메뉴얼 설정입니다. 옵션은 tool_call_sound 하나이며, 메뉴얼을 불러온 직후 재생할 실행 대기음입니다.

references
References · object

본문에서 찾은 참조입니다. manual_ids, tool_ids(커스텀 도구), built_in_names로 나눠 담습니다.

diagnostics
Diagnostics · object[]

이 메뉴얼에서 발견된 진단 목록입니다. 각 항목에 code, severity, manual_id, path, reference, message가 담깁니다.