Amaçlar, bir şeyin nasıl yapılacağını açıklayan mesaj nesneleridir. Amaçları iki şekilde kullanabilirsiniz:
- Bir amacın karşılanmasını sağlayarak veya
- Google Asistan tarafından bir amacın yerine getirilmesini isteyerek.
Niyetlerin karşılanmasını sağlama süreci, Dialogflow ile derleme yapan geliştiriciler ile Actions SDK ile derleme yapan geliştiriciler için farklıdır. Ancak her iki durumda da amacın adını ve istek karşılama webhook'unuzun URL'sini sağlarsınız. Bu, Actions on Google'a amaçla eşleşen kullanıcı sorgularını destekleyebileceğinizi bildirir.
Bir amacın yerine getirilmesini istemek için Asistan'a yanıt verirken amacı possibleIntents nesnesinde belirtirsiniz. Karşılamanıza gönderilen sonraki istekte Asistan, işlenen 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 yerine getirmenizi istediği amaçlar açıklanmaktadır.
| Amaç adı | Kullanım | Dialogflow etkinliği |
|---|---|---|
actions.intent.MAIN |
Zorunlu: Her İşlem paketi, kullanıcıların görüşme başlatması için giriş noktası olarak yalnızca bir niyet işlemi bildirir. | WELCOME veya GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
Kullanıcı isteğinin ham metin temsilini elde etme. Bunu çoğu zaman kullanıcılarla sohbet ederken 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öylediğinde bu niyeti sipariş karşılamanızdaki bir sonraki istekte alırsınız. Böylece son bir mesajla yanıt verebilir ve istek karşılama mantığınızda tüm temizlemeleri yapabilirsiniz. | actions_intent_CANCEL |
actions.intent.NO_INPUT |
Bu niyeti, işlem paketinizde giriş içermeyen niyet almayı etkinleştirdiğinizde alırsınız. Kullanıcılar bir isteme yanıt vermediğinde bu niyeti, istek karşılamanızla ilgili 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ımlar açıklanmaktadır.
| Amaç adı | Kullanım | Dialogflow etkinliği |
|---|---|---|
actions.intent.PERMISSION |
Kullanıcının tam adını, yaklaşık konumunu, tam konumunu ya da üçünü birden edinin. | actions_intent_PERMISSION |
actions.intent.OPTION |
Seçilen öğeyi liste veya bant kullanıcı arayüzünden alın. Alternatif olarak, kullanıcı listeden veya bant kullanıcı arayüzünden seçim yapmazsa listedeki veya bant kullanıcı arayüzündeki tuşla 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 alın. | actions_intent_DATETIME |
actions.intent.SIGN_IN |
Bir kullanıcının hesabını bağlamak için hesap bağlama akışı ister. | actions_intent_SIGN_IN |
actions.intent.PLACE |
Kullanıcıdan bir adres veya kayıtlı konum elde edin. | actions_intent_PLACE |
actions.intent.CONFIRMATION |
Kullanıcıdan onay alma (örneğin, evet-hayır sorusuna yanıt). | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE |
Başka bir Asistan yüzeyine aktarmak için kullanıcıdan izin ister. | actions_intent_NEW_SURFACE |
Yerleşik amaçlar
Yerleşik amaçlar, kullanıcıların yapmaya çalıştıkları görevleri veya aradıkları bilgileri (ör. yemek siparişi vermek, yolculuk rezervasyonu yapmak ya da hesap bakiyesini kontrol etmek) ifade etmek için kullandığı bazı yaygın yöntemleri modeller. Daha fazla bilgi için yerleşik amaçlar referansına bakın.
Ek amaçlar
Çoğu Conversational Actions, yaygın niyetler, yardımcılar ve yanıtların bir kombinasyonuyla oluşturulur. Bununla birlikte, işlemler veya günlük güncellemeler gibi ek özellikler içeren İşlemler, bu özelliklere özgü amaçlara erişebilir.
İşlem yardımcıları
Aşağıdaki tabloda, Asistan'dan yerine getirmesini isteyebileceğiniz satın alma işlemlerinin işlenmesiyle ilgili yardımcılar açıklanmaktadır. Bunları ve diğer ilgili amaçları nasıl uygulayacağınız hakkında daha fazla bilgiyi işlemler özelliği belgelerinde bulabilirsiniz.
| Amaç adı | Kullanım | Dialogflow etkinliği |
|---|---|---|
actions.intent.DELIVERY_ADDRESS |
Kullanıcıdan teslimat adresi girişi alın. | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK |
İşlemle ilgili tüm koşulları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şip gerçekleşmeyeceğini sorar. | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK |
Kullanıcının işlem yapılandırmasını doğrular. İşleminin başarısız olacağı kullanıcılara dijital ürünler 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ı ve nasıl başarısız olduğunu açıklayan bir satın alma sonucu elde edilir. | actions_intent_COMPLETE_PURCHASE |
Kullanıcı etkileşimi amaçları
Aşağıdaki tabloda, kullanıcı etkileşimi özellikleriyle ilgili amaçlar açıklanmaktadır. Bu ve diğer ilgili amaçları nasıl uygulayacağınız hakkında daha fazla bilgiyi kullanıcı etkileşimi özelliği belgelerinde bulabilirsiniz.
| Amaç adı | Sipariş karşılama sağlayın | İstek karşılama | Kullanım | Dialogflow etkinliği |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | Kullanıcıdan güncellemelere kaydolmasını ister. | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | Bu niyeti, kullanıcı güncellemelere kaydolmaya çalıştığında alırsınız (yani bir REGISTER_UPDATE niyeti gönderilmelidir). | actions_intent_CONFIGURE_UPDATES |
Özel amaçlar
Görüşmelerde kısayollar tanımlayarak kullanıcıların işlerini daha verimli bir şekilde yapmalarına yardımcı olmak için kendi amaçlarınızı oluşturabilirsiniz. Bu amaçlar kendi ad alanınızda yer alır. Kullanıcıların amaçları nasıl tetikleyeceğini siz tanımlarsınız ve Action paketiniz, bunları destekleyebilecek tek öğedir.
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ı belgelerinde bulabilirsiniz.
Akıllı ev amaçları
Bir akıllı ev işlemi oluşturuyorsanız niyet desteğini biraz farklı bir şekilde tanımlarsınız. Daha fazla bilgi için akıllı ev amaçları dokümanlarını inceleyin.