შექმენით მორგებული ქმედებები Google ასისტენტისთვის: 12 ნაბიჯი

2024 ავტორი: John Day | [email protected]. ბოლოს შეცვლილი: 2024-01-30 10:17

ვხედავ Google ასისტენტის პოტენციალს, როგორც ეს წარმოდგენილი იყო Google I/O 18 – ში, ასევე Volvo Cars– ში მათ ინფო -გასართობ სისტემაში, მე ვერ შევეწინააღმდეგე მის გამოცდას. მე ხელახლა გამოვიყენე ჩემი ერთ -ერთი ძველი პროექტი, VasttraPi და დავუკავშირდი მას Google ასისტენტთან. თუ გსურთ მეტი წაიკითხოთ პროექტის შესახებ, მოხარული ვიქნები, თუ გადახედავთ ჩემს ბლოგთან დაკავშირებულ სტატიას: მორგებული ქმედებები Google ასისტენტისთვის.

ამ ინსტრუქციაში ჩვენ გადავდივართ აუცილებელ საფეხურებზე იმისათვის, რომ დავიწყოთ თქვენი საკუთარი Google Assistant Action, რომელიც დაუკავშირდება თქვენს სერვერს და დაგიკავშირდებათ, ჩამოთვლის მომავალ გამგზავრებებს. გაითვალისწინეთ, რომ ჩვენ არ ვაპირებთ SDK– ს გამოყენებას, რადგან ჩვენ ამას სრულად ვმუშაობთ Google ასისტენტის შიგნით და არა ჩვენივე მოწყობილობის შიგნით. საერთო ჯამში, ეს იქნება მარტივი. თქვენი ქმედება გამოსაყენებელი იქნება Google Assistant– ის მხარდაჭერის მქონე მოწყობილობებზე, როგორიცაა ტელეფონები, ტაბლეტები, სახლის ასისტენტები და ტარებადი მოწყობილობები და თქვენც კი შეგიძლიათ გაუზიაროთ ის, როგორც ამას Play Store– ის აპთან ერთად!

მსგავსი რამის შექმნის ერთ -ერთი მთავარი უპირატესობა ისეთ სერვისებთან შედარებით, როგორიცაა IFTTT არის ის, რომ თქვენ შეგიძლიათ შექმნათ პერსონალური პასუხები თქვენს სერვერზე, რომელსაც წაიკითხავს Google ასისტენტი. IFTTT– ში კომუნიკაცია არის რამდენადაც მე ცალმხრივი.

გაშუქდება შემდეგი თემები:

• თქვენი პირველი სამოქმედო პროექტის შექმნა
• თქვენი პერსონალური განზრახვის შექმნა
• თქვენი პერსონალური ერთეულის შექმნა
• Webhook- ის დაყენება თქვენი მოქმედების შესასრულებლად
• მარტივი REST სერვერის დაყენება, დაწერილი პითონში Flask– ით, რომელიც უზრუნველყოფს პასუხებს ან „შესრულებას“
• ტესტირება თქვენი სამოქმედო პროექტი
• გაათავისუფლეთ თქვენი სამოქმედო პროექტი

აქ თქვენ ვერ ნახავთ ბევრ დეტალს ან თეორიას Google ასისტენტის სხვადასხვა ფუნქციისა და კონცეფციის შესახებ. თუ თქვენ დაინტერესებული ხართ მათთან, გირჩევთ მიჰყევით ოფიციალურ სამეურვეოს ან უყუროთ ამ ვიდეოს.

ნაბიჯი 1: დააყენეთ თქვენი Google ანგარიშის ნებართვები

სანამ დავიწყებთ, ჩვენ უნდა დავრწმუნდეთ, რომ Google ასისტენტს აქვს შესაბამისი ნებართვები.

1. გადადით აქტივობის კონტროლზე

2. დარწმუნდით, რომ ჩართულია შემდეგი:

   1. ვებსა და აპებში აქტივობა
   2. მოწყობილობის ინფორმაცია
   3. ხმოვანი და აუდიო აქტივობა

ნაბიჯი 2: შექმენით თქვენი მოქმედება

1. გადადით Actions Console– ზე და დააწკაპუნეთ „პროექტის დამატება/იმპორტი“
2. მოდით ვუწოდოთ ამ აქციების პროექტს "ლოკალური-ტრაფიკის დამგეგმავი".
3. დააჭირეთ ღილაკს "შექმენით პროექტი".
4. შემდეგ გვერდზე არ აირჩიოთ კატეგორია და დააწკაპუნეთ "გამოტოვება".
5. თქვენ უნდა იყოთ მთავარ Actions Console გვერდზე.

ნაბიჯი 3: სამოქმედო მოწვევა

განსაზღვრეთ, როგორ გსურთ Google ასისტენტის გააქტიურება თქვენი მოქმედების დასაწყებად.

1. დააწკაპუნეთ "გადაწყვიტეთ, როგორ ხდება თქვენი ქმედების გამოძახება" "სწრაფი დაყენების" პუნქტში.
2. დაარქვით მას "ჩემი ადგილობრივი ტრაფიკის დამგეგმავი" და დააწკაპუნეთ "შენახვაზე".

3. დააწკაპუნეთ "განახლების ნიმუშის ინვოკაციების" მოთხოვნაზე, რომელიც გამოჩნდა შენახვის დაწკაპუნების შემდეგ.

   თქვენ ასევე შეგიძლიათ იპოვოთ ეს ვარიანტი "დირექტორია ინფორმაცია"

4. დაამატეთ "ჰკითხეთ ჩემს ადგილობრივ ტრაფიკის დამგეგმავს", როგორც ახალი გამოძახება და დააწკაპუნეთ "შენახვაზე".

ნაბიჯი 4: დაამატეთ თქვენი პირველი მოქმედება

1. დააწკაპუნეთ "ქმედებებზე" მარცხენა ზოლში.
2. დააწკაპუნეთ "დაამატე შენი პირველი მოქმედება".
3. აირჩიეთ "მორგებული განზრახვა" და შემდეგ დააჭირეთ "აშენება".
4. თქვენ გადაგიყვანთ Dialogflow გვერდზე, სადაც თქვენ განახორციელებთ მთავარ ლოგიკას.

ნაბიჯი 5: სასწავლო ფრაზები თქვენი განზრახვისთვის

1. შეარჩიეთ თქვენი დროის ზონა და დააჭირეთ ღილაკს "შექმნა".
2. მომდევნო გვერდზე დატოვეთ არსებული მიზნები და დააწკაპუნეთ "CREATE INTENT".
3. მიეცით განზრახვა გონივრული სახელი, ანუ "გამგზავრება".
4. გადადით "სასწავლო ფრაზები" და დააწკაპუნეთ "სასწავლო ფრაზების დამატებაზე".

5. გამოიყენეთ შემდეგი ფრაზები თქვენი მოდელის გასაწვრთნელად, რათა მან შეძლოს იმის ინტერპრეტაცია, რასაც თქვენ ეუბნებით:

   1. ახლა სახლში ვარ
   2. ჯერჯერობით სახლში ვარ
   3. ამ წუთში ჩვენს ბინაში ვარ
   4. მე სახლში ვჯდები
   5. ამჟამად სამსახურთან ახლოს ვარ
   6. მე ვარ სამსახურში
   7. მე ოფისში ვარ
   8. მუშაობა
   9. მთავარი

ნაბიჯი 6: პირები

ახლა თქვენ დააკონკრეტეთ რა უნდა იყოს მეტნაკლებად მოსალოდნელი შეყვანის სახით, ჩვენ უნდა განვსაზღვროთ შეყვანის რომელი ნაწილები აინტერესებს ჩვენს ბიზნეს ლოგიკას, რათა მოხდეს მათი მოპოვება და მონიშნვა ჩვენს სერვერზე. ჩვენს შემთხვევაში, ჩვენ გვსურს ვიცოდეთ მომხმარებელი სახლშია თუ სამსახურში, ასე რომ ჩვენ შეგვიძლია ვუპასუხოთ კონკრეტული სადგურიდან გამგზავრებით. ვნახოთ, როგორ შეგვიძლია ამის გაკეთება.

1. თუ ორჯერ დააწკაპუნებთ სასწავლო ფრაზის ერთ ან მეტ სიტყვას, მიიღებთ წინასწარ განსაზღვრული პირების სიას. თითოეული მათგანის შესახებ მეტი შეგიძლიათ წაიკითხოთ აქ. საერთო ჯამში, ყველაზე შესაფერისი იქნება @sys.location, თუმცა მე ვფიქრობ, რომ ეს არის საუკეთესო და მარტივი, თუ ჩვენ შევქმნით ჩვენს საკუთარ ერთეულს, რომელსაც უნდა ვუწოდოთ @current-location.
2. დააწკაპუნეთ "სუბიექტების" ვარიანტზე მარცხენა მხარეს.
3. დააწკაპუნეთ "CREATE ENTITY".

4. დააყენეთ სახელი "მიმდინარე ადგილმდებარეობა" და განსაზღვრეთ ორი საცნობარო მნიშვნელობა მათ სინონიმებთან ერთად:

   1. სახლში

      სახლი, სახლი, ბინა, საწოლი

   2. მუშაობა

      სამუშაო, ოფისი, Aptiv, კოდის ნაღმები (lol უბრალოდ ვხუმრობ)

5. დააწკაპუნეთ "შენახვაზე. დამატებითი ეფექტისთვის ასევე შეგიძლიათ დააწკაპუნოთ" ავტომატური გაფართოების დაშვებაზე ", რათა Google ასისტენტს მიეცეს დამატებითი თავისუფლება სცადოს და შეადაროს მეტი სინონიმები თქვენს საცნობარო მნიშვნელობებს.

ნაბიჯი 7: მოქმედება და პარამეტრები

დროა გარკვეული მნიშვნელობა მიანიჭოთ საკვანძო სიტყვებს თქვენი სასწავლო ფრაზების შიგნით.

1. დააწკაპუნეთ "განზრახვაზე" და შემდეგ გადადით თქვენს პერსონალურ განზრახვაზე, ანუ "გამგზავრებებზე", თუკი მიჰყევით ჩემი სახელის შემოთავაზებებს.
2. გადადით ქვემოთ "სასწავლო ფრაზები".
3. ორჯერ დააწკაპუნეთ სიტყვებზე, რომლებიც მიუთითებენ თქვენს ამჟამინდელ მდებარეობას და ამომხტარი ფანჯრიდან აირჩიეთ @current-location tag.
4. გადაახვიეთ ქვემოთ "ქმედებები და პარამეტრები", დააწკაპუნეთ "მართვაზე"
5. თუ ყველაფერი სწორად გაკეთდა, დაინახავთ, რომ თქვენი ახალი ერთეული იქ არის ჩამოთვლილი.
6. შეამოწმეთ ყუთი "საჭირო", რომელიც გამოჩნდება ახალი სვეტი "მოთხოვნა". მოთხოვნა არის ის, რაც მომხმარებელმა უნდა მოისმინოს, თუკი არაფერი ემთხვევა მოლოდინს.
7. დააწკაპუნეთ "განსაზღვრეთ მოთხოვნაზე" და ჩადეთ მსგავსი რამ "მე არ მესმის თქვენი ადგილმდებარეობა. სად ხართ ამ წუთას?".

ნაბიჯი 8: შესრულება

ახლა დროა დაუკავშიროთ თქვენი ვებ სერვისი Google Assistant Action. თქვენს კავშირს დაერქმევა, როდესაც ეს კონკრეტული განზრახვა ამოქმედდება და უნდა წარმოადგენდეს ამ მოქმედების შესრულებას. მანამდე, ჩვენ ასევე გვინდა განვსაზღვროთ ჩვენი განზრახვა, რომ დავასრულოთ მოქმედება შესრულების შემდეგ.

1. გადადით "პასუხებში" და დააჭირეთ ღილაკს "პასუხის დამატება".
2. არ დაამატოთ რაიმე პასუხი, უბრალოდ ჩართეთ "დააყენეთ ეს განზრახვა, როგორც საუბრის დასასრული".
3. გადაახვიეთ ქვემოთ „შესრულება“დააწკაპუნეთ „ჩართვის განხორციელებაზე“და შემდეგ ჩართეთ „ამ მიზნისთვის ვებგვერდის ზარის ჩართვა“.
4. დააწკაპუნეთ "შენახვაზე" და შემდეგ გადადით "შესრულების" ვარიანტზე მარცხენა მხარეს.

5. ჩართეთ "Webhook" ვარიანტი და ჩადეთ URL, რომელსაც "უსმენს" თქვენი ვებ სერვერი.

   როდესაც განზრახვა ამოქმედდება, ის გამოგიგზავნით POST მოთხოვნას თქვენს ვებგვერდზე, მოთხოვნის ძირითადი ტექსტით, რომელიც შეიცავს JSON ობიექტს მომხმარებლის ამჟამინდელი მდებარეობით

6. დააწკაპუნეთ შენახვაზე.
7. ახლა ჩვენ მზად ვართ შევქმნათ ჩვენი ვებ სერვისი, მაგრამ მანამდე, დავრწმუნდეთ, რომ ჩვენი აქცია მივესალმებით სათანადოდ.

ნაბიჯი 9: მისასალმებელი განზრახვა

მომხმარებლის გამოცდილების მორგების მიზნით, ჩვენ უნდა შევქმნათ შესაბამისი მისალმება ჩვენთვის, როდესაც ჩვენ ვიწყებთ ჩვენს მოქმედებას.

1. გადადით "განზრახვაში" და შემდეგ დააჭირეთ ღილაკს "ნაგულისხმევი მისასალმებელი განზრახვა".
2. გადაახვიეთ ქვემოთ "პასუხები", ამოიღეთ არსებული და ჩასვით რა გსურთ თქვენი ქმედება როგორ მივესალმოთ მას დაწყებისთანავე.
3. დააჭირეთ "შენახვა".

ნაბიჯი 10: თქვენი პითონის ვებ სერვისი

მოდით გავაკეთოთ სწრაფი და ბინძური პითონის სერვერი Flask– ის გამოყენებით. ამ ნაბიჯის ეკრანის ანაბეჭდები არ არის, მაგრამ ის საკმაოდ წინ უნდა იყოს.

1. გახსენით ახალი ჩანართი და შექმენით ანგარიში pythonanywhere.com– ზე
2. დაადასტურეთ თქვენი ელ.ფოსტის მისამართი.
3. შექმენით თქვენი ვებ პროგრამა, დააჭირეთ ღილაკს "გახსენით ვებ ჩანართი".
4. დააწკაპუნეთ "დაამატეთ ახალი ვებ აპლიკაცია" და შეარჩიეთ "Flask" როგორც თქვენი Python ვებ ჩარჩო.
5. აირჩიეთ პითონი 3.6 და დააჭირეთ "შემდეგი".
6. შეარჩიეთ გზა, სადაც გსურთ თქვენი "flask_app.py" იყოს. მე ის პირდაპირ ჩემი მთავარი საქაღალდის შიგნით მოვათავსე, როგორც "/home/your-username/flask_app.py".
7. დაბრუნდით მთავარ გვერდზე პითონის ლოგოზე დაჭერით ზედა მარცხენა კუთხეში.
8. ფაილების ქვეშ დააწკაპუნეთ "flask_app.py" - ზე, რომ დაიწყოთ მისი რედაქტირება.
9. როდესაც ვებ ტექსტური რედაქტორი იხსნება, ჩასვით შემდეგი კოდი და დააწკაპუნეთ "შენახვაზე".საერთო იდეა იმაში მდგომარეობს, რომ Google Asssistant- ისგან მიღებული JSON- ის ანალიზის მიხედვით ჩვენი სერვერი შეასრულებს ქმედებას (მაგ. წაკითხვა ან წერა) და აცნობებს მას საპასუხოდ /შესრულება, რომელიც უნდა წაიკითხოს მომხმარებელმა.
10. კვლავ დააწკაპუნეთ "გახსენით ვებ ჩანართი" და შემდეგ მწვანე "გადატვირთვის ღილაკი".
11. ამ დროისთვის თქვენ უნდა გქონდეთ თქვენი საკუთარი პითონის ვებ სერვერი გაშვებული "https://your-username.pythonanywhere.com/departures".

ნაბიჯი 11: გამოსცადეთ თქვენი მოქმედება

კარგი, თქვენ უკვე დასრულებული ხართ. მოდით გამოვცადოთ მთელი სტეკი ახლა და მივიღოთ ეს "გამარჯობა სამყარო" მაგალითი!

1. დააწკაპუნეთ "ინტეგრაციაზე" მარცხენა მხარის ზოლიდან.
2. დააწკაპუნეთ "ინტეგრაციის პარამეტრებზე" Google ასისტენტის ვარიანტის ქვეშ.
3. პუნქტში "იგულისხმება ინვოკაცია დაამატეთ თქვენი განზრახვის სახელი, ანუ" გამგზავრებები ", ასე რომ ის შეიძლება გააქტიურდეს უშუალოდ სიტყვით" Hey Google, ესაუბრეთ ჩემს ადგილობრივ ტრაფიკის დამგეგმავს სახლიდან გასვლის შესახებ ".
4. "ავტომატური გადახედვის" ცვლილებების ჩართვა.
5. დააწკაპუნეთ "ტესტირებაზე", რომელიც გახსნის ახალ გვერდს.
6. ჩაწერეთ "ესაუბრეთ ჩემს ადგილობრივ ტრაფიკის დამგეგმავს".
7. თქვენი ქმედება უნდა იყოს გამოძახებული, რომელიც უნდა მივესალმოთ თქვენს ერთ -ერთ ადრე მისასალმებელ განზრახვის პასუხს.
8. შემდეგ ჩაწერეთ "მე სამსახურში ვარ". თქვენს პითონის სერვერს უნდა დაუკავშირდეს და პასუხს წაიკითხავს Google ასისტენტი.

მაგარია არა? ახლა წარმოიდგინეთ, რისი გაკეთება შეგიძლიათ სენსორებთან, აქტივატორებთან და სხვა API– ებთან თქვენი Google ასისტენტის საშუალებით.

ნაბიჯი 12: გაათავისუფლეთ თქვენი მოქმედება

მას შემდეგ რაც დაასრულებთ თქვენი მოქმედების გამოცდას და ის კარგ მდგომარეობაშია დროა გაგიზიაროთ სიყვარული სამყაროს ან, თუ ამას აზრი არ აქვს, თქვენს მეგობრებსა და ოჯახს.

1. დაუბრუნდით თქვენს Actions კონსოლს და შეარჩიეთ თქვენი ადგილობრივი ტრაფიკის დამგეგმავი მოქმედება.
2. "მოემზადეთ განსახორციელებლად" განყოფილებაში დააწკაპუნეთ "შეიყვანეთ საჭირო ინფორმაცია თქვენი ქმედებების ჩამონათვალში ქმედებების დირექტორიაში".
3. შეიყვანეთ მოკლე აღწერა, გრძელი აღწერა, პატარა ლოგო, თქვენი საკონტაქტო ინფორმაცია, კონფიდენციალურობის პოლიტიკის ბმული (თუ არ აპირებთ ამის საჯაროდ გაზიარებას, უბრალოდ განათავსეთ ბმული თქვენს ვებსაიტზე ან რამეზე) და კატეგორია.
4. გადაახვიეთ ზემოთ და დააწკაპუნეთ "შენახვაზე".
5. დააწკაპუნეთ "გათავისუფლების" ვარიანტზე მარცხენა ბარიდან.
6. აქ თქვენ შეგიძლიათ აირჩიოთ რა მდგომარეობაშია თქვენი მოქმედება. თუ არ გსურთ მოისმინოთ პასუხი "მოდი მივიღოთ ჩემი ადგილობრივი ტრაფიკის დამგეგმავის საცდელი ვერსია" თქვენ უნდა გააკეთოთ სრულფასოვანი საჯარო გამოშვება. თუმცა ეს მოითხოვს Google- ის მიმოხილვას და არ იქნება გათვალისწინებული ამ სამეურვეოში. ამის ნაცვლად, თქვენ მაინც შეგიძლიათ გაუზიაროთ ეს 20 -მდე ადამიანს ალფა გამოშვების არჩევით და ალფა შემმოწმებლების დამატებით.
7. დაამატეთ ნებისმიერი ალფა შემმოწმებელი მათ ბმულის გაგზავნით ან ელ.ფოსტის დამატებით.
8. დააწკაპუნეთ "SUBMIT FOR ALPHA", მონიშნეთ ყუთები, დააწკაპუნეთ "SUBMIT" და თქვენ დასრულებული ხართ!

ახლა თქვენი მოქმედება პირდაპირ ეთერშია და მასზე წვდომა შეგიძლიათ თქვენ და თქვენს მეგობრებს. Გაერთე!

თუ თქვენ დაინტერესებული ხართ ჩემ მიერ გამოყენებული კოდით, გადახედეთ პროექტს GitHub– ზე.