ภาพรวม Actions SDK (Dialogflow)

Actions on Google ช่วยให้คุณขยายฟังก์ชันการทำงานของ Google Assistant ได้ด้วย การดำเนินการ การดำเนินการช่วยให้ผู้ใช้ทำสิ่งต่างๆ ให้เสร็จผ่านอินเทอร์เฟซแบบสนทนา ซึ่งมีตั้งแต่คำสั่งด่วนเพื่อเปิดไฟบางดวงหรือใช้เวลานานขึ้น เช่น การเล่นเกมทายปัญหา

Actions SDK เป็นวิธีการพัฒนาการดำเนินการเพื่อดำเนินการตามการสนทนาโดยไม่มี โดยใช้ Dialogflow เมื่อใช้ Actions SDK คุณจะใช้แพ็กเกจการดําเนินการเพื่อ จะแมป Intent เพื่อดำเนินการตามคำสั่งซื้อได้ นอกจากนี้ คุณยังต้องระบุรูปแบบคำค้นหาใน แพ็กเกจการดำเนินการเพื่อกำหนดวลีตัวอย่างที่ผู้ใช้อาจพูด

CLI ของ Gactions

เมื่อพัฒนาด้วย Actions SDK คุณจะใช้บรรทัดคำสั่ง gactions Interface (CLI) เพื่อทดสอบและอัปเดตโปรเจ็กต์ Actions gactions CLI ยังช่วยให้คุณสร้างและจัดการแพ็กเกจการดำเนินการสำหรับการดำเนินการแบบการสนทนาได้อีกด้วย

สร้างการดำเนินการในแพ็กเกจการดำเนินการ

คุณสร้างการดำเนินการในแพ็กเกจการดำเนินการได้โดยการแมป Intent กับ Fulfillment การดำเนินการกำหนดจุดแรกเข้าเพื่อเริ่มการสนทนากับ ที่เรียกว่าความตั้งใจ Intent จะแมปกับการดำเนินการให้สมบูรณ์ ซึ่งประมวลผล Intent

ตัวอย่างเช่น สมมติว่าคุณต้องการสร้างโปรเจ็กต์ที่มีการดำเนินการ ซื้อสินค้า ตรวจสอบสถานะคำสั่งซื้อ และเพื่อแสดงดีลประจำวัน คุณระบุ Intent ที่ทริกเกอร์ได้โดยพูดว่า

  • "Ok Google คุยกับ ExampleAction"
  • "Ok Google ขอคุยกับ ExampleAction เพื่อซื้อรองเท้าสักคู่"
  • "Ok Google ขอคุยกับ ExampleAction เพื่อตรวจสอบคำสั่งซื้อของฉัน"
  • "Ok Google ขอคุยกับ ExampleAction เพื่อแสดงดีลของวันนี้หน่อย"

ไฟล์ JSON ของแพ็กเกจการดำเนินการอาจมีลักษณะดังนี้

{
  "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"
    }
  }
}

สร้างและทำให้เว็บฮุคการดำเนินการตามคำสั่งซื้อใช้งานได้

เมื่อมีการเรียกใช้ Actions ในโปรเจ็กต์ของคุณ Actions on Google จะเรียก Fulfillment เพื่อเริ่มบทสนทนากับผู้ใช้เพื่อดำเนินการตามการดำเนินการนั้น

ในทุกคำขอที่ส่งไปยังเว็บฮุคของการดำเนินการตามคำสั่งซื้อ คุณจะได้รับข้อมูลจากผู้ใช้เป็น สตริงข้อความ ในการประมวลผลความตั้งใจ คุณมักจะแยกวิเคราะห์ข้อความที่ป้อนและ แสดงคำตอบ การแลกเปลี่ยนข้อมูลระหว่างกันนี้จะเกิดขึ้นจนกว่าการดำเนินการ จบการสนทนา

อัปโหลดแพ็กเกจการดำเนินการ

เมื่อสร้างแพ็กเกจการดำเนินการและทำให้การดำเนินการดำเนินการตามคำสั่งซื้อใช้งานได้แล้ว คุณสามารถอัปโหลดแพ็กเกจการดำเนินการ ไปยังคอนโซลการดำเนินการ คอนโซล Actions ใช้โปรเจ็กต์การดำเนินการเพื่อจัดกลุ่มการดำเนินการแบบการสนทนากับข้อมูลเมตา เช่น การตรวจสอบ สถานะและชื่อที่แสดงในไดเรกทอรี Assistant โปรเจ็กต์นี้ยังให้คุณ กำหนดข้อมูลเมตาเกี่ยวกับการดำเนินการของคุณ ตลอดจนจัดการและติดตามการดำเนินการของคุณผ่าน ขั้นตอนการอนุมัติ

เมื่อมีโปรเจ็กต์ คุณสามารถอัปโหลดแพ็กเกจการดำเนินการที่กำหนดทั้งหมด การดำเนินการโดยใช้ gactions CLI

ส่งโปรเจ็กต์เพื่อขออนุมัติและทำให้ผู้ใช้ใช้งานได้

ตัวอย่าง

หากต้องการสำรวจโปรเจ็กต์ที่เสร็จสมบูรณ์แล้ว โปรดดูตัวอย่าง Actions SDK ของ Node.js และ Java