Vytvořte vlastní akce pro Google Assistant: 12 kroků

2024 Autor: John Day | [email protected]. Naposledy změněno: 2024-01-30 08:21

Když jsem viděl potenciál Google Assistant, jak byl představen v Google I/O 18, stejně jako Volvo Cars v jejich informačním a zábavním systému, nemohl jsem odolat a vyzkoušet ho. Znovu jsem použil jeden ze svých starších projektů VasttraPi a propojil jej s Google Assistant. Pokud si chcete o projektu přečíst více, budu rád, když se podíváte na související článek na mém blogu: Vlastní akce pro Google Assistant.

V tomto Instructable procházíme kroky nezbytné pro spuštění vaší vlastní akce Google Assistant, která bude komunikovat s vaším serverem a bude vám mluvit zpět, přičemž bude uveden seznam nadcházejících odjezdů. Mějte na paměti, že sadu SDK nebudeme používat, protože ji spouštíme zcela v Asistentovi Google, nikoli v našem vlastním zařízení. Celkově to bude jednoduché. Vaše akce bude použitelná na zařízeních, která podporují Google Assistant, jako jsou telefony, tablety, domácí asistenti a nositelná zařízení, a dokonce ji můžete sdílet stejně jako s aplikací v Obchodě Play!

Jednou z hlavních výhod vytváření něčeho takového oproti používání služeb, jako je IFTTT, je to, že na svém serveru můžete vytvářet vlastní odpovědi, které bude číst Google Assistant. V IFTTT je komunikace, pokud jde o mě, jednosměrná.

Budou probrána následující témata:

• Vytvoření prvního akčního projektu
• Vytvoření vlastního záměru
• Vytvoření vlastní entity
• Nastavení webhooku pro splnění vaší akce
• Nastavení jednoduchého REST serveru napsaného v Pythonu s Flaskem, který poskytne odpovědi nebo „plnění“
• Testování vašeho akčního projektu
• Uvolnění vašeho akčního projektu

Zde nenajdete mnoho podrobností ani teorií o různých funkcích a konceptech Google Assistant. Pokud vás zajímají, důrazně doporučuji sledovat oficiální návod nebo se podívat na toto video.

Krok 1: Nastavte oprávnění k účtu Google

Než začneme, musíme zajistit, aby Google Assistant měl příslušná oprávnění.

1. Přejděte na Ovládací prvky aktivity

2. Ujistěte se, že jsou povoleny následující:

   1. Aktivita na webu a v aplikacích
   2. Informace o zařízení
   3. Hlasová a zvuková aktivita

Krok 2: Vytvořte svou akci

1. Přejděte do konzoly Actions Console a klikněte na „Přidat/importovat projekt“
2. Nazvěme tento projekt Actions „local-traffic-planner“.
3. Klikněte na „Vytvořit projekt“.
4. Na další stránce nevybírejte kategorii a klikněte na „Přeskočit“.
5. Nyní byste měli být na hlavní stránce konzoly akcí.

Krok 3: Vyvolání akce

Určete, jak chcete aktivovat Asistenta Google, aby zahájil vaši akci.

1. V části „Rychlé nastavení“klikněte na „Rozhodnout, jak bude vaše akce vyvolána“.
2. Nazvěte to „Můj místní plánovač provozu“a klikněte na „Uložit“.

3. Klikněte na výzvu „UPDATE SAMPLE INVOCATIONS“, která se objevila po kliknutí na save.

   Tuto možnost najdete také v části „Informace o adresáři“

4. Přidejte „Zeptejte se mého místního plánovače provozu“jako nové vyvolání a klikněte na „Uložit“.

Krok 4: Přidejte svou první akci

1. Klikněte na „Akce“na levé liště.
2. Klikněte na „PŘIDAT SVOU PRVNÍ AKCI“.
3. Vyberte „Vlastní záměr“a poté klikněte na „Vytvořit“.
4. Dostanete se na stránku Dialogflow, kde implementujete hlavní logiku.

Krok 5: Školení frází pro váš záměr

1. Vyberte si časové pásmo a klikněte na „Vytvořit“.
2. Na další stránce ponechte stávající záměry a klikněte na „VYTVOŘIT ZÁMĚR“.
3. Dejte záměru rozumný název, tj. „Odchody“.
4. Přejděte na „Tréninkové fráze“a klikněte na „Přidat cvičné fráze“.

5. Použijte následující fráze k tréninku svého modelu, aby mohl interpretovat to, co mu říkáte:

   1. Právě jsem doma
   2. Prozatím jsem doma
   3. V tuto chvíli jsem v našem bytě
   4. Sedím doma
   5. V současné době jsem blízko práce
   6. jsem v práci
   7. Jsem v kanceláři
   8. Práce
   9. Domov

Krok 6: Subjekty

Nyní jste zadali, co by mělo být více či méně očekáváno jako vstup, musíme definovat, které části vstupu jsou předmětem zájmu naší obchodní logiky, aby je bylo možné extrahovat a zvýraznit na našem serveru. V našem případě chceme vědět, zda je uživatel doma nebo v práci, abychom mohli reagovat zpět s odjezdy z konkrétní stanice. Podívejme se, jak to můžeme udělat.

1. Pokud dvakrát kliknete na jedno nebo více slov tréninkových frází, dostanete seznam předdefinovaných entit. Více o každé z nich si můžete přečíst zde. Celkově by nejvhodnější byl @sys.location, ale myslím si, že je nejlepší a nejjednodušší, pokud vytvoříme vlastní entitu, kterou bychom měli nazývat @aktuální umístění.
2. Klikněte na možnost „Entity“na levé straně.
3. Klikněte na „VYTVOŘIT entitu“.

4. Nastavte název na „aktuální umístění“a definujte dvě referenční hodnoty spolu s jejich synonymy:

   1. Domov

      domov, dům, byt, postýlka

   2. práce

      práce, kancelář, Aptiv, kódové doly (lol jen si dělám srandu)

5. Klikněte na „Uložit“. Chcete -li dosáhnout extra efektu, můžete také kliknout na „Povolit automatické rozšíření“a poskytnout Asistentovi Google další volnost při pokusu spojit více synonym s vašimi referenčními hodnotami.

Krok 7: Akce a parametry

Čas dát klíčovým slovům ve vašich tréninkových frázích nějaký význam.

1. Klikněte na „Záměry“a poté přejděte na svůj vlastní záměr, tj. „Odchody“, pokud jste se řídili mými návrhy jmen.
2. Přejděte dolů na „Tréninkové fráze“.
3. Dvakrát klikněte na slova, která označují vaši aktuální polohu, a ve vyskakovacím okně vyberte značku @aktuální poloha.
4. Přejděte dolů na „Akce a parametry“, klikněte na „Spravovat“
5. Pokud bylo vše provedeno správně, uvidíte zde svou novou entitu.
6. Zaškrtněte políčko „Povinné“, čímž se zobrazí nový sloupec „Výzvy“. Výzvy je to, co by měl uživatel slyšet, pokud nebylo dodáno nic, co odpovídá očekávání.
7. Klikněte na „Definovat výzvy“a vložte něco jako „Nerozuměl jsem vaší poloze. Kde se momentálně nacházíte?“.

Krok 8: Splnění

Nyní je čas připojit vaši webovou službu k akci Google Assistant. Když se spustí tento konkrétní záměr, zavolá se váš háček, který by měl zajistit splnění této akce. Předtím chceme také stanovit náš záměr uzavřít akci po jejím splnění.

1. Přejděte na „Odpovědi“a klikněte na „PŘIDAT ODPOVĚĎ“.
2. Nepřidávejte žádné odpovědi, pouze povolte „Nastavit tento záměr jako konec konverzace“.
3. Přejděte dolů na „Splnění“, klikněte na „POVOLIT PLNĚNÍ“a poté zapněte „Povolit volání webhooku pro tento záměr“.
4. Klikněte na „Uložit“a poté přejděte na možnost „Splnění“na levé straně.

5. Povolte možnost „Webhook“a vložte adresu URL, kterou „poslouchá“váš webový server.

   Kdykoli je záměr spuštěn, odešle na váš web požadavek POST s textem požadavku obsahujícím objekt JSON s aktuálním umístěním uživatele

6. Klikněte na Uložit.
7. Nyní jsme připraveni vytvořit naši webovou službu, ale ještě předtím se ujistěte, že nás naše akce vítá správným způsobem.

Krok 9: Welcome Intent

Abychom mohli přizpůsobit uživatelské prostředí, měli bychom pro nás vytvořit vhodný pozdrav, kdykoli spustíme naši akci.

1. Přejděte na „Záměry“a poté klikněte na „Výchozí uvítací záměr“.
2. Přejděte dolů na „Odpovědi“, odeberte stávající a vložte, co chcete, aby vás vaše akce přivítala, jakmile bude zahájena.
3. Klikněte na „Uložit“.

Krok 10: Vaše webová služba Python

Vytvořme rychlý a špinavý server Python pomocí Flask. Pro tento krok nejsou žádné screenshoty, ale mělo by to být docela přímočaré.

1. Otevřete novou kartu a vytvořte si účet na pythonanywhere.com
2. Ověřte svůj email.
3. Nastavte si webovou aplikaci kliknutím na „Otevřít webovou kartu“.
4. Klikněte na „Přidat novou webovou aplikaci“a jako webový rámec pro Python vyberte „Flask“.
5. Vyberte Python 3.6 a klikněte na „Další“.
6. Vyberte cestu, ve které chcete umístit „flask_app.py“. Umístil jsem jej přímo do své domovské složky jako „/home/your-username/flask_app.py“.
7. Vraťte se na hlavní stránku kliknutím na logo Pythonu v levém horním rohu.
8. V části soubory klikněte na „flask_app.py“a začněte jej upravovat.
9. Když se otevře webový textový editor, vložte následující kód a klikněte na „Uložit“. Celková myšlenka je, že v závislosti na analyzovaném JSON pocházejícím z Google Asssistant náš server provede akci (např. Čtení nebo zápis) a nahlásí to jako odpověď /plnění, které by mělo být uživateli přečteno.
10. Klikněte znovu na „Otevřít webovou kartu“a poté na zelené „Tlačítko Znovu načíst“.
11. Nyní byste měli mít vlastní webový server Python spuštěný na adrese „https://your-username.pythonanywhere.com/departures“.

Krok 11: Otestujte svou akci

Dobře, už jste téměř hotovi. Vyzkoušejte nyní celý zásobník a začněte pracovat s tímto příkladem „Hello world“!

1. Klikněte na "Integrace" na levé boční liště.
2. Klikněte na „Nastavení integrace“v možnosti Asistenta Google.
3. V části „Implicitní vyvolání přidejte název svého záměru, tj.„ Odlety “, aby jej bylo možné spustit přímo vyslovením výrazu„ Hej Google, promluvte si s místním plánovačem provozu o odjezdech z domova “.
4. Povolte změny „Automatický náhled“.
5. Kliknutím na „Test“se otevře nová stránka.
6. Zadejte „Talk to My local traffic planner“.
7. Vaše akce by měla být vyvolána, což by vás mělo pozdravit jednou z dříve nastavených odpovědí na uvítací záměr.
8. Poté zadejte „Jsem v práci“. Měli byste kontaktovat váš server Python a odpověď přečte Google Assistant.

Cool ne? Nyní si představte, co můžete dělat pomocí senzorů, akčních členů a dalších API prostřednictvím svého asistenta Google.

Krok 12: Uvolněte svou akci

Poté, co skončíte s testováním vaší akce a je v dobrém stavu, je čas sdílet lásku se světem, nebo pokud to nedává smysl, se svými přáteli a rodinou.

1. Vraťte se do konzoly Actions a vyberte akci místního plánovače provozu.
2. V části „Připravte se na nasazení“klikněte na „Zadejte informace požadované pro zařazení vaší akce do adresáře Akce“.
3. Zadejte krátký popis, delší popis, malé logo, své kontaktní údaje, odkaz na zásady ochrany osobních údajů (pokud to nebudete sdílet veřejně, vložte odkaz na svůj web nebo něco) a kategorii.
4. Přejděte nahoru a klikněte na „Uložit“.
5. Klikněte na možnost „Uvolnit“na levé boční liště.
6. Zde si můžete vybrat, v jakém stavu se vaše akce nachází. Pokud nechcete slyšet odpověď „Pojďme získat testovací verzi mého místního plánovače provozu“, musíte vytvořit plnohodnotné veřejné vydání. Vyžaduje to však kontrolu společností Google a tento tutoriál se na to nevztahuje. Místo toho to můžete stále sdílet až s 20 lidmi výběrem vydání Alpha a jeho přidáním jako testery Alpha.
7. Přidejte libovolné testery alfa tak, že jim pošlete odkaz nebo přidáte jejich e -maily.
8. Klikněte na „ODESLAT PRO ALPHU“, zaškrtněte políčka, klikněte na „ODESLAT“a máte hotovo!

Nyní je vaše akce naživo a máte k ní přístup vy i vaši přátelé. Bavte se!

Pokud vás zajímá kód, který jsem použil, podívejte se na projekt na GitHubu.