> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-55d9d317.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Web search

> أداة Web search خارجية لـ ClickHouse Agents

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                ميزة Beta. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        مزيد من المعلومات.
                    </a>
                </u>
            </span>
        </div>;
};

تتيح Web search للوكيل جلب معلومات من الويب العام أثناء المحادثة. استخدمها للأسئلة التي تتطلب إجابات حديثة — مثل الإصدارات الأخيرة، أو الوثائق الموجودة خارج خدمتك، أو لإجراء تحقق سريع بالرجوع إلى مصدر موثوق.

<div id="enable-it">
  ## فعِّله
</div>

في Agent Builder، فعِّل **Web Search** في قسم **Capabilities**. بعد تفعيله، يحدِّد الوكيل متى يُجري بحثًا استنادًا إلى سؤال المستخدم وتعليمات الوكيل. يُجرى البحث، وتُستخرج النتائج، ثم يُمرَّر المحتوى الأكثر صلةً إلى سياق النموذج.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-55d9d317/YqMzyzaUAaGuM5mi/images/cloud/agent-builder/web-search/web-search.png?fit=max&auto=format&n=YqMzyzaUAaGuM5mi&q=85&s=6211fe0426af562cdfde2a927644ef23" alt="لوحة Capabilities مع تمييز قسم Web Search، وتعرض مربع اختيار Web Search" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/web-search/web-search.png" />

<div id="how-a-search-round-works">
  ## كيف تعمل جولة البحث
</div>

يتم كل بحث عبر ثلاث مراحل، وتُدار هذه المراحل نيابةً عنك في Cloud:

1. **البحث** - يُرسل استعلام الوكيل إلى موفّر بحث يعيد عناوين URL المرشحة.
2. **الجلب** - تُجلب الصفحات ذات الصلة ويُستخرج منها النص المفيد.
3. **إعادة الترتيب** - يُقيّم مُعيد الترتيب النتائج لكي يرى النموذج أكثرها فائدة أولًا.

يستشهد ردّ الوكيل بعناوين URL التي استخدمها فعليًا.

<div id="when-to-use-it">
  ## متى تستخدمه
</div>

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

تخطَّه في الأسئلة التي يمكن الإجابة عنها بالاعتماد على بياناتك أو على معرفة النموذج نفسه. كل جولة بحث تضيف زمن استجابة.