Visão geral das ações do dispositivo
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com o SDK do Google Assistente, é possível incorporar o Google Assistente ao seu
próprio projeto, fazendo com que ele funcione de maneira semelhante a um Google Home. No entanto, seu projeto pode ter recursos de hardware exclusivos que o Google Home não tem. Por exemplo, ele pode ter um display LED exclusivo com configurações de brilho e cor personalizáveis.
As ações de dispositivo são um conjunto de ferramentas e APIs que permitem estender o que
o Google Assistente pode fazer nos projetos que você desenvolve para aproveitar todo o potencial
dos recursos de hardware.
Ações integradas do dispositivo
O Google criou uma ampla variedade de ações comuns integradas para dispositivos para coisas do dia a dia, incluindo luzes, eletrodomésticos e câmeras. Com essas ações, você pode
aproveitar o poder do processamento de linguagem natural do Google Assistente para
controlar seu projeto. Por exemplo, um projeto com uma luz pode ser ativado de
diferentes maneiras:
- Ok Google, acenda a luz.
- Ok Google, acenda a luz.
- Ok Google, acenda a luz da sala de estar.
Você pode criar seu próprio projeto que responde a comandos para
muitos
traços de casa inteligente
como:
- Ok Google, defina o brilho em 50%.
- Ok Google, ajuste a temperatura para 36 graus.
Ações personalizadas do dispositivo
Você também pode criar ações personalizadas para seu próprio hardware exclusivo. Para essas
ações, você define a gramática e os comandos:
- Ok Google, pisque a luz cinco vezes.
- Ok Google, mova para a esquerda.
Saiba mais sobre como incorporar essas ações usando o serviço do Google Assistente.
Como funciona
O dispositivo tem o SDK do Google Assistente instalado, além das credenciais para
acessar o serviço do Google Assistente. O dispositivo envia o comando falado
(Ligue.) e pede ao serviço para acender o LED integrado do dispositivo.
O dispositivo também envia os identificadores do modelo e da instância para que o serviço
possa determinar a melhor forma de responder ao pedido no contexto.
O serviço usa o reconhecimento automático de fala (ASR) para determinar quais palavras foram ditas pelo usuário, o processamento de linguagem natural (PLN) para analisar e entender o significado do pedido com base nessas palavras e a correspondência de dispositivos para fornecer contexto ao pedido. Esse contexto é importante porque define as ações compatíveis com o dispositivo e como elas devem ser executadas.
Em seguida, o serviço responde com um texto que é falado para o usuário (Claro.)
junto com o comando específico do dispositivo. O dispositivo sabe como processar esse comando: ele acende o LED!
Primeiros passos
Dê vida às suas ideias incorporando o Google Assistente
ao seu projeto e adicionando funcionalidades exclusivas com as ações
de dispositivo. Você pode desenvolver seu projeto usando o serviço do Google Assistente.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]
