Actions SDK'sına genel bakış (Dialogflow)

Actions on Google, Actions ile Google Asistan'ın işlevlerini genişletmenizi sağlar. İşlemler, kullanıcıların bir sohbet arayüzü üzerinden işlerini halletmesini sağlar. Bu arayüz, kısa bir komuttan bazı ışıkları ya da daha uzun bir görüşmeyi (ör. bilgi yarışması oyunu) etkinleştirmek için kullanılabilir.

Actions SDK'sı, Dialogflow kullanmadan görüşme memnuniyeti geliştirme yöntemidir. Actions SDK'yı kullanırken, niyetleri karşılama şekilleriyle eşlemek için bir İşlem paketi kullanırsınız. Kullanıcılarınızın söyleyebileceği örnek ifadeleri tanımlamak için İşlem paketinde sorgu kalıpları da sağlamanız gerekir.

aksiyonlar KSA

Actions SDK'sı ile geliştirme yaparken Actions projenizi test etmek ve güncellemek için gactions komut satırı arayüzünü (CLI) kullanırsınız. gactions KSA, Sohbet İşleminiz için İşlem paketini oluşturmanıza ve yönetmenize de yardımcı olur.

İşlem paketinizde İşlem Oluşturma

İşlemler paketinde niyetleri yerine getirme işlemiyle eşleyerek Actions'ı oluşturursunuz. İşlem, amaç adı verilen benzersiz bir tanımlayıcıyla görüşmeler başlatmak için bir giriş noktası tanımlar. Niyetler, niyeti işleyen istek karşılamalarıyla eşlenir.

Örneğin, bazı ürünleri satın almak, siparişlerin durumunu kontrol etmek ve bazı günlük fırsatları göstermek için Actions'ı içeren bir proje oluşturmak istediğinizi düşünelim. Tetiklenen niyetleri şu şekilde tanımlayabilirsiniz:

  • "Ok Google, ExampleAction ile konuş."
  • "Ok Google, ayakkabı almak için ExampleAction ile konuş."
  • "Ok Google, siparişimi kontrol etmek için ExampleAction ile konuş."
  • "Ok Google, bugünkü fırsatları göstermek için ExampleAction ile konuş."

İşlem paketi JSON dosyası aşağıdaki gibi görünebilir:

{
  "actions": [
    {
      "name": "MAIN",
      "intent": {
        "name": "actions.intent.MAIN"
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "BUY",
      "intent": {
        "name": "com.example.ExampleAction.BUY",
        "parameters": [{
          "name": "color",
          "type": "org.schema.type.Color"
        }],
        "trigger": {
          "queryPatterns": [
            "find some $org.schema.type.Color:color sneakers",
            "buy some blue suede shoes",
            "get running shoes"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "ORDER_STATUS",
      "intent": {
        "name": "com.example.ExampleAction.ORDER_STATUS",
        "trigger": {
          "queryPatterns": [
            "check on my order",
            "see order updates",
            "check where my order is"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "DAILY_DEALS",
      "intent": {
        "name": "com.example.ExampleAction.DAILY_DEALS",
        "trigger": {
          "queryPatterns": [
            "hear about daily deals",
            "buying some daily deals",
            "get today's deals"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  }
}

İstek karşılama webhook'u oluşturma ve dağıtma

Projenizde bir işlem çağrıldığında Actions on Google, işlemi gerçekleştirmek üzere kullanıcılarla görüşme başlatmak için karşılamanızı çağırır.

İstek karşılama webhook'unuza yapılan her istekte kullanıcı girişini metin dizesi olarak alırsınız. Niyeti işlemek için genellikle metin girişini ayrıştırır ve bir yanıt döndürür. Bu karşılıklı iletişim, İşleminizin görüşmesi sona erene kadar gerçekleşir.

İşlem paketinizi yükleyin

İşlem paketinizi oluşturduktan ve siparişin dağıtımını gerçekleştirdikten sonra İşlem paketinizi Actions konsoluna yükleyebilirsiniz. İşlemler konsolu, Sohbet İşleminizi, Asistan dizinindeki inceleme durumu ve görünen ad gibi meta verilerle gruplandırmak için kullanır. Proje, İşleminizle ilgili meta verileri tanımlamanıza ve İşleminizi onay süreci üzerinden yönetmenize ve izlemenize de olanak tanır.

Bir projeniz oluşturduktan sonra, tüm İşlemlerinizi tanımlayan İşlem paketinizi gactions KSA'yı kullanarak yükleyebilirsiniz.

Projenizi onay için gönderin ve kullanıcılara sunun

Örnekler

Tamamlanan projeleri keşfetmek için Node.js ve Java Actions SDK örneklerine bakın.