تخطي إلى المحتوى الرئيسي

البدء السريع

البداية · البدء السريع

دليل المشاريع

الهدف​

تشرح هذه الصفحة كيفية إعداد الوصول إلى ProPM Agent، وإنجاز أول اتصال، واختيار المشروع الصحيح، والتحقق من النقاط التقنية الأساسية مباشرة بعد النشر.

من يمكنه استخدام هذه الصفحة​

  • مستخدم أعمال يتلقى عنوان URL ويحتاج إلى الاتصال من دون مساعدة كبيرة؛
  • مالك مشروع يحتاج إلى إنشاء أول سياق مشروع أو تحديده؛
  • مسؤول تقني يحتاج إلى التحقق من المصادقة، وruntime، والوصول الأولي.

إذا لم يكن لديك عنوان URL للتطبيق بعد​

إذا لم يتم نشر مثيلك بعد، فابدأ من نشر Azure Marketplace. تتيح هذه الخطوة الحصول على عنوان URL للويب، وواجهة API، ومعلمات runtime اللازمة قبل أي اتصال مستخدم.

قبل البدء​

متطلبات المستخدم المسبقة​

للاستخدام العادي، تحتاج إلى:

  • عنوان URL للنشر الخاص بـ ProPM Agent؛
  • حساب Microsoft Entra ID مصرح به في المستأجر الموافق؛
  • الوصول إلى مشروع واحد على الأقل، أو حق إنشاء مشروع؛
  • متصفح حديث يدعم تطبيقات الويب الحديثة؛
  • إذا كنت تستخدم الصوت، فمتصفح متوافق مع واجهات API للتعرف على الكلام.

متطلبات المسؤول التقني المسبقة​

يجب إعداد العناصر التالية بشكل صحيح:

العنصرالدور
clientIdيحدد تطبيق Entra المستخدم في الويب
authorityيحدد سلطة Microsoft Entra الخاصة بالاتصال
scopesيحدد الأذونات المطلوبة عند المصادقة
redirectUri وpostLogoutRedirectUriيتحكمان في العودة بعد الاتصال وتسجيل الخروج
allowedTenantIdيقيد المستأجر المصرح به إذا تم إعداده
/runtime-config.jsonيتجاوز ديناميكيا عناوين URL ومعلمات المصادقة وقت التشغيل
عنوان URL لواجهة APIيتيح لواجهة الويب الاتصال بخدمات المنصة
الاشتراك / المقاعديحدد الوصول في عمليات النشر التي تفرض ترخيصا لكل مستخدم

مسار الاتصال الأول​

  1. افتح عنوان URL المنشور الخاص بنشرك؛
  2. دع التطبيق يعيد توجيهك إلى صفحة تسجيل الدخول في Microsoft؛
  3. اتصل بالحساب المصرح به؛
  4. عد إلى التطبيق، غالبا إلى لوحة التحكم؛
  5. تحقق من لغة الواجهة، والمشروع الحالي، وأي رسائل مرئية محتملة في الشريط العلوي؛
  6. افتح المشاريع لتحديد مشروعك الأول أو إنشائه.

أول اتصال في 5 دقائق​

لجولة أولى بسيطة جدا، اتبع هذا الترتيب:

  1. سجل الدخول؛
  2. أكد المشروع النشط في الشريط العلوي أو افتح المشاريع؛
  3. أنشئ مشروعا أو افتحه؛
  4. افتح الوكلاء لطرح سؤال بسيط أول، مثلا عن الحالة أو المخاطر ذات الأولوية؛
  5. راجع المخرج المنظم؛
  6. ثم افتح سجل الذكاء الاصطناعي إذا كنت تحتاج إلى استرداد أثر run، أو التقارير والآثار إذا كنت تريد تحويل النتيجة إلى مستند محكوم.

يكفي هذا المسار لفهم المنطق المركزي للتطبيق من دون البدء بكل شاشات الإدارة.

حالات الوصول التي يجب معرفتها​

توجد حالتان مختلفتان في الواجهة:

  • قراءة فقط: يمكنك استعراض مساحة ما لكن لا يمكنك تعديل إعداداتها؛
  • وصول مرفوض: المسار أو الإجراء غير متاح لحسابك.

هذا التمييز مهم لمناطق الإدارة: أحيانا يمكن فتح صفحة تقنية للاطلاع من دون القدرة على حفظ التغييرات.

النتيجة المتوقعة بعد الاتصال الأول​

إذا كان كل شيء معدا بشكل صحيح، ينبغي أن تتمكن من:

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

إنشاء مشروع أول​

يقترح نموذج التطبيق الحقول التالية:

  • معرف المشروع؛
  • الاسم؛
  • الوصف؛
  • لغة البيانات الافتراضية؛
  • لغات البيانات الإضافية.

نافذة إنشاء المشروع

نقطة مهمة​

لغة بيانات المشروع ليست هي نفسها لغة الواجهة.

تؤثر لغة البيانات خصوصا في:

  • فئات المستندات المقترحة افتراضيا؛
  • بعض إعدادات النظام أو دعواته في الوكلاء؛
  • القيم الأولية الخاصة بالمشروع.

إذا لم يظهر أي مشروع​

تعرض عدة شاشات حالة فارغة صريحة عندما لا يتم تحديد أي مشروع. هذا طبيعي.

للمتابعة:

  1. استخدم محدد المشروع في الشريط العلوي؛
  2. افتح المشاريع لاختيار مشروع يمكن الوصول إليه؛
  3. إذا كان لديك حق الإنشاء، فأنشئ مشروعا؛
  4. إذا بقيت القائمة فارغة، فتحقق مع المسؤول لديك من أن حسابك أضيف إلى المشروع الصحيح.

قائمة تحقق ما بعد النشر للمسؤول التقني​

بعد نشر جديد، تحقق على الأقل من:

  1. عنوان URL للويب المنشور فعليا؛
  2. توفر ملف /runtime-config.json؛
  3. الاتساق بين عنوان URL المنشور وredirect URIs المعدة في Entra؛
  4. وجود client ID صالح؛
  5. القيمة الصحيحة لـ authority، وallowedTenantId إذا استعمل؛
  6. scopes المتوقعة من الواجهة الأمامية وواجهة API؛
  7. عنوان URL الخاص بـ API؛
  8. استهلاك المقاعد أو توفرها إذا كانت الخطة تفرض ذلك؛
  9. أول اختبار اتصال بحساب مستخدم قياسي وحساب مسؤول.

تحققات متكررة عند تسجيل الدخول​

تتم مصادقة حساب Microsoft، لكن الوصول لا يحدث بعد كما هو متوقع​

تحقق بهذا الترتيب:

  1. المستأجر المستخدم أثناء الاتصال؛
  2. أن الحساب مصرح به بالفعل في ذلك المستأجر؛
  3. توفر مقعد إذا كانت الخطة تطبق ترخيصا لكل مستخدم؛
  4. وجود مشروع واحد على الأقل يمكن لذلك الحساب الوصول إليه.

حالة مستأجر أو حساب خارجي / ضيف​

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

redirect URI mismatch​

إذا أعاد الاتصال خطأ إعادة توجيه، فقارن عنوان URL المنشور فعليا مع Redirect URIs الخاصة بتسجيل تطبيق Entra. يجب إدراج كل بيئة منشورة بدقة، من دون أخطاء مطبعية.

unauthorized_client أو تطبيق Entra في المستأجر الخاطئ​

يشير هذا العرض عادة إلى أن تسجيل التطبيق ليس في المستأجر الصحيح، أو أن النشر يستخدم authority غير متوافق مع تطبيق single-tenant.

نجاح الوصول، لكن شاشة المسؤول في وضع القراءة فقط​

يعني ذلك غالبا أن الحساب تمت مصادقته لكنه لم يحل كمسؤول منصة قابل للتعديل. تحقق من مجموعات الإدارة، ومستأجر الرمز المميز، وطريقة حل المسؤول المستخدمة في بيئتك.

الاتصال OK، ولوحة التحكم محملة، لكن تحقق إضافي مفيد​

تشير هذه الحالة غالبا إلى أن المصادقة نجحت، لكن التحقق الإضافي من runtime أو الاتصال ما يزال مفيدا. افتح مؤشر الصحة، وسجل حالة API، وauth، والكمون، والمشروع الحالي، ثم انتقل إلى الواجهة والتنقل لقراءة اللوحة وإلى الصيانة والدعم والأسئلة الشائعة لنقاط التحقق.

مراجع سريعة — وصول يجب تأكيده​

الحالة الأوليةتحقق أولاثم
تعيد Microsoft خطأ قبل العودة إلى التطبيقauthority، والمستأجر المستخدم، وclientId، وredirectUri، وpostLogoutRedirectUri، وallowedTenantIdقارن إعداد runtime وتسجيل Entra، ثم أعد الاختبار بالحساب الصحيح
يعمل اتصال Microsoft لكن التطبيق يبقى عالقاتوفر مقعد، ومؤشر الصحة، وعنوان URL الخاص بـ APIتحقق بعد ذلك من الوصول إلى مشروع ومن الحقوق الفعلية للحساب
يعمل الاتصال، وتتحمل لوحة التحكم، لكن يوصى بالتحقق من التوفرحالات auth، وAPI، والكمون، والمشروع النشطافتح الواجهة والتنقل، ثم الصيانة والدعم والأسئلة الشائعة للتمييز بين المصادقة، وruntime، وسياق المشروع
يفتح التطبيق لكن لا يظهر أي مشروعمحدد المشروع، وقائمة المشاريع، والعضوية في المشروع، وحق الإنشاءاطلب من مالك المشروع إضافة الحساب إلى المشروع الصحيح عند الحاجة
صفحة مرئية لكنها غير قابلة للتعديلدور المشروع أو دور المسؤول، وحالة قراءة فقط مقابل وصول مرفوضتحقق بعد ذلك من مجموعة الإدارة أو أذونات المشروع الموافقة

الحالة، والعناصر التي يجب إبرازها، والصفحة التالية​

الحالة التي تواجههاالعناصر التي يجب إبرازهاالصفحة التالية التي يجب فتحها
خطأ من Microsoft قبل العودة إلى التطبيقالرسالة الدقيقة، ولقطة شاشة، والحساب المستخدم، وعنوان URL المفتوح فعلياالبداية، ثم الصيانة والدعم والأسئلة الشائعة إذا استمر الشك
لوحة التحكم محملة لكن التحقق من التوفر مفيدحالات API، وrealtime، وauth، والكمون، ووقت الاختبار، والمشروع الحاليالواجهة والتنقل، ثم الصيانة والدعم والأسئلة الشائعة
لا يظهر أي مشروعلقطة لمحدد المشروع، والبريد الإلكتروني للحساب، والمشروع المتوقعالمشاريع ومساحة العمل
صفحة مرئية لكن عناصر التحكم معطلةاسم الصفحة، والدور المتوقع، ولقطة للأزرار المعطلةالتحكم في الوصول وأدوار المشروع أو المحفظة والإدارة التقنية حسب المساحة
الاتصال OK لكن عمليات التنفيذ لا تبدأTrace ID إذا كان موجودا، والمشروع النشط، ومؤشر الصحة، ومزود الذكاء الاصطناعي المتوقعالصيانة والدعم والأسئلة الشائعة، ثم التقارير وسجل الذكاء الاصطناعي وقابلية التتبع

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

ممارسات جيدة منذ البداية​

  • اختر المشروع الصحيح قبل تشغيل الوكلاء؛
  • حدد لغة بيانات المشروع بشكل صحيح عند الإنشاء؛
  • تحقق من مستوى حقك قبل تعديل الحوكمة أو الإدارة التقنية؛
  • إذا كان نشرك يستخدم نموذج مقاعد، فتأكد من أن وصولك أسند بشكل صحيح؛
  • احفظ عنوان URL للنشر، وTrace ID المعروض عند الحاجة للدعم.

التالي​