وكيل تدقيق تعريفات المقاييس
يكتشف أين يعني اسم مقياس واحد ثلاثة أشياء مختلفة
- 8قواعد صارمة
- أشياء يُمنع عليه فعلها أبدًا، مفروضة في كل تشغيل
- 5قواعد تسليم
- حالات يتوقف عندها ويسلّم العمل إلى شخص
- 10حقول المخرجات
- نتيجة منظّمة، لا فقرة عليك إعادة قراءتها
- ≤7خطوة لكل تشغيل
- عمل محدود: 5 استدعاء أداة كحد أقصى، مفروضة من بيئة التشغيل
قراءة فقط بحكم التصميم. هذا الوكيل لا يملك أي طريق للإرسال أو الإنفاق أو النشر أو الالتزام بأي شيء. وحين يكون هذا الحد هو المنتج نفسه، فإن إزالته تزيل سبب الثقة في المخرجات.
نظرة عامة
أخطر عطل في ذكاء الأعمال ليس خط أنابيب معطلاً — فذلك يُلاحَظ ويُصلَح. الأخطر أن "العميل النشط" يعني شيئاً في لوحة المالية، وشيئاً آخر في لوحة المنتج، وشيئاً ثالثاً في تقرير مجلس الإدارة، وكلها تحمل التسمية نفسها.
يحدث هذا دون أن يرتكب أحد خطأً. فكل لوحة معلومات بناها شخص مختلف لسؤال مختلف، وكان كل تعريف معقولاً لذلك السؤال. لم يكتبه أحد لأنه كان بديهياً في حينه. وبعد عامين يرحل الشخص ولا يبقى التعريف إلا في SQL.
تقع التكلفة في الاجتماعات. يتجادل فريقان لمدة ساعة حول أي رقم صحيح بينما كلاهما صحيح ويقيسان أمرين مختلفين. أما النسخة الأكثر كلفة فهي حين لا ينتبه أحد، ويُتخذ قرار بناءً على رقم لا يعني ما تظنه الغرفة أنه يعنيه.
أدوات الحوكمة تبيع كتالوجات عليك ملؤها، ولهذا تنتهي نصف مملوءة. هذا الوكيل يفعل العكس: يقرأ الاستعلامات الموجودة فعلاً، ويستخلص ما يحسبه كل مقياس فعلياً، ويوضح أين يعني الاسم نفسه أشياء مختلفة وأين تعني أسماء مختلفة الشيء نفسه.
لا يغيّر أي استعلام ولا ينشر أي تعريف. فتحديد التعريف الصحيح قرار عمل، ويعود إلى من يملكون المقياس.
الفوائد
تتوقف الاجتماعات عن الجدال حول الأرقام
وتبدأ الجدال حول القرار.
قرارات تُبنى على أرقام تعني ما تظنه
وهذه هي النسخة الباهظة من هذه المشكلة.
سجل تعريفات مبني من الواقع
بدلاً من سجل لا يملؤه أحد.
ماذا يفعل
يقرأ التعريفات التي تعمل فعلياً
ليس كتالوجاً كان على أحد ملؤه. التعريف الحقيقي يعيش في الاستعلام، وهناك فقط.
يكتشف اسماً واحداً بعدة معانٍ
كل تعريف كان معقولاً للسؤال الذي بُني من أجله. لم يُكتب أي منها.
وعدة أسماء بمعنى واحد
عمل مكرر يُصان بشكل منفصل، ويتباعد بهدوء.
يحدد الفروق التي تهم
فلتر، أساس تاريخ، قاعدة إدراج. يذكر بالضبط أي شرط يجعل رقمين مختلفين.
يتنبأ بأي التقارير ستتعارض
بحيث يكون الاجتماع مُعداً بدلاً من أن يُفاجَأ.
لا ينشر أي تعريف
تحديد أيها صحيح قرار عمل يملكه من يملكون المقياس.
ما الذي يتغيّر
ما الذي يتغيّر في أسبوعك
- يتولّى
- تحديد ما يحسبه كل مقياس فعلياً، عبر كل لوحة معلومات.
- من يقوم به اليوم
- كتالوج بيانات كان على أحد ملؤه.
- كم مرة
- أبداً، ولهذا يجادل الاجتماع.
- الجهد اليدوي المعتاد
- التعريف الحقيقي يعيش في الاستعلام، وهناك فقط.
لماذا البيانات وذكاء الأعمال تحديدًا. "العميل النشط" يعني ثلاثة أشياء مختلفة في ثلاث لوحات معلومات، وكلها تحمل التسمية نفسها. كان كل منها معقولاً لسؤاله الخاص ولم يكتبه أحد، فرحل التعريف برحيل كاتبه.
يعمل دون إشراف
تبدأه أنت أو يبدأ بحدث، ثم ينهيه بنفسه. لا شيء ينتظر أن يكون أحدهم أمام مكتبه.
المعيار نفسه في كل مرة
العنصر المئتان يُقاس بالمعيار الذي قِيس به الأول. الاتساق هو الجزء الذي لا يستطيع البشر الحفاظ عليه.
لا يستطيع التصرّف من تلقاء نفسه
وكيل تدقيق تعريفات المقاييس لا يملك أي طريق للإرسال أو الإنفاق أو الالتزام. وهذا الحد نفسه هو سبب أمان التصرّف بناءً على مخرجاته.
كيف يعمل
يعمل هذا الوكيل على الخادم عبر بيئة تشغيل PROMIVO. يُسجَّل كل تشغيل خطوة بخطوة، ويُفحص إذن كل استدعاء أداة قبل تنفيذه.
- 1المدخليُتحقَّق منه وفق مخطّط مدخلات الوكيل
- 2النموذجclaude-opus-5 مع تحويل احتياطي تلقائي
- 3الأدواتextract_structured_data
- 4الصلاحياتينفّذ إجراءات READ تلقائيًا؛ وما فوقها ينتظر الموافقة
- 5المخرجنتيجة منظّمة مطابقة لمخطّط المخرجات
- 6التسجيلالرموز والمدة وكل خطوة مسجّلة
عرض توضيحي
بيانات تجريبيةIllustrative sample output, abridged.
المدخلات
{
"metrics": []
}المخرجات
{
"noOwner": [
"Four metrics feeding the board pack have no recorded owner, so nobody can reconcile them."
],
"escalate": true,
"disclaimer": "A reading of the definitions supplied. No query, model or dashboard has been changed, nothing was written to any system, no definition is stated to be correct or canonical, and equivalences marked apparent were not verified against data.",
"escalationReason": "A metric in the board pack is computed three different ways, its revenue metric contains an unexplained hard-coded exclusion, and four board metrics have no owner.",
"dateBasisConflicts": [
"Revenue is recognised by invoice date in three reports and by service period in two. Same table, same filters, different date basis — invisible in a meeting and it moves the number every quarter end."
],
"hardCodedOrAdjusted": [
"The revenue metric excludes two named account identifiers in the WHERE clause. No comment explains why, and no reader of the dashboard can see it."
],
"reportsThatWillDisagree": [
"The board pack and the finance dashboard will report different active customer counts for the same month. Both are correct for their own definition."
],
"sameNameDifferentMeaning": [
{
"name": "Active customers",
"usedIn": [
"Finance dashboard",
"Product dashboard",
"Monthly board pack"
],
"variants": 3,
"differences": [
"Finance dashboard: any account with an invoice in the period, regardless of usage.",
"Product dashboard: any account with a login in the last 30 days, regardless of billing.",
"Board pack: any account with a live contract on the last day of the period."
],
"likelyDivergence": "The three would differ most in a month with high churn and slow invoicing — exactly the month the number gets scrutinised."
}
],
"differentNamesSameMeaning": [
"\"Monthly recurring revenue\" and \"Contracted monthly value\" compute identically. Two queries, two owners, maintained separately and already drifting."
],
"appearsEquivalentUnverified": [
"Two churn definitions appear to compute the same thing. They were not run against data, so this is reported as apparent rather than confirmed."
]
}المتطلبات
التكاملات
لا يحتاج أي تكامل.
قبل أن تبدأ
- أكواد SQL أو تعريفات النماذج الكامنة خلف مقاييسكم
- أي لوحة معلومات أو تقرير يغذيه كل مقياس
- أسماء المقاييس كما تظهر للقراء
- يتطلب خطة الوصول الكامل أو أعلى
حالات الاستخدام
قبل تقرير مجلس الإدارة
التحقق من توافق الأرقام مع لوحات المعلومات التشغيلية.
بناء طبقة دلالية (semantic layer)
معرفة التعريفات الحالية، قبل تقرير ما ينبغي أن تكون عليه.
بعد تغيير في فريق البيانات
التعريفات التي رحلت مع الشخص الذي كتبها.
رقم مثار حوله خلاف
تحديد أي شرط بالضبط يجعل الرقمين مختلفين.
التسعير
الوصول الكامل
يُفوتر شهريًا ضمن اشتراكك في PROMIVO. ويمكنك الإلغاء في أي وقت.
التشغيلات تستهلك حصّة باقتك من تنفيذات الوكلاء والرموز. انظر حدود الباقات
الأسئلة الشائعة
هل يقرر الوكيل أي تعريف صحيح؟
لا. عادة ما يكون كلاهما صحيحاً لسؤاله الخاص. اختيار التعريف المعتمد قرار عمل، وقيام أداة باتخاذه بصمت هو كيف يفوز التعريف الخاطئ.
هل يغيّر استعلاماتنا أو لوحات معلوماتنا؟
لا. هو يقرأها فقط. ليس لديه أي صلاحية كتابة على أي مستودع بيانات أو نموذج أو لوحة معلومات.
هل نحتاج إلى كتالوج بيانات أولاً؟
لا — غياب واحد هو سبب وجود هذا الوكيل. يعمل من تعريفات الاستعلامات نفسها، وهي المكان الوحيد الذي تُخزَّن فيه الحقيقة.
التقييمات
تُفتح التقييمات بعد أن يشغّل العملاء هذا الوكيل.
تريد هذا الوكيل أن يعمل بشكل مختلف؟
أخبرنا بما تريد تغييره وسيحدّد فريقنا نطاق نسخة مخصّصة لعملك.
خصّص هذا الوكيل