목적

저장된 학습용 질문·답변 데이터를 기준으로 답변을 조회하고, AI를 한 번 호출하여 답변을 정리한 뒤 반환합니다. stream 값에 따라 일반 JSON 또는 SSE 스트림으로 받을 수 있습니다.

URL

<https://api.sidetalk.ai/v1/knowledge/completions>

HTTP 메서드

POST

요청 본문

knowledgeId 또는 question 중 하나는 전달해야 합니다. 두 값을 모두 전달하면 knowledgeId를 우선 사용합니다.

요청 예시

knowledgeId로 조회하는 요청

curl -X POST "<https://api.sidetalk.ai/v1/knowledge/completions>" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_KEY}" \
  -d '{
    "knowledgeId": "456",
    "stream": false
  }'

기존 세션으로 요청

curl -X POST "<https://api.sidetalk.ai/v1/knowledge/completions>" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_KEY}" \
  -d '{
    "knowledgeId": "456",
    "sessionId": "943f15db-3984-4f21-ad64-f0115839c3a6",
    "stream": false
  }'

성공 응답(200 OK)

{
  "success": true,
  "knowledgeId": "456",
  "sessionId": "943f15db-3984-4f21-ad64-f0115839c3a6",
  "message": {
    "content": "배송은 결제 후 2~3일 이내에 진행됩니다."
  },
  "recommended_questions": [
    {
      "knowledgeId": "3356",
      "question": "배송 조회는 어떻게 하나요?",
      "type": "chat_data"
    }
  ],
  "meta": {
    "chat_log_uuid": "uuid",
    "knowledgeId": "456",
    "sessionId": "943f15db-3984-4f21-ad64-f0115839c3a6",
    "latency_ms": 850,
    "used_credit": 1,
    "tokens": {
      "input_tokens": 100,
      "output_tokens": 30,
      "total_tokens": 130,
      "token_cost": 0
    }
  }
}

오류 응답