Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Un progetto Azioni pacchettizza tutte le azioni in un unico container. Tu
pubblica questo progetto su Actions on Google in modo che l'Assistente Google sappia come scoprire
e richiamare le tue esperienze di conversazione.
Figura 1. Struttura del progetto Actions.
Puoi usare i seguenti componenti di basso livello per creare il tuo progetto Actions:
Le impostazioni e le risorse definiscono i metadati di progetto
e risorse come le icone di progetto. Google utilizza queste informazioni per pubblicare
le tue Azioni alla directory dell'assistente, in modo che gli utenti possano rilevare e richiamare
che li rappresentano.
Gli intent rappresentano un'attività da eseguire, ad esempio
input dell'utente o un evento di sistema che deve essere elaborato. Il tipo più comune di
l'intent che utilizzerai sono gli intenti dell'utente. Questi intent ti consentono di dichiarare
Frasi che vengono espanse in modo naturale dalla NLU (comprensione del linguaggio naturale)
per includere molte altre frasi simili. La NLU utilizza l'aggregazione
queste frasi per addestrare un modello linguistico che l'assistente utilizza per abbinare
di testo. Durante una conversazione, se un input utente corrisponde alla lingua dell'intent
modello, il runtime dell'assistente invia l'intent all'azione, in modo che possa
elaborarlo e rispondere all'utente.
I tipi ti consentono di estrarre dati strutturati dall'input degli utenti. Di
Annotando frasi di addestramento con tipi, la NLU può estrarre pertinenti, strutturati
i dati, in modo da non dover analizzare l'input a risposta aperta.
Gli intent di processo delle scene e sono i principali esecutori logici per
le tue Azioni. Possono eseguire il riempimento degli slot, valutare la logica condizionale, restituire
i prompt all'utente e persino chiamare servizi web esterni per
la logica di business. In combinazione con gli intent, le scene sono uno strumento efficace per
rilevare input utente specifici o eventi di sistema e svolgere
logica.
I prompt definiscono le risposte statiche o dinamiche che utilizzi per
e rispondere agli utenti.
I webhook consentono di delegare il lavoro aggiuntivo ai servizi web
(fulfillment), ad esempio la convalida dei dati o la generazione di prompt. Le tue azioni
comunicare con il tuo fulfillment tramite un protocollo webhook basato su JSON.
Interactive Canvas ti consente di creare richiami
e coinvolgenti con le app web che utilizzano HTML, CSS e JavaScript.
Creare un progetto
Devi creare un progetto nella console di Actions prima di poter sviluppare
Assistente Google. Per creare un progetto:
Inserisci un nome per il progetto e fai clic su Crea progetto.
Nella schermata Che tipo di azione vuoi creare?, seleziona
una categoria che rappresenti al meglio il tuo progetto e fai clic su Avanti.
Nella schermata Come vuoi crearlo, seleziona un modo per creare
e fai clic su Inizia a creare. Ad esempio, puoi iniziare con uno spazio
progetto o con un campione.
di Gemini Advanced.
Definisci le informazioni del progetto
Le impostazioni e le risorse del progetto definiscono informazioni sul progetto,
funzioni e piattaforme, lingue supportate, nome visualizzato, descrizione,
loghi e altro ancora. La tabella seguente descrive le impostazioni e le risorse principali
che fornisci. Actions on Google utilizza questa opzione
per implementare e pubblicare il progetto
sull'Assistente Google
Google Cloud.
Nome
Descrizione
Informazioni sulla directory
Fornisce informazioni per consentire ad Actions on Google di pubblicare il tuo
progetto nella directory dell'assistente. Include metadati e descrizioni
sul tuo progetto e sulle risorse per le immagini per i loghi e le immagini dei banner.
Targeting per località
Consente di configurare le impostazioni internazionali in cui sono disponibili le azioni.
Capacità di superficie
Consente di configurare le piattaforme su cui sono disponibili le Azioni.
Dettagli dell'azienda
Specifica i dati di contatto della tua azienda.
Verifica del brand
Collega un sito web o un'app per Android di tua proprietà per ottenere vantaggi extra
come nomi di chiamata riservati e collegamenti a siti web all'interno delle Azioni.
Rilascia
Configura release di test e produzione diverse per l'azione
per i test e la produzione.
Link all'assistente
Consenti agli utenti di richiamare le azioni dalle tue proprietà web.
Per definire le informazioni del progetto:
Testa i progetti nel simulatore
La console di Actions fornisce un simulatore in cui visualizzare l'anteprima delle azioni. La
permette di vedere informazioni di debug, impostare funzionalità del dispositivo, simulare
impostazioni internazionali e altre impostazioni.
Figura 3. Le aree principali del simulatore: (1) input dell'utente,
(2) visualizzazione dei dispositivi, (3) opzioni e impostazioni e (4) log delle conversazioni.
[null,null,["Ultimo aggiornamento 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:"]]
