アクションを定義する（Dialogflow）

アクションは、呼び出しと検出を定義するアプリへのエントリポイントです。必要があります。アクションは、アクションパッケージと呼ばれる JSON ファイルで宣言します。後でテストやテストを行う場合にデベロッパープロジェクトにアップロードする承認を受けるためにアクションプロジェクトを送信します。アクションパッケージはは、Actions プロジェクトのアクションを定義します。

アクションパッケージでアクションを定義するには、まずアクションをアクションが呼び出されたときに対応するフルフィルメントエンドポイントインテントがトリガーされます。作成できるアクションには、次のタイプがあります。

デフォルトのアクション: すべての Actions プロジェクトには、ウェルカムインテントを実装する必要があります。ユーザーが会話を始めるための入り口として利用できます。ウェルカムインテントは、ユーザーがアクションの名前を発話して明示的に呼び出すとトリガーされます（（例: 「OK Google, ExampleAction と話して」）。このウェルカムインテントは、 actions.intent.MAIN インテント名。
ディープリンクのための追加のアクション: 以下の場所で追加のアクションを作成できます。自分で定義したインテントを含むアクションパッケージ。これによりユーザーはインテントと一緒にアクション名を指定することで特定の機能を呼び出す（例: 「OK Google, ExampleAction に話しかけて靴を探して」）。

詳細については、インテントと呼び出しをご覧ください。これらの呼び出しモデルが機能します

デフォルトのアクションを定義する

すべてのアクションパッケージには、特定のアクションのアクションを actions.intent.MAIN インテント。このインテントはユーザーが名前によるアクション（例: 「OK Google, ExampleAction と話して」）。

action.json という名前のボイラープレートアクションパッケージファイルを生成するには、手順は次のとおりです。

gactions CLI をダウンロードします。
アクションプロジェクトのソースファイル用のローカルディレクトリを作成します。
ターミナルで次のコマンドを実行します。
```
$ cd PROJECT_DIRECTORY
$ gactions init
```

アクションパッケージファイルが生成されたら、プレースホルダのコンテンツを使用できます。ExampleAction に変更を加えた action.json の例を次に示します。

{
  "actions": [
    {
      "description": "Default welcome intent",
      "name": "MAIN",
      "fulfillment": {
        "conversationName": "ExampleAction"
      },
      "intent": {
        "name": "actions.intent.MAIN",
        "trigger": {
          "queryPatterns": [
            "talk to ExampleAction"
          ]
        }
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  },
  "locale": "en"
}

追加のアクションを定義する

エントリポイントとなる追加のアクションを指定できます。これによりユーザーはユーザーが何を行うかを詳しく指定できるようにすることで、ユーザーの意図を明確にします。（例: 「OK Google, ExampleAction に話しかけて靴」など）。

追加のアクションを定義するには:

actions 配列で、すべてのエントリポイントにアクションを指定します。
たとえば、次のコードは、追加の「buy」という以下を定義するアクション: <ph type="x-smartling-placeholder">
- com.example.ExampleAction.BUY というインテント名
- parameters: このインテントがトリガーされたときにユーザー入力から解析します。これは、アクションフレーズの特定のデータが必要なときにユーザーがアクションを呼び出します。
- queryPatterns: インテントをトリガーするために必要なユーザーの呼びかけを定義します。クエリパターンには Schema.org タイプを含めることができる引数を定義します。
```
{
  "description": "Direct access",
  "name": "BUY",
  "fulfillment": {
    "conversationName": "ExampleAction"
  },
  "intent": {
    "name": "com.example.ExampleAction.BUY",
    "parameters": [
      {
        "name": "color",
        "type": "org.schema.type.Color"
      }
    ],
    "trigger": {
      "queryPatterns": [
        "find some $org.schema.type.Color:color sneakers",
        "buy some blue suede shoes",
        "get running shoes"
      ]
    }
  }
}
      
```

注: インテントごとに queryPatterns のフレーズを 10 個ほど設定することをおすすめします。これらのクエリパターンは、アクションのランキングと検出のために Google によって使用されます。これらはアクションの機能を表しており、ユーザーがアクションを呼び出したくなるかもしれません。

conversationName を指定して、このインテントのフルフィルメントを指定します。これは conversations オブジェクトのアイテムに対応します。
```
{
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  }
}
    
```

これがアクションパッケージ全体の例です。

{
  "actions": [
    {
      "description": "Default welcome intent",
      "name": "MAIN",
      "fulfillment": {
        "conversationName": "ExampleAction"
      },
      "intent": {
        "name": "actions.intent.MAIN",
        "trigger": {
          "queryPatterns": [
            "talk to ExampleAction"
          ]
        }
      }
    },
    {
      "description": "Direct access",
      "name": "BUY",
      "fulfillment": {
        "conversationName": "ExampleAction"
      },
      "intent": {
        "name": "com.example.ExampleAction.BUY",
        "parameters": [
          {
            "name": "color",
            "type": "org.schema.type.Color"
          }
        ],
        "trigger": {
          "queryPatterns": [
            "find some $org.schema.type.Color:color sneakers",
            "buy some blue suede shoes",
            "get running shoes"
          ]
        }
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  },
  "locale": "en"
}