내장 인텐트 (BII)를 사용하면 앱에서 처리 기능을 표현할 수 있습니다.
Google에 문의하기 shortcuts.xml 파일에서 기능을 선언하고
매핑함으로써 인텐트 매개변수를 fulfillment에 매핑하면
Google 어시스턴트가 응답하여 특정 화면에 앱을 실행하도록
사용자가 작업을 완료할 수 있습니다.
내장 인텐트는 앱 카테고리에 따라 그룹화됩니다. 각 카테고리는 사용자가 앱에서 자주 실행하려는 일련의 일반적인 작업을 나타냅니다. 사용 가능한 BII, 매개변수, 예시의 전체 목록
테스트에 사용할 수 있는 쿼리는 내장 인텐트 참조에 있습니다.
많은 BII에는 특정 배포 요구사항이 있으며
추천을 제공합니다 이러한 요구사항과 권장사항은 앱이 다음과 같은 이점을 제공하는 데 도움이 됩니다.
최상의 경험을 할 수 있도록 돕는 것입니다.
그림 1. 음성으로 START_EXERCISE BII 호출
어시스턴트에 쿼리를 요청해 보세요
앱 작업의 경우 기능을 선언하고 BII 매개변수를 처리합니다.
shortcuts.xml 파일에 추가합니다. BII를 구현하고
다음 단계를 따르세요.
선택한 BII를 사용하여 capability를 선언합니다.
추가하려는 각 BII 필드에 중첩된 parameter 요소를 추가합니다.
targetClass 또는 targetPackage를 사용하는 경우 Android에 매핑합니다.
extras 인텐트를 가져옵니다.
딥 링크 URL을 사용하는 경우 쿼리에 이름이 지정된 매개변수를 사용합니다.
URL 템플릿의 문자열입니다.
BII 매개변수를 처리하려면 BII 매개변수를
capability에 있는 명시적 Android 인텐트의 상응하는 매개변수입니다.
그런 다음 앱에서 그 가치를 사용할 수 있습니다. 앱에서
BII 매개변수 하지만 '권장됨'으로 표시된 데이터 필드를 처리하세요.
내장 인텐트 참조에서 확인하세요.
각각 고유한 세트의 집합을 갖는 여러 인텐트 처리를 정의할 수 있습니다.
권장 매개변수입니다. Google은 다음에 따라 적절한 처리를 선택합니다.
기능 매개변수를 사용하여 사용자의 쿼리와 선언된
인텐트에 포함됩니다.
예를 들면 다음과 같습니다. actions.intent.START_EXERCISE
인텐트는 앱에서 exercise.name BII 매개변수를 처리하도록 권장하지만
매개변수 없이 앱에서 BII를 구현할 수 있습니다.
이 작업을 수행하면 구체적인
운동 이름(예: "Example App에 운동 추적을 시작하도록 요청")
이
다음 스니펫에는 필수 매개변수가 없는 처리로의 대체가 있습니다.
매개변수가 사용자의 쿼리에 포함되지 않은 경우:
Google 어시스턴트는 사용자에게 가장 관련성 높은 정보를 제공하기 위해
앱에 매개변수 값을 반환할 때 사용자에게 적용됩니다. 예를 들어
예시 레스토랑의 모바일 앱에서 피자를 주문할 때
볼 수 있습니다 사용자에게 더 나은 서비스를 제공하기 위해 어시스턴트가 위도를 제공할 수 있습니다.
앱에 가장 가까운 Example Restaurant의 경도 값을 반환합니다.
추가 요구사항으로, 앱에서 직접 실행되는
사용자의 실제 상태를 수정하는 작업 (예:
송금, 주문, 메시지 전송)이 있으면 먼저
작업을 수행할 수 있습니다.
명확성
<url-parameter> 또는 인텐트 추가 항목을 통해 앱에 전달된 인수는
고유하게 식별할 수 있습니다. 이 경우
인수 값을 검색 인수로 사용하고 사용자를 검색으로 이동
확인할 수 있습니다. 적절한 항목을 명확하게 구분하고 선택할 수 있습니다.
예를 들어 사용자의 검색어가 '예시 식당에서 주문'이라고 하면
BII ORDER_MENU_ITEM을 사용하는 경우 사용자에게
이름이 "Example Restaurant"과 일치하는 음식점
언어 및 언어 지원
각 앱 작업 BII에서 개발 및 테스트에 지원되는 언어
내장 인텐트 참조에 나열되어 있습니다. 일부 BII에는
개발자 테스트 및 어시스턴트에서 사용자 트리거를 위한 언어 지원
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Built-in intents for App Actions\n\nBuilt-in intents (BIIs) allow your app to express its fulfillment capabilities\nto Google. By declaring capabilities in your [shortcuts.xml](https://developer.android.com/guide/app-actions/action-schema) file and\nmapping intent parameters to the fulfillment, you make it possible for\nGoogle Assistant to launch your app to a specific screen in response to a\nquery, so the user can complete a task. \n\nBuilt-in intents are grouped according to app categories. Each category\nrepresents a set of common tasks that users frequently want to perform on their\napps. The full list of available BIIs, their parameters, and example\nqueries usable for testing is in the [built-in intent reference](/reference/app-actions/built-in-intents).\n\nMany BIIs have specific deployment requirements and\nrecommendations. These requirements and recommendations help your app deliver\nthe best possible experience to your users. \n**Figure 1.** Invoke the `START_EXERCISE` BII with a voice query to Assistant. \n**Figure 2.** Launch the app to a specific screen to begin the `START_EXERCISE` task. \n**Figure 3.** Display a [widget](/guide/app-actions/widgets) in response to a query.\n\n\n---\n\nImplement BIIs and handle intent parameters\n-------------------------------------------\n\nFor App Actions, you declare capabilities and handle BII parameters\nin your [shortcuts.xml](https://developer.android.com/guide/app-actions/action-schema) file. To implement a BII and handle its\nparameters, follow these steps:\n\n1. Declare the `capability` with the chosen BII.\n2. Add nested `parameter` elements for each BII field you want to add.\n 1. If you use `targetClass` or `targetPackage`, map them to the Android intent `extras` using a name you choose.\n 2. If you use a deep link URL, use the named parameters in the query string of the URL template.\n\nTo handle a BII parameter, map the BII parameter to the\ncorresponding parameter of an explicit Android intent in your `capability`.\nThen, you can use its value in your app. Your app is not required to handle\nBII parameters. However, do attempt to handle data fields marked as \"Recommended\"\nin the [built-in intent reference](/reference/app-actions/built-in-intents).\n\nYou can define multiple intent fulfillments, each with its own set of\nrecommended parameters. Google selects the appropriate fulfillment based on the\ncapability parameters it identifies from the user's query and the ones declared\nin an intent.\n\nFor example, the [`actions.intent.START_EXERCISE`](/reference/app-actions%20built-in-intents/health-and-fitness/start-exercise)\nintent recommends that your app handle the `exercise.name` BII parameter, but you\ncan implement the BII in your app with no parameters.\nYou might do this if you want to handle user queries without the specific\nexercise name, like *\"Ask Example App to start tracking exercise.\"*\n\nThe\nfollowing snippet has a fallback to a fulfillment with no required parameters\nif the parameters are not included in the user's query: \n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cshortcuts xmlns:android=\"http://schemas.android.com/apk/res/android\"\u003e\n\n \u003ccapability android:name=\"actions.intent.START_EXERCISE\"\u003e\n \u003cintent\n android:action=\"android.intent.action.VIEW\"\n android:targetClass=\"com.example.myapplication.Activity1\"\n android:targetPackage=\"com.example.myapplication\"\u003e\n \u003cparameter\n android:name=\"exercise.name\"\n android:key=\"exerciseType\"\n android:required=\"true\"\n /\u003e\n \u003c/intent\u003e\n \u003cintent\n android:action=\"android.intent.action.VIEW\"\n android:targetClass=\"com.example.myapplication.Activity2\"\u003e\n \u003c/intent\u003e\n \u003c/capability\u003e\n \u003c/shortcuts\u003e\n\nGoogle Assistant does its best to provide the most relevant information to\nthe user when returning parameter values to your app. For example, user queries\nfor ordering pizza from Example Restaurant's mobile app don't always include a\nlocation. To better serve the user, Assistant might provide the latitude\nand longitude values of the nearest Example Restaurant to that app.\n\nAs an additional requirement, you don't want your app to directly perform an\naction that modifies a user's real-world state (for example, transferring\nmoney, placing an order, or sending a message) without first confirming the\naction with the user.\n\n\n| **Note:** App Actions, like all Actions that support built-in intents, trigger on a number of factors, including quality and relevancy to the user's request. Based on those factors, Google may exercise discretion in surfacing your Action in response to user requests.\n\n\u003cbr /\u003e\n\nDisambiguation\n--------------\n\nArguments passed to your app via `\u003curl-parameter\u003e` or intent extras might not\nuniquely identify the item that you want to show to the user. In this case,\nuse the argument value as a search argument and take the user to the search\npage of the app. They can disambiguate and choose the right item.\n\nFor example, if a user's query is *\"Order from Example Restaurant\"* for the\nBII `ORDER_MENU_ITEM`, you can present to the user a list of\nrestaurants whose names match the term `\"Example Restaurant\"`.\n\nLanguage and locale support\n---------------------------\n\nThe locales supported for development and testing by each App Action BII\nare listed in the [built-in intent reference](/reference/app-actions/built-in-intents). Some BIIs have different\nlocale support for developer testing and for user triggering from Assistant."]]
