에이전트 메뉴얼 수정
에이전트의 현재 편집본에 있는 메뉴얼을 부분 수정합니다. 생략한 필드는 유지되고, 필드에 null은 보낼 수 없습니다.
Authorizations
조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Path Parameters
agent_id로 반환되는 에이전트 UUID입니다.
메뉴얼 UUID입니다. GET /v3/agents/{agent_id}/manuals 응답의 manual_id를 사용합니다.
Body
수정할 메뉴얼 필드입니다. expected_head_revision 외에 한 개 이상 보내야 합니다.
메뉴얼 부분 수정 요청입니다. 메뉴얼 필드를 한 개 이상 보내야 합니다. 생략한 필드는 유지되고, null은 보낼 수 없습니다.
마지막으로 조회한 에이전트 head_revision입니다. 그 뒤 에이전트가 바뀌었으면 409 REVISION_CONFLICT를 반환합니다.
x >= 0메뉴얼 이름입니다. 최대 128자이며, 빈 이름은 보낼 수 없습니다.
128메뉴얼을 불러올 대화 상황입니다. 비워 두면 다른 메뉴얼이 참조할 때만 불러옵니다.
메뉴얼 본문입니다. 공백을 포함해 최대 8,096자이며 @tool:과 @manual: 참조를 담을 수 있습니다.
8096이 메뉴얼의 빌트인 도구 목록입니다. 보내면 목록 전체를 교체합니다. 각 name은 고유한 식별자여야 합니다.
통화 종료 built-in 도구 설정입니다.
- EndCallTool
- TransferCallTool
- TransferAgentTool
- SendSmsTool
- SendDtmfTool
- SearchAddressTool
- SkillTool
메뉴얼 설정입니다. 보낸 옵션만 바꾸고, 옵션 값에 null을 보내면 그 설정을 지웁니다.
Response
성공 응답
메뉴얼 1건입니다. 본문의 참조와 진단을 함께 담습니다.
메뉴얼 이름입니다. 최대 128자입니다.
128메뉴얼을 불러올 대화 상황입니다. 비워 두면 다른 메뉴얼이 참조할 때만 불러옵니다.
메뉴얼 본문입니다. 공백을 포함해 최대 8,096자이며 @tool:과 @manual: 참조를 담을 수 있습니다.
8096에이전트 UUID입니다.
메뉴얼 UUID입니다.
현재 편집본의 리비전입니다. 다음 쓰기 요청의 expected_head_revision으로 보냅니다.
이 메뉴얼의 빌트인 도구 목록입니다. 본문에서 @tool:{name}으로 참조합니다. 각 name은 고유한 식별자([a-zA-Z_][a-zA-Z0-9_]*)여야 합니다.
통화 종료 built-in 도구 설정입니다.
- EndCallTool
- TransferCallTool
- TransferAgentTool
- SendSmsTool
- SendDtmfTool
- SearchAddressTool
- SkillTool
메뉴얼 설정입니다. 옵션은 tool_call_sound 하나이며, 메뉴얼을 불러온 직후 재생할 실행 대기음입니다.
본문에서 찾은 참조입니다. manual_ids, tool_ids(커스텀 도구), built_in_names로 나눠 담습니다.
이 메뉴얼에서 발견된 진단 목록입니다. 각 항목에 code, severity, manual_id, path, reference, message가 담깁니다.