Visão geral do build
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para criar ações de conversação, você cria e implanta os seguintes componentes:
- Projeto do Actions: o contêiner lógico para todas as suas
ações de conversa, serviços da Web e apps da Web. Ele também define as configurações e os recursos do projeto que descrevem como implantar seu projeto no Actions on Google.
- Modelo de invocação: define como os usuários descobrem e iniciam as
ações no seu projeto. Você cria seu modelo de invocação com
intenções e tipos.
- Modelo de conversa: define o que os usuários podem dizer às suas
ações e como elas respondem aos usuários. Você cria seu modelo conversacional com intents, tipos, cenas e comandos.
- Webhooks: as ações podem acionar webhooks para delegar
lógica adicional aos seus serviços de atendimento, como gerar comandos,
validar dados e muito mais.
- Tela interativa: em vez de enviar respostas de texto simples ou cards e imagens avançados, você pode oferecer um app da Web interativo em tela cheia com tecnologia HTML, CSS e JavaScript.
As seções a seguir descrevem as ferramentas que você vai usar para criar ações.
Ações
A API Actions é um conjunto de ferramentas para desenvolvedores que permite criar ações para o Google Assistente. Ele consiste nos seguintes recursos:
Uma representação aberta, baseada em arquivos, de um projeto do Actions: crie seus modelos de invocação e conversa com intentos, tipos, cenas e comandos. É possível editar seus projetos do Actions
com seu editor de texto favorito, verificar o controle de origem, criar
processos automatizados e muito mais.
Uma interface de linha de comando (CLI): a
ferramenta gactions
oferece uma CLI para inicializar e
automatizar o desenvolvimento das suas ações. Com ela, é possível inicializar arquivos de projeto de ação padrão, enviar atualizações para o Console do Actions, implantar projetos de ação e muito mais. Com ela, é possível realizar muitos fluxos de trabalho comuns, como importar
projetos atuais ou começar a trabalhar em uma ramificação de recurso usando seu sistema de
controle de origem favorito.
API Actions: é a mesma API usada pela ferramenta
gactions
. A API Actions fornece uma lista de endpoints REST para
gerenciar suas ações, inclusive para testes e criação. Com a API, é possível usar
solicitações JSON para realizar muitos fluxos de trabalho comuns. Ao
usar a API Actions, há
alguns limites e práticas recomendadas que você precisa considerar.
Webhooks e uma biblioteca de fulfillment do Node.js: suas ações podem delegar
lógica de negócios aos serviços da Web com webhooks e um formato de mensagens
baseado em JSON. Fornecemos uma biblioteca de fulfillment do Node.js que oferece interfaces idiomáticas para o
webhook de conversa. Essa biblioteca facilita a implementação de muitos fluxos de usuários comuns. Por exemplo, alguns recursos incluem
extrair parâmetros de uma consulta do usuário e gerar uma experiência multimodal
(somente voz e voz e recursos visuais) para o Google Assistente.
Actions Builder
O Actions Builder oferece um IDE baseado na Web poderoso e fácil de usar, integrado ao console do Actions. Como o Actions Builder é criado com as
mesmas tecnologias da API Actions, você pode usar o recurso sozinho ou com
a API Actions, dependendo das suas necessidades.
A interface do Actions Builder é dividida nas seguintes áreas:
- O menu superior dá acesso às diferentes áreas do console do Actions, e você pode acessar o Actions Builder na guia Desenvolver.
- O menu à esquerda permite acessar todos os componentes para criar ações, como
intents e cenas.
- A área de build permite criar o componente em que você está trabalhando.
- Na área de detalhes, é possível configurar mais informações sobre o componente em que você está
trabalhando.
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-24 UTC.
[null,null,["Última atualização 2025-07-24 UTC."],[[["\u003cp\u003eConversational Actions are built using an Actions project, an invocation model, a conversation model, webhooks, and optionally Interactive Canvas.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize the Actions API, which includes an open file-based project representation, a command-line interface, a REST API, and webhook support with a Node.js library.\u003c/p\u003e\n"],["\u003cp\u003eActions Builder provides a web-based IDE within the Actions console, offering a user-friendly interface for building and managing conversational actions, integrated with the Actions API.\u003c/p\u003e\n"]]],[],null,["# Build overview\n\nTo build Conversational Actions, you create and deploy the following components:\n\n- **[Actions project](/assistant/conversational/build/projects)** - The logical container for all of your Conversational Actions, web services, and web apps. It also defines project settings and resources that describe how to deploy your project to Actions on Google.\n- **[Invocation model](/assistant/conversational/build/invocation)** - Defines how users discover and start the Actions inside your project. You build your invocation model with [intents](../intents) and [types](../types).\n- **[Conversation model](/assistant/conversational/build/conversation)** - Defines what users can say to your Actions and how your Actions respond to users. You build your conversational model with [intents](../intents), [types](../types), [scenes](../scenes), and [prompts](../prompts).\n- **[Webhooks](../webhooks)** - Actions can trigger webhooks to delegate additional logic to your fulfillment services, like generating prompts, validating data, and more.\n- **[Interactive Canvas](/assistant/interactivecanvas)** - Instead of sending simple text responses or rich cards and images, you can deliver a full-screen, interactive web app powered by HTML, CSS, and JavaScript.\n\nThe following sections describe the tools that you'll use to build Actions.\n\n### Actions\n\nThe Actions API is a set of developer tools for building Actions for the\nGoogle Assistant. It consists of the following features:\n\n- **An open, file-based representation of an Actions project** - Build your\n invocation and conversation models with\n [intents](/assistant/conversational/intents),\n [types](/assistant/conversational/types),\n [scenes](/assistant/conversational/scenes), and\n [prompts](/assistant/conversational/prompts). You can edit your Actions\n projects with your favorite text editor, check them into source control, build\n automated processes, and more.\n\n- **A command-line interface (CLI)** - The\n [`gactions` tool](/assistant/actionssdk/gactions) provides a CLI to bootstrap and\n automate development of your Actions. It lets you initialize standard Action\n project files, push updates to the Actions console, deploy Action projects,\n and more. The tool lets you perform many common workflows, such as importing\n existing projects or starting work on a feature branch using your favorite\n source control system.\n\n- **The Actions API** - The Actions API is the same API used by\n the `gactions` tool. The Actions API provides a list of REST endpoints to\n manage your Actions, including for testing and building. The API lets you use\n JSON requests to perform many common workflows. When\n [using the Actions API](/assistant/actions/api) there are\n certain limits and best practices that you should consider.\n\n- **Webhooks and a Node.js fulfillment library** - Your Actions can delegate\n business logic to your web services with webhooks and a JSON based messaging\n format. We provide a Node.js fulfillment library that provides idiomatic interfaces for the\n [Conversation Webhook](/assistant/conversational/webhooks). This library makes it\n easy to implement many common user flows. For example, some features include\n extracting parameters from a user query and generating a multimodal experience\n (voice only and voice and visuals) for Google Assistant.\n\n### Actions Builder\n\nActions Builder gives you a powerful and easy-to-use, web-based IDE that's\nintegrated into the Actions console. Since Actions Builder is built on the\nsame technologies as the Actions API, you can use it on its own or together with\nthe Actions API depending on your needs. \n\nThe Actions Builder UI is split into the following areas:\n\n1. The top menu provides access to the different areas of the Actions console, and you can access Actions Builder on the **Develop** tab.\n2. The left menu lets you access all the components to build Actions, like intents and scenes.\n3. The build area lets you build the component you're working on.\n4. The details area lets you configure more details about the component you're working on."]]