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