インテリジェントモニタリング 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 のバイト数で 256 KiB に制限され、生成結果、下書き、および保存時の検証と一致します。 |
パラメータ補足説明¶
デフォルトでは SSE ストリーミングで Copilot POST /runs（stream=true）を呼び出し、StreamEvent JSON を透過的に渡します。最終結果は終端状態の data.response にあります。 stream=false の場合は同期 JSON の content RunResponse を保持し、モニターの保存や有効化は行いません。 succeeded かつ result が空の場合も上流のレスポンスを保持し、呼び出し側はステップ内の理由を読み取ります。ストリーム開始前の失敗はエラーを返し、ストリーム断絶後に終端状態を受信していない場合は未完了と見なされます。 X-Smart-Monitor-Generation-Id はストリーミングレスポンスヘッダーで事前に割り当てられ、成功した終端状態かつ有効な YAML の場合にのみ 24 時間の下書きが生成されます。中断、失敗、空の結果は保存できません。 OpenAPI では有効な V2 YAML を直接送信してモニターを作成でき、生成インターフェースを呼び出す必要はありません。言語とワークスペースのアイデンティティはサーバー側で制約されます。