프롬프트 조회

지정한 AI 프롬프트의 상세 정보를 조회합니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/ai/prompts/a1b2c3d4-e5f6-7890-abcd-ef1234567890

요청 매개변수

경로 매개변수

정상 응답

{
  "prompt": {
    "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "로그 분석",
    "type": "qna",
    "prompt": "로그를 분석하여 이상 징후를 탐지하세요.",
    "description": "로그 분석용 프롬프트",
    "enabled": true,
    "builtin": false,
    "created": "2024-01-15 10:30:00+0900",
    "updated": "2024-01-15 10:30:00+0900"
  }
}

• prompt (객체): 프롬프트 정보
  • guid (문자열): 프롬프트 고유 식별자
  • name (문자열): 프롬프트 이름
  • type (문자열): 프롬프트 유형. plan, action, qna
  • prompt (문자열): 프롬프트 내용
  • description (문자열): 프롬프트 설명
  • enabled (불리언): 활성화 여부
  • builtin (불리언): 앱 내장 프롬프트 여부
  • created (문자열): 생성일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • updated (문자열): 수정일시 (yyyy-MM-dd HH:mm:ssZ 형식)

오류 응답

식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guid should be guid type."
}

프롬프트가 존재하지 않는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "prompt not found"
}