> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

[ميزة Beta](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

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

## المتطلبات الأساسية

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

## أنشئ الوكيل

**1. شغّل ClickHouse Agents**

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

![تنقّل خدمة Cloud مع تحديد ClickHouse agents (Beta)، مع ظهور صفحة الإطلاق التي تتضمن زر Launch ClickHouse agents](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/launch-ch-agents.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=7b76b7220ae2e5848fefb70d25e6401c)

**2. أنشئ الوكيل**

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

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

![لوحة Agent Builder تعرض القائمة المنسدلة Create New Agent، وحقول النموذج (Name وDescription وCategory وInstructions وModel)، وقسم Capabilities](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/agent-builder.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b18a3db920e9ec695938613037a72578)

**3. أضف الإمكانات والأدوات**

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

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

![قسم Capabilities في لوحة Agent Builder يعرض أزرار التبديل الخاصة بـ Run Code وWeb Search وFile Context وArtifacts وMCP Servers وSkills](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/capabilities.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b82e23e834b7b1a8321f80ffc526c936)

**Tools** خلف زر **Add Tools** أسفل اللوحة — تكاملات خارجية مثل [توليد الصور](https://clickhouse.com/docs/ar/agents/builder/image-generation.md)، و[Vision](https://clickhouse.com/docs/ar/agents/builder/vision.md)، وواجهات برمجة تطبيقات البحث، والخدمات الخارجية.

![الجزء السفلي من لوحة Agent Builder مع تمييز زر Add Tools](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-button.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=42c611769822a510b7b372437b0ddd70)

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

![نافذة Agent Tools تعرض شبكة من التكاملات الخارجية، بما في ذلك Google وOpenAI Image Tools وWolfram وDALL-E-3 وTavily Search وCalculator وStable Diffusion](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-modal.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=31187ed13e978de4ad88020c060ab2d5)

يتم إعداد [Subagents](https://clickhouse.com/docs/ar/agents/builder/subagents.md) ضمن **Advanced settings** — راجع صفحة Subagents للتفاصيل.

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

**4. شغّل استعلامًا**

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

![محادثة تعرض السؤال 'What are my top 10 tables by row count this week?' وردّ الوكيل — جدول Markdown يرتّب أفضل 10 جداول عبر الخدمات حسب عدد الصفوف، مع Key Observations في الأسفل](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/chat-query.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=09fc2481502e3af9c35a59641528c8aa)

## الخطوات التالية

* [شارِك الوكيل](https://clickhouse.com/docs/ar/agents/sharing-and-access.md) مع زملائك في الفريق.
* انشره في [السوق](https://clickhouse.com/docs/ar/agents/marketplace.md) بمجرد أن يصبح الوكيل مستقرًا.
