Panoramica della build
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Per creare Azioni conversazionali, devi creare e implementare i seguenti componenti:
- Progetto Azioni: il contenitore logico per tutte le tue
Azioni conversazionali, i tuoi servizi web e le tue app web. Definisce inoltre le impostazioni e le risorse del progetto che descrivono come eseguire il deployment del progetto in Azioni su Google.
- Modello di invocazione: definisce il modo in cui gli utenti scoprono e avviano le
azioni all'interno del tuo progetto. Il modello di invocazione viene creato con
intent e tipi.
- Modello di conversazione: definisce cosa possono dire gli utenti alle tue
azioni e come rispondono le tue azioni agli utenti. Il modello conversazionale
viene creato con intent, tipi, scene e
prompt.
- Webhook: le azioni possono attivare webhook per delegare
logica aggiuntiva ai tuoi servizi di evasione, come la generazione di prompt,
la convalida dei dati e altro ancora.
- Interactive Canvas: anziché inviare semplici risposte di testo o schede e immagini avanzate, puoi fornire un'app web interattiva a schermo intero basata su HTML, CSS e JavaScript.
Le seguenti sezioni descrivono gli strumenti che utilizzerai per creare le Azioni.
Azioni
L'API Actions è un insieme di strumenti per sviluppatori per la creazione di azioni per l'Assistente Google. È composto dalle seguenti funzionalità:
Una rappresentazione aperta e basata su file di un progetto Actions: crea i tuoi modelli di invocazione e conversazione con intent, tipi, scene e prompt. Puoi modificare i tuoi progetti
di Azioni con il tuo editor di testo preferito, eseguirne il controllo della sorgente, creare
processi automatizzati e altro ancora.
Un'interfaccia a riga di comando (CLI): lo
strumento gactions
fornisce una CLI per avviare e
automatizzare lo sviluppo delle tue Azioni. Consente di inizializzare i file di progetto Action standard, eseguire il push degli aggiornamenti nella console di Actions, implementare i progetti Action e altro ancora. Lo strumento ti consente di eseguire molti flussi di lavoro comuni, ad esempio importare
progetti esistenti o iniziare a lavorare su un ramo di funzionalità utilizzando il tuo sistema di controllo della sorgente preferito.
API Actions: l'API Actions è la stessa API utilizzata dallo strumento gactions
. L'API Actions fornisce un elenco di endpoint REST per
gestire le tue azioni, anche per i test e la creazione. L'API ti consente di utilizzare
richieste JSON per eseguire molti flussi di lavoro comuni. Quando
utilizzi l'API Actions, devi
tenere in considerazione determinati limiti e best practice.
Webhook e libreria di fulfillment Node.js: le tue Azioni possono delegare
la logica di business ai tuoi servizi web con webhook e un formato di messaggistica
basato su JSON. Forniamo una libreria di fulfillment Node.js che fornisce interfacce idiomatiche per il
webhook di conversazione. Questa libreria semplifica l'implementazione di molti flussi utente comuni. Ad esempio, alcune funzionalità includono
l'estrazione di parametri da una query utente e la generazione di un'esperienza multimodale
(solo voce e voce e immagini) per l'Assistente Google.
Actions Builder
Actions Builder ti offre un IDE potente, facile da usare e basato sul web che è
integrato nella console Actions. Poiché Actions Builder è basato sulle stesse tecnologie dell'API Actions, puoi utilizzarlo da solo o insieme all'API Actions, a seconda delle tue esigenze.
L'interfaccia utente di Actions Builder è suddivisa nelle seguenti aree:
- Il menu in alto consente di accedere alle diverse aree della console di Actions,
mentre puoi accedere ad Actions Builder nella scheda Sviluppa.
- Il menu a sinistra ti consente di accedere a tutti i componenti per creare Azioni, come
intent e scene.
- L'area di build ti consente di creare il componente su cui stai lavorando.
- L'area dei dettagli ti consente di configurare ulteriori dettagli sul componente su cui stai lavorando.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-24 UTC.
[null,null,["Ultimo aggiornamento 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."]]