skill
مراقبة واجهة سطر الأوامر لوكلاء Google
تستخدم هذه المهارة عندما يرغب المستخدم في "إعداد التتبع"، "مراقبة وكيله"، "تهيئة التسجيل"، "إضافة قابلية الملاحظة"، "تصحيح أخطاء حركة المرور في الإنتاج"، أو يحتاج إلى إرشادات حول مراقبة الوكلاء المنشورين، بما في ذلك وكلاء ADK (Agent Development Kit). تغطي Cloud Trace، وتسجيل الاستجابة الفورية، وتحليلات وكيل BigQuery، وعمليات التكامل مع الجهات الخارجية (AgentOps، Phoenix، MLflow، إلخ)، واستكشاف الأخطاء وإصلاحها. وهي جزء من مجموعة مهارات agents-cli. لا تستخدم لإعداد النشر (استخدم google-agents-cli-d...).
نبذة
# دليل المراقبة
> تعمل **Cloud Trace** فورا — لا حاجة للبنية التحتية. يتطلب **تسجيل الاستجابة الفورية (Prompt-response logging)** و**تحليلات وكيل BigQuery (BigQuery Agent Analytics)** بنية تحتية مجهزة بواسطة Terraform (حساب خدمة، حاوية GCS، مجموعة بيانات BigQuery). قم بتشغيل `agents-cli infra single-project --apply --project PROJECT_ID` لتوفير هذه الموارد. تحصل مشاريع Go أيضا على مكدس قياسات BigQuery؛ تحميل إكمال GCS خلف تسجيل الاستجابة الفورية ومكون BigQuery Agent Analytics الإضافي متاحان فقط في Python. راجع `references/cloud-trace-and-logging.md` للحصول على التفاصيل، ومتغيرات البيئة، وأوامر التحقق. إذا لم يتم إعداد مشروعك بعد، فراجع `/google-agents-cli-scaffold` أولا.
### ترتيب النشر
| هل تريد مراقبة مدارة بواسطة Terraform؟ | الإجراء | |---|---| | **لا** | قم بتشغيل `agents-cli deploy` مباشرة (يعمل لجميع الأهداف). | | **نعم** | قم بتشغيل `agents-cli infra single-project --apply` أولا، ثم `agents-cli deploy`. |
**إذا قمت بالفعل بتشغيل `agents-cli deploy` بشكل إلزامي:** لا تقم بتطبيق Terraform بعد ذلك. بالنسبة ل Agent Runtime في منصة Gemini، يمتلك Terraform المحرك بأكمله (حساب الخدمة، مواصفات النشر، متغيرات البيئة)، لذا لا يمكن التوفيق بين تطبيق لاحق دون الاستيلاء على المورد. إما أن تحذف النشر وتبدأ من جديد، أو تحتفظ بالمثيل المنشور بواسطة SDK — تخطى `infra single-project` وقم بتعيين متغيرات بيئة المراقبة عن طريق إعادة تشغيل `agents-cli deploy --update-env-vars "KEY=VALUE,..."`؛ يتطابق النشر مع Reasoning Engine الحالي حسب اسم العرض ويحدثه في مكانه، مع الحفاظ على متغيرات البيئة المعينة خارج النشر. يجب عليك أيضا منح حساب خدمته أدوار IAM الخاصة بالقياسات التي سيوفرها Terraform بخلاف ذلك: `roles/storage.admin` (لكتابة الإكمال إلى حاوية السجلات)، `roles/logging.logWriter`، `roles/cloudtrace.agent`، بالإضافة إلى `roles/bigquery.dataOwner` + `roles/bigquery.jobUser` عند الإعداد باستخدام `--bq-analytics`. المجموعة الكاملة موجودة في `deployment/terraform/single-project/iam.tf` (من `app_sa_roles`) و`telemetry.tf`. متغيرات البيئة المدارة بواسطة Terraform غير متاحة في هذا الوضع.
### ملفات المرجع
| الملف | المحتويات | |------|----------| | `references/cloud-trace-and-logging.md` | تفاصيل المشروع المجهز — الموارد الموفرة بواسطة Terraform، متغيرات البيئة، أوامر التحقق، التمكين/التعطيل محليا | | `references/bigquery-agent-analytics.md` | مكون BQ Agent Analytics الإضافي — التمكين، الميزات الرئيسية، تفريغ GCS، مصدر الأداة | | `references/adk-docs.md` | **ADK:** صفحات adk.dev لجلب التفاصيل التي تتجاوز هذه المهارة | | `references/feedback-mechanism.md` | إضافة نقطة نهاية لتعليقات المستخدمين — نموذج الطلب، التسجيل المنظم، مجمع السجلات ← BigQuery |
---
## مستويات المراقبة
اختر المستوى المناسب من المراقبة بناء على احتياجاتك:
| المستوى | ما يفعله | النطاق | الحالة الافتراضية | الأفضل ل | |------|-------------|-------|---------------|----------| | **Cloud Trace** | التتبع الموزع — تدفق التنفيذ، زمن الوصول، الأخطاء عبر نطاقات OpenTelemetry | جميع القوالب، جميع البيئات | ممكن دائما | تصحيح أخطاء زمن الوصول، فهم تدفق تنفيذ الوكيل | | **Prompt-Response Logging** | تفاعلات GenAI المصدرة إلى GCS و BigQuery و Cloud Logging | مشاريع ADK Python و Claude المجهزة | معطل محليا، ممكن عند النشر | تدقيق تفاعلات LLM، الامتثال | | **BigQuery Agent Analytics** | أحداث الوكيل المنظمة (استدعاءات LLM، استخدام الأداة، النتائج) إلى BigQuery | وكلاء ADK Python مع تمكين المكون الإضافي؛ وكلاء قالب Claude | اختياري (`--bq-analytics` وقت الإعداد) | تحليلات المحادثة، لوحات المعلومات المخصصة، تقييمات LLM-as-judge | | **Third-Party Integrations** | منصات المراقبة الخارجية (AgentOps, Phoenix, MLflow, إلخ.) | أي وكيل مزود بأدوات OpenTelemetry | اختياري، إعداد لكل مزود | التعاون الجماعي، التصور المتخصص، إدارة المطالبات |
**اسأل المستخدم** عن المستويات التي يحتاجها — يمكن دمجها. Cloud Trace يعمل دائما؛ المستويات الأخرى إضافية.
---
## Cloud Trace
تستخدم الوكلاء المجهزة OpenTelemetry لإصدار آثار موزعة. ينتج كل استدعاء للوكيل نطاقات تتتبع تدفق التنفيذ الكامل.
### التسلسل الهرمي للنطاقات
> **مشاريع ADK.** هذه هي أسماء نطاقات ADK؛ تصدر الأطر الأخرى نطاقاتها الخاصة (`generate_content` يأتي من أداة google-genai المشتركة على أي حال).
``` invoke_workflow (top-level run) └── invoke_agent (one per agent in the chain) ├── call_llm (model request) │ └── generate_content (underlying GenAI model call) └── execute_tool (tool execution) ```
### الإعداد حسب نوع النشر
| النشر | الإعداد | |-----------|-------| | **Agent Runtime** | تلقائي — يتم توصيل المصدرين عند بدء التشغيل، ويتم التحكم فيه بواسطة `GOOGLE_CLOUD_AGENT_ENGINE_ENABLE_TELEMETRY` (يتم تعيينه بواسطة النشر)؛ يصدر إلى Cloud Trace/Logging + صفحة Agent Runtime في وحدة تحكم Google Cloud | | **Cloud Run / GKE (مجهز)** | تلقائي — يتم توصيل المصدرين عند بدء التشغيل، يصدر إلى Cloud Trace/Logging | | **Cloud Run / GKE (يدوي)** | قم بتكوين مصدر OpenTelemetry في تطبيقك | | **التطوير المحلي** |
التثبيت
شغل هذا الأمر
npx skills add google/agents-cliيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add google/agents-cli`، أو استنسخ المستودع وانسخ مجلد `skills/google-agents-cli-observability` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة مراقبة واجهة سطر الأوامر لوكلاء Google؟
تستخدم هذه المهارة عندما يرغب المستخدم في "إعداد التتبع"، "مراقبة وكيله"، "تهيئة التسجيل"، "إضافة قابلية الملاحظة"، "تصحيح أخطاء حركة المرور في الإنتاج"، أو يحتاج إلى إرشادات حول مراقبة الوكلاء المنشورين، بما في ذلك وكلاء ADK (Agent Development Kit). تغطي Cloud Trace، وتسجيل الاستجابة الفورية، وتحليلات وكيل BigQuery، وعمليات التكامل مع الجهات الخارجية (AgentOps، Phoenix، MLflow، إلخ)، واستكشاف الأخطاء وإصلاحها. وهي…
كيف أثبت مراقبة واجهة سطر الأوامر لوكلاء Google؟
شغل هذا الأمر في الطرفية:
npx skills add google/agents-cliمع أي أدوات ذكاء اصطناعي تعمل مراقبة واجهة سطر الأوامر لوكلاء Google؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور مراقبة واجهة سطر الأوامر لوكلاء Google؟
طورها google.
هل مراقبة واجهة سطر الأوامر لوكلاء Google مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add heygen-com/hyperframes
npx skills add microsoft/azure-skills
npx skills add microsoft/azure-skills
npx skills add microsoft/azure-skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى