組み込みインテントは、アクションが特定のカテゴリのユーザー リクエストを処理できることをアシスタントに伝えるために指定できる一意の識別子です。組み込みインテントを使用すると、ユーザーはプロジェクトの表示名を使用せずにアクションを呼び出すことができます。一致するアクションを見つけるために、Google アシスタントは、構成済みのインテントのいずれかの呼び出しフレーズに似たことをユーザーがリクエストしているかどうか、またはアクションが適切な状況にいるかどうかを判別します。
以下に、アシスタントが組み込みインテントと照合するユーザークエリの例を示します。
- 「ゲームをプレイ」組み込みインテント: 「OK Google,記憶ゲームをする」
- 「新しいことを教えて」組み込みインテント: 「OK Google。新しいことを教えて」
- 「Storytelling」組み込みインテント: 「OK Google。「おやすみの物語を聞かせて」
アシスタントは、アクションの検出中に、アクションに関するメタデータ（指定した組み込みインテントなど）を使用して、そのアクションをユーザーにおすすめします。会話のラウンドトリップを最小限に抑えるため、アシスタントはユーザークエリからパラメータをスキャンし、アクションに渡すことも試みます。
Actions SDK を使用してアクションを開発する場合は、組み込みインテントを利用するために、バージョン 3.1.0 以降の gactions バイナリを使用していることを確認してください。
呼び出しパラメータ
一部の組み込みインテントには、検出のためにアクションをさらに分類するためのパラメータ値があります。たとえば、ストーリーテリングの組み込みインテントには、ジャンル パラメータ値があります。ユーザーは、「OK Google。アドベンチャーのストーリーを教えて」
特定のパラメータ値の詳細については、ストーリーテリングと説明のセクションをご覧ください。
Play ゲームの組み込みインテント
Play ゲームの組み込みインテントを使用すると、アシスタント ユーザーが「OK Google, OK Google, ゲームをする」
アシスタント ゲームの開発とガイダンスについて詳しくは、Google アシスタントのゲーム設計ガイドをご覧ください。
設定
Play ゲームの組み込みインテントをセットアップする手順は次のとおりです。
- Actions Console に移動します。
- [新しいプロジェクト] をクリックし、プロジェクト名を入力して、[プロジェクトを作成] をクリックします。
ストーリーテリングの組み込みインテント
ストーリーテリングの組み込みインテントによってアクションが登録され、「OK Google,プリンセスのストーリーを教えて」
ストーリーテリング アクションでは、次のガイドラインに沿う必要があります。
- アクションがストーリーテリングの主となる音声としてテキスト読み上げに依存していません
- アクションは画面の有無にかかわらず楽しめます
- アクションはファミリー向けである必要があります
呼び出しパラメータ
ストーリーテリングの組み込みインテントの呼び出しパラメータは、ユーザーがストーリーを聞くリクエストに含めることができるジャンルを表します。以下のパラメータを使用すると、リクエストしたジャンルで見つけてもらいやすくなります。
| Genre（Actions Builder） | パラメータ値（SDK） |
|---|---|
| 冒険 | ADVENTURE |
| おやすみ時間 | BEDTIME |
| ファンタジー | FANTASY |
| インタラクティブ | INTERACTIVE |
| お姫様 | PRINCESS |
設定
ストーリーテリングの組み込みインテントをセットアップする手順は次のとおりです。
- Actions Console に移動します。
- [新しいプロジェクト] をクリックし、プロジェクト名を入力して、[プロジェクトを作成] をクリックします。
教育の組み込みインテント
教育向けの組み込みインテントは、Google アシスタントから「OK Google, 新しいことを教えてくれませんか。」
教育関連アクションは、以下の大まかなガイドラインに従う必要があります。
アクションは教えたり学習を支援することを目的とする必要があります。
アクションが広告や人材募集のツールを対象としていない
アクションがスキルと知識に焦点を当てる
アクションが確立されたスキルと知識を習得する
アクションが教えている情報が、意見や時事問題の結果に基づいたものではない
呼び出しパラメータ
教育の組み込みインテントの呼び出しパラメータは、ユーザーがリクエストに含めることができる学習トピックを表します。これらのパラメータを使用すると、リクエストした学習トピックで見つけてもらいやすくなります。
| 学習トピック（アクション ビルダー） | パラメータ値（SDK） |
|---|---|
| 新しい言語を学びましょう | LANGUAGE |
| 自然界について詳しく知る | WORLD |
| 新しいスキルを習得 | SKILL |
| 家族で学ぶ | FAMILY |
設定
教育の組み込みインテントを設定する手順は次のとおりです。
- Actions Console に移動します。
- [新しいプロジェクト] をクリックし、プロジェクト名を入力して、[プロジェクトを作成] をクリックします。