Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Aby użytkownicy mogli korzystać z Twojej akcji, muszą ją wywołać. W wielu przypadkach użytkownicy będą mieli na myśli konkretną akcję, więc poproszą Asystenta Google o interakcję z nią. Jeśli zaprojektujesz akcję tak, aby wykonywała konkretne, przydatne zadania, Asystent może ją polecać użytkownikom, gdy będzie ona najlepszą dostępną akcją w odpowiedzi na ich zapytanie.
W sekcjach poniżej znajdziesz opis różnych typów wywołań i dowiesz się, jak najlepiej zaprojektować działanie z myślą o odkrywaniu.
Typy wywołań
Istnieją 2 rodzaje wywoływania działania:
Jawne wywołanie ma miejsce, gdy użytkownicy mówią Asystentowi, że chcą użyć Twojej akcji. Masz największą kontrolę nad tym, jak użytkownicy wywołują Twoją akcję, ale musisz poinformować ich, jakie frazy rozpoczynają rozmowę z nią. Sekcja Zapytaj Asystenta na liście akcji w katalogu to dobre miejsce, aby przekazać te informacje użytkownikom.
Przykład: „OK Google, porozmawiaj z Wayne's Bikes.”
Niejawne wywołanie ma miejsce, gdy Asystent decyduje się wywołać Twoją akcję bez podawania jej nazwy przez użytkowników. Najczęstszy przykład wywołania domyślnego to sytuacja, w której użytkownicy mówią Asystentowi, że chcą wykonać określone zadanie (podając fraze wywołania), a Asystent decyduje się wywołać Twoją akcję, ponieważ może zrealizować intencję użytkownika. Wywołanie niejawne umożliwia użytkownikom poznawanie i korzystanie z Twojej usługi bez specjalnego wysiłku, ale projektowanie usługi z uwzględnieniem naszych najlepszych praktyk zwiększa szanse na jej odkrycie.
Przykład: „OK Google, umów mnie na wizytę w serwisie rowerowym.”
Frazy wywołania
Fraza wywołania opisuje konkretną funkcję akcji. Gdy użytkownicy wywołują Twoją akcję, mogą użyć frazy wywołania, która może zawierać precyzyjny link do jednej z określonych funkcji akcji.
Przykłady fraz wywołania:
„co mam dziś założyć”
„kiedy odjeżdża następny autobus do $location”
„jaka jest aktualna cena złota”
„chcę medytować”
Użytkownicy mogą dołączać frazę wywołania na końcu wywołania jawnego lub używać jej samodzielnie w przypadku wywołania niejawnego. W obu przypadkach zadbaj o to, aby frazy wywołania były przydatne i dopasowane do celu działania. Zbyt ogólne frazy wywołania nie są przydatne dla użytkownika i zmniejszają widoczność i wykrywalność działania.
Oprócz wywoływania za pomocą Asystenta możesz też włączyć link do Asystenta w przypadku dowolnej ze swoich działań. Użytkownicy, którzy klikną ten link w przeglądarce internetowej lub mobilnej, zostaną przekierowani do Asystenta Google, gdzie rozpoczną rozmowę z daną czynnością.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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."]]
