[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eBuilt-in intents help users discover and invoke your Google Assistant Action without needing to know its specific name, enabling actions to be triggered by common user phrases like "Play a game" or "Teach me something new".\u003c/p\u003e\n"],["\u003cp\u003eUsing built-in intents increases the visibility of your Action during discovery by allowing Google Assistant to recommend it based on user queries related to categories like games, storytelling, or education.\u003c/p\u003e\n"],["\u003cp\u003eBuilt-in intents may include invocation parameters, like genres for storytelling or topics for education, providing users with more specific ways to discover and interact with your Action based on their interests.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize built-in intents, developers using the Actions SDK need to ensure they are using version 3.1.0 or higher of the \u003ccode\u003egactions\u003c/code\u003e binary.\u003c/p\u003e\n"],["\u003cp\u003eActions utilizing certain built-in intents and parameters, especially those related to storytelling and family-oriented content, must adhere to the Actions for Families program guidelines and content restrictions.\u003c/p\u003e\n"]]],[],null,["# Built-in intents\n\nA 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.\n\nFor example, here are some user queries that Assistant matches to built-in\nintents:\n\n- **\"Play game\" built-in intent** : *\"Ok Google. Play a memory game\"*\n- **\"Teach me something new\" built-in intent** : *\"Ok Google. Teach me something new\"*\n- **\"Storytelling\" built-in intent** : *\"Ok Google. Tell me a bedtime story\"*\n\nDuring [Action discovery](/console/analytics#discovery), Assistant can use metadata about\nyour Action, including the built-in intents you've specified, to recommend your\nAction to users. To minimize conversational round-trips, Assistant also attempts\nto scan parameters from the user queries and pass them on to your Action.\n\nIf you develop your Action using the Actions SDK, make sure you're using version 3.1.0 or higher of the [gactions binary](/assistant/actionssdk/gactions#install_the_gactions_command-line_tool) to utilize built-in intents.\n| **Note:** Action Discovery through built-in intents is only available in English.\n\nInvocation parameters\n---------------------\n\nCertain built-in intents have parameter values that are used to further\ncategorize your Action for discovery. For example, the storytelling built-in\nintent has genre parameter values. Users can include these values in their query\nto Assistant, by making requests like *\"Ok Google. Tell me an **adventure** story\"*.\n\nSee the [storytelling](#storytelling) and [educational](#education) sections for details on specific parameter values.\n\nPlay Game built-in intent\n-------------------------\n\nThe Play Game built-in intent grants your Action additional discoverability to Assistant users who make requests like *\"Okay Google. Play a game.\"*\n\nFor more information on Assistant game development and guidance, see [Game design guide for Google Assistant](/assistant/games/guide).\n\n### Set up\n\nActions Builder Actions SDK\n\nTo set up the Play Game built-in intent, follow these steps:\n\n1. Go to the [Actions console](https://console.actions.google.com/).\n2. Click **New project** , enter a project name, and click **Create project**.\n\n\u003cbr /\u003e\n\nStorytelling built-in intent\n----------------------------\n\nThe storytelling built-in intent registers your Action for additional storytelling discovery through Assistant requests like *\"Okay Google. Tell me a **princess** story.\"*\n\nStorytelling Actions should follow these high-level guidelines:\n\n- Your Action **doesn't rely on text-to-speech as the primary storytelling voice**\n- Your Action should **be enjoyed with or without a screen**\n- Your Action must **be family friendly**\n\n| **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).\n\n### Invocation parameters\n\nInvocation 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:\n\n| Genre (Actions Builder) | Parameter value (SDK) |\n|-------------------------|-----------------------|\n| Adventure | `ADVENTURE` |\n| Bedtime | `BEDTIME` |\n| Fantasy | `FANTASY` |\n| Interactive | `INTERACTIVE` |\n| Princess | `PRINCESS` |\n\n| **Note:** All storytelling genres require [Actions for Families registration](/assistant/actions-for-families) and cannot be used in conjunction with non-AFF built-in intents/parameters.\n\n### Set up\n\nActions Builder Actions SDK\n\nTo set up the storytelling built-in intent, follow these steps:\n\n1. Go to the [Actions console](https://console.actions.google.com/).\n2. Click **New project** , enter a project name, and click **Create project**.\n\nEducation built-in intent\n-------------------------\n\nThe educational built-in intent registers your Action for additional education discovery through Assistant requests like *\"Okay Google. Teach me something new.\"*\n\nEducational Actions should follow these high-level guidelines:\n\n- Your Action should **aim to teach or assist in learning**\n\n- Your Action is **not intended for advertisements or recruitment tools**\n\n- Your Action **focuses on skills and knowledge**\n\n- Your Action **teaches well-established skills and knowledge**\n\n- The information your Action teaches is **not opinion-based or the result of current events**\n\n| **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.\n\n### Invocation parameters\n\nInvocation 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:\n\n| Learning topic (Actions Builder) | Parameter value (SDK) |\n|------------------------------------|-----------------------|\n| Learn a new language | `LANGUAGE` |\n| Learn more about the natural world | `WORLD` |\n| Learn a new skill | `SKILL` |\n| Learn with family | `FAMILY` |\n\n| **Note:** The **Learn with family** topic requires [Actions for Families registration](/assistant/actions-for-families), and cannot be used in conjunction with other learning topics or non-AFF built-in intents/parameters.\n\n### Set up\n\nActions Builder Actions SDK\n\nTo set up the educational built-in intent, follow these steps:\n\n1. Go to the [Actions console](https://console.actions.google.com/).\n2. Click **New project** , enter a project name, and click **Create project**."]]
