بررسی های سلامت

ناظران Google برای تأیید اینکه در دسترس هستند و به درخواست‌های کاربر پاسخ می‌دهند، Actions را اجرا کردند.

نقطه پایانی هر Action برای پاسخ به یک فراخوانی پیش‌فرض و بدون پارامتر لازم است. این از سناریویی پشتیبانی می‌کند که در آن کاربر بدون ارائه اطلاعات اضافی، درخواست می‌کند با یک Action صحبت کند (به عنوان مثال، "من می‌خواهم با نام فراخوانی صحبت کنم" ).

سوالات متداول

آیا برای پشتیبانی از بررسی های سلامت نیاز به اجرای چیز خاصی دارم؟

خیر. بررسی‌های سلامت Action مانند یک درخواست استاندارد برای صحبت با یک Action عمل می‌کنند.

سلامت اکشن من هر چند وقت یکبار بررسی می شود؟

ممکن است Action شما در طول روز تحت نظر باشد.

چگونه می توانم تشخیص دهم که یک درخواست چک سلامت است؟

اگر از Actions Builder به عنوان پلتفرم توسعه خود استفاده می کنید، یک درخواست بررسی سلامت مشابه قطعه زیر دریافت می کنید:

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

وقتی این درخواست را دریافت کردید، باید با یک کد پاسخ 200 پاسخ دهید. در غیر این صورت، اقدام شما ناسالم تلقی می شود. قطعه زیر نمونه ای از یک پاسخ با قالب بندی مناسب است:

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

اگر از Dialogflow به‌عنوان پلتفرم توسعه خود استفاده می‌کنید، Google یک آرگومان "is_health_check" اضافه می‌کند و آن را به intent ارسال می‌کند. این آرگومان در شیء ورودی درخواست webhook یافت می شود:

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

اگر گوگل یک اقدام ناسالم را تشخیص دهد چه اتفاقی می افتد؟ اگر Google تشخیص دهد که Action دچار قطعی شده است، Action به حالت تعلیق در می‌آید. کاربرانی که اقدام ناسالم را درخواست می کنند، «ACTION_NAME در دسترس نیست» را خواهند شنید.

اگر یک اقدام به عنوان ناسالم علامت گذاری شود، چگونه به من اطلاع داده می شود؟ وقتی Google یک اقدام ناسالم را تشخیص می‌دهد، یک ایمیل اعلان به برنامه‌نویس اصلی مرتبط با پروژه Actions ارسال می‌کنیم.

اگر اقدام من که از پیوند حساب استفاده می کند به عنوان ناسالم علامت گذاری شود چه اتفاقی می افتد؟ برخلاف سایر Actions، اقداماتی که از پیوند حساب استفاده می‌کنند، پس از اعلام ناسالم Google، به حالت تعلیق در نمی‌آیند. پس از دریافت ایمیل اعلان، کاربران همچنان می توانند به مدت 7 روز به Action شما دسترسی داشته باشند. با این حال، اگر بعد از 7 روز مشکل پیوند حساب را برطرف نکرده باشید، Action شما حذف خواهد شد.

چگونه می توانم وضعیت سلامتی Action خود را بررسی کنم؟ می توانید کنسول توسعه دهنده خود را بررسی کنید و وضعیت Action خود را ببینید. اقدامات ناسالم وضعیت ناسالم خواهد داشت. اقدامات سالم به عنوان مستقر شده علامت‌گذاری می‌شوند.

روند بازگرداندن یک Action به حالت Deployed چیست؟ شما باید استقرار خود را بررسی کنید و به مشکلاتی که ممکن است باعث شود Action به قصد راه اندازی پاسخ ندهد رسیدگی کنید.

Google به طور دوره‌ای سلامت Action را در حالی که ناسالم است نظارت می‌کند. وقتی Google تشخیص داد که Action همانطور که انتظار می‌رود پاسخ می‌دهد، Action به حالت پیاده‌سازی برمی‌گردد.