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

# البدء السريع

> أنشئ وشغّل أول ClickHouse Agent لك على خدمة في ClickHouse Cloud

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

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>;
};

أنشئ وكيلاً مخصصًا في وحدة تحكم Cloud، ثم شغِّل استعلامًا بلغة طبيعية على خدمتك.

<div id="prerequisites">
  ## المتطلبات الأساسية
</div>

* خدمة في ClickHouse Cloud يمكنك إجراء استعلامات عليها.
* خيار **إنشاء وكيل** في Agent Builder. إذا لم يكن ظاهرًا، فاطلب من مسؤول المؤسسة منح إذن إنشاء الوكلاء عبر Admin Settings كما هو موضح في [المشاركة والوصول](/ar/products/cloud/features/ai-ml/agents/sharing-and-access).

<div id="build-the-agent">
  ## أنشئ الوكيل
</div>

<Steps>
  <Step>
    ### شغّل ClickHouse Agents

    من خدمة Cloud الخاصة بك، انقر على **ClickHouse agents** في الشريط الجانبي الأيسر لفتح صفحة إطلاق الوكلاء. ثم انقر على **Launch ClickHouse agents** لفتح Agent Builder.

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/XOOlYBuM8pBBOTzZ/images/cloud/agent-builder/launch-ch-agents.webp?fit=max&auto=format&n=XOOlYBuM8pBBOTzZ&q=85&s=90a17a907d16a863c4904a8c2c6ef60d" alt="تنقّل خدمة Cloud مع تحديد ClickHouse agents (Beta)، مع ظهور صفحة الإطلاق التي تتضمن زر Launch ClickHouse agents" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/launch-ch-agents.webp" />
  </Step>

  <Step>
    ### أنشئ الوكيل

    في Agent Builder، انقر على **Create New Agent** أعلى اللوحة اليسرى. ثم املأ الحقول الأساسية:

    * **Name** - معرّف قصير لوكيلك.
    * **Description** - وصف يوضح الغرض من الوكيل، وسيظهر لزملائك.
    * **Category** - فئة الوكيل. يمكنك تركها على `General` ما لم تكن لدى مؤسستك فئات مخصّصة.
    * **Instructions** - الـ system prompt، ويحدّد دور الوكيل، والأسئلة التي ينبغي أن يجيب عنها، وأي قواعد عمل يجب أن يلتزم بها.
    * **Model** - اختر نموذجًا من القائمة المنسدلة.

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/XOOlYBuM8pBBOTzZ/images/cloud/agent-builder/agent-builder.webp?fit=max&auto=format&n=XOOlYBuM8pBBOTzZ&q=85&s=05d2c7afb965de32f20bbba9443957f2" alt="لوحة Agent Builder تعرض القائمة المنسدلة Create New Agent، وحقول النموذج (Name وDescription وCategory وInstructions وModel)، وقسم Capabilities" size="lg" width="3834" height="1932" data-path="images/cloud/agent-builder/agent-builder.webp" />
  </Step>

  <Step>
    ### أضف الإمكانات والأدوات

    توجد إمكانات الوكيل وأدواته في موضعين.

    **Capabilities** في اللوحة الرئيسية — ميزات أصلية مثل [Run Code](/ar/products/cloud/features/ai-ml/agents/builder/code-interpreter)، و[Web Search](/ar/products/cloud/features/ai-ml/agents/builder/web-search)، وFile Context، وArtifacts، و[MCP Servers](/ar/products/cloud/features/ai-ml/agents/builder/mcp-servers)، و[Skills](/ar/products/cloud/features/ai-ml/agents/builder/skills). فعّل ما يحتاجه الوكيل منها.

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/XOOlYBuM8pBBOTzZ/images/cloud/agent-builder/capabilities.webp?fit=max&auto=format&n=XOOlYBuM8pBBOTzZ&q=85&s=745633ecd4ab764d37d1011a4f99f04c" alt="قسم Capabilities في لوحة Agent Builder يعرض أزرار التبديل الخاصة بـ Run Code وWeb Search وFile Context وArtifacts وMCP Servers وSkills" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/capabilities.webp" />

    **Tools** خلف زر **Add Tools** أسفل اللوحة — تكاملات خارجية مثل [توليد الصور](/ar/products/cloud/features/ai-ml/agents/builder/image-generation)، و[Vision](/ar/products/cloud/features/ai-ml/agents/builder/vision)، وواجهات برمجة تطبيقات البحث، والخدمات الخارجية.

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/XOOlYBuM8pBBOTzZ/images/cloud/agent-builder/tools-button.webp?fit=max&auto=format&n=XOOlYBuM8pBBOTzZ&q=85&s=263bb1a39df5be42e7719d7ad2d78fe5" alt="الجزء السفلي من لوحة Agent Builder مع تمييز زر Add Tools" size="sm" width="596" height="836" data-path="images/cloud/agent-builder/tools-button.webp" />

    انقر على **Add Tools** لاستعراض الكتالوج:

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/XOOlYBuM8pBBOTzZ/images/cloud/agent-builder/tools-modal.webp?fit=max&auto=format&n=XOOlYBuM8pBBOTzZ&q=85&s=42ddc031306fc9917ac76f433fac95cc" alt="نافذة Agent Tools تعرض شبكة من التكاملات الخارجية، بما في ذلك Google وOpenAI Image Tools وWolfram وDALL-E-3 وTavily Search وCalculator وStable Diffusion" size="lg" width="2560" height="1280" data-path="images/cloud/agent-builder/tools-modal.webp" />

    يتم إعداد [Subagents](/ar/products/cloud/features/ai-ml/agents/builder/subagents) ضمن **Advanced settings** — راجع صفحة Subagents للتفاصيل.

    يمكنك تغيير الإمكانات والأدوات المضافة في أي وقت.
  </Step>

  <Step>
    ### شغّل استعلام

    احفظ الوكيل، وافتح conversation جديدة، ثم اختر وكيلك من أداة اختيار الوكيل. اكتب سؤالًا — على سبيل المثال، *"ما أكثر 10 جداول لديّ من حيث عدد الصفوف هذا الأسبوع؟"* — وسيضع الوكيل خطة، ويستدعي الأدوات عند الحاجة، ثم يعرض الإجابة.

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/XOOlYBuM8pBBOTzZ/images/cloud/agent-builder/chat-query.webp?fit=max&auto=format&n=XOOlYBuM8pBBOTzZ&q=85&s=049b8a51858ff2f11890df875a492ade" alt="محادثة تعرض السؤال 'What are my top 10 tables by row count this week?' وردّ الوكيل — جدول Markdown يرتّب أفضل 10 جداول عبر الخدمات حسب عدد الصفوف، مع Key Observations في الأسفل" size="lg" width="2722" height="1882" data-path="images/cloud/agent-builder/chat-query.webp" />
  </Step>
</Steps>

<div id="next-steps">
  ## الخطوات التالية
</div>

* [شارك الوكيل](/ar/products/cloud/features/ai-ml/agents/sharing-and-access) مع زملائك.
* انشره في [السوق](/ar/products/cloud/features/ai-ml/agents/marketplace) بمجرد أن يصبح الوكيل مستقرًا.