> ## 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 Agents

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 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/docs/beta-and-experimental-features#beta-features">
                        مزيد من المعلومات.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

يستخدم ClickHouse Agents نموذج أذونات متعدد الطبقات: تتحكم الأدوار في الميزات التي يمكن للمستخدمين استخدامها أساسًا، وتتحكم قوائم الوصول على مستوى المورد في من يمكنه استخدام وكيل معيّن أو أي مورد آخر، وتتحكم أذونات المسؤول في من يدير كل شيء.

<div id="roles">
  ## الأدوار
</div>

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

* **User** - يمكنه تشغيل الوكلاء والدردشة. أما إمكانية build agents أو إنشاء مهارات أو مشاركة الموارد وما إلى ذلك، فتعتمد على مفاتيح التبديل الخاصة بكل ميزة ضمن دوره.
* **Admin** - يشمل كل ما يتيحه دور User، بالإضافة إلى عناصر تحكم على مستوى org: إدارة المستخدمين، وتهيئة marketplace، ومنح الأذونات.

يمكن للمسؤولين إنشاء أدوار مخصصة تتضمن مفاتيح تبديل خاصة بها للحصول على تحكم أدق.

<div id="resource-sharing">
  ## مشاركة الموارد
</div>

لكل من الوكلاء والموجّهات والمهارات قائمة وصول. وهناك ثلاثة مستويات وصول لكل جهة:

* **العارض** - يمكنه استخدام المورد، لكنه لا يستطيع تعديله.
* **المحرر** - يمكنه تغيير إعدادات المورد (التعليمات، والأدوات المرفقة، والنموذج، وما إلى ذلك).
* **المالك** - محرر، بالإضافة إلى إمكانية حذف المورد أو تغيير إعدادات مشاركته.

عند إنشاء مورد، تكون مالكه افتراضيًا. وكل ما لا تشاركه صراحةً يبقى خاصًا بك.

<div id="principals">
  ## الجهات المخوَّلة
</div>

يمكنك منح حق الوصول إلى:

* **المستخدمون الأفراد** - مستخدم واحد في كل مرة.
* **المجموعات** - الفرق أو الوحدات التنظيمية. إذا انضم مستخدم إلى المجموعة أو غادرها لاحقًا، فسيُحدَّث مستوى وصوله تلقائيًا.
* **على مستوى المؤسسة بالكامل** - يمكن لجميع أفراد المؤسسة رؤية هذا المورد، وذلك وفقًا لزر التبديل على مستوى الدور الذي يتيح ذلك.

إن مستوى الرؤية على نطاق المؤسسة بالكامل هو ما يجعل المورد قابلاً للاكتشاف في [marketplace](/docs/ar/products/cloud/features/ai-ml/agents/marketplace).

<div id="share-an-agent">
  ## مشاركة وكيل
</div>

انقر على أيقونة **Share** في أسفل Agent Builder. تُظهر الشارة على الأيقونة عدد المستخدمين أو المجموعات الذين لديهم حق الوصول حاليًا.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/sharing/sharing.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=d69e0d0dcda49492fd9a0212fcb93cf8" alt="الجزء السفلي من لوحة Agent Builder مع تمييز أيقونة Share وشارة تُظهر جهة واحدة تمت مشاركتها معها" size="sm" width="696" height="1934" data-path="images/cloud/agent-builder/sharing/sharing.webp" />

تُفتح نافذة **Share**. ابحث عن مستخدم أو مجموعة بالاسم أو البريد الإلكتروني، واختر مستوى الوصول (**عارض** أو **محرر** أو **مالك**)، ثم انقر على **Save Changes**. ولمشاركة الوكيل على مستوى المؤسسة بالكامل، فعِّل زر التبديل **Share with everyone in ClickHouse**.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/sharing/share-agent-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=1153af97349da4397d4fcf2e1428a7b1" alt="نافذة Share مع قسم أذونات المستخدمين والمجموعات، وحقل بحث، ومستخدم موجود بدور مالك، وزر تبديل Share with everyone in ClickHouse، وزري Cancel وSave Changes" size="md" width="1544" height="824" data-path="images/cloud/agent-builder/sharing/share-agent-modal.webp" />

سيرى المستلم الوكيل في قائمة الوكلاء المتاحين لديه في المرة التالية التي يُحدِّث فيها القائمة. ولإلغاء الوصول، احذف الصف من النافذة نفسها. يفقد المستلم حق الوصول فورًا؛ وتُستكمل المحادثات الجارية، لكن لن تُفتح محادثات جديدة.

<div id="default-agent">
  ## الوكيل الافتراضي
</div>

يمكنك تعيين وكيل واحد ليكون وكيلك الافتراضي. تُفتح المحادثات الجديدة مع هذا الوكيل ما لم تختر غيره. ويمكن للمشرفين أيضًا تعيين وكيل افتراضي على مستوى المؤسسة للمستخدمين الذين لم يختاروا وكيلاً افتراضيًا لأنفسهم.

<div id="admin-operations">
  ## عمليات المشرف
</div>

تشمل العمليات المتاحة للمشرف فقط ما يلي:

* إنشاء الأدوار وتحريرها.
* إعداد فئات marketplace وتنظيم الوكلاء المميزين.
* تمكين الميزات أو تعطيلها على مستوى المؤسسة (Memory وWeb search وCode interpreter وmarketplace وغير ذلك).
* منح صلاحيات المشرف لمستخدمين آخرين.

في ClickHouse Cloud، تتوفر لوحة الإدارة لمشرفي المؤسسة. إذا لم تتمكن من رؤيتها، فتواصل مع مشرف المؤسسة لديك أو مع ClickHouse Cloud Support لطلب الوصول.

<div id="gotchas">
  ## أمور يجب الانتباه لها
</div>

* **يؤدي حذف وكيل إلى تعطيل المشاركة بالكامل.** يفقد المستلمون إمكانية الوصول؛ وتظل محادثاتهم المحفوظة مع الوكيل قابلة للقراءة، لكن لا يمكن متابعتها.
* **يؤثر تحرير وكيل مُشارَك على جميع المستخدمين له.** استخدم نسخة إذا كنت بحاجة إلى التجربة من دون إرباك الآخرين.
* **لا يؤدي سحب دور المستخدم إلى حذف الموارد التي أنشأها.** تظل وكلاؤه وتوجيهاته ومهاراته ضمن قوائم الوصول الخاصة بها؛ انقل الملكية قبل إنهاء وصوله بالكامل.