LogBrew للوكلاء
توضح هذه الصفحة كيف ينبغي للوكلاء قراءة LogBrew دون الحاجة إلى حالة المتصفح أو سياق مخفي أو وصول خاص إلى لوحة التحكم.
logbrew status --jsonابدأ بالحالة المحلية، ثم اقرأ السجلات والمشكلات والإجراءات والتتبّعات والإصدارات والمشاريع فقط بعد التأكد من المصادقة وإمكانية الوصول.
خريطة مهام الوكيل
اتبع هذا الترتيب عندما يساعد مساعدٌ مطوّرًا في إعداد LogBrew أو قراءة الإشارات الخاصة.
- الخطوة 1
اقرأ الخريطة العامة
حمّل فهرس المسارات العامة قبل تغيير كود التطبيق، ليبدأ المساعد من سياق LogBrew الحالي.
استخدم نسخ Markdown المرتبطة للحصول على سياق عام أعمق.curl -L https://logbrew.co/llms.txtتم النسخ. الصقه في الطرفية أو في المساعد، ثم انتقل إلى الخطوة التالية. - الخطوة 2
اختر بطاقة SDK
اقرأ دليل اختيار SDK قبل تثبيت أي شيء، ثم استخدم «نسخ موجّه التثبيت» في «إضافة مشروع» ليتبع المساعد المنصة المختارة.
اطلب من المستخدم المسجَّل دخوله أن يفتح «إضافة مشروع»، وينسخ موجّه التثبيت، ويُبقي بيانات اعتماد الاستيعاب خارج المحادثة.curl -L https://logbrew.co/en/docs.mdتم النسخ. الصقه في الطرفية أو في المساعد، ثم انتقل إلى الخطوة التالية. - الخطوة 3
افحص الحالة المحلية
تأكد من إمكانية الوصول إلى API ومن مصدر المصادقة قبل قراءة المشاريع أو السجلات أو المشكلات أو الإجراءات أو التتبّعات أو الإصدارات الخاصة.
اتبع الحقل next الآمن للرمز المميز بدلًا من التخمين.logbrew status --jsonتم النسخ. الصقه في الطرفية أو في المساعد، ثم انتقل إلى الخطوة التالية. - الخطوة 4
تحقّق من أول إشارة
بعد أن يرسل الإعداد إشارة SDK آمنة، اقرأ نتيجة واحدة محددة النطاق، وأبقِ الرموز المميزة وملفات تعريف الارتباط وبيانات المشروع خارج الموجّهات.
لا تقرأ المشكلات والإجراءات والتتبّعات والإصدارات والمشاريع إلا بعد جاهزية المصادقة.logbrew logs info --jsonتم النسخ. الصقه في الطرفية أو في المساعد، ثم انتقل إلى الخطوة التالية.
أعطِ الوكيل خريطة LogBrew العامة قبل أن يعدّل تطبيقك أو أمر الإعداد.
curl -L https://logbrew.co/llms.txtتم النسخ. الصقه في الطرفية أو في المساعد، ثم انتقل إلى الخطوة التالية.اقرأ https://logbrew.co/llms.txt، ثم اختر بطاقة SDK المطابقة في https://logbrew.co/en/docs#docs-sdk-choice-title. استخدم npm install @logbrew/sdk @logbrew/node فقط لخدمة Node.js تعمل على جهة الخادم. أما مع Next.js أو React أو iOS أو Android أو React Native، فاستخدم البطاقة المختارة وموجّه «إضافة مشروع». اطلب من المستخدم المسجَّل دخوله أن يفتح «إضافة مشروع»، وأن يضع بيانات الاعتماد في بيئة التطبيق المطابقة فقط. في Node.js على جهة الخادم، متغير البيئة هو LOGBREW_SERVER_API_KEY. شغّل node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs لخدمات Node فقط، ثم تحقّق باستخدام logbrew logs info --json. لا تطلب بيانات الاعتماد في المحادثة أو في الـcommits.تم النسخ. الصقه في الطرفية أو في المساعد، ثم انتقل إلى الخطوة التالية.ينبغي للوكلاء العثور على سياق LogBrew العام عبر صفحات مترجمة ثابتة ونسخ Markdown وllms.txt وrobots.txt وsitemap.xml.
- استخدم /en/agents.md عندما يكون النص العادي هو المُدخل الأكثر أمانًا.
- استخدم /en/docs.md لسياق الأوامر ومسارات API.
- استخدم /llms.txt لاكتشاف الموارد العامة التي يقرؤها الوكلاء.
ينبغي أن يخبر CLI الوكلاء هل المصادقة المحلية وإمكانية الوصول إلى API وخطوات الاسترداد جاهزة، دون كشف بيانات الرمز المميز.
- شغّل logbrew status --json قبل قراءة المشاريع.
- اتبع الخطوات التالية من مخرجات JSON والمخرجات المقروءة للبشر بدلًا من التخمين.
- أبقِ بيانات الرمز المميز خارج الموجّهات والسجلات ولقطات الشاشة والصفحات العامة.
ينبغي للوكلاء قراءة السجلات والمشكلات والإجراءات والتتبّعات والإصدارات والمشاريع بالمفردات نفسها التي يستخدمها البشر للموارد.
- استخدم عوامل التصفية للإصدار والبيئة والمشروع والتتبّع والخطورة والحالة والاسم والمستخدم.
- استخدم مسارات تفاصيل المشكلة والتتبّع عندما يكون المعرّف معروفًا.
- استخدم نسخ Markdown للسياق العام، وAPI الذي يتطلب المصادقة لبيانات المشاريع الخاصة.
استخدم التوثيق العام لإرشادات المنتج، واستخدم القراءات التي تتطلب المصادقة لبيانات المشاريع الخاصة.
- لا تستخرج بيانات لوحة التحكم دون جلسة مستخدم صالحة.
- لا تنشر أسماء المشاريع الخاصة أو الرموز المميزة أو التتبّعات أو تفاصيل النشر.
- استخدم الصفحات العامة للتعلّم العام، والمسارات التي تتطلب المصادقة لبيانات المستخدم المحددة النطاق.