Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Un proyecto de acciones empaqueta todas tus acciones en un solo contenedor. Tú
publica este proyecto en Actions on Google para que Asistente de Google sepa cómo detectarlo
e invocar tus experiencias conversacionales.
Figura 1: Estructura del proyecto de acciones
Usa los siguientes componentes de bajo nivel para compilar tu proyecto de acciones:
La configuración y los recursos definen los metadatos del proyecto
y recursos, como íconos de proyectos. Google usa esta información para publicar
tus acciones al directorio del Asistente, de modo que los usuarios puedan descubrirlas e invocarlas
de ellos.
Los intents representan una tarea que se realizará, como algunas
una entrada del usuario o un evento
del sistema que necesita procesamiento. El tipo más común de
que usarás son las intents de usuario. Estos intents te permiten declarar el entrenamiento
frases que el CLN (comprensión del lenguaje natural) expande de forma natural
para incluir muchas más frases similares. La CLN usa la agregación de
estas frases para entrenar un modelo de lenguaje que el Asistente use
entrada. Durante una conversación, si alguna entrada del usuario coincide con el idioma del intent
el entorno de ejecución de Asistente envía el intent a tu acción para que pueda
procesarlo y responder al usuario.
Los tipos te permiten extraer datos estructurados de las entradas del usuario. De
anotando frases de entrenamiento con tipos, la CLN puede extraer datos relevantes,
datos por ti, de modo que no tengas que analizar entradas abiertas.
Las escenas procesan intents y son los principales ejecutores de lógica para
tus Acciones. Llenado de ranuras, evaluar la lógica condicional, mostrar
mensajes al usuario e incluso llamar a servicios web externos para
en la lógica empresarial. En combinación con los intents, las escenas te brindan una forma poderosa
detectar entradas del usuario o eventos del sistema específicos y llevar a cabo
lógica.
Las instrucciones definen las respuestas estáticas o dinámicas que usas para
responder a los usuarios.
Los webhooks te permiten delegar trabajo adicional a los servicios web
(entrega), como validar datos o generar instrucciones. Tus acciones
comunicarse con tu entrega a través de un protocolo webhook basado en JSON.
El lienzo interactivo te permite crear contenido
y experiencias inmersivas con aplicaciones web que utilizan HTML, CSS y JavaScript.
Crea un proyecto
Debes crear un proyecto en la Consola de Actions antes de poder desarrollar para
Asistente de Google Para crear un proyecto, sigue estos pasos:
Ingresa un nombre para el proyecto y haz clic en Crear proyecto.
En la pantalla What kind of Action do you want to build?, selecciona
la categoría que mejor represente a tu proyecto y haz clic en Next.
En la pantalla How do you want to build it, selecciona una forma de compilarlo.
y haz clic en Comenzar compilación. Por ejemplo, puedes comenzar con una cadena
proyecto o con una muestra.
Definir la información del proyecto
La configuración y los recursos de tu proyecto definen información sobre tu proyecto, como
compatibilidad con funciones y plataformas, configuraciones regionales admitidas, nombre visible, descripción,
logotipos y mucho más. En la siguiente tabla, se describen la configuración y los recursos principales
que usted proporciona. Actions on Google usa esto
específica para implementar y publicar tu proyecto en el Asistente
de la aplicación.
Nombre
Descripción
Información del directorio
Proporciona información para que Actions on Google pueda publicar tu
proyecto en el directorio del Asistente. Incluye metadatos y descripciones
sobre tu proyecto y tus recursos de imagen para logotipos e imágenes de banners.
Segmentación geográfica
Establece las configuraciones regionales en las que están disponibles tus Acciones.
Capacidades de la superficie
Configura las superficies en las que están disponibles tus acciones.
Datos de la empresa
Especifica la información de contacto de tu empresa.
Verificación de marca
Conecta un sitio web o una app para Android de tu propiedad para obtener beneficios adicionales
como nombres de invocación reservados y vínculos a sitios web en tus Acciones.
Lanzamiento
Configura diferentes versiones de prueba y producción para tu acción.
para las pruebas y la producción.
Vínculos de Asistente
Permite que los usuarios invoquen tus acciones desde tus propiedades web.
Para definir la información del proyecto:
Cómo probar proyectos en el simulador
La Consola de Actions proporciona un simulador para obtener una vista previa de tus acciones. El
el simulador te permite ver la información de depuración, configurar las capacidades del dispositivo, simular
la configuración regional y más.
Figura 3: Las principales áreas del simulador: (1) entrada del usuario,
(2) vista de dispositivo, (3) opciones y configuración, y (4) registro de conversaciones.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-26 (UTC)"],[[["\u003cp\u003eAn Actions project enables the creation of conversational experiences for Google Assistant by packaging all actions into a single container for publishing.\u003c/p\u003e\n"],["\u003cp\u003eBuilding an Actions project involves utilizing components such as intents, types, scenes, prompts, webhooks and more for defining user interactions and logic.\u003c/p\u003e\n"],["\u003cp\u003eDefining project information in the Actions console, including directory information, locales and surfaces, is crucial for publishing and deploying to the Assistant directory.\u003c/p\u003e\n"],["\u003cp\u003eThe Actions console simulator provides a comprehensive environment for testing projects with features such as debugging, device settings, and locale simulation.\u003c/p\u003e\n"]]],[],null,["# Build projects\n\nActions Builder Actions SDK \n\nAn Actions project packages all of your Actions into a single container. You\npublish this project to Actions on Google so Google Assistant knows how to discover\nand invoke your conversational experiences.\n**Figure 1**. Actions project structure\n\nYou use the following low-level components to build your Actions project:\n\n- [**Settings and resources**](#define_project_information) define project metadata\n and resources like project icons. Google uses this information to publish\n your Actions to the Assistant directory, so that users can discover and invoke\n them.\n\n- [**Intents**](../intents) represent a task to be carried out, such as some\n user input or a system event that needs processing. The most common type of\n intent you'll use are user intents. These intents let you declare training\n phrases that are naturally expanded by the NLU (natural language understanding)\n engine to include many more, similar phrases. The NLU uses the aggregation of\n these phrases to train a language model that the Assistant uses to match user\n input. During a conversation, if some user input matches the intent's language\n model, the Assistant runtime sends the intent to your Action, so that it can\n process it and respond to the user.\n\n- [**Types**](../types) let you extract structured data from user input. By\n annotating training phrases with types, the NLU can extract relevant, structured\n data for you, so you don't have to parse open-ended input.\n\n- [**Scenes**](../scenes) process intents and are the main logic executors for\n your Actions. They can do slot-filling, evaluate conditional logic, return\n prompts to the user, and even call on external web services to carry out\n business logic. In combination with intents, scenes give you a powerful way to\n detect specific user input or system events and to carry out corresponding\n logic.\n\n- [**Prompts**](../prompts) define static or dynamic responses that you use to\n respond back to users.\n\n- [**Webhooks**](../webhooks) let you delegate extra work to web services\n (fulfillment), such as validating data or generating prompts. Your Actions\n communicate with your fulfillment through a JSON-based, webhook protocol.\n\n- [**Interactive Canvas**](/assistant/interactivecanvas) lets you create rich\n and immersive experiences with web apps that utilize HTML, CSS, and JavaScript.\n\nCreate a project\n----------------\n\nYou must create a project in the Actions console before you can develop for\nGoogle Assistant. To create a project:\n\n1. Go to the [Actions console](//console.actions.google.com/).\n2. Click **New project**.\n3. Enter a name for your project and click **Create Project** .\n4. In the **What kind of Action do you want to build?** screen, select a category that best represents your project and click **Next**.\n5. In the **How do you want to build it** screen, select a way to build and click **Start building**. For example, you can start with an empty project or with a sample.\n\n| **Key Point:** If you are building for Interactive Canvas, follow these additional steps:\n|\n| 1. If you did not select the **Game** card on the **What type of Action\n| do you want to build?** screen, click **Deploy** in the top navigation. Under **Additional Information** , select the **Games \\& fun** category. Click **Save**.\n| 2. Click **Develop** in the top navigation of the Actions console.\n| 3. Click **Interactive Canvas** in the left navigation.\n| 4. Under **Does your Action use Interactive Canvas?** , select **Yes**.\n| 5. **Optional** : Enter your web app URL into the **Set your default web app URL** field. This action adds a default `Canvas` response with the URL field to your Main invocation.\n| 6. Click **Save**.\n\n\u003cbr /\u003e\n\nDefine project information\n--------------------------\n\n| **Note:** See the [Directory information](/assistant/console/directory-information) documentation for more details on how to manage project information.\n\nYour project's settings and resources define information about your project like\nfeature and surface support, supported locales, display name, description,\nlogos, and more. The following table describes the main settings and resources\nyou provide. Actions on Google uses this\ninformation to deploy and publish your project to the [Assistant\ndirectory](//assistant.google.com/explore).\n\n| Name | Description |\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Directory information | Provides information so that Actions on Google can publish your project to the Assistant directory. Includes metadata and desecriptions about your project and image resources for logos and banner images. |\n| Location targeting | Configures the locales that your Actions are available in. |\n| Surface capabilities | Configures the surfaces that your Actions are available on. |\n| Company details | Specifies contact information for your company. |\n| Brand verification | Connect a website or Android app that you own to gain extra benefits such as reserved invocation names and website linking within your Actions. |\n| Release | Configures different testing and production releases for your Action for testing and production. |\n| Assistant links | Let users invoke your Actions from your web properties. |\n\nTo define project information:\n\nTest projects in the simulator\n------------------------------\n\n| **Note:** See the [Actions simulator](/assistant/console/simulator) documentation for complete information about testing your projects.\n\nThe Actions console provides a simulator to preview your Actions in. The\nsimulator lets you see debug information, set device capabilities, simulate\nlocale, and more.\n**Figure 3.** The main areas of the simulator: (1) user input, (2) device view, (3) options and settings, and (4) conversation log.\n\nTo test a project:"]]
