Google Asistan için Özel İşlemler Oluşturun: 12 Adım

2024 Yazar: John Day | [email protected]. Son düzenleme: 2024-01-30 13:18

Google I/O 18'de ve Volvo Cars'ta bilgi-eğlence sistemlerinde sunulduğu şekliyle Google Asistan'ın potansiyelini görünce, denemekten kendimi alamadım. Eski projelerimden biri olan VasttraPi'yi yeniden kullandım ve Google Asistan ile arayüz oluşturdum. Proje hakkında daha fazla bilgi edinmek isterseniz blogumdaki ilgili makaleye bir göz atarsanız sevinirim: Google Asistan için özel işlemler.

Bu Eğitilebilir Tabloda, sunucunuzla iletişim kuracak ve sizinle konuşacak ve yaklaşan kalkışları listeleyecek kendi Google Asistan İşleminizi başlatmak için gerekli adımların üzerinden geçiyoruz. Bunu tamamen kendi cihazımızda değil Google Asistan'da çalıştırdığımız için SDK'yı kullanmayacağımızı unutmayın. Genel olarak basit tutulacak. İşleminiz telefonlar, tabletler, ev asistanları ve giyilebilir cihazlar gibi Google Asistan'ı destekleyen cihazlarda kullanılabilir olacak ve hatta Play Store'daki bir uygulama ile paylaşabileceksiniz!

IFTTT gibi hizmetleri kullanmak yerine böyle bir şey oluşturmanın ana avantajlarından biri, sunucunuzda Google Asistan tarafından okunacak özel yanıtlar oluşturabilmenizdir. IFTTT'de iletişim tek yönlüdür.

Aşağıdaki konular ele alınacaktır:

• İlk Eylem projenizi oluşturma
• Özel Niyetinizi oluşturma
• Özel varlığınızı oluşturma
• İşleminizi gerçekleştirmek için bir web kancası ayarlama
• Yanıtları veya "yerine getirmeyi" sağlayacak, Flask ile Python'da yazılmış basit bir REST sunucusu kurma
• Eylem projenizi test etme
• Eylem projenizi yayınlama

Burada çeşitli Google Asistan işlevleri ve kavramları hakkında çok fazla ayrıntı veya teori bulamazsınız. Onlarla ilgileniyorsanız, resmi öğreticiyi takip etmenizi veya bu videoyu izlemenizi şiddetle tavsiye ederim.

1. Adım: Google Hesabı İzinlerinizi Ayarlayın

Başlamadan önce Google Asistan'ın uygun izinlere sahip olduğundan emin olmamız gerekiyor.

1. Etkinlik Kontrollerine Git

2. Aşağıdakilerin etkinleştirildiğinden emin olun:

   1. Web ve Uygulama Etkinliği
   2. Cihaz bilgisi
   3. Ses ve Ses Etkinliği

2. Adım: Eyleminizi Oluşturun

1. Eylemler Konsolu'na gidin ve "Proje ekle/içe aktar"a tıklayın
2. Bu Eylemler projesine "yerel-trafik-planlayıcı" diyelim.
3. "Proje oluştur" u tıklayın.
4. Bir sonraki sayfada, bir kategori seçmeyin ve "Atla" yı tıklayın.
5. Şimdi ana Eylemler Konsolu sayfasında olmalısınız.

3. Adım: Eylem Çağrısı

İşleminizi başlatmak için Google Asistan'ı nasıl tetiklemek istediğinizi belirleyin.

1. "Hızlı kurulum" altında "İşleminizin nasıl çağrılacağına karar verin" seçeneğini tıklayın.
2. "Yerel trafik planlayıcım" olarak adlandırın ve "Kaydet"e tıklayın.

3. Kaydet'e tıkladıktan sonra açılan "ÖRNEK ÇAĞRILARI GÜNCELLE" istemine tıklayın.

   Bu seçeneği "Dizin Bilgileri" altında da bulabilirsiniz

4. Yeni bir çağrı olarak "Yerel trafik planlayıcıma sor"u ekleyin ve "Kaydet"i tıklayın.

4. Adım: İlk İşleminizi Ekleyin

1. Soldaki çubukta "Eylemler" üzerine tıklayın.
2. "İLK İŞLEMİNİZİ EKLEYİN" üzerine tıklayın.
3. "Özel amaç"ı seçin ve ardından "Oluştur"a tıklayın.
4. Ana mantığı uygulayacağınız Dialogflow sayfasına yönlendirileceksiniz.

Adım 5: Amacınıza Yönelik Eğitim İfadeleri

1. Saat diliminizi seçin ve "Oluştur"a tıklayın.
2. Bir sonraki sayfada, mevcut niyetleri bırakın ve "Niyet OLUŞTUR" u tıklayın.
3. Amaca makul bir ad verin, yani "kalkışlar".
4. "Eğitim cümleleri"ne gidin ve "Eğitim cümleleri ekle"ye tıklayın.

5. Modelinizi, söylediklerinizi yorumlayabilmesi için eğitmek için aşağıdaki ifadeleri kullanın:

   1. şuan evdeyim
   2. şimdilik evdeyim
   3. şu an bizim apartmandayım
   4. evde oturuyorum
   5. Şu anda işe yakınım
   6. işteyim
   7. ben ofisteyim
   8. Çalışmak
   9. Ev

6. Adım: Varlıklar

Artık bir girdi olarak az çok ne beklenmesi gerektiğini belirlediniz, girdinin hangi bölümlerinin iş mantığımıza ilgi duyduğunu tanımlamamız gerekiyor, böylece bunlar sunucumuza ayıklanıp vurgulanabilsin. Bizim durumumuzda, kullanıcının evde mi yoksa işte mi olduğunu bilmek istiyoruz, böylece belirli istasyondan hareketlerle yanıt verebiliriz. Bunu nasıl yapabileceğimize bir bakalım.

1. Eğitim ifadelerinin bir veya daha fazla kelimesine çift tıklarsanız, önceden tanımlanmış varlıkların bir listesini alırsınız. Her biri hakkında daha fazla bilgiyi buradan okuyabilirsiniz. Genel olarak, en uygun olanı @sys.location olacaktır, ancak @current-location olarak adlandırmamız gereken kendi varlığımızı yaratmamızın en iyi ve en kolay olduğunu düşünüyorum.
2. Sol taraftaki "Varlıklar" seçeneğine tıklayın.
3. "VARLIK OLUŞTUR" üzerine tıklayın.

4. Adı "geçerli konum" olarak ayarlayın ve eş anlamlılarıyla birlikte iki referans değeri tanımlayın:

   1. ev

      ev, ev, daire, beşik

   2. İş

      iş, ofis, Aptiv, kod mayınları (lol sadece şaka yapıyorum)

5. "Kaydet'i tıklayın. Daha fazla etki için, Google Asistan'a referans değerlerinizle daha fazla eşanlamlıyı denemek ve eşleştirmek için daha fazla özgürlük vermek üzere "Otomatik genişlemeye izin ver"i de tıklayabilirsiniz.

7. Adım: Eylem ve Parametreler

Eğitim cümlelerinizin içindeki anahtar kelimelere biraz anlam vermenin zamanı geldi.

1. "Niyetler"e tıklayın ve ardından özel Niyetinize gidin, yani isim önerilerimi takip ediyorsanız "kalkışlar".
2. "Eğitim cümleleri"ne ilerleyin.
3. Mevcut konumunuzu belirten kelimelere çift tıklayın ve açılır pencereden @current-location etiketini seçin.
4. "Eylemler ve parametreler"e gidin, "yönet"e tıklayın
5. Her şey doğru yapıldıysa, yeni varlığınızın orada listelendiğini göreceksiniz.
6. Yeni bir "İstemler" sütununun görünmesini sağlayan "Gerekli" kutusunu işaretleyin. İstemler, beklentiyle eşleşen hiçbir şey sağlanmadığında kullanıcının duyacağı şeydir.
7. "İstemleri tanımla"yı tıklayın ve "Konumunuzu anlamadım. Şu anda neredesiniz?" gibi bir şey girin.

Adım 8: Yerine Getirme

Artık web hizmetinizi Google Asistan Eylemine bağlamanın zamanı geldi. Bu özel amaç tetiklendiğinde kancanız çağrılır ve bu eylemin yerine getirilmesini sağlamalıdır. Bundan önce, eylemi yerine getirdikten sonra sonuçlandırma niyetimizi de belirlemek istiyoruz.

1. "Yanıtlar"a gidin ve "YANIT EKLE"ye tıklayın.
2. Herhangi bir yanıt eklemeyin, sadece "Bu amacı konuşmanın sonu olarak ayarla" seçeneğini etkinleştirin.
3. "Yerine Getirme" seçeneğine ilerleyin, "GERÇEKLEŞTİRMEYİ ETKİNLEŞTİR" üzerine tıklayın ve ardından "Bu amaç için web kancası çağrısını etkinleştir"i açın.
4. "Kaydet"i tıklayın ve ardından sol taraftaki "Yerine Getirme" seçeneğine gidin.

5. "Web kancası" seçeneğini etkinleştirin ve web sunucunuz tarafından "dinlenen" URL'yi girin.

   Niyet tetiklendiğinde, kullanıcının o anki konumuna sahip bir JSON nesnesi içeren isteğin gövdesiyle web sitenize bir POST isteği gönderir

6. Kaydet'i tıklayın.
7. Artık web servisimizi oluşturmaya hazırız, ancak ondan önce Action'ımızın bizi uygun bir şekilde karşıladığından emin olalım.

9. Adım: Karşılama Niyeti

Kullanıcı deneyimini özelleştirmek için, eylemimizi tetiklediğimizde bizim için uygun bir karşılama oluşturmalıyız.

1. "Amaçlar"a gidin ve ardından "Varsayılan Hoş Geldiniz Niyeti"ne tıklayın.
2. "Yanıtlar" a gidin, mevcut olanları kaldırın ve başlatıldığında sizi nasıl karşılayacağınızı istediğiniz eylemi ekleyin.
3. "Kaydet"i tıklayın.

Adım 10: Python Web Hizmetiniz

Flask kullanarak hızlı ve kirli bir Python sunucusu yapalım. Bu adım için ekran görüntüsü yok, ancak oldukça basit olmalı.

1. Yeni bir sekme açın ve pythonanywhere.com'da bir hesap oluşturun
2. Eposta adresinizi doğrulayın.
3. "Web sekmesini aç"a tıklayarak web uygulamanızı kurun.
4. "Yeni bir web uygulaması ekle"ye tıklayın ve Python web çerçeveniz olarak "Flask"ı seçin.
5. Python 3.6'yı seçin ve "İleri"ye tıklayın.
6. "flask_app.py" dosyanızın bulunmasını istediğiniz yolu seçin. Onu doğrudan ana klasörümün içine "/home/your-username/flask_app.py" olarak yerleştirdim.
7. Sol üst köşedeki Python logosuna tıklayarak ana sayfaya dönün.
8. Dosyaların altında, düzenlemeye başlamak için "flask_app.py" üzerine tıklayın.
9. Web metin düzenleyicisi açıldığında, aşağıdaki kodu yapıştırın ve "Kaydet"i tıklayın. Genel fikir, Google Asistan'dan gelen ayrıştırılmış JSON'a bağlı olarak sunucumuzun bir eylem gerçekleştireceği (örn. okuma veya yazma) ve yanıt olarak geri rapor etmesidir. /yerine getirme kullanıcıya okunması gerekir.
10. Tekrar "Web sekmesini aç" ve ardından yeşil "Yeniden Yükle düğmesi" üzerine tıklayın.
11. Şimdiye kadar "https://your-username.pythonanywhere.com/departures" adresinde çalışan kendi Python web sunucunuz olmalıdır.

Adım 11: Eyleminizi Test Edin

Tamam, şimdiye kadar büyük ölçüde bitirdiniz. Şimdi tüm yığını test edelim ve bu "Merhaba dünya" örneğini çalıştıralım!

1. Sol taraftaki çubuktan "Entegrasyonlar" üzerine tıklayın.
2. Google Asistan seçeneğinin altındaki "Entegrasyon Ayarları"na tıklayın.
3. "Örtülü çağrı altına niyetinizin adını, yani "kalkışlar"ı ekleyin, böylece "Ok Google, evden ayrılmalar hakkında yerel trafik planlayıcımla konuşun" gibi bir şey söyleyerek doğrudan tetiklenebilir.
4. "Otomatik önizleme" değişikliklerini etkinleştirin.
5. Yeni bir sayfa açacak olan "Test" üzerine tıklayın.
6. "Yerel trafik planlayıcımla konuş" yazın.
7. Eyleminiz, önceden ayarlanmış hoş geldiniz niyeti yanıtlarından biriyle sizi selamlaması gereken çağrılmalıdır.
8. Ardından "İşteyim" yazın. Python sunucunuzla iletişime geçilmeli ve yanıt Google Asistan tarafından okunacaktır.

Harika değil mi? Şimdi, Google Asistanınız aracılığıyla sensörler, aktüatörler ve diğer API'lerle etkileşim kurarak neler yapabileceğinizi hayal edin.

Adım 12: Eyleminizi Serbest Bırakın

Eyleminizi test etmeyi bitirdikten ve iyi bir durumda olduktan sonra, sevgiyi dünyayla veya bu bir anlam ifade etmiyorsa arkadaşlarınız ve ailenizle paylaşmanın zamanı geldi.

1. Eylemler konsolunuza geri dönün ve yerel trafik planlayıcı eyleminizi seçin.
2. "Dağıtım için hazırlanın" altında, "Eyleminizi Eylemler dizininde listelemek için gerekli bilgileri girin" seçeneğini tıklayın.
3. Kısa bir açıklama, daha uzun bir açıklama, küçük bir logo, iletişim bilgileriniz, bir gizlilik politikası bağlantısı (bunu herkese açık olarak paylaşmayacaksanız, web sitenize bir bağlantı veya başka bir şey koyun) ve bir kategori girin.
4. Yukarı kaydırın ve "Kaydet" e tıklayın.
5. Sol taraftaki çubuktan "Bırak" seçeneğine tıklayın.
6. Burada Eyleminizin hangi durumda olduğunu seçebilirsiniz. "Yerel trafik planlayıcımın test sürümünü alalım" yanıtını duymak istemiyorsanız, tam teşekküllü bir genel yayın yapmanız gerekir. Ancak bunun için Google tarafından bir inceleme yapılması gerekir ve bu eğiticide ele alınmayacaktır. Bunun yerine, bir Alfa sürümü seçip bunları Alfa test kullanıcıları olarak ekleyerek bunu en fazla 20 kişiyle paylaşabilirsiniz.
7. Bir bağlantı göndererek veya e-postalarını ekleyerek herhangi bir alfa test kullanıcısını ekleyin.
8. "ALFA İÇİN GÖNDER"e tıklayın, kutuları işaretleyin, "GÖNDER"e tıklayın ve bitirdiniz!

Artık Eyleminiz yayında ve siz ve arkadaşlarınız tarafından erişilebilir. İyi eğlenceler!

Kullandığım kodla ilgileniyorsanız, GitHub'daki projeye bir göz atın.