# LogBrew للوكلاء
توضح هذه الصفحة كيف ينبغي للوكلاء قراءة LogBrew دون الحاجة إلى حالة المتصفح أو سياق مخفي أو وصول خاص إلى لوحة التحكم.

## أول قراءة آمنة
```bash
logbrew status --json
```

## سياق مساعد الذكاء الاصطناعي
أعطِ الوكيل خريطة LogBrew العامة قبل أن يعدّل تطبيقك أو أمر الإعداد.

موجّه التثبيت

```text
اقرأ 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 أو قراءة الإشارات الخاصة.

## الخطوة 1: اقرأ الخريطة العامة
حمّل فهرس المسارات العامة قبل تغيير كود التطبيق، ليبدأ المساعد من سياق LogBrew الحالي.

```bash
curl -L https://logbrew.co/llms.txt
```

Next: استخدم نسخ Markdown المرتبطة للحصول على سياق عام أعمق.

## الخطوة 2: اختر بطاقة SDK
اقرأ دليل اختيار SDK قبل تثبيت أي شيء، ثم استخدم «نسخ موجّه التثبيت» في «إضافة مشروع» ليتبع المساعد المنصة المختارة.

```bash
curl -L https://logbrew.co/en/docs.md
```

Next: اطلب من المستخدم المسجَّل دخوله أن يفتح «إضافة مشروع»، وينسخ موجّه التثبيت، ويُبقي بيانات اعتماد الاستيعاب خارج المحادثة.

## الخطوة 3: افحص الحالة المحلية
تأكد من إمكانية الوصول إلى API ومن مصدر المصادقة قبل قراءة المشاريع أو السجلات أو المشكلات أو الإجراءات أو التتبّعات أو الإصدارات الخاصة.

```bash
logbrew status --json
```

Next: اتبع الحقل next الآمن للرمز المميز بدلًا من التخمين.

## الخطوة 4: تحقّق من أول إشارة
بعد أن يرسل الإعداد إشارة SDK آمنة، اقرأ نتيجة واحدة محددة النطاق، وأبقِ الرموز المميزة وملفات تعريف الارتباط وبيانات المشروع خارج الموجّهات.

```bash
logbrew logs info --json
```

Next: لا تقرأ المشكلات والإجراءات والتتبّعات والإصدارات والمشاريع إلا بعد جاهزية المصادقة.

## استخدم عناوين URL عامة يمكن توقعها
ينبغي للوكلاء العثور على سياق 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 الذي يتطلب المصادقة لبيانات المشاريع الخاصة.

## أبقِ البيانات الخاصة خلف المصادقة
استخدم التوثيق العام لإرشادات المنتج، واستخدم القراءات التي تتطلب المصادقة لبيانات المشاريع الخاصة.

- لا تستخرج بيانات لوحة التحكم دون جلسة مستخدم صالحة.
- لا تنشر أسماء المشاريع الخاصة أو الرموز المميزة أو التتبّعات أو تفاصيل النشر.
- استخدم الصفحات العامة للتعلّم العام، والمسارات التي تتطلب المصادقة لبيانات المستخدم المحددة النطاق.

## Public agent links
- Agents: https://logbrew.co/ar/agents
- Agents Markdown: https://logbrew.co/ar/agents.md
- Docs Markdown: https://logbrew.co/ar/docs.md
- Home Markdown: https://logbrew.co/ar/page.md
- llms.txt: https://logbrew.co/llms.txt
- Sitemap: https://logbrew.co/sitemap.xml