
مهارات Elastic الرسمية
<p align="center"> <img alt="شعار Elastic" src="https://assets.kitploit.com/production/public/readmes/12587/8e357b6e4cbecb13a462cd8da398525dbe599bb7210c6426f2f1103702561816.png" width="200"> </p> <p align="center"> <a href="https://github.com/elastic/agent-skills/blob/main/LICENSE"><img alt="الترخيص" src="https://img.shields.io/badge/license-Apache%202.0-blue"></a> </p> # مهارات وكيل Elastic مهارات وكيل Elastic — التي بناها الأشخاص الذين بنوا Elastic — تقدّم خبرة المنصة الأصلية مباشرةً إلى وكيل البرمجة بالذكاء الاصطناعي الخاص بك. هذه هي مكتبة مهارات الوكيل الرسمية، المتوافقة مع بيئات التطوير المتكاملة الوكيلية مثل Cursor وGitHub Copilot وWindsurf وGemini CLI وغيرها. تتبع المهارات المعيار المفتوح [Agent Skills](https://agentskills.io/). > [!NOTE] > **معاينة تقنية** > > هذه المهارات في مرحلة إصدار مبكر وتخضع لتطوير نشط. توقّع حدوث تغييرات مع تقنين المهارات عبر تقييمات > قوية ومع تطور مشهد النماذج. تحقق بشكل متكرر للحصول على التحديثات. ## نبذة يحتوي هذا المستودع على مهارات منسّقة عبارة عن حزم من التعليمات والسياق والأدوات التي تعلّم أي وكيل ذكاء اصطناعي كيفية العمل بشكل صحيح مع Elasticsearch وKibana وElastic Observability وElastic Security. أضفها إلى بيئة تشغيل الوكيل التي تستخدمها بالفعل، وسيتوقف مساعدك عن استخدام الأنماط القديمة ويبدأ في إنجاز الأمور بشكل صحيح. ## ما هي المهارات؟ المهارات عبارة عن حزم مكتفية ذاتيًا تمنح وكلاء الذكاء الاصطناعي المعرفة والأدوات لإنجاز مهام محددة بطريقة قابلة للتكرار. توجد كل مهارة في مجلد خاص بها يحتوي على ملف `SKILL.md` يتضمن البيانات الوصفية والتعليمات التي يتبعها الوكيل. لمزيد من الخلفية حول معيار Agent Skills، راجع [agentskills.io](http://agentskills.io/). ## النطاق تركّز المهارات في هذا المستودع على: - التفاعل مع واجهات برمجة تطبيقات Elasticsearch (البحث، الفهرسة، إدارة العنقود) - بناء وإدارة محتوى Kibana مثل التنبيهات والموصلات وغيرها - أنماط Elastic Observability وElastic Security وAgent Builder <!-- BEGIN-SKILL-TABLE --> ## المهارات المتاحة <details> <summary>السحابة (2)</summary> | المهارة | الوصف | الإصدار | المؤلف | | ----- | ----------- | ------- | ------ | | [cloud-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/cloud/onboarding/SKILL.md) | تأهيل مؤسسة Elastic Cloud: تكوين سياق السحابة ومفتاح API الخاص بأداة `elastic` CLI، وتحديد منطقة افتراضية، ثم دعوة المستخدمين، وتعيين أدوار مشاريع Serverless المحددة مسبقًا أو المخصصة، وإنشاء مفاتيح Cloud API أو إبطالها. استخدمها عند إعداد مصادقة السحابة أو عند منح وصول المستخدمين إلى مؤسسة ومشاريعها أو تعديله أو تدقيقه. | 0.3.0 | elastic | | [cloud-provisioning](https://github.com/elastic/agent-skills/blob/main/skills/cloud/provisioning/SKILL.md) | توفير البنية التحتية لـ Elastic Cloud وتشغيلها: إنشاء مشاريع Serverless (Elasticsearch وObservability وSecurity) والاتصال بها وتحديثها وحذفها؛ وإدارة مرشحات حركة المرور (أمان الشبكة عبر IP وAWS PrivateLink)؛ وإدارة دورة حياة عمليات نشر Elastic Cloud Hosted. استخدمها عند إنشاء مشاريع serverless أو عمليات نشر مستضافة أو تنفيذ عمليات اليوم الثاني عليها، أو عند تقييد وصولها إلى الشبكة. | 0.3.0 | elastic | </details> <details> <summary>Elasticsearch (10)</summary> | المهارة | الوصف | الإصدار | المؤلف | | ----- | ----------- | ------- | ------ | | [elasticsearch-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection/SKILL.md) | إنشاء وإدارة مهام الكشف عن الشذوذ في Elastic ML عبر واجهة API. استخدمها عند إعداد المهام على فهرس أو تدفق بيانات، أو تكوين المهام وتدفقات البيانات (datafeeds)، أو فتحها أو تشغيلها أو إيقافها. | 1.1.0 | elastic | | [elasticsearch-anomaly-detection-explainer](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection-explainer/SKILL.md) | شرح درجات الكشف عن الشذوذ في Elasticsearch ML وسلوك النموذج وتفسير النتائج. استخدمها عندما يسأل المستخدم عن سبب ارتفاع درجة أو انخفاضها، أو كيف يتعلّم النموذج، أو ماذا تعني الأرقام، أو كيفية استكشاف درجات الشذوذ غير المتوقعة وإصلاحها. | 0.3.0 | elastic | | [elasticsearch-cluster-health](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-cluster-health/SKILL.md) | تشخيص عنقود Elasticsearch غير السليم (non-green) وإبراز السبب الأكثر ترجيحًا مع الحل. استخدمها عندما يُبلّغ مشغّل عن حالة صفراء أو حمراء، أو شظايا غير مُخصّصة (unassigned shards)، أو إخفاقات تخصيص، أو عندما يريد فرزًا للقراءة فقط قبل تحقيق أعمق. تعلّم تأثير النسخ المتماثلة مقابل الأساسية (replica-vs-primary)، وتصنيف محدِّد التخصيص (allocation decider)، والوعي بفقدان البيانات. | 0.1.0 | elastic | | [elasticsearch-esql](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-esql/SKILL.md) | تنفيذ استعلامات ES\|QL (لغة استعلام Elasticsearch)، استخدمها عندما يريد المستخدم الاستعلام عن بيانات Elasticsearch، أو تحليل السجلات، أو تجميع المقاييس، أو استكشاف البيانات، أو إنشاء مخططات ولوحات معلومات من نتائج ES\|QL. | 0.10.0 | elastic | | [elasticsearch-index-design](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-index-design/SKILL.md) | تصميم ومراجعة تعيينات فهارس Elasticsearch لأنماط الوصول المحددة: أنواع الحقول الصحيحة، والحقول المتعددة text+keyword، وضبط doc_values، وتجنّب تضخّم التعيينات (mapping-explosion)، وإعدادات الشظايا الصريحة. استخدمها عند إنشاء فهرس جديد، أو مراجعة تعيين لأداء التخزين أو الاستعلام، أو إصلاح أنواع الحقول الخاطئة، أو عندما يسأل المستخدم عن النوع الذي يجب استخدامه للبحث أو التصفية أو الفرز أو التجميع على حقل ما. | 0.1.0 | elastic | | [elasticsearch-ingest](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-ingest/SKILL.md) | تحميل ملفات CSV وJSON وNDJSON إلى فهارس Elasticsearch باستخدام واجهة bulk API والتعيينات الصريحة عندما تكون أنواع الحقول مهمة. استخدمها عند الاستيراد الدفعي للملفات المحلية، أو تحويل صفوف CSV أو مصفوفات JSON إلى صيغة NDJSON الدفعية، أو تأكيد اتصال العنقود عبر elastic es info قبل الإدخال، أو التحقق من عدد المستندات والتعيينات بعد الإدخال — وليس لخطوط أنابيب Logstash أو Beats أو النصوص البرمجية المخصصة أو إعادة الفهرسة من فهرس إلى فهرس. | 0.1.3 | elastic | | [elasticsearch-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-onboarding/SKILL.md) | مساعدة المطورين الجدد على Elasticsearch للانتقال من الصفر إلى تجربة بحث عاملة. وجّههم عبر فهم مقصدهم، وتعيين بياناتهم، وبناء تجربة بحث مع دمج أفضل الممارسات. استخدمها عندما يُبدي المستخدم نية لبناء وظائف متعلقة بالبحث، أو يسأل عن مفاهيم متعلقة بـ Elasticsearch لحالته، أو يعبّر عن حاجته للمساعدة في البدء مع Elasticsearch. | 0.3.0 | elastic | | [elasticsearch-query-optimization](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-query-optimization/SKILL.md) | تشخيص عمليات البحث البطيئة في Elasticsearch Query DSL واقتراح إصلاحات مقيسة. استخدمها عندما يكون البحث بطيئًا، أو يُظهر مخرجات التحليل (profile) بندًا مكلفًا، أو تكون مرشّحات المطابقة التامة في سياق التقييم (scoring context)، أو تهيمن أحرف البدل البادئة (leading wildcards) على زمن الاستجابة. أسند كل توصية إلى تحليل البحث (search profiling) — انقل البنود غير المُقيِّمة إلى سياق التصفية (filter context)، وأزل أحرف البدل البادئة، وأعد التحليل لتأكيد التحسّن. | 0.1.0 | elastic | | [elasticsearch-reindex](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-reindex/SKILL.md) | إرشاد حول إعادة الفهرسة (reindex) في Elasticsearch من أجل الأداء: المحلية والبعيدة، والتقسيم (slicing)، وتحديد المعدل (throttling)، وواجهة task API. استخدمها عند نسخ الفهارس أو ترحيلها، أو تغيير التعيينات، أو التحويل أثناء إعادة الفهرسة. | 0.2.0 | elastic | | [elasticsearch-search-relevance](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-search-relevance/SKILL.md) | تحسين صلة البحث في Elasticsearch لفهارس المحتوى والكتالوج: تثبيت النتائج أو الترويج لها باستخدام قواعد الاستعلام (نوع القاعدة الصحيح، والمعايير، وربط قاعدة الاستعلام) وضبط الترتيب العضوي باستخدام multi_match، وتعزيز الحقول، والتحليل المستند إلى تعيين الفهرس. استخدمه عندما تكون ترتيب نتائج البحث ضعيفًا، أو عندما يجب أن يظهر مستند معين أولًا لاستعلام ما، أو عندما يطلب المستخدم ضبط المطابقة النصية الكاملة — وليس لتحليلات ES\|QL، أو إدخال الفهرس، أو صحة العنقود. | 0.1.0 | elastic | </details> <details> <summary>Kibana (7)</summary> | المهارة | الوصف | الإصدار | المؤلف | | ----- | ----------- | ------- | ------ | | [kibana-agent-builder](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-agent-builder/SKILL.md) | إنشاء وإدارة وكلاء Kibana Agent Builder والأدوات المخصصة. استخدمها عند الطلب بإنشاء أو تحديث أو حذف أو اختبار أو فحص الوكلاء أو الأدوات في Agent Builder، أو عندما يرغب المستخدم في معرفة الوكلاء أو الأدوات الموجودة بالفعل. | 0.3.0 | elastic | | [kibana-alerting-rules](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-alerting-rules/SKILL.md) | إنشاء وإدارة قواعد التنبيه في Kibana. استخدمها عند إنشاء أو تحديث أو إدارة دورة حياة القواعد (تمكين، تعطيل، كتم، تأجيل)، أو اختيار أنواع قواعد عتبة المقاييس ومعاملاتها، أو البحث/السرد للقراءة فقط مع مرشحات الوسوم. | 0.3.0 | elastic | | [kibana-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-anomaly-detection/SKILL.md) | الكشف عن الشذوذ في Elastic ML — التحقيق/تحليل السبب الجذري (RCA)، وشرح الدرجات، واستكشاف أخطاء دورة حياة المهام وإصلاحها، وعمليات المهام. استخدمها عند الإجابة عن "ما الذي تعطّل؟"/"أي كيان؟"/RCA، أو "لماذا الدرجة مرتفعة/منخفضة؟"/إعادة التطبيع، أو "توقف datafeed"/"حد الذاكرة"/hard_limit، أو عند تهيئة مهام الكشف عن الشذوذ في ML. تقرأ النتائج من `.ml-anomalies-*` وحالة المهمة من واجهات ML REST APIs. | 0.3.0 | elastic | | [kibana-cases](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-cases/SKILL.md) | إدارة حالات التحقيق والحوادث عبر Elastic Security وObservability وStack Management — إنشاء الحالات والبحث عنها وتحديثها وإثراؤها بالتعليقات والتنبيهات والأحداث والمؤشرات القابلة للملاحظة (IOCs). استخدمها عند تتبع الحوادث، أو ربط التنبيهات بحالة، أو إضافة ملاحظات التحقيق، أو تحديث الحالة أو الخطورة، أو إدارة مخرجات الفرز. | 0.2.0 | elastic | | [kibana-context-engine](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-context-engine/SKILL.md) | الاستعلام عن فهارس Elastic Context Engine AI ومؤشرات المعرفة (KIs) التي تخزّنها. استخدمها عند الطلب بالبحث أو الاستكشاف أو العدّ أو الإجابة عن أسئلة من فهرس معرفة AI Index / KI / Context Engine، وعند كتابة ES\|QL الذي يستعلم عن أحدها. | 0.2.1 | elastic | | [kibana-dashboards](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-dashboards/SKILL.md) | إنشاء وإدارة لوحات معلومات Kibana ومرئيات Lens. استخدمها عندما تحتاج إلى تعريف لوحات المعلومات والمرئيات تعريفًا تصريحيًا، أو التحكم في إصداراتها، أو أتمتة نشرها، أو تحسين التخطيط أو الأقسام أو عناصر التحكم أو تصميم المخططات. | 0.4.0 | elastic | | [kibana-workflows](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-workflows/SKILL.md) | تأليف تعريفات Elastic Workflow YAML والتحقق منها واختبارها وتشغيلها وفحصها. استخدمها عندما يرغب المستخدم في تحويل اللغة الطبيعية إلى سير عمل Kibana، أو إصلاح Workflow YAML، أو فهم المحفزات أو الخطوات، أو تشغيل حلقة اختبار سريعة مقابل Kibana حقيقي. | 0.5.0 | elastic | </details> <details> <summary>Observability (6)</summary> | المهارة | الوصف | الإصدار | المؤلف | | ----- | ----------- | ------- | ------ | | [observability-csp-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/csp-investigation/SKILL.md) | التحقيق في مشكلات خدمات مزوّد السحابة (CSP) — AWS حاليًا (ينطبق المنطق على أي خدمة من خدمات AWS؛ والمخطط وتوقيعات الأعطال هي الأعمق في RDS وLambda وSQS وALB وEC2)، وفي المستقبل GCP وAzure — باستخدام مقاييس السحابة بمخطط OTel في Elastic. استخدمها عند تشخيص مشكلات موارد السحابة، سواء أكانت ناتجة عن تنبيه أم عشوائية: ضغط اتصالات قاعدة البيانات/المعالج/الذاكرة، ومعدلات أخطاء الدوال وتقييدها، وتراكم قوائم الانتظار وتأخر المستهلكين، وأخطاء 5xx في موازن التحميل، وإشباع النسخ. تربط المورد قيد التحقيق بخط أساسه الخاص، وتصنّف نمط العطل، وتستبعد الحالات المتزامنة لكن غير ذات الصلة. | 0.2.0 | elastic | | [observability-k8s-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/k8s-investigation/SKILL.md) | التحقيق في مشكلات أحمال عمل Kubernetes والعُقد ومستوى التحكم باستخدام قياسات OTel (EDOT). استخدمها عند تشخيص أعطال الحاويات (CrashLoopBackOff، OOMKilled، Error)، وضغط العُقد، ونفاد الموارد، وفشل سحب الصور، ورفض القبول، وشذوذ التوسّع التلقائي، أو ربط حالة K8s بإشارات التطبيق. مسار استقبال OTel فقط — شكل تكامل ECS Kubernetes القديم خارج النطاق. | 0.5.1 | elastic | | [observability-llm-obs](https://github.com/elastic/agent-skills/blob/main/skills/observability/llm-obs/SKILL.md) | الإجابة عن الأسئلة المتعلقة بسلوك نماذج اللغة الكبيرة والتطبيقات الوكيلية من البيانات المستوعبة مسبقًا في Elastic: زمن الاستجابة ومعدل الأخطاء، واستهلاك الرموز والتكلفة، وجودة الاستجابة وأحداث حواجز الحماية، وتنسيق سلسلة الاستدعاء الوكيلية. استخدمها عندما يسأل المستخدم عن مراقبة نماذج اللغة الكبيرة، أو رصد GenAI، أو إنفاق الرموز أو تكلفة الذكاء الاصطناعي، أو زمن استجابة النموذج، أو فشل المطالبات أو حواجز الحماية، أو كيفية تنفيذ سلسلة استدعاء الأدوات لدى الوكيل. | 0.3.1 | elastic | | [observability-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/observability/onboarding/SKILL.md) | إدماج تطبيق في Elastic Observability باستخدام Elastic Distribution of OpenTelemetry (EDOT): التوجيه حسب اللغة وبيئة التشغيل، واكتشاف وكيل Elastic APM الكلاسيكي واستبداله، وتطبيق إعداد OTLP المطلوب، ثم التحقق باستخدام ES\|QL من وصول التتبعات والمقاييس والسجلات فعليًا تحت اسم الخدمة المتوقع. استخدمها عند إضافة الرصد إلى خدمة، أو الترحيل من وكيل Elastic APM الكلاسيكي، أو تصحيح سبب عدم ظهور خدمة مزوّدة بأدوات الرصد في Elastic. | 0.3.0 | elastic | | [observability-service-reliability](https://github.com/elastic/agent-skills/blob/main/skills/observability/service-reliability/SKILL.md) | تصميم أهداف موثوقية الخدمة وتشغيلها في Elastic Observability: اختيار نوع SLI وهدف قابل للدفاع عنه، واختيار نافذة زمنية وطريقة للميزانية، وإنشاء SLOs وصيانتها عبر Kibana API، وإرفاق قواعد تنبيه معدل الاستهلاك، وتحديد متى يكون SLO الأداة الخاطئة ومتى تكون قاعدة العتبة أو مهمة الشذوذ أو مراقب Synthetics هي الصحيحة. استخدمها عند تعريف SLOs وميزانيات الأخطاء أو مراجعتها، أو ضبط تنبيهات معدل الاستهلاك، أو تقليل ضجيج التنبيهات، أو إعداد مراقبة التوافر لنقطة نهاية مواجهة للمستخدم. | 0.4.1 | elastic | | [observability-sre-triage](https://github.com/elastic/agent-skills/blob/main/skills/observability/sre-triage/SKILL.md) | فرز خدمة متدهورة أو مشتبه بها من البداية إلى النهاية: قراءة حالة SLO ومعدل الاستهلاك، والتحقق من قواعد التنبيه النشطة وشذوذات ML، وقياس الإنتاجية وزمن الاستجابة ومعدل الأخطاء، وتقييم صحة التبعيات وإشباع البنية التحتية، وتضييق السجلات وصولًا إلى الأعطال التي تفسّرها. استخدمها عندما يسأل أحدهم عمّا إذا كانت خدمة ما سليمة، أو لماذا هي بطيئة أو تُصدر أخطاء، أو ما الموجود في سجلاتها، أو أي سمة تميّز الطلبات الفاشلة. استخدمها أيضًا عندما يطلب أحدهم الاستعلام الكامن وراء أي من تلك الإشارات — الإنتاجية، أو مئينات زمن الاستجابة، أو معدل الأخطاء، أو صحة التبعيات، أو حجم السجلات — عبر تتبعات أو مقاييس أو سجلات APM/OTel. | 0.5.2 | elastic | </details> <details> <summary>الأمان (6)</summary> | المهارة | الوصف | الإصدار | المؤلف | | ----- | ----------- | ------- | ------ | | [security-alert-analysis](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-analysis/SKILL.md) | التحقيق في تنبيه كشف محدد من Elastic Security: جمع السياق، وتقييم مخاطر الكيان، وتصنيف التهديد، وتوثيق النتائج، والاعتراف بالتنبيه اختياريًا. استخدمها عند فرز تنبيه واحد معروف، أو إجراء تحقيق في مركز العمليات الأمنية (SOC)، أو المتابعة بعد أن تحدد مهارة security-alert-triage مجموعة تستدعي التحقيق. | 0.1.0 | elastic | | [security-alert-triage](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-triage/SKILL.md) | ترتيب أولويات قائمة تنبيهات Elastic Security وترتيبها حسب المخاطر الموزونة — درجة المخاطر الأساسية، وتعزيز تكتيك MITRE، ومخاطر الكيان، وأهمية الأصل — ثم تجميع التنبيهات في مجموعات كيانات. استخدمها عندما يسأل محلل عن ما ينبغي التركيز عليه، أو عن التنبيهات الأكثر إلحاحًا، أو عندما يريد نقطة بداية مرتبة عبر القائمة قبل بدء تحقيق أعمق. | 0.2.0 | elastic | | [security-case-management](https://github.com/elastic/agent-skills/blob/main/skills/security/case-management/SKILL.md) | إنشاء حالات SOC والبحث فيها وتحديثها وإدارتها عبر Kibana Cases API. استخدمها عند تتبع الحوادث، أو ربط التنبيهات بالحالات، أو إضافة ملاحظات التحقيق، أو إدارة مخرجات الفرز. | 0.1.0 | elastic | | [security-detection-rule-management](https://github.com/elastic/agent-skills/blob/main/skills/security/detection-rule-management/SKILL.md) | إنشاء قواعد كشف Elastic Security (SIEM وEndpoint) وضبطها وإدارتها. استخدمها للتعامل مع الإيجابيات الكاذبة، أو الاستثناءات، أو التغطية الجديدة، أو القواعد المزعجة، أو إدارة القواعد عبر Kibana API. | 0.1.0 | elastic | | [security-generate-security-sample-data](https://github.com/elastic/agent-skills/blob/main/skills/security/generate-security-sample-data/SKILL.md) | إنشاء أحداث أمنية نموذجية، وسيناريوهات هجوم، وتنبيهات اصطناعية لـ Elastic Security. استخدمها عند العرض التوضيحي، أو تعبئة لوحات المعلومات، أو اختبار قواعد الكشف، أو إعداد إثبات مفهوم (POC). | 0.1.0 | elastic | | [security-ml-integrations](https://github.com/elastic/agent-skills/blob/main/skills/security/ml-integrations/SKILL.md) | تثبيت حزم تكامل التعلم الآلي الأمني في Elastic (beaconing، ded، dga، lmd، pad، problemchild) وإدارتها. تتولى دورة الحياة الكاملة: فحوصات ما قبل التنفيذ، وتثبيت حزمة Fleet، وقوالب المكونات، وخطوط أنابيب الاستيعاب، والتحويلات، وعروض البيانات، ومهام كشف الشذوذ بالتعلم الآلي، وقواعد الكشف. استخدمها عندما يطلب مستخدم تثبيت حزمة تكامل التعلم الآلي الأمني، أو إعدادها، أو التحقق من حالتها، أو استكشاف مشكلاتها وإصلاحها. | 0.1.0 | elastic | </details> <!-- END-SKILL-TABLE --> ## اعتبارات أمنية تعمل وكلاء البرمجة بالذكاء الاصطناعي ببيانات اعتماد حقيقية، ووصول فعلي إلى الصدفة (shell)، وغالبًا بكامل أذونات المستخدم الذي يشغّلها. وعندما تُوجَّه هذه الوكلاء إلى سير عمل أمنية، تصبح المخاطر أعلى. وهذا يستدعي محادثة صريحة حول المخاطر قبل أن تبدأ. - **أجرِ تقييمك الخاص للتهديدات.** قيّم البيانات التي يمكن للوكيل الوصول إليها، والإجراءات التي يمكنه اتخاذها، وما يحدث إذا تصرف بشكل غير متوقع. تُعد [الإرشادات المشتركة الصادرة عن CISA بشأن نشر أنظمة الذكاء الاصطناعي بشكل آمن](https://www.cisa.gov/news-events/alerts/2024/04/15/joint-guidance-deploying-ai-systems-securely) نقطة انطلاق جيدة. - **كن على دراية بالبيانات التي تتدفق عبر الوكيل.** قد تحتوي بيانات الأمان على معلومات التعريف الشخصية (PII)، وبيانات الاعتماد المضمّنة في سطور الأوامر، وغيرها من البيانات الخاضعة للتنظيم. عندما يستعلم الوكيل عن التنبيهات أو أحداث العمليات، يدخل ذلك المحتوى إلى سياق النموذج وقد يُرسل إلى واجهة برمجة تطبيقات تابعة لجهة خارجية. أشرك فرق أمن المعلومات والامتثال لديك في وقت مبكر. - **تتعامل هذه الوكلاء مع مدخلات يتحكم بها المهاجمون.** تحتوي التنبيهات وحقول الأحداث ومحتويات الملفات بانتظام على سلاسل نصية يصوغها المهاجمون. حقن الأوامر (Prompt injection) ليس نظريًا هنا؛ بل هو خاصية متأصلة في بيئة التشغيل. تُظهر أبحاث مثل [Brainworm](https://www.originhq.com/blog/brainworm) أن ملفات سياق الوكيل وحدها يمكن أن تكون بمثابة آلية استمرارية لبرمجيات الحقن النصي (promptware). - **اضبط الامتيازات بشكل صارم.** امنح مفاتيح واجهة برمجة التطبيقات الحد الأدنى من الامتيازات المطلوبة. تُعد امتيازات الاستجابة الواسعة خطيرة بشكل خاص. الوصول للقراءة فقط هو إعداد افتراضي جيد حتى تتحقق من السلوك. - **قيّد وصول الوكيل إلى الأدوات ونطاق الشبكة.** تأتي معظم وكلاء البرمجة بالذكاء الاصطناعي بإعدادات افتراضية واسعة: تنفيذ الأوامر عبر الصدفة، والكتابة على نظام الملفات، والوصول إلى الإنترنت. تقليل سطح الأدوات المتاحة يحدّ مما يمكن لوكيل مخترق أو مُضلَّل فعله. - **ابدأ في بيئات غير إنتاجية.** استخدم مشروع تجريبي على Serverless، أو عنقود تطوير، أو مساحة Kibana معزولة لتقييم المهارات قبل ربطها بأي شيء يحمل بيانات أمان حية. هذه المهارات مفتوحة المصدر تحديدًا لتتمكن من تدقيق ما تفعله. نشجعك على قراءتها قبل تشغيلها. ## البدء يمكنك تثبيت مهارات Elastic باستخدام نظام الإضافات الأصلي في Claude Code، أو أداة سطر الأوامر `skills` مع `npx`، أو باستنساخ هذا المستودع وتشغيل سكربت التثبيت المرفق. تتطلب طريقة `npx` توفر `Node.js` مع `npx` في بيئتك. > [!TIP] > **لا تثبّت كل المهارات.** كل مهارة مثبّتة تضيف سياق توجيه يقيّمه وكيلك عند كل طلب. ثبّت مهارات المصادقة **cloud** و**elasticsearch** — إذ تعتمد عليها معظم المهارات الأخرى — ثم أضف فقط المهارات ذات الصلة بسير عملك. يساعد إبقاء المجموعة المثبّتة مركّزة على تجنب تضخم السياق ويساعد الوكيل على التوجيه إلى المهارة الصحيحة بشكل موثوق. ### إضافة Claude Code (موصى بها لمستخدمي Claude Code) يمتلك Claude Code نظام إضافات أصليًا يدير المهارات مباشرة. ابدأ بإضافة هذا المستودع كمصدر سوق: ```sh claude plugin marketplace add https://github.com/elastic/agent-skills ``` بمجرد الإضافة، ثبّت الإضافات الفردية بالاسم: ```sh claude plugin install elastic-elasticsearch@elastic-agent-skills claude plugin install elastic-kibana@elastic-agent-skills claude plugin install elastic-observability@elastic-agent-skills claude plugin install elastic-security@elastic-agent-skills claude plugin install elastic-cloud@elastic-agent-skills ``` > [!NOTE] > بعد التثبيت، قد لا تظهر المهارات فورًا عند تشغيل `/reload-plugins`. هذه مشكلة معروفة في Claude Code — أعد تشغيل جلسة Claude Code لالتقاط الإضافات المثبّتة حديثًا. أو استخدم متصفح الإضافات التفاعلي داخل أي جلسة Claude Code: ``` /plugins ``` يفتح هذا قائمة لتصفح الإضافات المتاحة من جميع الأسواق المُهيأة، واختيار ما تريد تثبيته، وإدارة ما هو مثبّت بالفعل. ### GitHub Copilot CLI يمتلك GitHub Copilot CLI نظام إضافات أصليًا. أضف هذا المستودع كمصدر سوق: ```sh copilot plugin marketplace add elastic/agent-skills ``` بمجرد الإضافة، ثبّت الإضافات الفردية بالاسم: ```sh copilot plugin install elasticsearch@elastic-agent-skills copilot plugin install kibana@elastic-agent-skills copilot plugin install observability@elastic-agent-skills copilot plugin install security@elastic-agent-skills ``` --- [Read more](https://github.com/elastic/agent-skills)