AI 채팅 질문 전송

지정한 AI 대화에 새 질문을 전송합니다. 호출 시 새 채팅이 생성되어 AI 어시스턴트가 응답을 처리하기 시작합니다. 응답 진행 상황은 AI 채팅 목록 조회 API를 통해 폴링하여 확인합니다.

필요 권한

사용자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d question="최근 1시간 동안 차단된 IP를 알려줘" \
     -d mode="auto" \
     -X POST \
     https://HOSTNAME/api/sonar/ai/conversations/a1b2c3d4-e5f6-7890-abcd-ef1234567890/chats

요청 매개변수

경로 매개변수

요청 본문 매개변수

정상 응답

{
  "guid": "c1d2e3f4-1234-5678-9abc-def012345678"
}

• guid (문자열): 생성된 채팅 GUID

오류 응답

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

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "question should be not null"
}

guid가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

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

대화가 존재하지 않거나 소유자가 아닌 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "cannot get conversation"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}