الاتصالات والمعرفةالمهارات العامة

Analytics & Reporting Skill (Revenue Intelligence)

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

افتح مصدر المهارة اقرأ الدليل الرسمي ↗

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

تنسيق التحليلات المُدارة — استعلام مقاييس الإيرادات، بناء لوحات المعلومات، تحليل مسارات التحويل، اكتشاف الشذوذ، توقع النمو، وشرح تغييرات المقاييس. استخدمه عند مراجعة مؤشرات الأداء الرئيسية، بناء لوحات المعلومات، تحليل المسارات، اكتشاف الشذوذ، توقع المقاييس، مقارنة الفترات، أو إنشاء تقارير تنفيذية…

الهيكلية

كيف يوجه Analytics & Reporting Skill (Revenue Intelligence) وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

→

مهارة Analytics & Reporting Skill (Revenue Intelligence)

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

→

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

→

mcp-analytics

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

→

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-analytics · الأدوات المسموح بها: 22

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

تأتي هذه المسارات مباشرة من تعليمات المهارة. تساعد النموذج على التعرف على النية واختيار أداة أو سير عمل مركّز بدلاً من الارتجال عبر كامل سطح القدرة.

"الإيرادات"، "MRR"، "ARR"، "النمو"؟

WORKFLOW 1: مقاييس الإيرادات

"قمع"، "تحويل"، "تسرب"؟

WORKFLOW 2: تحليل القمع

"شذوذ"، "ارتفاع"، "انخفاض"، "غير معتاد"؟

WORKFLOW 3: اكتشاف الشذوذ

"توقع"، "تنبؤ"، "الشهر القادم"؟

WORKFLOW 4: التنبؤ

"لوحة معلومات"، "إنشاء"، "تقرير"؟

WORKFLOW 5: بناء لوحة المعلومات

"لماذا"، "شرح"، "ما الذي تغير"؟

WORKFLOW 6: نسب التغيير

غير واضح؟

اسأل: "هل ترغب في التحقق من مقياس، تحليل قمع، أو بناء لوحة معلومات؟"

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

حدود الأداة

قد تستخدم المهارة 22 أدوات موثقة.

يتم إعلان هذه القائمة المسموح بها من قبل المهارة. تحافظ على تركيز الوكيل على الإجراءات اللازمة لهذه المهمة بينما يحتفظ mcp-analytics بالمسؤولية عن المصادقة، التحقق، والنظام المتصل.

list_data_sources

list_datasets

describe_dataset

list_metrics

get_metric_definition

query_metric

breakdown_metric

compare_metric

query_events

query_report

analyze_funnel

analyze_cohort

detect_anomalies

forecast_metric

explain_change

generate_insight_summary

list_dashboards

get_dashboard

summarize_dashboard

create_dashboard

add_widget

validate_analytics_policy

قواعد العمل

ما الذي يجب على الوكيل القيام به.

اتبع دليل القرار، استخدم حدود الأداة المعلنة، وتحقق من النتيجة قبل الرد.

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

راجع SKILL.md الكامل قبل تمكين هذه المهارة للعمل الإنتاجي.

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-analytics، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة

git clone https://github.com/zavora-ai/skill-analytics-reporting.git \
  ~/.skills/skills/analytics-reporting

شكل تحميل ADK-Rust

let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("analytics-reporting").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-analytics. اختياري: mcp-slack لتسليم التنبيهات، mcp-email للتقارير المجدولة.

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md سير عمل عبر Mcp ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md حساب المسار ↗scripts/calculate_funnel.py تقرير المسار ↗assets/funnel-report.md

استمر في الاستكشاف