프롬프트 추가

새 AI 프롬프트를 추가합니다.

HTTP 요청

POST /api/sonar/ai/prompts
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     -d name="로그 분석" \
     -d type=qna \
     -d prompt="로그를 분석하여 이상 징후를 탐지하세요." \
     -X POST \
     https://HOSTNAME/api/sonar/ai/prompts
요청 매개변수
필수타입설명비고
nameO문자열프롬프트 이름
typeO문자열프롬프트 유형plan, action, qna 중 하나
promptO문자열프롬프트 내용
guidX문자열프롬프트 GUID36자 GUID. 미지정 시 자동 생성
descriptionX문자열프롬프트 설명

정상 응답

{
  "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "name should be not null"
}
프롬프트 유형이 올바르지 않은 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "type should be 'plan', 'action', or 'qna'"
}