Method: projects.matchIntents

지정된 쿼리와 일치하는 인텐트를 찾습니다.

HTTP 요청

POST https://actions.googleapis.com/v2/{project=projects/*}:matchIntents

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
project

string

필수 항목입니다. 프로젝트 ID로 표시되는 테스트 중인 프로젝트 형식: projects/{project}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "query": string,
  "locale": string
}
필드
query

string

필수 항목입니다. 일반 텍스트로 된 사용자 쿼리입니다.
locale

string

필수 항목입니다. 쿼리를 평가하는 데 사용할 언어입니다(예: 'en'). 형식은 BCP 47을 따라야 합니다. https://tools.ietf.org/html/bcp47 https://developers.google.com/assistant/console/languages-locales에서 지원되는 언어 목록을 참고하세요.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

일치하는 인텐트를 찾기 위한 응답입니다.

JSON 표현 
{
  "matchedIntents": [
    {
      object (Intent)
    }
  ]
}
필드
matchedIntents[]

object (Intent)

일치하는 인텐트이며 관련성이 높은 인텐트부터 가장 낮은 인텐트 순서로 정렬됩니다. 일치하는 처음 50개만 반환됩니다.

인텐트

인텐트를 나타냅니다.

JSON 표현 
{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}
필드
name

string

필수 항목입니다. 마지막으로 일치된 인텐트의 이름입니다.
params

map (key: string, value: object (IntentParameterValue))

필수 항목입니다. 인텐트 일치의 일부로 식별된 매개변수를 나타냅니다. 식별된 매개변수의 이름을 사용자 입력에서 식별된 매개변수 값에 매핑합니다. 식별된 일치하는 인텐트에서 정의된 모든 매개변수가 여기에 나타납니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예를 들면 { "name": "wrench", "mass": "1.3kg", "count": "3" }입니다.
query

string

선택사항입니다. 이 인텐트와 일치하여 최종 사용자의 입력 또는 음성 입력입니다. 사용자 입력에 따라 인텐트가 일치할 때 채워집니다.