Health Check

Google memantau Action yang di-deploy untuk memverifikasi ketersediaannya dan merespons permintaan pengguna.

Setiap endpoint Action diperlukan untuk merespons panggilan default, tanpa parameter. Hal ini mendukung skenario saat pengguna meminta untuk berbicara dengan Action tanpa memberikan informasi tambahan apa pun (misalnya, "I want to talk to invocation name").

Pertanyaan umum

Apakah saya perlu menerapkan sesuatu yang spesifik untuk mendukung health check?

Tidak. Health check Action akan berfungsi seperti permintaan standar untuk berbicara dengan Action.

Seberapa sering respons Action saya diperiksa?

Action Anda mungkin dipantau sepanjang hari.

Bagaimana cara mendeteksi bahwa permintaan merupakan health check?

Jika menggunakan Action Builder sebagai platform pengembangan, Anda akan menerima permintaan health check yang mirip dengan cuplikan di bawah:

Catatan: Dengan Action Builder, jika Anda menggunakan library klien di webhook, health check akan ditangani untuk Anda.

{
  "handler": {
    "name": "actions.handler.HEALTH_CHECK"
  },
  "intent": {
    "name": "actions.intent.HEALTH_CHECK"
  },
  "session": {
    "id": "actions.session.HEALTH_CHECK"
  },
  "user": {
    "locale":"en-US"
  },
  "device": {
    "capabilities": []
  }
}
  

Saat menerima permintaan ini, Anda harus merespons dengan kode respons 200; jika tidak, Action Anda akan dianggap tidak responsif. Cuplikan berikut contoh respons yang diformat dengan benar:

  {"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}

Jika Anda menggunakan Dialogflow sebagai platform pengembangan, Google akan menambahkan argumen "is_health_check" dan meneruskannya ke intent. Argumen ini ditemukan dalam objek Input pada permintaan webhook:

{
  ...
  "originalDetectIntentRequest": {
    ...
    "payload": {
      ...
      "inputs": [{
        ...
        "arguments": [{
          "name": "is_health_check",
          "boolValue": true,
          "textValue": "1"
        }]
      }],
      ...
    }
  }
}
  

Apa yang terjadi jika Google mendeteksi Action yang tidak responsif? Jika Google mendeteksi bahwa Action mengalami gangguan, Action tersebut akan ditangguhkan. Pengguna yang meminta Action yang tidak responsif akan mendengar "ACTION_NAME tidak tersedia".

Bagaimana saya akan diberi tahu jika Action ditandai sebagai tidak responsif? Saat Google mendeteksi Action yang tidak responsif, kami akan mengirimkan email notifikasi ke developer utama yang terkait dengan project Action.

Apa yang terjadi jika Action saya yang menggunakan penautan akun ditandai sebagai tidak responsif? Tidak seperti Action lain, Action yang menggunakan penautan akun tidak ditangguhkan setelah Google menyatakannya tidak responsif. Pengguna masih dapat mengakses Action Anda selama 7 hari setelah Anda menerima email notifikasi. Namun, jika Anda belum memperbaiki masalah penautan akun setelah 7 hari, Action Anda akan dihapus.

Bagaimana cara memeriksa status respons Action saya? Anda dapat memeriksa konsol developer dan melihat status Action Anda. Tindakan Tidak sehat akan memiliki status Tidak sehat. Action Sehat akan ditandai sebagai Di-deploy.

Apa proses untuk menampilkan Action ke status di-deploy? Anda harus meninjau deployment dan mengatasi masalah apa pun yang mungkin menyebabkan Action gagal merespons intent peluncuran.

Google akan terus memantau kondisi Action secara berkala meskipun sedang tidak responsif. Saat Google mendeteksi bahwa Action merespons seperti yang diharapkan, Action akan kembali ke status di-deploy.