Actions on Google webhook biçimleri (Dialogflow)

Bu dokümanda, Actions on Google ile özel bir sohbet kullanıcı arayüzü tanımlayan istek karşılama hizmeti arasındaki iletişimde kullanılacak webhook biçimi açıklanmaktadır.

Actions on Google ile istek karşılamanın Actions on Google webhook biçimleri üzerinden nasıl iletişim kurduğunu anlamanız önemlidir:

  • Actions on Google ile görüşmelere katılmak için istek karşılama mantığınız, Actions on Google'dan gelen HTTP isteklerine yanıt verebilen bir webhook uygular.
  • Kullanıcılar İşleminizi çağırdığında, karşılamanıza kullanıcının isteğini açıklayan bir JSON yükü içeren bir HTTP POST gönderilir.
  • Buna karşılık, istek karşılama mantığınız istek yükündeki parametreleri okumaktan, JSON biçimli uygun bir yanıt oluşturmaktan ve bu yanıtla Asistan'a yanıt göndermekten sorumludur.

İstek türleri

Bu tabloda webhook'unuzun Asistan'dan alabileceği istek türleri özetlenmektedir:

Tür Açıklama JSON Örnekleri
Çağrı istekleri Talebinizin karşılanmasıyla ilgili iletişimi başlatan veya derin bağlantı İşlemlerini tetikleyen kullanıcı ifadeleri (örneğin, "Akşam yemeği tarifleri bulmak için Kişisel Şef ile konuşun").
  • Dialogflow kullanılıyorsa bu istekler Google Asistan entegrasyon ayarlarının Keşif bölümünde tanımlanan amaçlara karşılık gelir.
  • Actions SDK'sını kullanıyorsanız bu istekler İşlem paketinizde tanımlanan amaçlara karşılık gelir.
Görüşme istekleri Sipariş karşılama sürecinizle görüşme başladıktan sonra aynı oturumdaki kullanıcıların söyledikleri. Görüşme webhook'u biçiminde, bunlar önceki turda karşılamanızın istediği actions.intent.TEXT amaçlarına karşılık gelen kullanıcıdan gelen ham metin yanıtlarıdır.
Yardımcı sonuçları Webhook'unuz, görüşmenin bazı bölümlerini (örneğin, actions.intent.OPTION ve actions.intent.PERMISSION) işlemek için görüşmenin önceki sırasında yardımcı amaç istediğinde Asistan tarafından istek karşılama mantığınıza gönderilen istekler.

Görüşme istekleri ve yanıtları

Tipik bir Actions on Google etkileşim senaryosunda, kullanıcılar bir işlemi çağırmak için bir kelime söyler. Actions on Google, yanıt sağlamak için kullanıcı tarafından çağrılan işlemle eşleşen istek karşılamayı bulur ve isteği oraya gönderir.

Actions on Google, karşılama işleminizin kullanıcının çağrısı için uygun olduğunu belirlediğinde istek karşılama uç noktanıza kullanıcının istek bilgilerini içeren JSON yükü içeren bir HTTP isteği göndererek görüşme oturumu başlatır. İstek yerine getirmeniz, isteği ayrıştırır ve JSON yükü içeren bir yanıt döndürür. Actions on Google, daha sonra yükü kullanıcılar için oluşturulan konuşma ve multimedya çıkışına dönüştürür.

Şekil 1. Karşılamanızı Actions SDK'sı aracılığıyla çağıran Actions on Google.

Actions on Google, Actions SDK'sı aracılığıyla karşılamanızı çağırdığında JSON yükünün biçimi hakkında daha fazla bilgi edinmek için Sohbet webhook biçimi bölümünü inceleyin.

Dialogflow istekleri ve yanıtları

Actions oluşturduğunuzda, sohbet arayüzleri oluşturma görevini basitleştirmek için isteğe bağlı olarak Dialogflow'u kullanabilirsiniz. Bu senaryoda Dialogflow, Actions on Google ile istek karşılama arasında bir proxy işlevi görür. Actions on Google, HTTP/JSON isteğini doğrudan istek karşılama uç noktanıza göndermek yerine Dialogflow'a gönderir.

Dialogflow, orijinal istekteki JSON yükünü Dialogflow webhook biçimine sarar ve elde edilen isteği Dialogflow karşılamanıza yönlendirir.

Buna karşılık, karşılama işleminiz Dialogflow'a yanıt gönderdiğinde, yanıtın JSON yükü Dialogflow webhook biçimine uygun olmalıdır. İstekte bulunmanız, Dialogflow JSON isteğinden parametreleri ayrıştırır ve Dialogflow webhook biçiminde bir yanıt oluşturur. Daha sonra Dialogflow, karşılamanızdan gelen yanıtı Asistan'ın anladığı bir yanıt mesajına dönüştürür.

Şekil 2. Dialogflow aracılığıyla karşılamanızı çağıran Actions on Google.

Actions on Google, Dialogflow aracılığıyla karşılamanızı çağırdığında JSON yükünün biçimi hakkında daha fazla bilgi edinmek için Dialogflow webhook biçimi bölümüne bakın.