لقد صدرت الحيرة pplx، عميل سطر أوامر رسمي لواجهة برمجة تطبيقات البحث الخاصة به. تقوم الأداة بإرجاع نتائج البحث المؤرضة ونص الصفحة المستخرج، كل ذلك بتنسيق JSON. ووفقًا لمستنداته، فإنه يستهدف البشر ووكلاء البرمجة على حدٍ سواء. إنه ليس عميل دردشة. لا يوجد وضع محادثة، ولا يوجد اختيار للنموذج، ولا توجد إجابة مركبة.
سطحان، عقد إخراج واحد
تعرض الأداة سطحي عمل بالضبط. pplx search web يدير بحثًا مباشرًا على الويب. pplx content fetch يسحب عنوان URL ويعيد نص الصفحة المنظف.
العقد من حولهم هو الجزء المثير للاهتمام. حسب المسؤول pplx-cli Agent Skill، النجاح يعني الخروج من الكود 0 وكائن JSON واحد بالضبط على stdout. عوائد البحث {hits: [{url, title, domain, snippet, ...}], total, saved_to?}.
كل فشل يخرج من 1 مع stdout فارغ. يذهب كائن خطأ JSON واحد إلى stderr، على شكل {"error":{"code","message","command","hint"?}}. تشمل الرموز الموثقة AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR و BAD_REQUEST. تشير المهارة إلى أن القائمة ليست شاملة، لذا يجب على المتصلين أن يتفرعوا error.code.
تثبيت المسار ودعم النظام الأساسي
التثبيت هو أمر Shell واحد يقوم بتوجيه البرنامج النصي إليه sh:
curl -fsSL https://github.com/perplexityai/perplexity-cli/releases/latest/download/install.sh | shقراءة install.sh يظهر ما يفعله في الواقع. يتم تنزيله manifest.json من الإصدار الأخير ويستخرج العلامة والإصدار. ثم يقوم بعد ذلك بتثبيت كل التنزيلات المتبقية على تلك العلامة، وذلك لتجنب التسابق مع النشر المتزامن.
إنه يجلب SHA256SUMS والنظام الأساسي الثنائي، يتحقق من المجموع الاختباري، ويتم التثبيت عليه ~/.local/bin/pplx. ليس هناك حاجة إلى سودو. يتم كتابة إيصال إلى ~/.config/pplx/pplx-receipt.json، ولكن فقط بعد تشغيل الملف الثنائي المثبت بنجاح.
تقتصر تغطية النظام الأساسي على ثلاثة أهداف: macOS على Apple Silicon وLinux x86_64 وLinux Arm64. وأي شيء آخر يخرج مع وجود خطأ. لا يوجد إصدار Windows ولا إصدار Intel macOS.
تعتبر اقتصاديات نافذة السياق أحد اهتمامات التصميم من الدرجة الأولى
الميزة الأكثر خصوصية للوكيل هي وضع ميزانية الرمز المميز. --output-dir يكتب مجموعة النتائج الكاملة إلى ملف JSON. --stdout-preview[=<CHARS>] يقتطع حقول السلسلة الطويلة في stdout، ويضيف ...<truncated> علامات.
المهارة صريحة بشأن الفخ: --stdout-preview يعد أمرًا محظورًا بدون دليل حفظ. يتم اقتطاعه فقط عندما يتم حفظ النتيجة أيضًا عبر --output-dir أو $PPLX_OUTPUT_DIR. عند استخدامه بمفرده، فإنه يُرجع مخرجات بالحجم الكامل، ويمكن أن يصل عدد الزيارات إلى عدة كيلوبايت لكل منها.
نتائج البحث المحفوظة تصل إلى {dir}/web/{rand}.json ويجلب عند {dir}/fetch/{rand}.json. تتم كتابة الملفات فقط بعد طلب ناجح. PPLX_OUTPUT_DIR يضبط الإعداد الافتراضي لمساحة العمل بحيث لا يلزم تكرار العلامة.
بالنسبة لجلب المحتوى، تضيف المهارة فحصًا للصحة بدلاً من التحقق من التكلفة. يؤكد error و is_paywall في الإخراج قبل الثقة content. --html يضيف أ raw_html تم جلب الحقل مباشرة عبر الزاحف، و --no-cache يفرض جلبًا مباشرًا.
الوجبات السريعة الرئيسية
pplxهو ثنائي واحد تم التحقق منه يعرض أمرين:pplx search webوpplx content fetch.- النجاح هو الخروج من 0 بالإضافة إلى كائن JSON واحد على stdout؛ أدت حالات الفشل إلى وضع كائن خطأ JSON واحد على stderr.
pplx auth loginهو TTY فقط، لذلك يجب على الوكلاء وCI التصديرPERPLEXITY_API_KEY.--stdout-previewيتم اقتطاعها فقط عند إقرانها بـ--output-dirأو$PPLX_OUTPUT_DIR.- تبلغ تكلفة فواتير واجهة برمجة تطبيقات البحث 5.00 دولارات لكل 1000 طلب، بحد أقصى 50 QPS على كل مستوى استخدام.
مصادر: perplexityai/perplexity-cli، pplx-cli SKILL.md، مطورو منصة api، تسعير Perplexity API، حدود الأسعار ومستويات الاستخدام، والبدء السريع لواجهة برمجة تطبيقات البحث
ميشال سوتر متخصص في علوم البيانات وحاصل على درجة الماجستير في علوم البيانات من جامعة بادوفا. بفضل أساس متين في التحليل الإحصائي والتعلم الآلي وهندسة البيانات، تتفوق ميشال في تحويل مجموعات البيانات المعقدة إلى رؤى قابلة للتنفيذ.
اكتشاف المزيد من كحيل | أخبار التقنية
اشترك للحصول على أحدث التدوينات المرسلة إلى بريدك الإلكتروني.
