스킬셋 답변 생성

Classic/VPC 환경에서 이용 가능합니다.

특정 스킬셋의 API를 호출하여 적절한 답변을 생성합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

헤더

헤더에 대한 설명은 다음과 같습니다.

경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

바디

요청 바디의 각 필드에 대한 설명은 다음과 같습니다.

구문

구문 예시는 다음과 같습니다.

curl --location --request POST 'https://clovastudio.stream.ntruss.com/testapp/v1/skillsets/{skillset-id}/versions/{version}/final-answer' \
--header 'X-NCP-CLOVASTUDIO-API-KEY: <X-NCP-CLOVASTUDIO-API-KEY>' \
--header 'X-NCP-APIGW-API-KEY: <X-NCP-APIGW-API-KEY>' \
--header 'X-NCP-CLOVASTUDIO-REQUEST-ID: <X-NCP-CLOVASTUDIO-REQUEST-ID>' \
--header 'Content-Type: application/json'
--data '{  
    "query": "내일 서울 날씨는 어때?",
    "tokenStream": true
    "chatHistory": [
                                {
                                    "role": "user",
                                    "content": "오늘 날씨 어때?"
                                 },
                                {
                                    "role": "assistant",
                                    "content": "폭풍전야입니다."
                                 }
                             ]
    }'

응답

응답 형식을 설명합니다.

헤더

헤더에 대한 설명은 다음과 같습니다.

바디

바디의 각 필드에 대한 설명은 다음과 같습니다.

구문

구문 예시는 다음과 같습니다.

{
  "status": {
    "code": "20000",
    "message": "OK"
  },
  "result": {
    "finalAnswer": "내일 서울 날씨는 맑음이며, 온도는 약 27도 정도로 예상됩니다.",
    "tokenCount": 1032,
    "apiResult": [
      {
        "url": "http://api.kcisa.kr/openapi/service/rest/convergence/conver8?serviceKey=247c5de7-556d-41bf-af3e-875e039e4f5c&numOfRows=1&keyword=판교",
        "requestBody": "string",
        "responseBody": "string",
        "apiOrder": 1,
        "operationId": "searchHotel",
        "nameForHuman": "V1ReviewSearch"
      }
    ]
  }
}

응답 스트림

각 이벤트를 하나씩 출력하도록 응답 스트리밍을 사용할 수 있습니다. 응답 스트리밍 형식을 설명합니다.

헤더

헤더에 대한 설명은 다음과 같습니다.

바디

바디의 각 필드에 대한 설명은 다음과 같습니다.

Token Event

토큰 스트리밍을 사용하는 경우 Token Data에 대한 설명은 다음과 같습니다.

구문

구문 예시는 다음과 같습니다.

{
    "status": {
        "code": "20000",
        "message": "OK"
    },
    "result": {
        "finalAnswer": "서울에 있는 호텔을 추천해 드리겠습니다.\n\n1. Luxury Hotel(4.0) - 서울특별시 중랑구 제일동 13-1\n2. Grand Resort(5.0) - 서울특별시 중구 문안동 12-1\n3. Movenpick Hotel(4.0) - 서울 광진구 워커힐로 120",
        "apiResult": [
            {
                "url": "https://free-api-0601.herokuapp.com/search_reviews_get?address=서울",
                "requestBody": "address=서울",
                "responseBody": "{\"hotels\": [{\"review_id\": 1, \"review_date\": \"20230811\", \"reviewer\": \"JohnDoe\", \"rating\": 4.0, \"content\": \"호텔은 좋은데 이상한 냄새가 납니다.\", \"hotel_name\": \"Luxury Hotel\", \"address\": \"서울특별시 중랑구 제일동 13-1\", \"room_name\": \"Deluxe Suite\", \"good_cnt\": 10, \"bad_cnt\": 2, \"rating_service\": 5.0, \"rating_clean\": 4.0, \"rating_room\": 4.0}, {\"review_id\": 2, \"review_date\": \"20230810\", \"reviewer\": \"JaneSmith\", \"rating\": 5.0, \"content\": \"방 안에 커피포트도 없고 주위에 커피를 파는곳도 없어요. 그거 빼고는 다 만족합니다.\", \"hotel_name\": \"Grand Resort\", \"address\": \"서울특별시 중구 문안동 12-1\", \"room_name\": \"Ocean View Room\", \"good_cnt\": 15, \"bad_cnt\": 0, \"rating_service\": 5.0, \"rating_clean\": 5.0, \"rating_room\": 5.0}, {\"review_id\": 5, \"review_date\": \"20230809\", \"reviewer\": \"ClaudeCalder\", \"rating\": 4.0, \"content\": \"사우나, 수영장 등 부대시설이 없어서 아쉬웠지만 가격이 저렴해서 좋았어요. 근처에 지하철역도 있고 편의점도 있어서 접근성이 좋아요. 잠시 머물기엔 딱 입니다.\", \"hotel_name\": \"Movenpick Hotel\", \"address\": \"서울 광진구 워커힐로 120\", \"room_name\": \"City View\", \"good_cnt\": 9, \"bad_cnt\": 0, \"rating_service\": 3.0, \"rating_clean\": 4.0, \"rating_room\": 4.0}], \"test\": \"test\"}",
                "operationId": "searchHotel",
                "nameForHuman": "V1ReviewSearch",
                "apiOrder": 1
            }
        ],
        "useTask": false,
        "tokenCount": 3524
    }
}