تستخرج Context API السياق الكامل من أي صفحة ويب

استخدم Perplexity Context API لتزويد وكلاء الذكاء الاصطناعي بمحتوى Markdown نظيف وروابط وفقرات ذات صلة من صفحات الويب المخزنة مؤقتًا أو المباشرة.

Context API artwork with a luminous mineral cross-section and geometric lines.

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

نطلق اليوم Perplexity Context API، التي تقرأ ما يصل إلى 10 عناوين URL وتُرجع لكل صفحة محتوى Markdown نظيفًا وHTML وروابط ومقتطفات مستندة إلى الاستعلام. تأتي المعلومات من فهرس الويب الضخم لدى Perplexity أو من جلب مباشر. ويمكن للوكلاء تحديد مدى حداثة كل طلب، والتحقق من مصدر كل نتيجة.

تدعم Context API مجموعة متنوعة من التنسيقات

يمكن للوكلاء بدء طلب من خلال تقديم قائمة بعناوين URL وتحديد تنسيقات الإخراج. وتُرجع واجهة API نتيجة لكل عنوان URL بالترتيب نفسه.

تدعم Context API مجموعة متنوعة من تنسيقات الاستجابة:

  • Markdown: محتوى الصفحة بتنسيق Markdown نظيف، جاهز لوضعه في سياق النموذج.
  • HTML: كود HTML الخاص بالصفحة، للتطبيقات التي تُجري التحليل بنفسها.
  • الروابط: الروابط الموجودة في الصفحة كعناوين URL مطلقة، دون تكرار وبترتيب ظهورها في الصفحة، ليتمكن الوكيل من تحديد وجهته التالية.
  • المقتطفات: أكثر فقرات الصفحة صلةً بالاستعلام المقدَّم، ضمن حد الرموز المميزة (tokens) الذي يحدده المطور لكل صفحة.

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

تتضمن كل نتيجة ناجحة أيضًا بيانات وصفية مثل العنوان والوصف واللغة والمؤلف وتاريخ النشر، إضافةً إلى وسوم Open Graph الخاصة بالصفحة. ولإنشاء محتوى Markdown، تقسّم Context API الصفحة إلى كتل، ويقيّم نموذجٌ كل كتلة باعتبارها محتوى رئيسيًا أو محتوى نمطيًا متكررًا. ولا يُحتفظ إلا بكتل المحتوى.

ضرورية للمهام التي تتطلب الصورة الكاملة

لا يكفي دائمًا العثور على صفحة ذات صلة لإنجاز مهمة ما. باستخدام Context API، يمكن للوكلاء استرداد المحتوى الذي يحتاجون إليه من عناوين URL محددة لإنجاز المهام المعقدة.

  • تنفيذ تكامل مع API: قد تُحدد نتيجة البحث الوثائق الصحيحة دون أن تتضمن المعلمات المطلوبة أو تعليمات المصادقة أو حالات الخطأ. ويمكن أن تساعد Context API وكيل البرمجة على استرداد الوثائق ومراجع API لكتابة تكامل يستند إلى تلك التفاصيل.
  • مقارنة الأسعار الحالية: قد يعتمد السعر المُعلن على حدود الاستخدام أو شروط الفوترة أو شروط الأهلية التي لا تظهر في مقتطف البحث. ويمكن للوكيل طلب جلب مباشر لصفحات أسعار محددة وقراءة تلك الشروط قبل إجراء المقارنة.
  • الإجابة عن أسئلة السياسات: قد يذكر مقتطف من سياسة الإرجاع مدة الإرجاع القياسية، لكنه يُغفل الاستثناءات الخاصة بمنتجات أو مناطق معينة. ويمكن لوكيل الدعم استرداد صفحة السياسة لتراعي إجابته تلك الاستثناءات.
  • البحث عبر مصادر متعددة: قد يُبرز مقتطف البحث نتيجةً ما دون المنهجية أو التحفظات أو الحجة المحيطة بها. ويمكن لوكيل البحث استرداد المقالات والتقارير المحددة، ثم مقارنة الأدلة بدلًا من الاعتماد على المقتطفات وحدها.

تحكّم في مدى الحداثة وتعامل مع عناوين URL بموثوقية

افتراضيًا، تتحقق Context API أولًا من فهرس الويب لدى Perplexity بحثًا عن نسخة من الصفحة جُلبت خلال اليومين الماضيين. وإذا لم تكن هناك نسخة، فإنها تجلب الصفحة مباشرةً. ويمكن للمطورين تغيير max_age_seconds إلى 0 لقراءة الصفحات المباشرة دائمًا، كما في الأسعار والنتائج الرياضية والأخبار العاجلة. أما المواد المرجعية التي نادرًا ما تتغير، فيمكنهم رفع هذه القيمة. واضبط cache_only على true لأعباء العمل التي يجب ألا تؤدي أبدًا إلى طلب مباشر.

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

تُجلب عناوين URL في الطلب بالتوازي، ولكل منها ميزانيتها الزمنية وحالتها الخاصة. ولا يؤدي بطء صفحة واحدة أو تعطلها إلى فشل الصفحات الأخرى. وتوضح الحالة ما حدث لكل عنوان URL، بحيث يمكن للوكيل إعادة محاولة الصفحات التي انتهت مهلتها فقط والاحتفاظ بالباقي.

تُرجع Context API محتوى كاملًا وقابلًا للاستخدام

اختبرنا Context API مقارنةً بـ Firecrawl وExa وParallel وKeenable وContext.dev على 1,000 عنوان URL مأخوذة كعينة من طلبات جلب حقيقية أجراها وكلاء. وتغطي المجموعة 715 موقعًا، وتشمل مصادر حكومية وأكاديمية وصفحات بلغات غير الإنجليزية. ثم قيّم نموذج تحكيم منفصل المخرجات دون معرفة المزوّد الذي أنتج كلًّا منها.

يقيس المخطط الأداء وفق ثلاثة معايير:

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

في هذا التقييم، أعادت Context API محتوى قابلاً للاستخدام لـ 92.3% من عناوين URL، واستعادت 87.9% من الحقائق الرئيسية، وحققت دقة بنسبة 80.3% في مقياس دقة المحتوى.

الأسعار

تكلفة Context API هي 1 دولار أمريكي لكل 1,000 عنوان URL يتم جلبه. يدفع المطورون مقابل كل عنوان URL يُرجع الحالة ok. ولا تُحتسب رسوم على عناوين URL التي تفشل.

البدء

bash
curl --request POST https://api.perplexity.ai/v1/context \ --header "Authorization: Bearer $PERPLEXITY_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "urls": ["https://info.cern.ch/hypertext/WWW/TheProject.html"], "formats": ["markdown"] }'

تُرجع كل نتيجة محتوى Markdown الخاص بالصفحة، والفقرات المطابقة للاستعلام، والبيانات الوصفية للصفحة، والحالة. تحقّق من حالة كل نتيجة قبل استخدام محتواها.

اقرأ وثائق Context API أو اطّلع على مرجع API.

  1. Orchestrator: واجهة API واحدة لاستدلال موثوقالمطوّرون١٧ نوفمبر ٢٠٢٦
  2. نقدّم Monitor API من Perplexityالمطوّرون١٦ نوفمبر ٢٠٢٦