Örtük çağrı, kullanıcı bir işlemi ada göre gerçekleştirmeden bir görev gerçekleştirmek için istek yaptığında gerçekleşen bir etkileşim akışıdır. Google Asistan kullanıcının isteğini uygun bir siparişle (ör. İşlem, arama sonucu veya mobil uygulama) eşleştirmeye çalışır. Daha sonra kullanıcıya öneriler sunar.
Kullanıcının görevine yardımcı olabilecek bir İşlem dağıttıysanız dolaylı çağrı, kullanıcıların Asistan üzerinden Action'ınızı keşfetmesini sağlar.
İşleyiş şekli
Eşleşen işlemleri bulmak için Google, kullanıcılara Asistan'a yapılandırılmış niyetlerinizden biri için çağrı ifadesine benzer bir işlem yapmasını söyleyen veya kullanıcının, İşleminizin uygun olacağı bir bağlamda olduğu gibi sinyaller kullanır.
Bu etkileşim şu şekilde gerçekleşir:
- Kullanıcı, Asistan'dan bir görevi gerçekleştirmesini ister.
- Öneri algoritması, Action'ınızın kullanıcının görevini tamamlayabileceğini belirler.
- Asistan, işleminizi kullanıcılara önerir.
Kullanıcı, örtülü çağrıdan sonra İşleminizi seçtiğinde Asistan, Action'ınızı kullanıcının istediği görevle ilgili olarak bilgilendirir.
Aşağıdaki örnekte bir kullanıcının, bir Action'ın çağrı adını belirtmeden bir tavuk çorbası tarifi isteyerek dolaylı bir çağrıyı nasıl tetikleyebileceği gösterilmektedir.
| Kullanıcı | Ok Google, tavuk çorbası tarifi istiyorum. |
| <Asistan, Actions on Google platformunu sorgulayarak kullanıcının isteğine uygun İşlemleri bulur> | |
| Asistan | Kesinlikle. Bunun için Kişisel Şef'i tercih edebilirsin. Denemek ister misin? |
İşleminizin çağrı ifadeleri alakalı çeşitli kullanıcı sorgularıyla eşleştirilemiyorsa alakalı olarak tanınmaz. Daha fazla bilgi için Faydalı çağrı ifadeleri yazmayla ilgili en iyi uygulamalar bölümüne bakın.
Öneri algoritmasının değişen yapısı nedeniyle Google, İşleminizin dolaylı çağrı üzerinden önerileceğini garanti edemez.
Çağrı ifadeleri ekleyin
Bu bölümde, İşleminizi oluşturmak için Dialogflow veya Actions SDK kullanıyorsanız dolaylı çağrı için çağrı ifadelerini nasıl ekleyeceğiniz açıklanmaktadır.
Dialogflow
Eğitim ifadelerinizde varlıklar kullanıyorsanız öğe içeren ifadelere ilişkin gereksinimler hakkında bilgi edinin.
Dialogflow'da işlemleriniz ve çağrı ifadeleri, dolaylı çağrı için belirttiğiniz niyetlerle ilgili eğitim ifadeleri olarak tanımlanır. Dialogflow entegrasyon kılavuzunda açıklandığı gibi, Dialogflow konsolunda tek adımlı bir işlem kullanarak Derin Bağlantılar ve İşleminiz için dolaylı çağrılar desteği ekleyebilirsiniz.
Actions SDK
Actions SDK'da, Actions ve çağrı ifadeleri, sorgu kalıpları olarak tanımlanır. Daha fazla bilgi için İşlemleri tanımlama bölümüne bakın.
Dolaylı çağrıları analiz etme ve görüntüleme
Bu bölümde, İşleminizle eşleşen dolaylı çağrılar hakkındaki bilgileri analiz etmek ve görüntülemek için Actions console'un nasıl kullanılacağı açıklanmaktadır.
Keşif analizi
Actions Console'un Analytics > Discovery bölümünde, Asistan'ın İşleminizi önermesini sağlayan ifadeler ve amaçlarınızdan hangisinin istemle eşleştiği hakkında faydalı bilgiler sağlanır.
Konsol analizleri ve sağlığı ile ilgili dokümanlarımızda daha fazla bilgi bulabilirsiniz.
Çağrı ifadelerini görüntüleyin
İşlemler konsolunda, Action'ınızı ve çağrı ifadelerini Derleme > İşlemler altında görüntüleyebilirsiniz.
Listelenen İşlemler'den herhangi birini tıklayarak çağrı ifadesini görüntüleyebilirsiniz. Dialogflow'u kullanıyorsanız Daha fazla ifade ekleme seçeneği sunulur. Bu seçenek, sizi Dialogflow'da doğrudan İşleminizin amaçlarına yönlendirir.
Varlıklı ifadeler için gereksinimler
Dialogflow'u kullanıyorsanız aşağıdaki kurallar varlıklar için geçerlidir. Bu söz dizimi kuralları, kelimeler arasında boşluk ayrımının kullanılmadığı diller (ör. Korece ve Tayca) için de geçerlidir.
- Bir ifadeyi bir ifadeye yerleştirirseniz öncesinde ve sonrasında boşluk bırakmalısınız.
- Bir kelime öbeğinin başına yerleştirildiğinde varlıktan önce boşluk eklemeniz gerekmez.
- Bir kelime öbeğinin sonuna yerleştirilmişse varlıktan sonra boşluk eklemeniz gerekmez.
Bir varlık, metinden boşlukla ayrılmamışsa Actions on Google, varlık için herhangi bir değer değişikliği olmadan tüm ifadeyi bir dize olarak okur.
Amaçlanan değerin korunduğundan emin olmak için Actions simülatöründe varlık ve metin içeren ifadeleri test etmelisiniz.
Daha fazla bilgi için Dialogflow varlıklara genel bakış bölümünü inceleyin.
Faydalı çağrı ifadeleri yazmaya ilişkin en iyi uygulamalar
Çağrı ifadeleri kullanıcılar için faydalı bir çağrı ve keşif aracı sunar, ancak bunları dikkatli bir şekilde seçmeniz gerekir. İşleminizin çağrı ifadelerini tasarlarken aşağıdaki en iyi uygulamaları aklınızda bulundurun:
Çağrı ifadelerinizi İşleminizin kullanım alanlarına özel tutun
İşleminiz belirli bir amaca hizmet etmelidir. Bu nedenle, çağrı ifadelerinin İşleminizin ne yaptığını gerçekten açıkladığından emin olun. Örneğin, İşleminiz uçuş rezervasyonu için kullanılıyorsa "$location'dan $location'ye nasıl giderim?" kullanmayın. Daha iyi bir alternatif, "$location - $location uçuş rezervasyonu yapın.".
- Çağrı ifadeleriniz varlıklar içeriyorsa bu varlıkların tüm eş anlamlılarının kelime öbekleriyle ve İşleminizin kullanım alanıyla genel olarak alakalı olduğundan emin olun.
Hem fiil hem de nesne içeren ifadeler oluşturun
Çağırma, tam bir cümleden oluşur. Yani, eyleminizin çağrı kelime öbeği, dilsel doğal olmak için fiil figürü çifti olmalıdır. Örneğin, tam çağrı "Ok Google, Kolay yemek tarifi" olacağı için "Kolay tarif." iyi bir çağrı ifadesi olmaz. Bunun yerine "Kolay bir yemek tarifi nasıl yapılır?" yerine "Ok Google, kolay bir yemek tarifi nasıl yapılır?" ifadesi kullanılabilir.
Aşağıdaki kötü ve iyi çağrı ifadelerine örnekler verin:
Kötü çağrı ifadeleri
- Kelime öbeğinde fiil yok: "Beş numara."
- Kelime öbeği çok genel: "İstanbul'a Seyahat."
İyi çağrı ifadeleri
- İfadede net bir fiil ve nesne var: "Baba şakalarını dinle."
Kelime öbeği belirli istekler sağlar:
- "Bugün ne giysem?"
- "Bilgi yarışması oynamak istiyorum."
- " için bebek adları almak istiyorum."
Bu çağrı ifadeleri İşleminize özel olmayabilir; kullanıcılara hangi İşlemleri önereceğine Asistan karar verir.