الفحوصات الصحية

تراقب Google الإجراءات المنشورة للتأكد من أنّها متاحة وتستجيب لطلبات المستخدمين.

يجب أن تستجيب نقطة نهاية الإجراء لكل إجراء تلقائي، بدون استدعاء معلَمة. يدعم هذا السيناريو الذي يطلب فيه المستخدم التحدث إلى إجراء بدون تقديم أي معلومات إضافية (على سبيل المثال، "أريد التحدث إلى اسم الاستدعاء").

الأسئلة الشائعة

هل أحتاج إلى تنفيذ أي إجراء محدّد لدعم عمليات التحقّق من الصحة؟

لا، ستعمل عمليات التحقّق من صحّة الإجراء كطلب عادي للتواصل مع إجراء معيّن.

كم مرة يتم فحص سلامة الإجراء الخاص بي؟

قد تتم مراقبة الإجراء الخاص بك على مدار اليوم.

كيف يمكنني اكتشاف أن الطلب هو فحص صحة؟

إذا كنت تستخدم "أداة إنشاء المهام" كمنصة للتطوير، ستتلقّى طلب فحص سلامة مشابهًا للمقتطف أدناه:

{
  "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" وتمرِّرها إلى الغرض. يمكن العثور على هذه الوسيطة في كائن الإدخال لطلب الرد التلقائي على الويب:

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

ماذا يحدث إذا رصدت Google إجراءً غير صحي؟ إذا اكتشفت Google أنّ الإجراء يواجه انقطاعًا في الخدمة، يتم تعليقه. سيسمع المستخدمون الذين يطلبون الإجراء غير الصحي الرسالة "ACTION_NAME غير متاح".

كيف سيتم إعلامي في حال تم تصنيف أحد الإجراءات على أنّه غير صحي؟ عندما ترصد Google إجراءً غير صحي، نرسل إشعارًا عبر البريد الإلكتروني إلى المطوّر الأساسي المرتبط بمشروع "المهام".

ماذا يحدث إذا تم تصنيف الإجراء الذي يستخدم ميزة ربط الحسابات على أنّه غير سليم؟ وعلى عكس "المهام" الأخرى، لا يتمّ تعليق الإجراءات التي تستخدم ميزة ربط الحسابات بعد أن تَقرّ Google أنّها غير سليمة. يبقى بإمكان المستخدمين الوصول إلى الإجراء الخاص بك لمدة 7 أيام من تاريخ تلقّي الإشعار عبر البريد الإلكتروني. في المقابل، ستتم إزالة الإجراء الخاص بك إذا لم يتم حلّ مشكلة ربط الحساب بعد مرور 7 أيام.

كيف يمكنني التحقّق من الحالة الصحية للإجراء الخاص بي؟ يمكنك التحقّق من وحدة تحكّم المطوّرين ومعرفة حالة الإجراء الخاص بك. سيتم تصنيف الإجراءات غير الصحية بالحالة غير صحية. سيتم وضع علامة تم النشر على الإجراءات الصحية.

ما هي عملية إرجاع مهمة إلى حالة نشرها؟ يجب عليك مراجعة عملية النشر ومعالجة أي مشكلات قد تتسبب في عدم استجابة الإجراء لهدف الإطلاق.

ستواصل Google مراقبة سلامة الإجراء بشكل دوري إذا كانت غير سليمة. عندما تكتشف Google أنّ الإجراء يستجيب على النحو المتوقّع، سيعود الإجراء إلى حالته التي تم نشرها.