الإسناد إلى الويب لـ Decisions API

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

بدءًا من اليوم، أصبح بإمكان Decisions API من Perplexity البحث في الويب قبل الإجابة.

أضف إعدادًا واحدًا، "mode": "web_grounding" إلى أي طلب Decisions API، وسيُجري Perplexity Fast Search استعلامًا واحدًا لكل سؤال. تُضاف النتائج إلى الحالة لديك بوصفها أدلة، فيُرجع نموذج القرار احتمالات مستنيرة بما هو موجود على الويب الآن. ويمكن أن تكون الحالة أيضًا عنوان URL لتوجيه النموذج إلى صفحة ويب محددة بدلًا من إدخال نصها.

في معيار PWS-Decisions، وهو معيار عام يضم 100 سؤال تعتمد على حقائق الويب الحالية، ارتفعت الدقة من 51% إلى 86%، مع استجابات تستغرق عادةً أقل من 400 مللي ثانية.

يُرجع نموذج القرار رقمًا كإجابة عن كل سؤال. يرسل المستخدمون المحتوى بوصفه state (نصًا أو JSON أو صورًا) مع سؤال واحد أو أكثر. في سؤال noul (نعم أو لا)، تكون النتيجة هي احتمال الإجابة بنعم. وفي سؤال choice، تكون النتيجة احتمالًا لكل خيار يحدده المستخدم. وفي سؤال score، تكون النتيجة احتمالًا لكل مستوى من مستويات معايير التقييم لديك، إلى جانب الدرجة المتوقعة.

لدى النموذج مصدران للمعلومات: الحالة التي يرسلها المستخدم، وما تعلّمه أثناء التدريب. وهذا كافٍ لسؤال مثل «هل تُبلغ هذه المراجعة عن عيب؟» لكنه غير كافٍ للإجابة عن «هل لا يزال هذا الشخص هو الرئيس التنفيذي؟» فقد تكون الإجابة تغيّرت بعد التدريب، ولا يوجد في الحالة ما يشير إلى ذلك. يضيف الإسناد إلى الويب مصدرًا ثالثًا: الويب، الذي يُبحث فيه وقت تقديم الطلب. ويمكن أن تكون الحالة أيضًا عنوان URL، بحيث يستطيع المستخدم توجيه النموذج إلى صفحة ويب بدلًا من النص.

يعمل الإسناد في بوابة API قبل استدعاء النموذج. فلكل سؤال في الطلب، تُنشئ البوابة استعلام Fast Search، وتُنفَّذ الاستعلامات بالتوازي. ثم تدمج البوابة النتائج، وتحذف عناوين URL المكررة، وتُلحق الأدلة بقيمة state: العنوان وعنوان URL ونص الصفحة. وإذا كانت قيمة state عنوان URL، فإن استعلام البحث يحمل هذا العنوان، فتعود الصفحة نفسها دليلًا ويُجيب النموذج استنادًا إلى نصها. ويُعيد النموذج الاحتمالات تمامًا كما يفعل مع أي طلب إلى Decisions API. وإذا فشل البحث أو انتهت مهلته، يُجيب النموذج استنادًا إلى ما عاد من أدلة. وتتضمن الاستجابة الحقل search_results ليتمكن المستخدم من الاطلاع على ما رآه النموذج. ويظل طلب المستخدم وبنية الاستجابة كما هما، وإنما يتغير ما يتوفر للنموذج من أدلة عند الإجابة.

أرسلنا 328 ادعاءً من نوع صواب أو خطأ إلى نموذج القرار نفسه مرتين، مرة مع الإسناد إلى الويب ومرة من دونه. وتوزعت الادعاءات بين أخبار أكتوبر 2026 وحقائق نادرة من ويكيبيديا، وكان لكل ادعاء صحيح توأم خاطئ يختلف عنه في تفصيل واحد. ولم تُقدَّم أي أدلة في الحالة.

من دون الإسناد إلى الويب، أجاب Decisions API إجابة صحيحة عن 56.4% من الادعاءات، وهي نسبة قريبة من التخمين. ومع الإسناد إلى الويب، بلغت نسبة الإجابات الصحيحة 97.3%، فانخفض عدد الأخطاء من 143 إلى 9. والمقابل هو السرعة: إذ ارتفع وسيط زمن الاستجابة من 139 مللي ثانية إلى 366 مللي ثانية، وارتفع زمن الاستجابة عند المئين الخامس والتسعين من 514 مللي ثانية إلى 742 مللي ثانية.

PWS-Decisions هو معيار أداء عام يتكون من أسئلة مغلقة حول أهلية الحسابات وإمكانات المنتجات وقواعد السياسات والأحداث سريعة التطور. ومن بينها 100 سؤال متاحة للعامة، وتُقيَّم بالمطابقة التامة مع إجابة مرجعية. وقد شغّلنا هذه الأسئلة على Decisions API + Web Grounding (pplx-decider-v1.2) في 4 نوفمبر 2026، فأجاب إجابة صحيحة عن 86 منها. أما النتائج الأخرى أدناه فهي لوحة الصدارة التي نشرها مؤلفو المعيار. وتتطابق نسبة 51% التي سجّلوها لـ Decisions API من دون Web Grounding مع نتيجة تشغيلنا.

استغرقت طلبات Decisions API مع الإسناد إلى الويب 370 مللي ثانية في الوسيط و685 مللي ثانية عند المئين الخامس والتسعين، وفق قياسات من العميل الخاص بنا على الأسئلة العامة المئة. ويُفيد مؤلفو المعيار بأن واجهة API الخاصة بهم سجّلت 560 مللي ثانية و710 مللي ثانية على المجموعة الكاملة المكونة من 300 سؤال، وفق قياسات من العميل الخاص بهم في 29 أكتوبر 2026. ومقارنةً بلوحة الصدارة المنشورة، يحقق Decisions API مع الإسناد إلى الويب أعلى دقة على المجموعة العامة، بزمن استجابة وسيط أقل من 400 مللي ثانية.

فعّل الإسناد إلى الويب للإجابة عن أسئلة لا تستطيع البيانات الإجابة عنها: عندما تتغير الحقائق بعد التدريب، وتُنشر معلومات جديدة على الويب. إليك بعض الأمثلة:

تأهيل الحسابات بناءً على الأخبار الأخيرة. سؤال «هل جمعت تمويلًا خلال آخر 90 يومًا؟» عبر قائمة حسابات كاملة.
تتبّع الأدوات التي تعتمد عليها. سؤال «هل يوجد إصدار مستقر أحدث من الإصدار المثبّت لدينا؟» يُراجَع وفق جدول زمني.
التأكيد قبل أن يتخذ العامل أي إجراء. يتحقق من «هل لا تزال هذه الفعالية قائمة؟» قبل أن يحجز.

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

أضِف "mode": "web_grounding" إلى أي طلب إلى Decisions API. ويمكن أن تكون قيمة state نصًا، كادعاء أو سجل، أو عنوان URL.

تحقّق من ادعاء بمقارنته بالويب:

bash

curl -X POST https://api.perplexity.ai/v1/decisions \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pplx-decider-v1.2",
    "mode": "web_grounding",
    "state": "Claim: The James Webb Space Telescope launched in December 2021.",
    "questions": {
      "supported": {
        "type": "noul",
        "instructions": "Is the claim true?"
      }
    }
  }'

تضيف الاستجابة الحقل search_results، أي الصفحات التي قرأها النموذج. في 4 نوفمبر، أعاد هذا الطلب احتمالًا لـ«نعم» تجاوز 0.99، وجاء سجل المركبة الفضائية الخاص بوكالة ناسا في المرتبة الأولى بين النتائج.

وجِّه النموذج إلى صفحة معيّنة بتمرير عنوان URL الخاص بها بوصفه قيمة state:

bash

curl -X POST https://api.perplexity.ai/v1/decisions \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pplx-decider-v1.2",
    "mode": "web_grounding",
    "state": "https://pypi.org/project/requests/",
    "questions": {
      "newer_stable_release": {
        "type": "noul",
        "instructions": "Has this package published a stable release newer than 2.31.0 as of today?"
      }
    }
  }'

في مكتبة Perplexity الخاصة بلغة Python، مرِّر mode في نص الطلب:

python

from perplexity import Perplexity

client = Perplexity()

response = client.decisions.create(
    model="pplx-decider-v1.2",
    state="Claim: The James Webb Space Telescope launched in December 2021.",
    questions={"supported": {"type": "noul", "instructions": "Is the claim true?"}},
    extra_body={"mode": "web_grounding"},
)

print(response.answers["supported"].noul)

تبلغ تكلفة كل عملية بحث مكتملة 0.001 دولار إضافةً إلى رموز الإدخال. وتُحتسب أدلة البحث ضمن رموز الإدخال. ويمكن أن يتضمن الطلب الذي يستخدم Web Grounding ما يصل إلى 100 سؤال.

ابدأ باستكشاف وثائق الإسناد إلى الويب.

كيف يعمل نموذج القرار

كيف يعمل الإسناد إلى الويب

اختبار الإسناد إلى الويب

PWS-Decisions

ما يمكن للمطورين إنشاؤه

ابدأ الآن