# Built-in intents

A built-in intent is a unique identifier that you can specify to tell Assistant that your Action can fulfill a specific category of user requests. Built-in intents let users invoke your Action without using your project's display name. To find matching Actions, Google Assistant determines if a user is asking to do something similar to an invocation phrase for one of your configured intents, or when the user is in a context where your Actions would be appropriate.

For example, here are some user queries that Assistant matches to built-in
intents:

- **"Play game" built-in intent** : *"Ok Google. Play a memory game"*
- **"Teach me something new" built-in intent** : *"Ok Google. Teach me something new"*
- **"Storytelling" built-in intent** : *"Ok Google. Tell me a bedtime story"*

During [Action discovery](https://developers.google.com/console/analytics#discovery), Assistant can use metadata about
your Action, including the built-in intents you've specified, to recommend your
Action to users. To minimize conversational round-trips, Assistant also attempts
to scan parameters from the user queries and pass them on to your Action.

If you develop your Action using the Actions SDK, make sure you're using version 3.1.0 or higher of the [gactions binary](https://developers.google.com/assistant/actionssdk/gactions#install_the_gactions_command-line_tool) to utilize built-in intents.

> [!NOTE]
> **Note:** Action Discovery through built-in intents is only available in English.

## Invocation parameters

Certain built-in intents have parameter values that are used to further
categorize your Action for discovery. For example, the storytelling built-in
intent has genre parameter values. Users can include these values in their query
to Assistant, by making requests like *"Ok Google. Tell me an **adventure** story"*.

See the [storytelling](https://developers.google.com/assistant/conversational/build/built-in-intents#storytelling) and [educational](https://developers.google.com/assistant/conversational/build/built-in-intents#education) sections for details on specific parameter values.

## Play Game built-in intent

The Play Game built-in intent grants your Action additional discoverability to Assistant users who make requests like *"Okay Google. Play a game."*

For more information on Assistant game development and guidance, see [Game design guide for Google Assistant](https://developers.google.com/assistant/games/guide).

### Set up

<button value="builder" default="">Actions Builder</button> <button value="sdk">Actions SDK</button>

To set up the Play Game built-in intent, follow these steps:

1. Go to the [Actions console](https://console.actions.google.com/).
2. Click **New project** , enter a project name, and click **Create project**.

<br />

## Storytelling built-in intent

The storytelling built-in intent registers your Action for additional storytelling discovery through Assistant requests like *"Okay Google. Tell me a **princess** story."*

Storytelling Actions should follow these high-level guidelines:

- Your Action **doesn't rely on text-to-speech as the primary storytelling voice**
- Your Action should **be enjoyed with or without a screen**
- Your Action must **be family friendly**

> [!NOTE]
> **Note:** As a part of the Actions for Families program, all stories must have appropriate content and follow the [AFF program guidelines](https://developers.google.com/assistant/console/policies/general-policies#actions_for_families).

### Invocation parameters

Invocation parameters for the storytelling built-in intent represent genres users can include in their request to hear a story. These parameters can improve your discovery in the requested genres:

| Genre (Actions Builder) | Parameter value (SDK) |
|---|---|
| Adventure | `ADVENTURE` |
| Bedtime | `BEDTIME` |
| Fantasy | `FANTASY` |
| Interactive | `INTERACTIVE` |
| Princess | `PRINCESS` |

> [!NOTE]
> **Note:** All storytelling genres require [Actions for Families registration](https://developers.google.com/assistant/actions-for-families) and cannot be used in conjunction with non-AFF built-in intents/parameters.

### Set up

<button value="builder" default="">Actions Builder</button> <button value="sdk">Actions SDK</button>

To set up the storytelling built-in intent, follow these steps:

1. Go to the [Actions console](https://console.actions.google.com/).
2. Click **New project** , enter a project name, and click **Create project**.

## Education built-in intent

The educational built-in intent registers your Action for additional education discovery through Assistant requests like *"Okay Google. Teach me something new."*

Educational Actions should follow these high-level guidelines:

- Your Action should **aim to teach or assist in learning**

- Your Action is **not intended for advertisements or recruitment tools**

- Your Action **focuses on skills and knowledge**

- Your Action **teaches well-established skills and knowledge**

- The information your Action teaches is **not opinion-based or the result of current events**

> [!NOTE]
> **Note:** An Action that includes intellectual property used in other educational contexts is not permitted. Your Action must be designed for teaching or learning purposes.

### Invocation parameters

Invocation parameters for the educational built-in intent represent learning topics users can include in their requests. These parameters can improve your discovery in the requested learning topics:

| Learning topic (Actions Builder) | Parameter value (SDK) |
|---|---|
| Learn a new language | `LANGUAGE` |
| Learn more about the natural world | `WORLD` |
| Learn a new skill | `SKILL` |
| Learn with family | `FAMILY` |

> [!NOTE]
> **Note:** The **Learn with family** topic requires [Actions for Families registration](https://developers.google.com/assistant/actions-for-families), and cannot be used in conjunction with other learning topics or non-AFF built-in intents/parameters.

### Set up

<button value="builder" default="">Actions Builder</button> <button value="sdk">Actions SDK</button>

To set up the educational built-in intent, follow these steps:

1. Go to the [Actions console](https://console.actions.google.com/).
2. Click **New project** , enter a project name, and click **Create project**.