대화형 작업이 2023년 6월 13일에 지원 중단되었습니다. 자세한 내용은
대화 작업 지원 중단을 참고하세요.
기기 작업 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google 어시스턴트 SDK를 사용하면 Google 어시스턴트를 자체 프로젝트에 삽입하여 Google Home과 유사하게 작동하도록 할 수 있습니다. 하지만 프로젝트에 Google Home에는 없는 고유한 하드웨어 기능이 있을 수 있습니다. 예를 들어 밝기와 색상 설정을 맞춤설정할 수 있는 고유한 LED 디스플레이가 있을 수 있습니다.
기기 작업은 개발하는 프로젝트에서 어시스턴트가 할 수 있는 작업을 확장하여 하드웨어 기능을 최대한 활용할 수 있도록 지원하는 도구 및 API 집합입니다.
기본 제공 기기 작업
Google에서는 조명, 가전제품, 카메라 등 일상적인 작업을 위한 다양한 일반 내장 기기 작업을 만들었습니다. 이러한 작업을 통해 Google 어시스턴트의 자연어 처리 기능을 활용하여 프로젝트를 제어할 수 있습니다. 예를 들어 조명이 있는 프로젝트는 다음과 같은 다양한 방법으로 켤 수 있습니다.
- Ok Google, 조명 켜 줘.
- Hey Google, 조명 켜 줘.
- Ok Google, 거실 조명 켜 줘.
다양한스마트 홈 특성
의 명령에 응답하는 자체 프로젝트를 만들 수 있습니다.
- Ok Google, 밝기를 50%로 설정해 줘.
- Hey Google, 온도를 37도로 설정해 줘.
맞춤 기기 작업
고유한 하드웨어에 맞게 맞춤 기기 작업을 만들 수도 있습니다. 이러한 작업의 경우 문법과 명령어를 정의합니다.
- Ok Google, 조명을 5번 깜박여 줘.
- Hey Google, 왼쪽으로 이동해 줘.
Google 어시스턴트 서비스를 사용하여 이러한 작업을 통합하는 방법을 자세히 알아보세요.
작동 방식
기기에 Google 어시스턴트 서비스에 액세스하기 위한 사용자 인증 정보와 함께 Google 어시스턴트 SDK가 설치되어 있습니다. 기기는 음성 요청(켜 줘.)을 전송하고 서비스에 기기의 온보드 LED를 켜 달라고 요청합니다.
또한 기기는 서비스가 요청에 대한 컨텍스트에서 가장 적절한 응답을 결정할 수 있도록 모델 및 기기 인스턴스 식별자를 전송합니다.
이 서비스는 자동 음성 인식 (ASR)을 사용하여 사용자가 말한 단어를 파악하고, 자연어 처리 (NLP)를 사용하여 이러한 단어에서 요청의 의미를 분석하고 이해하며, 기기 매칭을 사용하여 요청의 컨텍스트를 제공합니다. 이 컨텍스트는 기기에서 지원하는 작업과 이러한 작업을 충족하는 방법을 정의하므로 중요합니다.
그러면 서비스는 기기별 명령어와 함께 사용자에게 다시 말해지는 텍스트 (네.)로 응답합니다. 기기는 이 명령어를 처리하는 방법을 알고 있습니다. LED를 켜는 것이죠.

시작하기
프로젝트에 Google 어시스턴트를 삽입한 다음 기기 작업을 사용하여 고유한 기능을 추가하여 아이디어를 실현하세요. Google 어시스턴트 서비스를 사용하여 프로젝트를 개발할 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eThe Google Assistant SDK enables you to integrate the Google Assistant into your projects, similar to a Google Home, and leverage Device Actions to utilize unique hardware features.\u003c/p\u003e\n"],["\u003cp\u003eDevice Actions provide tools and APIs to extend the Assistant's capabilities, allowing your project to respond to voice commands for functionalities like lights, appliances, and cameras using built-in or custom actions.\u003c/p\u003e\n"],["\u003cp\u003eBuilt-in Device Actions cover common smart home features, while Custom Device Actions let you define unique voice commands and functionalities tailored to your specific hardware.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Assistant service utilizes Automatic Speech Recognition, Natural Language Processing, and device context to understand user requests and trigger corresponding actions on your device.\u003c/p\u003e\n"],["\u003cp\u003eYou can get started by embedding the Google Assistant into your project and adding custom functionalities with Device Actions using the provided resources and guides.\u003c/p\u003e\n"]]],[],null,["# Device Actions Overview\n\nWith the Google Assistant SDK, you can embed the Google Assistant into your\nown project, making it function similarly to a Google Home. However, your project\nmay have unique hardware capabilities that Google Home does not have: for\nexample, it may have a unique LED display with customizable brightness and\ncolor settings.\n\nDevice Actions are a set of tools and APIs that allow you to extend what\nthe Assistant can do, in the projects you develop, to take full potential of\ntheir hardware capabilities.\n\nBuilt-in Device Actions\n-----------------------\n\nGoogle has created a wide range of common built-in device actions for everyday\nthings, including lights, appliances, and cameras. With these actions, you can\nharness the power of the Google Assistant's natural language processing to\ncontrol your project. For example, a project with a light can be turned on in\ndifferent ways:\n\n- *Ok Google, turn on the light.*\n- *Hey Google, turn my light on.*\n- *Ok Google, turn on my living room light.*\n\nYou can create your own project that responds to commands for\nmany\n[smart home traits](/assistant/sdk/reference/traits)\nlike:\n\n- *Ok Google, set the brightness to 50%.*\n- *Hey Google, set the temperature to 98 degrees.*\n\nCustom Device Actions\n---------------------\n\nYou can also create custom device actions for your own unique hardware. For these\nactions, you define the grammar and commands:\n\n- *Ok Google, blink my light 5 times.*\n- *Hey Google, move left.*\n\nLearn more about incorporating these actions using the [Google Assistant service](/assistant/sdk/guides/service/python/extend/custom-actions).\n\nHow it works\n------------\n\nThe device has the Google Assistant SDK installed on it along with credentials for\naccessing the Google Assistant Service. The device sends out the spoken request\n(*Turn on.*) and asks the service to turn on the device's onboard LED.\nThe device also sends its model and device instance identifiers so the service\ncan determine how to best respond in context to the request.\n\nThe service uses Automatic Speech Recognition (ASR) to determine what words were\nspoken by the user, Natural Language Processing (NLP) to analyze and understand\nthe meaning of the request from these words, and device matching to provide context\nfor the request. This context is important because it defines the actions the\ndevice supports and how these actions should be fulfilled.\n\nThe service then responds with text that is spoken back to the user (*Sure.*)\nalong with the device-specific command. The device knows how to handle this\ncommand: it turns on its LED!\n\nGet started\n-----------\n\nBring your ideas to life by embedding the Google Assistant\ninto your project and then adding unique functionality with Device\nActions. You can develop your project [using the Google Assistant service](/assistant/sdk/guides/service/python)."]]