Vytvorenie vlastných akcií pre asistenta Google: 12 krokov

2025 Autor: John Day | [email protected]. Naposledy zmenené: 2025-01-13 06:58

Keď som videl potenciál asistenta Google, ako bol predstavený v službe Google I/O 18, ako aj v spoločnosti Volvo Cars v ich informačnom a zábavnom systéme, nemohol som odolať a vyskúšať ho. Opätovne som použil jeden zo svojich starších projektov VasttraPi a prepojil ho s Asistentom Google. Ak si chcete prečítať viac o projekte, budem rád, keď sa pozriete na súvisiaci článok na mojom blogu: Vlastné akcie pre asistenta Google.

V tomto návode sa zaoberáme krokmi potrebnými na spustenie vašej vlastnej akcie Asistenta Google, ktorá bude komunikovať s vašim serverom a hovoriť s vami a uvedie zoznam nadchádzajúcich odchodov. Majte na pamäti, že sadu SDK nebudeme používať, pretože ju spúšťame výlučne v rámci Asistenta Google, a nie z vlastného zariadenia. Celkovo to zostane jednoduché. Vašu akciu bude možné použiť na zariadeniach, ktoré podporujú Asistenta Google, ako sú telefóny, tablety, domáci asistenti a nositeľné zariadenia, a dokonca ju môžete zdieľať rovnako ako s aplikáciou v obchode Play!

Jednou z hlavných výhod vytvorenia niečoho podobného oproti využívaniu služieb, ako je IFTTT, je to, že na svojom serveri môžete vytvárať vlastné odpovede, ktoré bude čítať asistent Google. V IFTTT je komunikácia, pokiaľ ide o mňa, jednosmerná.

Budú sa zaoberať nasledujúcimi témami:

• Vytvorenie prvého akčného projektu
• Vytvorenie vlastného zámeru
• Vytvorenie vlastnej entity
• Nastavenie webhooku, aby splnil vašu akciu
• Nastavenie jednoduchého servera REST napísaného v Pythone s Flaskom, ktorý poskytne odpovede alebo „splnenie“
• Testovanie vášho akčného projektu
• Uvoľnenie vášho akčného projektu

Tu nenájdete veľa podrobností ani teórií o rôznych funkciách a koncepciách asistenta Google. Ak vás zaujímajú, dôrazne vám odporúčame, aby ste sa riadili oficiálnym návodom alebo si pozreli toto video.

Krok 1: Nastavte povolenia účtu Google

Skôr ako začneme, musíme zaistiť, aby mal Asistent Google príslušné povolenia.

1. Prejdite na položku Riadenie aktivity

2. Uistite sa, že sú povolené nasledujúce položky:

   1. Aktivita na webe a v aplikáciách
   2. Informácie o zariadení
   3. Hlasová a zvuková aktivita

Krok 2: Vytvorte svoju akciu

1. Prejdite do konzoly Actions Console a kliknite na „Pridať/importovať projekt“
2. Nazvime to projekt Actions „local-traffic-planner“.
3. Kliknite na „Vytvoriť projekt“.
4. Na ďalšej stránke nevyberajte kategóriu a kliknite na „Preskočiť“.
5. Teraz by ste mali byť na hlavnej stránke Konzoly akcií.

Krok 3: Akčné vyvolanie

Stanovte si, ako chcete, aby Asistent Google spustil vašu akciu.

1. V časti „Rýchle nastavenie“kliknite na „Rozhodnúť, ako sa má vaša akcia vyvolať“.
2. Nazvite to „Môj miestny plánovač návštevnosti“a kliknite na „Uložiť“.

3. Kliknite na výzvu „UPDATE SAMPLE INVOCATIONS“, ktorá sa zobrazila po kliknutí na tlačidlo uložiť.

   Túto možnosť nájdete aj v časti „Informácie o adresári“

4. Pridajte „Opýtajte sa môjho miestneho plánovača návštevnosti“ako nové vyvolanie a kliknite na „Uložiť“.

Krok 4: Pridajte svoju prvú akciu

1. Kliknite na položku „Akcie“na paneli vľavo.
2. Kliknite na „PRIDAŤ SVOJU PRVÚ AKCIU“.
3. Vyberte „Vlastný zámer“a potom kliknite na „Zostaviť“.
4. Dostanete sa na stránku Dialogflow, kde implementujete hlavnú logiku.

Krok 5: Školenie fráz pre váš úmysel

1. Vyberte časové pásmo a kliknite na „Vytvoriť“.
2. Na ďalšej stránke nechajte existujúce zámery a kliknite na „VYTVORIŤ ZÁMER“.
3. Dajte zámeru primeraný názov, t. J. „Odchody“.
4. Prejdite na „Tréningové frázy“a kliknite na „Pridať cvičné frázy“.

5. Nasledujúce frázy použite na trénovanie svojho modelu, aby mohol interpretovať to, čo mu hovoríte:

   1. Práve som doma
   2. Zatiaľ som doma
   3. Momentálne som v našom byte
   4. Sedím doma
   5. Aktuálne som blízko práce
   6. som v práci
   7. Som v kancelárii
   8. Práca
   9. Domov

Krok 6: Subjekty

Teraz ste zadali, čo by sa malo ako vstup viac alebo menej očakávať, musíme definovať, ktoré časti vstupu sú zaujímavé pre našu obchodnú logiku, aby ich bolo možné extrahovať a zvýrazniť na našom serveri. V našom prípade chceme vedieť, či je používateľ doma alebo v práci, aby sme mohli odpovedať na odchody z konkrétnej stanice. Pozrime sa, ako to dokážeme.

1. Ak dvakrát kliknete na jedno alebo viac slov z cvičných fráz, zobrazí sa zoznam preddefinovaných entít. Viac o každom z nich si môžete prečítať tu. Celkovo by bol najvhodnejší @sys.location, ale myslím si, že je najlepšie a najľahšie, ak vytvoríme vlastnú entitu, ktorú by sme mali nazývať @current-location.
2. Kliknite na možnosť „Entity“na ľavej strane.
3. Kliknite na „VYTVORIŤ entitu“.

4. Nastavte názov na „aktuálne umiestnenie“a definujte dve referenčné hodnoty spolu s ich synonymami:

   1. Domov

      domov, dom, byt, postieľka

   2. práca

      práca, kancelária, Aptiv, kódové bane (lol žartujem)

5. Kliknite na „Uložiť“. Ak chcete dosiahnuť extra efekt, môžete tiež kliknúť na „Povoliť automatické rozšírenie“, aby ste Asistentovi Google poskytli ďalšie slobody vyskúšať a priradiť k vašim referenčným hodnotám viac synoným.

Krok 7: Akcia a parametre

Čas dať kľúčovým slovám vo vašich tréningových frázach určitý význam.

1. Kliknite na „Zámery“a potom prejdite na svoj vlastný zámer, tj. „Odchody“, ak ste sa riadili mojimi návrhmi mien.
2. Prejdite nadol na položku „Tréningové frázy“.
3. Dvakrát kliknite na slová, ktoré označujú vašu aktuálnu polohu, a v rozbaľovacom okne vyberte značku @aktuálna poloha.
4. Prejdite nadol na „Akcie a parametre“, kliknite na „spravovať“
5. Ak bolo všetko vykonané správne, uvidíte tam svoju novú entitu.
6. Začiarknite políčko „Povinné“, čím sa zobrazí nový stĺpec „Výzvy“. Výzvy je to, čo by mal používateľ počuť, ak nebolo dodané nič, čo zodpovedá očakávaniu.
7. Kliknite na „Definovať výzvy“a zadajte niečo ako „Nerozumiem vašej polohe. Kde sa momentálne nachádzate?“.

Krok 8: Splnenie

Teraz je načase pripojiť vašu webovú službu k akcii Asistenta Google. Váš háčik sa zavolá, keď sa spustí tento konkrétny zámer, a mal by priniesť splnenie tejto akcie. Predtým chceme tiež stanoviť náš zámer ukončiť akciu po jej splnení.

1. Prejdite na „Odpovede“a kliknite na „PRIDAŤ ODPOVEĎ“.
2. Nepridávajte žiadne reakcie, iba povoľte „Nastaviť tento zámer ako koniec konverzácie“.
3. Posuňte zobrazenie nadol na položku „Splnenie“, kliknite na „POVOLIŤ PLNENIE“a potom zapnite „Povoliť volanie webhook pre tento zámer“.
4. Kliknite na „Uložiť“a potom prejdite na možnosť „Splnenie“na ľavej strane.

5. Povoľte možnosť „Webhook“a zadajte webovú adresu, ktorú „počúva“váš webový server.

   Kedykoľvek sa spustí zámer, odošle požiadavku POST na váš web s textom žiadosti obsahujúcim objekt JSON s aktuálnym umiestnením používateľa

6. Kliknite na položku Uložiť.
7. Teraz sme pripravení vytvoriť našu webovú službu, ale predtým sa uistite, že nás naša akcia riadnym spôsobom víta.

Krok 9: Uvítací úmysel

Aby sme mohli prispôsobiť používateľskú skúsenosť, mali by sme pre nás vytvoriť vhodný pozdrav vždy, keď spustíme našu akciu.

1. Prejdite na „Zámery“a potom kliknite na „Predvolený úmysel na uvítanie“.
2. Posuňte zobrazenie nadol na časť „Odpovede“, odstráňte existujúce a vložte, čo chcete, aby vás vaša akcia mohla privítať po jej zahájení.
3. Kliknite na „Uložiť“.

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

Vytvorme rýchly a špinavý server Python pomocou Flask. Pre tento krok nie sú k dispozícii žiadne snímky obrazovky, ale mali by byť celkom priame.

1. Otvorte novú kartu a vytvorte si účet na pythonanywhere.com
2. Overte svoj e -mail.
3. Nastavte si webovú aplikáciu kliknutím na „Otvoriť webovú kartu“.
4. Kliknite na „Pridať novú webovú aplikáciu“a ako webový rámec v Pythone vyberte „Flask“.
5. Vyberte Python 3.6 a kliknite na „Ďalej“.
6. Vyberte cestu, v ktorej sa má nachádzať vaše „flask_app.py“. Vložil som ho priamo do svojho domovského priečinka ako „/home/your-username/flask_app.py“.
7. Vráťte sa na hlavnú stránku kliknutím na logo Pythonu v ľavom hornom rohu.
8. V časti súbory kliknite na položku „flask_app.py“a spustite úpravu.
9. Keď sa otvorí webový textový editor, prilepte nasledujúci kód a kliknite na „Uložiť“. Celková predstava je taká, že v závislosti od analyzovaného JSONu pochádzajúceho z programu Google Asssistant náš server vykoná akciu (napr. Čítanie alebo zápis) a nahlási ju ako odpoveď. /splnenie, ktoré by sa malo prečítať používateľovi.
10. Znova kliknite na „Otvoriť webovú kartu“a potom na zelené tlačidlo „Znova načítať“.
11. Teraz by ste už mali mať spustený vlastný webový server Python na adrese „https://your-username.pythonanywhere.com/departures“.

Krok 11: Otestujte svoju akciu

Dobre, už ste skoro hotoví. Vyskúšajme si teraz celý stoh a nechajme tento príklad „Hello world“fungovať!

1. Na ľavom bočnom paneli kliknite na položku „Integrácie“.
2. V možnosti Asistenta Google kliknite na položku „Nastavenia integrácie“.
3. V časti „Implicitné vyvolávanie“zadajte názov svojho zámeru, t. J. „Odchody“, aby sa mohol spustiť priamo vyslovením výrazu „Hej Google, porozprávajte sa s mojím miestnym plánovačom návštevnosti o odchodoch z domu“.
4. Povoliť zmeny „Automatický náhľad“.
5. Kliknutím na „Test“sa otvorí nová stránka.
6. Zadajte „Talk to My local traffic planner“.
7. Mala by sa vyvolať vaša akcia, ktorá by vás mala pozdraviť jednou z predtým nastavených odpovedí na uvítací zámer.
8. Potom zadajte „som v práci“. Malo by byť kontaktované váš server Python a odpoveď bude prečítaná Asistentom Google.

Cool nie? Teraz si predstavte, čo môžete robiť pomocou senzorov, akčných členov a ďalších rozhraní API prostredníctvom svojho asistenta Google.

Krok 12: Uvoľnite akciu

Potom, čo ste testovali svoju akciu a je v dobrom stave, je načase podeliť sa o lásku so svetom alebo, ak to nedáva zmysel, so svojimi priateľmi a rodinou.

1. Vráťte sa do konzoly Akcií a vyberte akciu miestneho plánovača návštevnosti.
2. V časti „Pripravte sa na nasadenie“kliknite na „Zadajte informácie potrebné na zaradenie vašej akcie do adresára Akcie“.
3. Zadajte krátky popis, dlhší popis, malé logo, svoje kontaktné údaje, odkaz na zásady ochrany osobných údajov (ak to nebudete verejne zdieľať, zadajte odkaz na svoj web alebo niečo) a kategóriu.
4. Prejdite nahor a kliknite na „Uložiť“.
5. Na ľavom bočnom paneli kliknite na možnosť „Uvoľniť“.
6. Tu si môžete vybrať, v akom stave sa vaša akcia nachádza. Ak nechcete počuť odpoveď „Získajme testovaciu verziu môjho miestneho plánovača návštevnosti“, musíte vytvoriť plnohodnotné verejné vydanie. Vyžaduje si to však kontrolu spoločnosťou Google a tento tutoriál sa týmto nezaoberá. Namiesto toho to môžete stále zdieľať až s 20 ľuďmi tak, že si vyberiete vydanie Alpha a pridáte ich ako testery Alpha.
7. Pridajte ľubovoľné testery alfa tak, že im pošlete odkaz alebo pridáte ich e -maily.
8. Kliknite na „ODOSLAŤ ALFA“, začiarknite políčka, kliknite na „ODOSLAŤ“a máte hotovo!

Teraz je vaša akcia naživo a máte k nej prístup vy a vaši priatelia. Bavte sa!

Ak vás zaujíma kód, ktorý som použil, pozrite sa na projekt na GitHub.