Named entity recognition API 사용

recognize 메소드는 자연어 텍스트를 입력으로 분석하고 인식된 엔티티가 있는 JSON 오브젝트를 리턴합니다.

curl -X POST https://api.ibm.com/scassistant/bluerun/named-entities/na/recognize \
   --header 'Accept: application/json' \
   --header 'Content-Type: application/json' \
   --header 'X-IBM-Client-Id: <put Client-Id here>' \
   --header 'Authorization: Bearer <put JWT here>' \
   -d '{"text": "show me inventory for category pharma"}'

응답은 텍스트에서 찾은 이름 지정된 엔티티의 모든 멘션을 포함하는 JSON 오브젝트입니다.

{
  "category_name": {
    "value": "Pharma",
    "literal": "pharma",
    "confidence": 1,
    "location": [
      31,
      37
    ],
    "values": [
      "Pharma"
    ],
    "count": 1,
    "list": [
      {
        "value": "Pharma",
        "literal": "pharma",
        "confidence": 1,
        "location": [
          31,
          37
        ]
      }
    ]
  },
  "@category_name": "Pharma"
}

JSON 오브젝트의 키는 엔티티 유형 (예: category_name 또는 location_city) 에 해당하는 반면, 값은 JSON 오브젝트 자체이며 다음 필드를 포함합니다.

리터럴

입력 텍스트에서 엔티티의 발견된 멘션입니다.

값

엔티티의 정규화된 값 (예: Pharma 또는 San Francisco). 이 값은 GraphQL 조회에서 데이터를 가져오는 데 사용할 수 있습니다.

위치

문장에서 엔티티의 위치입니다.

신뢰도

신뢰수준을 나타내는 0-1범위의 숫자 값입니다. 값 1은 100% 확신합니다.

가치

모든 엔티티 값을 포함하는 문자열의 배열입니다.

수

서로 다른 엔티티 값의 수입니다.

목록

모든 엔티티 멘션이 있는 배열입니다.

values, count및 list 특성은 입력 텍스트에 동일한 엔티티 유형의 여러 멘션이 포함된 경우에 유용할 수 있습니다. 두 개 이상의 값을 예상하지 않는 경우 언급된 모든 값에 액세스하거나 후속 질문을 할 수 있습니다.

1. Watson Assistant에 로그인하십시오.
2. 대화 스킬로 이동하여 옵션을 클릭하십시오.
3. 웹훅 URL을 다음 recognize 엔드포인트로 설정하십시오.

   https://api.ibm.com/scassistant/bluerun/named-entities/na/recognize

4. 다음 헤더를 설정하십시오.
   웹훅의 헤더

   헤더 이름	헤더 값
   권한 부여	다음 값을 사용하십시오. Bearer $integrations.chat.private.jwt
   X-IBM®-Client-Id	사용자의 클라이언트 ID입니다.

입력에 동일한 엔티티 유형의 멘션이 두 개 이상 있는 경우 values 및 list 배열에서 둘 이상의 항목을 가져옵니다. 예를 들어, What's available in San Francisco and New York? 문장은 다음 엔티티를 포함하는 것으로 인식됩니다.

{
  "location_city": {
    "value": "San Francisco",
    "literal": "San Francisco",
    "confidence": 1,
    "location": [20, 33],
    "values": ["San Francisco", "New York"],
    "count": 2,
    "list": [
      {
        "value": "San Francisco",
        "literal": "San Francisco",
        "confidence": 1,
        "location": [20, 33]
      },
      {
        "value": "New York",
        "literal": "New York",
        "confidence": 1,
        "location": [38, 46]
      }
    ]
  },
  "@location_city": "San Francisco"
}