ربط تتبّع Langfuse
مراقبة اختيارية من طرف ثالث للمشاريع وعمليات التقييم، معطّلة افتراضيًا وخاملة تمامًا من دون مفاتيحك أنت.
منذ RoughCut 1.9.2 أصبحت مجموعة إعدادات التقييمات التي تضم حقلي مفتاحي Langfuse مخصّصة للتطوير فقط، لذا لا يتيح إصدار Mac App Store طريقة لإدخالهما ولا يُرسل أي أثر. Langfuse لوحة تحكم اختيارية من طرف ثالث لتتبّع عمليات الذكاء الاصطناعي. يُشحن RoughCut والتتبّع معطّل، ويظل العميل خاملًا تمامًا ما لم يكن الخيار مفعّلًا والمفتاحان محفوظين معًا، فلا يُرسَل شيء حتى تفعّله أنت عمدًا. وللربط أنشئ حسابًا ومشروعًا في Langfuse، وانسخ المفتاح العام والمفتاح السري لمشروع Langfuse ذاك، ثم الصقهما في الإعدادات ضمن تبويب متقدم ومجموعة التقييمات، وتأكد أن عنوان Langfuse الأساسي يطابق منطقتك أو نسختك المستضافة ذاتيًا، ثم فعّل تتبع Langfuse. يُخزَّن المفتاحان في Keychain على macOS. والذي يغادر جهازك هو بيانات وصفية عن التشغيل ودرجات رقمية مجمّعة فقط، من دون أي وسائط أو نص مفرّغ أو مفاتيح API. وإذا كنت تفضّل ألا يُرسَل شيء على الإطلاق فاترك الخيار معطّلًا، وهو الوضع الافتراضي والخيار الآمن.
في هذه الصفحة
غير متوفر في إصدار App Store. منذ RoughCut 1.9.2 أصبحت مجموعةالتقييماتفيالإعدادات ← متقدممخصّصة للتطوير فقط، وتضم تلك المجموعة حقليالمفتاح العام لـ Langfuseوالمفتاح السري لـ Langfuse. لذا لا يتيح إصدار Mac App Store أي طريقة لإدخال المفتاحين اللذين يحتاجهما التتبع، والشيء الوحيد الذي يرسل أثرا هو تشغيل تقييم — وهو ما لا يستطيع ذلك الإصدار بدءه أيضا. أماتتبع Langfuseوعنوان Langfuse الأساسيفما زالا يظهران فيالإعدادات ← أساسي، لكن بدون المفتاحين لا يُرسل أي شيء. وتبقى هذه الصفحة وصفا لما يرسله مسار التتبع وما لا يرسله؛ ولا تعتمد عليه أي ميزة تحرير.
متقدم واختياري تمامًا. Langfuse خدمة من طرف ثالث. وتفعيل التتبّع يعني إرسال بيانات عن تشغيلاتك إلى شركة ليست Apple وليست RoughCut. الخيار الآمن هو الوضع المشحون افتراضيًا: معطّل. لا يُرسَل شيء ما دامتتبع Langfuseمعطّلًا، ولا يُرسَل شيء حتى مع تفعيل الخيار ما لم يكن المفتاحان موجودين معًا. وللعودة إلى الوضع الافتراضي في أي وقت، عطّلتتبع Langfuseثم اضغطحفظ الإعدادات؛ ولمزيد من الاحتياط، احذف المفتاحين.
المتطلبات المسبقة
- سبب يجعلك ترغب فيه. التتبّع مفيد إذا كنت تشغّل عمليات تقييم كثيرة وتريد جمع سجلها وأزمنتها ودرجاتها في لوحة واحدة عبر الوقت. أما لعدد قليل من التشغيلات، فملفات الملخص داخل مجموعتك المرجعية تكفي.
- حساب على Langfuse ومشروع بداخله. Langfuse ليست تابعة لـ RoughCut.
- أن تكون مرتاحًا للبيانات المذكورة تحت ما الذي يُرسَل أدناه. اقرأ ذلك القسم قبل أن تفعّل الخيار.
الخطوات
- أنشئ حسابًا على Langfuse، ثم أنشئ مشروعًا بداخله.
- من إعدادات ذلك المشروع، أنشئ زوج مفاتيح API وانسخ نصفيه: المفتاح العام (يبدأ بـ
pk-) والمفتاح السري (يبدأ بـsk-). ويُعرض المفتاح السري عادة مرة واحدة فقط، فانسخه قبل إغلاق الصفحة. - في RoughCut، افتح
الإعدادات، واختر تبويبمتقدم، ثم انزل إلى مجموعةالتقييمات. - الصق المفتاح العام في حقل
المفتاح العام لـ Langfuseواضغط زرحفظالخاص به. ينتقل الحقل إلى حالة محفوظة مع إخفاء القيمة. - الصق المفتاح السري في حقل
المفتاح السري لـ Langfuseواحفظه بالطريقة نفسها. - تحقق من
عنوان Langfuse الأساسي. القيمة الافتراضية هيhttps://cloud.langfuse.com؛ غيّرها إذا كان مشروعك يقع على نقطة نهاية إقليمية مختلفة أو على نسخة مستضافة ذاتيًا. - فعّل
تتبع Langfuse. - اضغط
حفظ الإعدادات. - شغّل شيئًا: مشروعًا عاديًا، أو تقييمًا سريعًا من شاشة
التقييم(التقييم). - افتح مشروعك في Langfuse وتأكد من ظهور الأثر.
النتيجة المتوقعة
يظهر أثر للتشغيل داخل مشروعك في Langfuse، موسومًا بالبيئة التي ضبطتها. ويصل أثر عملية التقييم باسم يدل على وضعها، حاملًا معرّف التشغيل، والوضع، وعدد المقاطع، ومصدر التفريغ النصي، وأعداد المقاطع التي حصلت على درجة والمتجاوَزة والفاشلة، وما إذا كانت قد وُضعت على التشغيل علامة تراجع، ومتوسط Word-F1 للتشغيل كدرجة رقمية.
ولا يظهر شيء إلا بعد تشغيل يقع بعد تفعيلك للتتبّع. فتفعيل الخيار لا يملأ أي سجل بأثر رجعي.
ما الذي يُرسَل
هذا هو الجزء المهم، ولذلك يُذكر صراحة.
ما يُرسَل: بيانات وصفية عن التشغيل ودرجات رقمية مجمّعة. وبالنسبة إلى عملية تقييم، يعني ذلك معرّف التشغيل، والوضع، وكم مقطعًا شارك، وما إذا كان التفريغ النصي على الجهاز أو سحابيًا، وكم مقطعًا حصل على درجة وكم جرى تجاوزه وكم فشل، وما إذا كانت قد وُضعت علامة تراجع، ومتوسط Word-F1 المجمّع. وتحمل الآثار وسم بيئة ووسومًا وصفية قصيرة.
ما لا يُرسَل: وسائطك، ونص التفريغ لديك، ومفاتيح API الخاصة بك. لا شيء من ذلك جزء من الأثر.
تنطلق الطلبات مباشرة من جهاز Mac لديك إلى العنوان الأساسي الذي ضبطته، موثَّقة بزوج مفاتيح Langfuse الخاص بك. ولا يوجد أي خادم لـ RoughCut في هذا المسار.
وإذا فشل طلب أثر، فإنه يُسجَّل ويُتجاهل. التتبّع لا يُفشل مشروعًا ولا عملية تقييم أبدًا.
وللصورة الكاملة عمّا يغادر جهازك على مستوى التطبيق كله، راجع الخصوصية ومسار البيانات.
وسم البيئة
بيئة Langfuse نص عادي يُلحق بكل أثر، وهو موجود للفصل بين تشغيلات غير مترابطة داخل مشروع Langfuse واحد. فإذا كنت تتتبّع من أكثر من جهاز، أو أردت فصل فترة تجريب عن تشغيلاتك المعتادة، غيّر الوسم بدل إنشاء مشروع آخر. ولا تتأثر الآثار الحاملة وسمًا سابقًا، لأن الوسم يُطبَّق لحظة إنشاء الأثر.
أين تُخزَّن المفاتيح
يُخزَّن مفتاحا Langfuse في Keychain على macOS، مشفَّرين بواسطة النظام، تمامًا مثل مفاتيح مزوّد الذكاء الاصطناعي لديك. ولا يُكتبان أبدًا في ملف إعدادات RoughCut ولا يُدرجان في أي إعدادات مصدَّرة. وبعد الحفظ لا تُعرض عليك القيمة المخزَّنة مرة أخرى؛ بل يمكنك استبدالها عبر استبدال... أو إزالتها عبر استبعاد.
تعامل مع المفتاح السري كما تتعامل مع كلمة مرور. راجع فهم إعدادات RoughCut.
إذا كانت الخصوصية أولويتك فاتركه معطّلًا
التتبّع هو الميزة الوحيدة في RoughCut التي يقوم غرضها بالكامل على إرسال معلومات عن عملك إلى طرف ثالث اخترته أنت. وإذا لم تكن متأكدًا من رغبتك في ذلك، فالجواب هو ترك تتبع Langfuse معطّلًا. فكل ما عدا ذلك في التطبيق — بما في ذلك منظومة التقييم بأكملها — يعمل بالطريقة نفسها من دونه، وملفات الملخص المكتوبة داخل مجموعتك المرجعية تحمل الأرقام نفسها محليًا بالفعل.
حل المشكلات
| العَرَض | السبب | الحل |
|---|---|---|
| لا آثار على الإطلاق | تتبع Langfuse معطّل | فعّله واضغط حفظ الإعدادات |
| لا آثار على الإطلاق | أحد المفتاحين ناقص | كلاهما مطلوب. يبقى العميل خاملًا بمفتاح واحد |
| لا آثار على الإطلاق | لم يحدث أي تشغيل منذ تفعيلك للخيار | شغّل مشروعًا أو تقييمًا سريعًا. لا شيء يُملأ بأثر رجعي |
| الآثار مفقودة رغم تفعيل الخيار | المفتاحان يعودان إلى مشروعين مختلفين، أو أن المفتاح العام لُصق في حقل المفتاح السري | أعد نسخ النصفين من زوج مفاتيح المشروع نفسه واحفظهما من جديد |
| لا يصل شيء رغم أن كل شيء يبدو سليمًا | عنوان Langfuse الأساسي يشير إلى منطقة خاطئة أو إلى عنوان قديم لنسخة مستضافة ذاتيًا | تحقق من العنوان الأساسي الصحيح لمشروعك وصحّح الحقل |
| لا يصل شيء على شبكة مقيّدة | الوصول الخارجي إلى مضيف Langfuse محجوب | اسمح بالمضيف، أو اقبل أن التتبّع لن يعمل هناك |
| الآثار تظهر في المكان الخطأ | وسم البيئة يختلف عن الوسم الذي تصفّي عليه | طابق بيئة Langfuse مع المرشّح الذي تستخدمه في Langfuse |
| تريد إيقافه | — | عطّل تتبع Langfuse، واحفظ، ثم احذف المفتاحين |
أخطاء شائعة
- توقّع أن يؤثر التتبّع في المونتاج. لا يفعل. إنه يراقب التشغيلات ولا يغيّرها أبدًا.
- تفعيل الخيار من دون حفظ. تغييرات الإعدادات تحتاج إلى
حفظ الإعدادات. أما المفاتيح فتُحفظ فورًا عند ضغط زرحفظالخاص بها. - لصق مفتاح على مستوى المؤسسة. استخدم زوج المفاتيح الخاص بالمشروع نفسه.
- افتراض أن فشل الأثر يعني فشل التشغيل. حالات فشل الأثر تُسجَّل وتُتجاهل عن قصد.
ملاحظة عن منتج Langfuse
يُطوَّر Langfuse بصورة مستقلة عن RoughCut. وواجهته ومصطلحاته وموضع مفاتيحه داخل إعداداته ونقاط نهايته الإقليمية، كلها قابلة للتغيير من دون إشعار. وحيثما اختلفت هذه الصفحة مع وثائق Langfuse حول أي شيء يخص جانب Langfuse، فوثائقهم هي المرجع. أما الثابت في جانب RoughCut فهو ما تصفه هذه الصفحة: مفتاحان، وعنوان أساسي واحد، وخيار تفعيل واحد، ووسم بيئة واحد، وآثار لا تحمل سوى بيانات وصفية عن التشغيل ودرجاته.