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

# AI Notebooks مع ClickStack

> دفاتر تحقيق مدعومة بالذكاء الاصطناعي لـ ClickStack

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

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

تُعد AI Notebooks أداة تفاعلية للاستقصاء في ClickStack تجمع بين وكيل AI والتحليل اليدوي. يمكنك وصف مشكلة بلغة بسيطة، وسيتولى وكيل AI الاستعلام عن السجلات والتتبعات والمقاييس نيابةً عنك، مع عرض البيانات والمخططات والملخصات ذات الصلة في سلسلة من البطاقات. ويمكنك أيضًا إضافة بطاقاتك الخاصة (مخططات وجداول وعمليات بحث وملاحظات Markdown) إلى جانب المخرجات التي ينشئها AI، لبناء سجل كامل لعملية استقصاء.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-notebook-hero.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=72c78cf9ad56fe4038d3f25a06f473ad" alt="دفتر AI يستقصي انقطاعًا كاملاً بسبب امتلاء ذاكرة التخزين المؤقت لـ Visa" size="lg" width="1440" height="900" data-path="images/use-cases/observability/hyperdx-notebook-hero.png" />

<Info>
  **Managed ClickStack فقط**

  لا تتوفر AI Notebooks إلا في بيئات Managed ClickStack.
</Info>

<div id="setup">
  ## الإعداد
</div>

تتوفر AI Notebooks حاليًا في ClickHouse Cloud كميزة تجريبية. وتُدار نماذج الذكاء الاصطناعي ومزوّدوها تلقائيًا بواسطة المنصة.

قبل استخدام AI Notebooks:

1. **تمكين Generative AI** — يجب على مسؤول الفريق تفعيل زر تبديل الموافقة الخاص بـ Generative AI. راجع [تمكين Generative AI](#enabling-generative-ai).
2. **الوصول إلى Notebooks** — يجب أن يتضمن دورك أذونات القراءة والكتابة لـ Notebooks.

بمجرد التمكين، سيظهر عنصر **Notebooks** في الشريط الجانبي الأيسر لجميع من لديهم الدور المناسب.

<div id="enabling-generative-ai">
  ## تمكين Generative AI
</div>

يجب على مسؤول الفريق تفعيل زر تبديل الموافقة على Generative AI قبل أن يصبح استخدام دفاتر الملاحظات (وسائر ميزات الذكاء الاصطناعي) ممكنًا.

1. انتقل إلى **Team Settings > Security Policies**.
2. فعّل **Generative AI**.
3. راجع مربع حوار الموافقة ثم اقبلها.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-notebook-ai-consent.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=12c00544f98977d1cf52397b4c3a9a8a" alt="زر تبديل Generative AI في Team Settings" size="lg" width="887" height="40" data-path="images/use-cases/observability/hyperdx-notebook-ai-consent.png" />

<div id="using-notebooks">
  ## استخدام AI Notebooks
</div>

<div id="creating-a-notebook">
  ### إنشاء دفتر الملاحظات
</div>

1. اختر **Notebooks** من الشريط الجانبي الأيسر.
2. انقر على **New Private Notebook** (مرئي لك فقط) أو **New Shared Notebook** (مرئي لفريقك).

تعرض صفحة قائمة دفاتر الملاحظات جميع دفاتر الملاحظات التي لديك حق الوصول إليها. يمكنك التصفية حسب الاسم أو الوسوم، أو التبديل بين **My Notebooks** و**All Notebooks**.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-notebook-list.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=4e4c3bee3152d9d7a6f9513825f9173f" alt="صفحة قائمة دفاتر الملاحظات" size="lg" width="1440" height="900" data-path="images/use-cases/observability/hyperdx-notebook-list.png" />

<div id="running-investigation">
  ### إجراء تحقيق بالذكاء الاصطناعي
</div>

في أسفل دفتر الملاحظات، أدخل موجّهًا يصف ما تريد التحقيق فيه — على سبيل المثال، *"لماذا ارتفعت معدلات الأخطاء في خدمة checkout خلال الساعة الماضية؟"*

اضغط **إرسال** (أو اضغط Enter). سيقوم وكيل الذكاء الاصطناعي بما يلي:

1. فحص مصادر البيانات المتاحة لك.
2. تشغيل استعلامات البحث والتجميع على السجلات والتتبعات والمقاييس لديك.
3. إنشاء سلسلة من البطاقات تعرض مسار تفكيره، والاستعلامات التي شغّلها، والمخططات البيانية الوسيطة، وملخصًا نهائيًا يتضمن الاستنتاجات.

تظهر كل خطوة كبطاقة في دفتر الملاحظات. تعرض بطاقات **مسار التفكير** المنطق وراء كل استعلام، بينما تحتوي بطاقات **المخرجات** على استنتاجات الوكيل ومخططات بيانية اختيارية. وعلى عكس دردشة الذكاء الاصطناعي التقليدية، تتيح لك دفاتر الملاحظات رؤية البيانات التي يعمل عليها الذكاء الاصطناعي بدقة في كل خطوة — بحيث يمكنك التحقق من منطقه، ورصد مسارات مهمة قد يكون أغفلها، و[تفريع](#branching) التحقيق لتوجيهه في مسار مختلف.

أثناء تشغيل التحقيق، يمكنك النقر على **إيقاف** لإلغائه.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-notebook-tiles.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=1215130ad6bf925b48643639e96ae219" alt="دفتر ملاحظات يحتوي على بطاقات أنشأها الذكاء الاصطناعي" size="lg" width="1728" height="899" data-path="images/use-cases/observability/hyperdx-notebook-tiles.png" />

<div id="branching">
  ### إنشاء فرع في التحقيق
</div>

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

لإنشاء فرع:

1. وسّع tile لمسار التفكير وانقر على **Restart from Here**.
2. في مربع الحوار، أدخل موجّهًا معدّلًا يوجّه التحقيق إلى المسار الجديد.
3. انقر على **Interrupt & Create Branch**. سيبدأ الذكاء الاصطناعي فرعًا جديدًا من التحقيق من تلك النقطة.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-notebook-branch-modal.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=e360d6733a9fcc41cb1b342a15e40eb6" alt="مربع الحوار Create New Branch" size="md" width="620" height="317" data-path="images/use-cases/observability/hyperdx-notebook-branch-modal.png" />

بمجرد أن يصبح لدى tile عدة فروع، سيظهر زرا السهمين الأيسر والأيمن في ترويسة tile مع شارة (مثل **1/2**) تشير إلى عدد الفروع الموجودة. انقر على السهمين للتبديل بين الفروع.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-notebook-branching.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=bbcf0a882e068a5cbacdd4dedd3a156b" alt="أسهم التنقل بين الفروع وشارة 1/2 على tile" size="lg" width="1635" height="33" data-path="images/use-cases/observability/hyperdx-notebook-branching.png" />

<div id="manual-tiles">
  ### إضافة بطاقات يدوية
</div>

بالإضافة إلى البطاقات التي يُنشئها الذكاء الاصطناعي، يمكنك إضافة كتل التحليل الخاصة بك باستخدام الأزرار الموجودة أسفل دفتر الملاحظات:

| الزر         | الاختصار | الوصف                                                                                                                                  |
| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **البحث**    | `S`      | عرض بحث للسجلات/التتبعات، وهو مكافئ لصفحة البحث.                                                                                       |
| **مخطط**     | `L`      | مخطط خطي لسلسلة زمنية، باستخدام أداة إنشاء المرئيات نفسها المستخدمة في [لوحات المعلومات](/ar/clickstack/features/dashboards/overview). |
| **جدول**     | `T`      | عرض جدولي للتجميعات.                                                                                                                   |
| **Markdown** | `M`      | نص حر للملاحظات أو الفرضيات أو الاستنتاجات.                                                                                            |

بعد إضافة بطاقة، تُفتح في وضع التحرير المضمن، حيث يمكنك تهيئة مصدر البيانات وعوامل التصفية والتجميعات — وهي الواجهة نفسها المستخدمة عند إنشاء [مرئيات لوحات المعلومات](/ar/clickstack/features/dashboards/overview#creating-visualizations). انقر على **Save** لإتمام البطاقة.

تُضاف البطاقات اليدوية أسفل آخر بطاقة ظاهرة في الفرع الحالي. ويمكنك تغيير حجم البطاقات رأسيًا بسحب حافتها السفلية.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-notebook-manual-tiles.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=a66b4c5331e841120daf52d02b709e30" alt="أزرار البطاقات اليدوية أسفل دفتر الملاحظات" size="lg" width="1358" height="109" data-path="images/use-cases/observability/hyperdx-notebook-manual-tiles.png" />

<Note>
  إذا كان تحقيق بالذكاء الاصطناعي قيد التشغيل حاليًا، فإن إضافة بطاقة يدوية أو تعديلها سيؤدي إلى إلغاء التحقيق. سيظهر مربع حوار للتأكيد قبل المتابعة.
</Note>

<div id="sharing-organizing">
  ### المشاركة والتنظيم
</div>

* **خاص أم مشترك** — بدّل أيقونة القفل في ترويسة دفتر الملاحظات للتنقّل بين الوضع الخاص (أنت فقط) والوضع المشترك (المرئي للفريق). ولا يمكن تغيير هذا الإعداد إلا بواسطة منشئ دفتر الملاحظات.
* **الوسوم** — أضف وسومًا إلى دفاتر الملاحظات لتسهيل التصفية في صفحة القائمة.
* **التسمية** — انقر على عنوان دفتر الملاحظات لإعادة تسميته. وإذا بدأت تحقيقًا في دفتر ملاحظات بلا عنوان، فسيقترح الذكاء الاصطناعي اسمًا تلقائيًا.

<div id="custom-agent-context">
  ### سياق الوكيل المخصص
</div>

يمكن لمسؤولي الفريق توفير سياق إضافي يُدرج في كل تحقيق من تحقيقات Notebooks المعتمدة على AI للفريق. يفيد ذلك في تزويد AI بخلفية عن بنية نظامك، أو اصطلاحات التسمية، أو المشكلات المعروفة.

لتهيئة ذلك:

1. انتقل إلى **Notebooks** من الشريط الجانبي الأيسر.
2. افتح **Agent Settings** (متاح لمسؤولي الفريق).
3. أدخل السياق المخصص لديك (حتى 50,000 حرف) واحفظه.

يُضاف هذا السياق إلى توجيه النظام الخاص بـ AI في جميع تحقيقات Notebooks على مستوى الفريق.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-notebook-agent-context.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=02ffa88f900e7ea86c32a41a01476a0a" alt="لوحة Agent Settings للسياق المخصص" size="lg" width="1440" height="900" data-path="images/use-cases/observability/hyperdx-notebook-agent-context.png" />