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:
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 اثني عشر بحثًا أو أكثر، وتُضاف النتائج التي يقرؤها إلى رموز الإدخال.