Çağrı modeli, kullanıcıların projenizdeki işlemleri nasıl çağıracağını belirler. Kullanıcılar bir İşlemi çağırdıklarında görüşme modeliniz tarafından tanımlanan işlemle bir görüşme başlatırlar. Çağrıları aşağıdaki şekillerde tanımlayabilirsiniz:
Ana çağrı: Actions projeniz için gerekli olan tek çağrı budur. Kullanıcılar bu amaca ulaşmak için "Ok Google, <display name> ile konuş" benzeri bir ifade kullanır. Bu cümle, genellikle kullanıcıyı karşılama mesajıyla karşılayarak halleder.
Derin bağlantı çağrıları: Özel bir amaçta eğitim ifadelerini tanımlamanıza olanak tanıyan isteğe bağlı çağrılardır. Böylece kullanıcılar, görüşmenizin belirli bir kısmıyla derin bağlantı kurabilir. Kullanıcılar bu tür niyetlerle eşleştirmek için "Ok Google, <display name> ile <deep linkphrase> arasında konuşun" benzeri bir ifade kullanabilir (örneğin, "Ok Google, şirketle ilgili bilgileri almak için Google hakkındaki bilgiler ile konuşun")
Yerleşik amaçlar: Bunlar, sistem tanımlı çağrı modellerinden yararlanmanızı sağlayan isteğe bağlı çağrılardır. Yerleşik bir amaca yönelik destek belirten kullanıcılar, görünen adınızı belirtmek zorunda kalmadan Actions projenizi keşfedip çağırabilir. Örneğin, kullanıcılar "Ok Google, oyun oyna" diyebilir ve Google Asistan, İşleminizi bir çağrı seçeneği olarak sunabilir.
Ana çağrıyı oluştur
Her Actions projesinin, Actions projenize varsayılan giriş noktası görevi gören bir varsayılan ana çağrısı vardır. Bu çağrının dil modeli, projenizin görünen adıyla ilişkilendirilir. Bu nedenle, kullanıcıların bu çağrıyı kullanmak için "Ok Google, <display name> ile konuş" benzeri bir kelime öbeği söylemesi yeterlidir. Kullanıcılar İşlemlerinizi bu şekilde çağırdığında Asistan çalışma zamanı, actions.intent.MAIN sisteminin amacıyla eşleşir.
Ana çağrıyı oluşturmak için:
Derin bağlantı çağrıları oluşturma
Derin bağlantı çağrıları oluşturmak amacıyla, derin bağlantı için ayarlamak istediğiniz kullanıcı girişini tanımlayan eğitim ifadeleriyle genel kullanıcı amaçları oluşturursunuz. Kullanıcılar, görünen adınızı derin bağlantı çağrısı yapmak için derin bağlantı ifadesiyle birlikte söyler (örneğin, "Ok Google, <görüntülü ad> ile <deep bağlantı ifadesi> konuşun")
Örtülü çağrılar oluşturma
Dolaylı çağrı, kullanıcıların projenizin görünen adını kullanmadan İşleminizi çağırmasına olanak tanır. Google, eşleşen İşlemleri bulmak için kullanıcıların, yapılandırılmış amaçlarınızdan biri için çağrı ifadesine benzer bir şey yapması için Asistan'a söylemesi veya kullanıcı, İşlemlerinizin uygun olacağı bir bağlamda bulunması gibi sinyalleri kullanır.
Çağrı etkinliklerini işleme
Asistan, genel amaçlarınızdan biriyle eşleştiğinde, işleyici ile işleyebileceğiniz bir etkinliği tetikler. Aşağıdaki bölümlerde işleyicinizin neler yapabileceği açıklanmaktadır (ikisinden birini veya herhangi bir kombinasyonunu seçebilirsiniz).
Webhook tetikleme
Amaç işleyiciniz bir webhook etkinliğini tetikleyerek bir web hizmetine yetki verebilir. Bir webhook'u tetiklemek ve bir web hizmetinin çağrıyı işlemesini sağlamak için:
İstemler
Amaç işleyiciniz statik bir istemle yanıt verebilir. Genellikle çağrı amaçlarıyla ilgili istemler kullanıcıyı karşılar, işlemi nasıl kullanacağı konusunda yönlendirir veya kullanıcının hemen ihtiyaç duyduğu bilgilere (tek seferlik İşlemler) yanıt verir.
Bir çağrı amacı eşleşmesini bir istemle işlemek için:
Bir sahneye geçiş
Amaç işleyiciniz, eşleşen çağrı niyetini işlemek için bir sahneye geçiş yapabilir. Bu, size mantığı yürütmek için en fazla esneklik sağlar. Bir sahneye geçiş yapmak için: