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

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