İşlemler SDK'sına genel bakış (Dialogflow)

Actions on Google, Google Asistan'ın işlevlerini İşlemler. İşlemler, kullanıcıların sohbet arayüzü üzerinden işlem yapmasına olanak tanır kısa bir komuttan bazı ışıkları açmak veya daha uzun bir süre için Örneğin bilgi yarışması oynayabilirsiniz.

Actions SDK'sı, API kullanmadan sohbetlerin karşılanmasını nasıl kullanacağınızı göstereceğim. Actions SDK'sını kullanırken İşlem paketi kullanarak amaçları karşılamalarıyla eşler. Sorgu kalıplarını Kullanıcılarınızın söyleyebileceği örnek ifadeler tanımlamak için işlem paketi.

gactions KSA

Actions SDK ile geliştirme yaparken gactions komut satırını kullanırsınız arayüzünü (KSA) kullanarak Actions projenizi test edip güncelleyin. gactions KSA Conversational Action'ınız için İşlem paketini oluşturmanıza ve yönetmenize de yardımcı olur.

İşlem paketinizde İşlemler oluşturma

Amaçları istek karşılama ile eşleyerek İşlem paketinizde İşlemler oluşturursunuz. Bir İşlem, görüşme başlatmak için benzersiz bir amaç adı verilen bir tanımlayıcıdır. Amaçlar, sipariş karşılama ile eşlenir. isteyebilirsiniz.

Örneğin, Virtual Verde için Eylemler içeren bir bazı ürünler satın alabilir, siparişlerin durumunu kontrol edebilir ve bazı günlük fırsatları gösterebilirsiniz. Tetiklenen amaçları şu şekilde tanımlayabilirsiniz:

  • "Ok Google, Ornekİşlemi ile konuş."
  • "Ok Google, ayakkabı satın almak için Ornekİşlemi 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"
    }
  }
}

Karşılama webhook'u oluşturma ve dağıtma

Projenizde bir Action çağrıldığında, Actions on Google Eylemi gerçekleştirmek için kullanıcılarla görüşme başlatmak üzere istek karşılama.

Karşılama webhook'unuza yapılan her istekte kullanıcı girişini metin dizesi. Amacı işlemek için genellikle metin girişini ayrıştırır ve yanıt verebilir. Bu karşılıklı etkileşim, İşleminiz iletişim sona erer.

İşlem paketinizi yükleyin

İşlem paketinizi oluşturduktan ve sipariş karşılamayı dağıttıktan sonra İşlem paketinizi Actions konsoluna yükleyebilirsiniz. Actions konsolu Conversational Action'ı inceleme gibi meta verilerle gruplandırmak için Eylem projelerini kullanır durumunu ve görünen adı kontrol edin. Bu proje ayrıca, İşleminizle ilgili meta verileri tanımlama ve onay sürecine tabidir.

Projeniz olduğunda tüm eylem paketinizi tanımlayan gactions KSA'yı kullanarak işlemleriniz.

Projenizi onay için gönderin ve kullanıcıların kullanımına sunun

Örnekler

Tamamlanan projeleri keşfetmek için Node.js ve Java Actions SDK örneklerini görüntüleyin.