Action

작업은 작업 프로젝트에서 지원하는 특정 상호작용을 나타냅니다. 상호작용은 한 번에 완료할 수도 있고, 다단계일 수도 있습니다.

JSON 표현
{
  "name": string,
  "fulfillment": {
    object (Fulfillment)
  },
  "intent": {
    object (Intent)
  },
  "description": string,
  "signInRequired": boolean,
  "source": string
}
필드
name

string

액션의 이름입니다. 일반적인 Action on Google 인텐트('actions.'로 시작)를 사용하는 경우에도 이름을 제공해야 합니다. 예를 들어 'actions.intent.MAIN'을 사용하는 경우 인텐트를 사용하는 경우 규칙에 따라 작업 이름은 'MAIN'입니다. 작업 패키지는 하나 이상의 작업을 선언해야 합니다.

fulfillment

object (Fulfillment)

이 작업을 실행하는 방법

intent

object (Intent)

이 작업이 처리하는 인텐트입니다. 일반적인 Action on Google 인텐트의 이름은 'actions.'로 시작합니다. 대화형 에이전트의 작업 패키지에는 이름이 'actions.intent.MAIN'인 인텐트가 있어야 합니다. https://developers.google.com/actions/reference/rest/intents를 참고하세요.

description

string

작업의 기능에 관한 영어 설명 주로 Google에서 작업을 검토하거나 디버깅 목적으로 사용됩니다. 이 설명은 사용자에게 표시되지 않습니다. ASCII 문자 100자 미만이어야 합니다.

signInRequired

boolean

이 작업에 로그인이 필요한지 여부를 나타냅니다. ActionPackage 객체에 AccountLinking 속성이 지정된 경우에만 유효합니다.

source
(deprecated)

string

이 작업을 만든 도구의 문자열 식별자입니다.

처리

작업을 실행하는 방법

JSON 표현
{

  // Union field conversation can be only one of the following:
  "conversationName": string,
  "useDialogflowFulfillment": boolean
  // End of list of possible types for union field conversation.
}
필드

통합 필드 conversation.

conversation는 다음 중 하나여야 합니다.

conversationName

string

대화 처리를 통해 작업을 실행합니다. 여기에서 'name'은 ActionPackage.conversations 필드의 Conversations 필드입니다.

useDialogflowFulfillment

boolean

이 필드는dialogflow 처리를 사용할지 여부를 나타냅니다.

인텐트

인텐트 및 사용자의 쿼리를 일치시키는 데 사용되는 관련 쿼리 패턴 초기 트리거에 사용됩니다.

JSON 표현
{
  "name": string,
  "parameters": [
    {
      object (Parameter)
    }
  ],
  "trigger": {
    object (Trigger)
  }
}
필드
name

string

이 인텐트의 이름을 나타냅니다. 예: BOOK_A_TABLE. actions.로 시작하는 내장 인텐트일 수 있습니다. 이 경우 매개변수와 쿼리 패턴이 암시적이므로 무시됩니다.

parameters[]

object (Parameter)

queryPatterns의 매개변수 목록입니다. queryPatterns 내의 모든 매개변수를 지정해야 합니다.

trigger

object (Trigger)

이 인텐트의 트리거 사양입니다.

매개변수

쿼리 패턴 내에서 사용되는 매개변수입니다. queryPatterns의 매개변수를 구조화된 표현으로 나타냅니다 (예: $Color:color).

JSON 표현
{
  "name": string,
  "type": string
}
필드
name

string

매개변수의 이름입니다. 예: color

type

string

매개변수입니다. 작업 패키지의 일부로 선언된 일반 유형 또는 맞춤 유형일 수 있습니다(예: Color

트리거

트리거 사양입니다.

JSON 표현
{
  "queryPatterns": [
    string
  ]
}
필드
queryPatterns[]

string

지정된 인텐트를 식별하는 데 사용되는 패턴의 목록입니다. 쿼리 패턴은 매개변수 필드에 선언된 매개변수만 참조해야 합니다.