Amaçlar, bir şeyin nasıl yapılacağını açıklayan mesajlaşma nesneleridir. Amaçları iki şekilde kullanabilirsiniz:
- Bir amacın karşılanmasını sağlayarak veya
- Google Asistan tarafından bir niyetin yerine getirilmesini isteyerek.
Bir amacın yerine getirilmesi için sağladığınız işlem, Dialogflow ile derleme yapan geliştiriciler ve Actions SDK ile çalışan geliştiriciler için farklıdır. Ancak her iki durumda da intent'in adını ve istek karşılama webhook'unuzun URL'sini sağlarsınız. Bu, Actions on Google'a, amaca uygun kullanıcı sorgularını destekleyebileceğinizi bildirir.
Bir niyetin yerine getirilmesini istemek için Asistan'a yanıt verirken niyeti possibleIntents nesnesinde belirtirsiniz. Asistan, istekle ilgili bir sonraki isteğinizde işlenmiş amacın sonucunu size döndürür. Daha fazla bilgi için yardımcı kullanımına genel bakış bölümünü okuyun.
Genel niyetler
Aşağıdaki tabloda, Asistan'ın gerçekleştirmenizi istediği amaçlar açıklanmaktadır.
| Niyet adı | Kullanım | Dialogflow etkinliği |
|---|---|---|
actions.intent.MAIN |
Gerekli: Her İşlem paketi, kullanıcıların yalnızca bir niyet taşıdığını belirler ve kullanıcıların görüşme başlatmasını sağlar. | WELCOME veya GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
Bir kullanıcı isteğinin ham metin temsilini alma. Kullanıcılarla görüşme yaparken çoğunlukla bunu kullanırsınız. | |
actions.intent.CANCEL |
Bu niyeti, işlem paketinizde iptal amaçları almayı etkinleştirdiğinizde alırsınız. Kullanıcılar "Çık" gibi genel bir iptal komutu söylediklerinde bu niyeti karşılamaya yönelik bir sonraki isteğinizde alırsınız. Böylece son bir mesajla yanıt verebilir ve sipariş karşılama mantığınızda tüm temizlikleri yapabilirsiniz. | actions_intent_CANCEL |
actions.intent.NO_INPUT |
Bu niyeti, işlem paketinizde girişsiz giriş almayı kabul ettiğinizde alırsınız. Kullanıcılar bir isteme yanıt vermediğinde, bu niyeti karşılamaya yönelik bir sonraki istekte alırsınız. | actions_intent_NO_INPUT |
Yardımcılar
Aşağıdaki tabloda, Asistan'dan yerine getirmesini isteyebileceğiniz, desteklenen yardımcılar açıklanmıştır.
| Niyet adı | Kullanım | Dialogflow etkinliği |
|---|---|---|
actions.intent.PERMISSION |
Kullanıcının tam adını, yaklaşık konumunu, tam konumunu veya üçünü de edinin. | actions_intent_PERMISSION |
actions.intent.OPTION |
Seçili öğeyi liste veya bant kullanıcı arayüzünden alın. Alternatif olarak, kullanıcı liste veya bant kullanıcı arayüzünden seçme yapmazsa liste veya bant kullanıcı arayüzündeki anahtarla eşleşen konuşma veya metin girişi alın. | actions_intent_OPTION |
actions.intent.DATETIME |
Kullanıcıdan tarih ve saat girişi elde edin. | actions_intent_DATETIME |
actions.intent.SIGN_IN |
Bir kullanıcının hesabını bağlamak için hesap bağlama isteği gönderir. | actions_intent_SIGN_IN |
actions.intent.PLACE |
Kullanıcıdan bir adres veya kayıtlı konum edinin. | actions_intent_PLACE |
actions.intent.CONFIRMATION |
Kullanıcıdan onay alın (örneğin, bir evet veya hayır sorusuna yanıt verme). | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE |
Kullanıcıdan başka bir Asistan yüzeyine yönlendirme izni ister. | actions_intent_NEW_SURFACE |
Yerleşik amaçlar
Yerleşik amaçlar, kullanıcıların yapmayı denedikleri yaygın işlemleri veya aradıkları bilgileri (ör. yemek sipariş etmek, araç rezervasyonu yapmak veya hesap bakiyesini kontrol etmek) ifade eder. Daha fazla bilgi için yerleşik amaçlar referansına bakın.
Ek amaçlar
Çoğu Konuşma İşlemi; ortak amaçlar, yardımcılar ve yanıtların bir kombinasyonuyla oluşturulur. Bununla birlikte, işlemler veya günlük güncellemeler gibi ek özellikleri içeren İşlemler, bu özelliklere özgü amaçlara erişebilir.
İşlem yardımcıları
Aşağıdaki tabloda, Asistan'ın gerçekleştirmesini istediğiniz satın alma işlemleriyle ilgili yardımcılar açıklanmaktadır. Bunların ve diğer ilgili amaçların nasıl uygulanacağı hakkında daha fazla bilgiyi işlemler özellik dokümanlarında bulabilirsiniz.
| Niyet adı | Kullanım | Dialogflow etkinliği |
|---|---|---|
actions.intent.DELIVERY_ADDRESS |
Kullanıcıdan teslimat adresi girişi elde etmek. | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK |
İşlemle ilgili tüm şartların karşılanıp karşılanmadığını kontrol edin. | actions_intent_TRANSACTION_REQUIREMENTS_CHECK |
actions.intent.TRANSACTION_DECISION |
Kullanıcıya işlemin gerçekleştirilip gerçekleştirilmeyeceğini sorar. | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK |
Kullanıcının işlem yapılandırmasını doğrular. Kullanıcılara, işlemin başarısız olacağı dijital ürünleri sunmaktan kaçınmak için kullanılır. | actions_intent_DIGITAL_PURCHASE_CHECK |
actions.intent.COMPLETE_PURCHASE |
Bir satın alma isteği başlatır. İşlemin başarılı veya başarısız olup olmadığını açıklayan bir satın alma sonucuyla sonuçlanır. | actions_intent_COMPLETE_PURCHASE |
Kullanıcı etkileşimi amaçları
Aşağıdaki tabloda, kullanıcı etkileşimi özellikleri ile ilgili amaçlar açıklanmaktadır. Bunların ve diğer ilgili girişlerin nasıl uygulanacağı hakkında daha fazla bilgiyi kullanıcı etkileşimi özelliği dokümanında bulabilirsiniz.
| Niyet adı | Sipariş karşılama hizmeti verin | Siparişin karşılanmasını iste | Kullanım | Dialogflow etkinliği |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | Kullanıcıdan güncellemeler için kaydolmasını ister. | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | Bu amaç, kullanıcı güncellemeler için kaydolmaya çalıştığında gönderilir (yani bir REGISTER_UPDATE amacı gönderilmelidir). | actions_intent_CONFIGURE_UPDATES |
Özel amaç kitleleri
Kullanıcıların işleri daha verimli bir şekilde yapmasına yardımcı olmak üzere görüşmelerde kısayollar tanımlamak için kendi niyetlerinizi oluşturabilirsiniz. Bu niyetler kendi ad alanınızda yer alır. Kullanıcıların amaçları nasıl tetiklediğini tanımlarsınız ve Action paketiniz bunları destekleyebilecek tek birimdir.
Daha fazla bilgi için Dialogflow'da İşlemleri tanımlama veya Actions SDK ile ilgili bilgileri okuyun. İşlem paketleri hakkında daha fazla bilgiyi İşlem paketi referansı dokümanlarında bulabilirsiniz.
Akıllı ev amaçları
Akıllı ev İşlemi oluşturuyorsanız amaçlar için desteği biraz farklı bir şekilde tanımlarsınız. Daha fazla bilgi için akıllı ev amaçları dokümanlarına bakın.