지능형 모니터링 V2 YAML 생성¶
POST /api/v1/checker/smart_monitor/generate
개요¶
Body 요청 매개변수¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| stream | boolean | 기본값 true는 SSE를 반환하고, false는 동기 JSON을 반환합니다. |
|
| prompt | string | Y | 빈 문자열 허용: False |
| language | string | 선택 값: ['zh', 'zh-hant', 'en', 'id', 'ja', 'ko'] |
|
| checkerUUID | string | ||
| existingYaml | string | 현재 전체 YAML로, UTF-8 바이트 수 기준 256KiB로 제한되며 생성 결과, 초안 및 저장 검증과 일치합니다. |
매개변수 추가 설명¶
기본적으로 SSE 스트리밍 방식으로 Copilot POST /runs(stream=true)를 호출하며 StreamEvent JSON을 그대로 전달합니다. 최종 결과는 종료 상태의 data.response에 있습니다. stream=false는 동기 JSON 콘텐츠 RunResponse를 유지하며, 모니터를 저장하거나 활성화하지 않습니다. succeeded이고 result가 비어 있더라도 상위 응답을 유지하므로, 호출자는 단계에서 원인을 읽을 수 있습니다. 스트림 생성 전 실패는 오류를 반환하고, 스트림이 끊겨 종료 상태를 수신하지 못한 경우에는 미완료로 간주합니다. X-Smart-Monitor-Generation-Id는 스트리밍 응답 헤더에 미리 할당되며, 성공적인 종료 상태의 유효한 YAML에만 24시간 초안이 생성됩니다. 중단, 실패, 빈 결과는 저장할 수 없습니다. OpenAPI로 유효한 V2 YAML을 직접 제출하여 모니터를 생성할 수 있으며, 생성 인터페이스를 호출할 필요가 없습니다. 언어와 워크스페이스 식별 정보는 서버 측에서 제한됩니다.