الانتقال إلى المحتوى الرئيسي
أضف phaseo:web_search ليتمكن النموذج من البحث على الويب عندما يحتاج إلى معلومات حديثة أو موثّقة بالمصادر. يكتب النموذج الاستعلام ويمكنه البحث عدة مرات في الطلب الواحد؛ ويعيد Phaseo عناوين URL والعناوين والمقتطفات والنقاط البارزة، ونص الصفحة اختياريًا، ثم يكتب النموذج إجابة مستندة إلى المصادر.
يعمل إدخال الأداة نفسه في tools على /v1/responses و/v1/messages.

المعاملات

ما يرسله النموذج

يحتوي كل استدعاء على query. ويمكن للنموذج أيضًا إرسال max_results وengine وsearch_context_size وقوائم النطاقات وinclude_text وinclude_highlights وmax_characters، إضافة إلى تلميحات الترجمة المحلية التالية: تحل القيم التي يرسلها النموذج محل القيم الافتراضية للأداة في ذلك الاستدعاء. يبقى max_results محدودًا بما تبقى من max_total_results؛ وعندما ينفد، تعيد الاستدعاءات اللاحقة max_total_results_reached.

اختيار المحرك

إذا لم يكن المحرك المُدار مفعّلًا، يعيد الاستدعاء search_not_configured إلى النموذج. مع engine: "native" على /v1/chat/completions أو /v1/responses، لا يُرسل الطلب إلا إلى المزوّدين الذين ينفذون البحث على الويب بأنفسهم. إذا لم يقدّم أي منهم النموذج، يشغّل Phaseo محركه الافتراضي بدلًا من ذلك ويحتسبه بحثًا مُدارًا. المزوّدون الذين ينفذون البحث على الويب بأنفسهم على نقاط النهاية هذه هم OpenAI وعمليات نشر Azure OpenAI على /v1/responses وxAI وDeepSeek على deepseek/deepseek-v4.1-flash-1017. لا يبحث DeepSeek بنفسه إلا عندما يكون البحث على الويب هو الأداة الوحيدة في الطلب، من دون قوائم نطاقات أو موقع للمستخدم، ومن دون مخرجات JSON أو tool_choice يفرض أداة. فواجهته البرمجية ترفض قوائم النطاقات والموقع ومخرجات JSON، وتوقف البحث على الويب عندما يحتوي الطلب على أدوات أخرى، ولا يمكنها فرض البحث. أما الطلبات الأخرى إلى ذلك النموذج فتستخدم بحث Phaseo بدلًا من ذلك، وهو يعمل جنبًا إلى جنب مع أدواتك الخاصة. وعند تفعيل الاستدلال، يجري DeepSeek بحثًا أعمق يفتح الصفحات ويقرؤها عبر عدة خطوات. إرسال أداة OpenAI الخاصة { "type": "web_search" } يعمل بالطريقة نفسها كما في engine: "native". اضبط native في تعريف الأداة فقط: إذا طلب النموذج native في استدعاء ما، يعيد الاستدعاء unsupported_search_engine، لأن أداة المزوّد يجب اختيارها قبل إرسال الطلب.

التصفية حسب النطاق

استخدم allowed_domains عندما يجب أن تأتي الإجابة من مجموعة ثابتة من المصادر، وexcluded_domains لاستبعاد مواقع محددة من بحث مفتوح فيما عدا ذلك.
تتعامل المحركات مع القوائم بطرق مختلفة:
  • Perplexity يقبل إحدى القائمتين، لا كلتيهما، وحتى 20 نطاقًا. تُرسل النطاقات المستبعدة بصيغة قائمة الحظر الخاصة به.
  • Firecrawl يقبل إحدى القائمتين، لا كلتيهما.
  • TinyFish يقبل القائمتين ويحوّلهما إلى عاملَي site: و-site: في الاستعلام.
  • DeepSeek يقبل القائمتين ويحوّلهما إلى عاملَي site: و-site:. استعلاماته محدودة بـ 128 حرفًا، لذا يُقصَّر الاستعلام ليتسع للعوامل. وإذا تجاوزت قوائم النطاقات وحدها الحد، يعيد الاستدعاء search_query_too_long.

ما تعيده الأداة

نتيجة JSON تتضمن المحرك والاستعلام ومصفوفة results. تحتوي كل نتيجة على title وurl وsnippet أو highlights، وtext عندما يُطلب نص الصفحة ويوفّره المحرك.

الاستخدام والتسعير

تضيف كل عملية بحث إلى usage.server_tool_use:
يحاسب Phaseo كل بحث مُدار بمبلغ $0.007، إضافة إلى $0.001 لكل نتيجة بعد أول 10 نتائج، ما لم تحدد بطاقة سعر النموذج أسعارها الخاصة لـ server_tool_web_search_requests وserver_tool_web_search_extra_results. لا تُحتسب عمليات البحث الفاشلة، وبحث TinyFish مجاني ضمن خططه المنشورة، لذا لا يضيف engine: "tinyfish" أي رسوم بحث. وتتطلب عمليات البحث على المحركات المدفوعة رصيدًا حتى عندما يكون النموذج مجانيًا. ويُحتسب البحث الأصلي عبر native_web_search_requests بالسعر المنشور لدى المزوّد: على سبيل المثال $10 لكل 1,000 عملية بحث لدى OpenAI وAnthropic، و$0.75 لكل 1,000 لدى DeepSeek، حيث تُحتسب فقط عمليات البحث التي تعيد نتائج. كما يحاسب DeepSeek على كل عملية جلب صفحة، أي قراءة عنوان URL بأداة قراءة الروابط، بمبلغ $0.75 لكل 1,000، ضمن native_web_fetch_requests. وعند تفعيل الاستدلال، قد تُجري إجابة واحدة من DeepSeek اثني عشر بحثًا أو أكثر، وتُضاف النتائج التي يقرؤها إلى رموز الإدخال.
آخر تعديل في ١٦ نوفمبر ٢٠٢٦