Çağrı modeli, kullanıcıların projenizdeki İşlemleri nasıl çağıracağını belirtir. Kullanıcılar bir Action'ı çağırdığında, söz konusu işlemle ileti dizisi modelinize göre tanımlanır. Çağrıları tanımlayabilirsiniz. aşağıdaki şekillerde kullanabilirsiniz:
Ana çağrı - Bu Actions projeniz için gerekli tek çağrıdır. Kullanıcılar bir ifade söylüyor "Ok Google, bu amaca ulaşmak için <display name> ile konuş" ifadesine benzer, genellikle kullanıcıyı bir karşılama mesajıyla karşılarken ele aldığınız.
Derin bağlantı çağrıları - Bunlar, eğitim ifadelerini Böylece kullanıcılar, uygulamanızın belirli bir bölümüne derin bağlantı verebilir yardımcı olur. Kullanıcılar "Ok Google, Talk to <görünen ad> anahtar kelime öbeğini <derin bağlantı ifadesi>" olarak değiştirin amaçlar (örneğin, "Ok Google, şirket katılımı için Google'la ilgili bilgiler ile olgular")
Yerleşik amaçlar: Bunlar, sistem tanımlı olan çağrı modellerine sahiptir. Yerleşik amaç için destek bildirildiğinde kullanıcılar belirtmek zorunda kalmadan Actions projenizi keşfedip çağırın görünen ad. Örneğin, kullanıcılar "Ok Google, oyun oyna" dediklerinde ve Google Asistan, işleminizi bir çağrı seçeneği olarak sunabilir.
Ana çağrıyı oluşturun
Her Actions projesinin varsayılan olarak işlem yapan bir varsayılan ana çağrısı vardır
.Bu çağrının dil modeli,
ile ilişkilendirildiği için kullanıcıların tek istedikleri
bunu kullanmak için "Ok Google, <display name> ile konuş" benzeri bir ifade
çağrılacaktır. Kullanıcılar İşlemlerinizi bu şekilde çağırdığında Asistan,
çalışma zamanı, actions.intent.MAIN sistem niyetiyle eşleşiyor.
Ana çağrıyı oluşturmak için:
Derin bağlantı çağrıları oluşturma
Derin bağlantı çağrıları oluşturmak için eğitimle global kullanıcı amaçları oluşturursunuz derin bağlantı için ayarlamak istediğiniz kullanıcı girişini tanımlayan ifadeler. Kullanıcılar, görünen adınızı ve derin bağlantı ifadesini birlikte söyleyecek bir derin bağlantı çağrısı gönderir (örneğin, "Ok Google, <display ile konuş ad> to <derin bağlantı ifadesi>")
Örtülü çağrılar oluşturma
Örtülü çağrı, kullanıcıların projenizin işlevini kullanmadan İşleminizi çağırmasına olanak tanır. görünen ad. Google, eşleşen işlemleri bulmak için kullanıcılar gibi sinyallerden yararlanır. Asistan'a, birinin çağrı ifadesine benzer bir şey yapmasını söyler yapılandırdığınız bir bağlamda olduğunda veya kullanıcı Actions'ınızın uygun olur.
Çağrı etkinliklerini işleme
Asistan genel amaçlarınızdan biriyle eşleştiğinde tek bir kodla işleyebilir. Aşağıdaki bölümlerde işleyicinizin (ikisinden birini veya üçünün herhangi bir kombinasyonunu seçebilirsiniz).
Webhook tetikleme
Niyet işleyiciniz, webhook etkinliğini tetikleyerek bir web hizmetine yetki verebilir. Bir webhook'u tetiklemek ve çağrıyı bir web hizmetinin işlemesini sağlamak için:
İstemler
Niyet işleyiciniz statik bir istemle yanıt verebilir. Genellikle kullanıcıyı karşılayan, İşlemin nasıl kullanılacağı konusunda yönlendirmek veya Kullanıcının ihtiyaç duyduğu bilgilerle hemen yanıt verme (tek seferlik İşlemler).
Bir çağrı intent eşleşmesini istemle işlemek için:
Sahneye geçiş
Niyet işleyiciniz, eşleşen çağrıyı işlemek için bir sahneye geçiş yapabilir isteyebilirsiniz. Bu size mantığı uygulamak için en fazla esnekliği sağlar. Şu hesaba geçiş yapmak için: bir sahne: