الاستدلال غير المتزامن يفصل تلقي طلب التنبؤ عن تسلم مخرجه. في InvokeEndpointAsync الموثقة، تعيد العملية الناجحة استجابة 202 ومعرفًا ومواقع لحفظ خرج الاستدلال أو فشله. [1]
الخلاصة السريعة
تعامل مع المعرف كوسيلة ربط، ثم اقرأ دليل النتيجة الخاص بالطلب؛ قبول الطلب أو إعلان موقع الخرج لا يثبت اكتمال التنبؤ.
- تعيد الواجهة الموثقة InferenceId وموقع OutputLocation وموقع FailureLocation؛ ليست استجابة القبول نفسها قيمة التنبؤ. [1]
- في سجلنا الافتراضي ق 7 هو معرف طلب، و«بانتظار دليل الخرج» وصف معرفتنا؛ لا نحوله إلى فئة تنبؤ أو حكم فشل.
- اربط حمولة النتيجة أو الفشل بالطلب المقصود، واقرأ محتواها؛ غياب الملف عن المراجعة وحده لا يثبت سببًا أو نهاية المهمة.
- احتفظ بمدخل الطلب ونسخة النموذج ودليل الخرج في بطاقة واحدة؛ اكتمال الخرج لا يثبت صحته، ولم ننفذ استدعاء أو متابعة آلية.
ماذا تقول استجابة القبول؟
تصف وثائق InvokeEndpointAsync استجابة ناجحة برمز 202. يحمل InferenceId معرف الطلب، ويحدد OutputLocation موقع حمولة الاستدلال، وFailureLocation موقع حمولة الفشل. [1]
هذه أسماء لحقول في واجهة بعينها. لا نطلب من القارئ حفظها لكل نظام غير متزامن، بل تمييز أدوارها: معرف يربط، وعنوان يدل على موضع، وحمولة تحتوي ما نحتاج قراءته. لا يؤدي استبدال اسم «المعرف» باسم «النتيجة» في شاشة إلى تغيير محتواه.
قبل انتظار قيمة، اسأل ما الذي عاد بالفعل. قد تكون لديك بطاقة قبول فقط. لا تستخرج منها درجة احتمالية أو اسم فئة، لأن تعريفها لا يمنحها هذا الدور.
اكتب ما تعرفه في تلك اللحظة
نرسم سجلًا افتراضيًا لطلب نسميه ق 7. تحفظ بطاقة الإرسال مدخلًا واحدًا، ثم ترد بطاقة أخرى تحمل ق 7 وعنوانًا مخصصًا للخرج. في هذه اللحظة لم نضع في المثال حمولة نتيجة يمكن قراءتها.
الوصف الدقيق هو «تلقينا معرفًا وموقعًا، ولم نراجع الخرج بعد». عبارة «بانتظار دليل الخرج» هنا تصف معرفتنا في التمرين، وليست قيمة حالة رسمية أعدناها من واجهة SageMaker. لا نخترع اسم مرحلة لتقديمه كحقل موثق.
لو سمّى القارئ ق 7 «الفئة السابعة»، فقد غير معنى السجل بلا دليل. ولو اعتبر مجرد وجود عنوان دليلًا على اكتمال المحتوى، خلط بين مكان مقصود للحفظ ومحتوى تمت مراجعته. الفاصل المفيد هو نوع الدليل الذي لدينا الآن.
كيف تميز نتيجة عن دليل فشل؟
نكمل التمرين بثلاث بطاقات محتملة، لا بثلاث استجابات حدثت: الأولى حمولة تخص ق 7 وتحمل درجة 0.4؛ والثانية تقرير يخص ق 7 ويشرح فشلًا؛ والثالثة ملاحظة تقول إن المراجع لم يجد الملف عند الفحص.
البطاقة الأولى تقدم قيمة يمكن تفسيرها فقط إذا عرفنا تعريف الدرجة وعقد المخرج. الثانية تقدم دليلًا على فشل في الحالة الموصوفة. الثالثة لا تساوي الثانية: قد يكون الفحص مبكرًا أو العنوان غير المقصود أو سبب آخر لم يحدد في المثال.
نراجع تطابق المعرف والموقع والمحتوى قبل وصل بطاقة بالطلب. لا يعني ذلك أن كل خدمة توفر طريقة استطلاع واحدة أو الحقول نفسها. المقال لا يصف حلقات متابعة أو إعادة محاولة، ولا يستنتج من الغياب وحده ما حدث داخل التنفيذ.
ما الذي تحفظه للمراجعة اللاحقة؟
نضع في بطاقة ق 7 المدخل الذي أرسلناه، وهوية النموذج المقصود إن كانت معروفة، واستجابة القبول، ثم دليل الخرج الذي راجعناه. إذا كان أحد هذه العناصر مجهولًا نكتبه مجهولًا، بدل سد الفراغ بنتيجة طلب قريب في الزمن.
حتى حمولة الدرجة 0.4 لا تجيب وحدها هل التنبؤ جيد. نحتاج إلى معنى الدرجة والمهمة وما يقارن به الجواب. انتهاء العمل وتوفر قيمة لا يقومان مقام تقييم تلك القيمة.
الرسم يفصل معرف الطلب عن أدلة النتيجة والفشل المحتملة. لم نرسل طلبًا إلى خدمة، ولم نقرأ ملفات خرج حقيقية. يفيد الفصل حين يكتب محرر أو مطور شاشة انتظار: ما الذي ثبت، وما الذي يحتاج وصول دليل آخر؟
المصادر ومتابعة القراءة
- Amazon SageMaker AI Runtime: InvokeEndpointAsync (يفتح في نافذة جديدة)docs.aws.amazon.com
أُعدّ هذا المقال بصياغة عربية أصلية بالاستناد إلى المصادر أعلاه، وهو مدخل تمهيدي إلى الموضوع. اقرأ منهجية المحتوى وحدوده.
