> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# الاستعلامات

> توثيق استعلامات FailproofAI Observability.

اطرح أي سؤال على بيانات وكيلك واحصل على إجابة في ثوانٍ. توفر لك FailproofAI Observability مكتبة من الاستعلامات المحفوظة والجاهزة للتشغيل على أحداثك وتقييماتك، بحيث تبدأ من مثال عملي بدلاً من محرر SQL فارغ.

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/queries.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=0035db75f0157d16acfe8dd0a4a95cd7" alt="مكتبة الاستعلامات المحفوظة: شبكة من الاستعلامات القابلة لإعادة الاستخدام، سواء كانت إعدادات مسبقة مدمجة أو استعلامات مخصصة" width="3200" height="2000" data-path="agenteye/images/queries.png" />

*مكتبة الاستعلامات المحفوظة لديك في `/<org-slug>/queries`: الإعدادات المسبقة المدمجة موجودة بجانب الاستعلامات التي حفظتها فريقك.*

## ابدأ من إعداد مسبق، وليس من صفحة فارغة

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

كل استعلام محفوظ له نطاق تنظيمي وهو مشترك، لذا فإن الاستعلامات المفيدة التي يكتبها زملاؤك تصبح ملكك أيضاً. سمِّ استعلاماً وأضف وصفاً له مرة واحدة، وستتمكن أي شخص في مؤسستك من العثور عليه أو تشغيله أو تثبيت نتائجه على لوحة تحكم لاحقاً.

ابحث عنه في `/<org-slug>/queries`.

## عدّله وشغّله في محرّر SQL

افتح أي استعلام وسيظهر في محرر SQL، حيث يمكنك تعديله ورؤية الإجابة فوراً: بدون تصدير، بدون حلقة ذهاب وإياب، بدون انتظار من شخص آخر.

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/query-lab.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=0db5b6d69d597935380c3a027c745dd5" alt="محرر استعلامات SQL يشغل استعلاماً محفوظاً، مع شريط جانبي للمخطط وشبكة نتائج مباشرة" width="3200" height="2000" data-path="agenteye/images/query-lab.png" />

*محرر SQL: استعلامك على اليسار، وشريط جانبي للمخطط حتى لا تضطر أبداً إلى تخمين اسم عمود، وشبكة نتائج مباشرة أدناه.*

* **شريط جانبي للمخطط** يعرض جداول التحليلات وأعمدتها، بحيث يمكنك صياغة استعلام بدون البحث عن أسماء الحقول.
* **شبكة نتائج مباشرة** تعيد الصفوف في اللحظة التي تشغل فيها الاستعلام، بحيث يمكنك التكرار في ثوانٍ بدلاً من التخمين وإعادة التخمين.
* **للقراءة فقط بالتصميم.** تعمل الاستعلامات على مخزن الأحداث الخاص بك ويتم التحقق منها على الخادم: يُسمح فقط بعبارات `SELECT` و `WITH`، مع مهلة انتظار بيان وحد أقصى للصفوف. لا يمكن لاستعلام استكشافي أن يعدّل بيانك، وسيتم إيقاف أي استعلام خارج السيطرة تلقائياً.

راضٍ عن النتيجة؟ احفظها في المكتبة حتى يستفيد منها الفريق كله، أو ثبّت مخرجاتها على لوحة تحكم كبطاقة خطية أو عمود أو منطقة أو دائرة.

## شغّلها من سطر الأوامر، أو دع المساعد يكتبها

الاستعلامات المحفوظة نفسها تتبعك في أي مكان تعمل فيه:

* **من سطر الأوامر.** يعرض CLI `agenteye` الاستعلامات نفسها ويشغّلها ويحفظها، بحيث يمكنك إدراج نتيجة في سكريبت أو ربطها في CI أو تسليمها إلى وكيل ترميز.

```bash theme={null}
agenteye query list                 # الاستعلامات المحفوظة نفسها، من طرف الأوامر
agenteye query run errs --arg prod  # شغّل واحداً واطبع الصفوف (أضف --json لتوصيلها)
```

انظر [CLI والوكلاء](/ar/agenteye/cli-and-agents) للحصول على مجموعة الأوامر الكاملة.

* **من مساعد AI.** غير متأكد من كيفية صياغة SQL؟ اسأل [مساعد AI](/ar/agenteye/assistant) داخل لوحة التحكم باللغة الإنجليزية العادية وسيصيغ الاستعلام ويحفظه في مكتبتك لك.

يتم التحكم في تشغيل استعلام محفوظ بواسطة إذن `queries:run`، يتم الاحتفاظ به بشكل منفصل عن الأذونات لإنشاء أو حذف الاستعلامات، بحيث يمكنك منح حق الوصول للقراءة بدون السماح للجميع بإعادة كتابة المكتبة.

## ذات صلة

* [لوحات التحكم](/ar/agenteye/dashboards): ثبّت نتائج الاستعلامات في مخططات مشتركة على مستوى المؤسسة.
* [مساعد AI](/ar/agenteye/assistant): اطرح أسئلة باللغة الإنجليزية العادية واحصل على استعلام مقابل.
* [CLI والوكلاء](/ar/agenteye/cli-and-agents): شغّل واحفظ الاستعلامات نفسها من سطر الأوامر.