مهارات Elastic Agent

مهارات Elastic Agent — التي طورها من صنعوا Elastic — تقدم خبرة المنصة الأصلية مباشرة إلى وكيل البرمجة الذكي الخاص بك. هذه هي مكتبة المهارات الرسمية لـ Agent، المتوافقة مع بيئات التطوير الذكية مثل Cursor وGitHub Copilot وWindsurf وGemini CLI وغيرها. تتبع المهارات المعيار المفتوح Agent Skills.

[!NOTE] معاينة تقنية

هذه المهارات في مرحلة إصدار مبكر وتحت تطوير نشط. توقع تغييرات مع تدوين المهارات بتقييمات قوية ومع تطور مشهد النماذج. تحقق باستمرار للحصول على التحديثات.

حول

يحتوي هذا المستودع على مهارات منسقة وهي حزم من التعليمات والسياق والأدوات التي تعلم أي وكيل ذكي كيفية العمل بشكل صحيح مع Elasticsearch وKibana وElastic Observability وElastic Security. قم بإسقاطها في بيئة تشغيل الوكيل التي تستخدمها بالفعل، وسيتوقف مساعدك عن استخدام أنماط قديمة ويبدأ في الحصول على الأمور بشكل صحيح.

ما هي المهارات؟

المهارات هي حزم مستقلة تمنح وكلاء الذكاء الاصطناعي المعرفة والأدوات لإكمال مهام محددة بطريقة قابلة للتكرار. تعيش كل مهارة في مجلدها الخاص مع ملف SKILL.md يحتوي على بيانات وصفية وتعليمات يتبعها الوكيل.

لمزيد من المعلومات حول معيار Agent Skills، راجع agentskills.io.

النطاق

تركز المهارات في هذا المستودع على:

• التفاعل مع واجهات برمجة تطبيقات Elasticsearch (بحث، فهرسة، إدارة الكتلة)
• بناء وإدارة محتوى Kibana مثل التنبيهات والموصلات والمزيد
• أنماط Elastic Observability وElastic Security وAgent Builder

المهارات المتاحة

اعتبارات الأمان

تعمل وكلاء البرمجة الذكية ببيانات اعتماد حقيقية ووصول حقيقي إلى الصدفة وغالباً بصلاحيات المستخدم الكامل الذي يشغلهم. عندما يتم توجيه هؤلاء الوكلاء إلى سير عمل الأمان، تكون المخاطر أعلى. وهذا يستدعي محادثة صريحة حول المخاطر قبل البدء.

• قم بنمذجة التهديدات الخاصة بك. قم بتقييم البيانات التي يمكن للوكيل الوصول إليها والإجراءات التي يمكنه اتخاذها وما يحدث إذا تصرف بشكل غير متوقع. التوجيه المشترك لـ CISA حول نشر أنظمة الذكاء الاصطناعي بشكل آمن هو نقطة بداية جيدة.
• كن على دراية بالبيانات التي تتدفق عبر الوكيل. يمكن أن تحتوي بيانات الأمان على معلومات تعريف شخصية وبيانات اعتماد مضمنة في أسطر الأوامر وبيانات منظمة أخرى. عندما يستفسر الوكيل عن التنبيهات أو أحداث العمليات، يدخل هذا المحتوى في سياق النموذج وقد يتم إرساله إلى واجهة برمجة تطبيقات تابعة لجهة خارجية. أشرك فرق أمن المعلومات والامتثال لديك مبكراً.
• تقوم هذه الوكلاء بمعالجة مدخلات يتحكم فيها المهاجم. تحتوي التنبيهات وحقول الأحداث ومحتويات الملفات بانتظام على سلاسل من إنشاء المهاجمين. حقن الأوامر ليس نظرياً هنا؛ إنها خاصية متأصلة في بيئة التشغيل. يوضح بحث مثل Brainworm أن ملفات سياق الوكيل وحدها يمكن أن تعمل كآلية استمرار لبرامج التعليمات البرمجية الخبيثة.
• حدد الامتيازات بإحكام. امنح مفاتيح API أقل الامتيازات المطلوبة. صلاحيات الاستجابة الواسعة خطيرة بشكل خاص. الوصول للقراءة فقط هو إعداد افتراضي جيد حتى تتحقق من السلوك.
• قم بتقييد الوصول إلى أدوات الوكيل والوصول إلى الشبكة. معظم وكلاء البرمجة الذكية يأتون بإعدادات افتراضية واسعة: تنفيذ الصدفة، كتابة نظام الملفات، الوصول إلى الإنترنت. تقليل سطح الأداة المتاحة يحد من ما يمكن للوكيل المخترق أو المضلل فعله.
• ابدأ في بيئات غير إنتاجية. استخدم مشروع Serverless تجريبي أو كتلة تطوير أو مساحة Kibana معزولة لتقييم المهارات قبل توصيلها بأي شيء يحمل بيانات أمان حية.

هذه المهارات مفتوحة المصدر تحديداً لتتمكن من تدقيق ما تفعله. نشجعك على قراءتها قبل تشغيلها.

البدء

يمكنك تثبيت مهارات Elastic باستخدام نظام الإضافات الأصلي لـ Claude Code، أو واجهة skills CLI مع 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 elasticsearch@elastic-agent-skills
claude plugin install kibana@elastic-agent-skills
claude plugin install observability@elastic-agent-skills
claude plugin install security@elastic-agent-skills
claude plugin install 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 copilot plugin install cloud@elastic-agent-skills

أو تصفح الإضافات المتاحة بشكل تفاعلي داخل جلسة Copilot:```
/plugin list

npx (مُوصَى به)

أسرع طريقة لتثبيت المهارات هي باستخدام واجهة سطر الأوامر skills. لا حاجة لاستنساخ هذا المستودع — فقط شغّل:```sh npx skills add elastic/agent-skills

يؤدي هذا إلى تشغيل موجه تفاعلي لاختيار المهارات و[العوامل المستهدفة](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents). يقوم CLI بنسخ كل مجلد مهارة إلى الموقع الصحيح ليكتشفه العامل.

تثبيت مهارة محددة بالاسم:

```bash
npx @vercel/skills@latest install <skill-name>
``````sh
npx skills add elastic/agent-skills --skill elasticsearch-esql

أو استخدم الاختصار @ لتحديد المهارة مباشرة كـ repo@skill (أي ما يعادل --skill):```sh npx skills add elastic/agent-skills@elasticsearch-esql

التثبيت إلى عوامل محددة (انظر [العوامل المدعومة](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)):```sh
npx skills add elastic/agent-skills -a cursor -a claude-code

عرض المهارات المتاحة دون تثبيت:```sh npx skills add elastic/agent-skills --list

تثبيت جميع المهارات لجميع الوكلاء (غير تفاعلي):```sh
npx skills add elastic/agent-skills --all

نسخة محلية

إذا كنت تفضل العمل من نسخة محلية، أو إذا كانت بيئتك لا تحتوي على Node.js / npx، فاستنسخ المستودع واستخدم مثبت bash المضمن:```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a

يتطلب البرنامج النصي bash 3.2+ والأدوات المساعدة القياسية لـ Unix (`awk`, `find`, `cp`, `rm`, `mkdir`).

| العلم              | الوصف                           |
| ----------------- | ------------------------------------- |
| `-a, --agent`     | الوكيل المستهدف (قابل للتكرار)             |
| `-s, --skill`     | تثبيت مهارات محددة بالاسم       |
| `-f, --force`     | الكتابة فوق المهارات المثبتة بالفعل    |
| `-y, --yes`       | تخطي مطالبات التأكيد             |

سرد جميع المهارات المتاحة:```sh
./scripts/install-skills.sh list

الوكلاء المدعومون

تحديث المهارات

تعتمد عملية التحديث على كيفية تثبيت المهارات.

المكوّن الإضافي لـ Claude Code

قم بتحديث جميع المكوّنات الإضافية المثبتة إلى أحدث إصداراتها:```sh claude plugin update

تحديث إضافة معينة:```sh
claude plugin update elastic-elasticsearch

للحفاظ على تحديث الإضافات تلقائيًا، قم بتمكين التحديث التلقائي باستخدام /plugins داخل Claude Code.

عند تشغيل التحديث التلقائي، يتحقق Claude Code من الإصدارات الجديدة للإضافات عند بدء التشغيل ويقوم بتحديثها في الخلفية.

GitHub Copilot CLI

تحديث جميع الإضافات المثبتة إلى أحدث إصداراتها:```sh copilot plugin update

تحديث إضافة محددة:```sh
copilot plugin update elasticsearch

npx

تحقق مما إذا كانت أي مهارات مثبتة قد تغيرت في upstream:```sh npx skills check

اسحب أحدث إصدارات جميع المهارات المثبتة:```sh
npx skills update

يقوم CLI بتتبع مستودع المصدر لكل مهارة وتجزئة المحتوى في ملف القفل. check يقارن التجزئات المحلية الخاصة بك مع GitHub؛ update يعيد تنزيل أي شيء تغير.

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

استنساخ محلي

أعد تشغيل المثبت باستخدام --force للكتابة فوق المهارات الموجودة:```sh git pull ./scripts/install-skills.sh add -a --force

بدون `--force`، يتخطى السكريبت المهارات المثبتة بالفعل.

## تنسيق المهارة

يحتوي كل مجلد مهارة على ملف `SKILL.md` مع بيانات واجهة YAML وتعليمات markdown:```yaml
---
name: elasticsearch-my-skill
description: >
  What the skill does AND when an agent should activate it.
metadata:
  version: 0.1.0
  visibility: public
---

# My Skill

[Instructions that the agent follows when this skill is active]

حقل description هو آلية التشغيل الوحيدة — تقوم بيئات تشغيل العامل بقراءته لتقرر متى تحمّل مهارة. للحصول على مواصفات التنسيق الكاملة، راجع agentskills.io/specification.

المشكلات

وجدت مشكلة أو لديك اقتراح؟ افتح مشكلة وسنقوم بمراجعتها.

إخلاء المسؤولية

هذه المهارات متوفرة كما هي. اختبر المهارات جيدًا دائمًا في بيئتك الخاصة قبل الاعتماد عليها في المهام الحرجة.