Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Affinché gli utenti possano interagire con la tua azione, devono invocarla. In molti
casi gli utenti hanno in mente la tua azione specifica, quindi chiedono all'Assistente
Google di interagire con essa. Inoltre, se progetti l'azione
per svolgere attività specifiche e utili, l'assistente potrebbe consigliarla agli utenti
quando è l'azione migliore disponibile per la loro query.
Le sezioni seguenti spiegano i diversi tipi di invocazione e
descrivono il modo migliore per progettare l'azione tenendo presente la funzionalità di scoperta.
Tipi di chiamata
Esistono due tipi di invocazione di azioni:
L'invocazione esplicita si verifica quando gli utenti dicono all'assistente che
vogliono utilizzare esplicitamente la tua azione. Hai il massimo controllo sul modo in cui i tuoi
utenti richiamano esplicitamente la tua Azione, ma devi comunicare loro
quali frasi iniziano una conversazione con la tua Azione. La sezione Chiedi all'assistente nella scheda della directory dell'Azione è un buon posto per comunicare queste informazioni agli utenti.
Esempio: "Hey Google, parla con Wayne's Bikes".
L'invocazione implicita si verifica quando l'assistente sceglie di richiamare la tua
Azione senza che gli utenti la chiamino per nome. L'esempio più comune di
invocazione implicita si verifica quando gli utenti dicono all'assistente di voler svolgere
una determinata attività (pronunciando una frase di invocazione) e
l'assistente sceglie di invocare la tua azione per quell'attività perché può
soddisfare l'intent dell'utente. L'invocazione implicita consente agli utenti di scoprire
e utilizzare la tua Azione semplicemente svolgendo le loro attività quotidiane, ma progettare la tua
Azione tenendo presente le nostre best practice aumenta le
probabilità che venga scoperta.
Esempio: "Hey Google, prenota un appuntamento per riparare la mia bicicletta."
Frasi di chiamata
Una frase di invocazione descrive una funzione specifica dell'Azione. Quando gli utenti
richiamano la tua Azione, possono includere una frase di invocazione che può creare un link diretto
a una delle funzioni specifiche dell'Azione.
Ecco alcuni esempi di frasi di invocazione:
"cosa dovrei indossare oggi"
"quando passa il prossimo autobus per $location"
"qual è il prezzo attuale dell'oro"
"voglio meditare"
Gli utenti possono aggiungere una frase di invocazione alla fine di un'invocazione esplicita o
utilizzarla da sola per un'invocazione implicita. In entrambi i casi, assicurati di progettare
frasi di invocazione utili e specifiche per lo scopo della tua azione. Le frasi di invocazione troppo generiche non sono utili per l'utente e riducono la visibilità e la rilevabilità dell'azione.
Per ulteriori informazioni su invocazione, rilevamento e frasi di invocazione,
leggi le sezioni relative all'invocazione esplicita e implicita.
Link dell'assistente
Oltre all'invocazione tramite l'assistente, puoi anche attivare un
link dell'assistente per qualsiasi azione. Gli utenti che fanno clic su questo link in un browser web
o mobile vengono indirizzati all'Assistente Google, dove inizieranno
una conversazione con l'Azione specifica.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-24 UTC."],[[["\u003cp\u003eUsers can engage with your Action through explicit invocation by directly calling its name or implicit invocation where the Assistant suggests it based on user needs.\u003c/p\u003e\n"],["\u003cp\u003eDesigning your Action for specific tasks improves the chances of the Google Assistant recommending it to users, increasing its discoverability.\u003c/p\u003e\n"],["\u003cp\u003eInvocation phrases that describe the Action's functions can be used by users for either explicit or implicit invocation.\u003c/p\u003e\n"],["\u003cp\u003eUsing clear and specific invocation phrases is crucial for enhancing your Action's visibility and ensuring it is easily discovered by users.\u003c/p\u003e\n"],["\u003cp\u003eAssistant links offer an alternative way for users to access your Action by clicking a link in a web or mobile browser to initiate a conversation with the Assistant.\u003c/p\u003e\n"]]],[],null,["# Overview (Dialogflow)\n\nIn order for users to engage with your Action, they need to invoke it. In many\ncases users will have your specific Action in mind, so they ask the Google\nAssistant to interface with it. Additionally, as long as you design your Action\nto accomplish specific, helpful tasks, the Assistant may recommend it to users\nwhen it's the best available Action for their query.\n\nThe following sections explain the different types of invocation and\ndescribe how best to design your Action with discovery in mind.\n\nInvocation types\n----------------\n\nThere are two types of Action invocation:\n\n- **Explicit Invocation** occurs when users tell the Assistant that they\n explicitly want to use your Action. You have the most control over how your\n users explicitly invoke your Action, but you need to let your users know\n what phrases start a conversation with your Action. The **Ask Your\n Assistant** section on your Action's [directory listing](/assistant/directory) is a\n good place to relay this information to users.\n\n Example: \"*Hey Google, talk to Wayne's Bikes.*\"\n- **Implicit Invocation** occurs when the Assistant chooses to invoke your\n Action without users calling it by name. The most common example of an\n implicit invocation is when users tell the Assistant they want to accomplish\n a certain task (by stating an [invocation phrase](#invocation_phrases)), and\n the Assistant opts to invoke your Action for that task because it can\n fulfill the user's intent. Implicit invocation enables users to learn about\n and use your Action simply by going about their day, but designing your\n Action with our [best practices](/assistant/df-asdk/checklist) in mind improves the\n chances that it's discovered.\n\n Example: \"*Hey Google, book an appointment to fix my bike.*\"\n\n| **Note:** You don't have to choose between types of invocation for your Action. Users can always explicitly invoke your Action, but you should keep implicit invocation in mind during the design process so you can increase the odds that users discover your Action on their own.\n\nInvocation Phrases\n------------------\n\nAn invocation phrase describes a specific function of your Action. When users\ninvoke your Action, they may include an invocation phrase that can deep link\ninto one of your Action's specific functions.\n\nExamples of invocation phrases include:\n\n- \"*what should I wear today*\"\n- \"*when's the next bus to $location*\"\n- \"*what's the current price of gold*\"\n- \"*want to meditate*\"\n\nUsers can append an invocation phrase to the end of an explicit invocation or\nthem on their own for an implicit invocation. Either way, make sure to design\nuseful invocation phrases that are specific to your Action's purpose. Invocation\nphrases that are too generic aren't helpful to the user and reduce your Action's\nvisibility and discovery.\n\nFor more information about invocation, discovery, and invocation phrases,\nread [explicit](/assistant/df-asdk/discovery/explicit) and [implicit](/assistant/df-asdk/discovery/implicit) invocation.\n\nAssistant links\n---------------\n\nIn addition to invocation using the Assistant, you can also enable an\n[Assistant link](/assistant/engagement/assistant-links) for any of your Actions. Users who click on this link in a web\nor mobile browser are directed to the Google Assistant, where they'll start\na conversation with that specific Action."]]