5.20 استخدام أدوات مساحة العمل Workspace Utilities #
استخدم صفحة أدوات مساحة العمل للوصول إلى الخدمات الممكّنة REST Enabled SQL، وخدمات الذكاء الاصطناعي التوليدي Generative AI، والخوادم البعيدة Remote Servers، ومجموعات التطبيقات Application Groups، وبيانات اعتماد الويب Web Credentials، وقوالب مساحة العمل Workspace Themes، والتصدير Export، وعروض Oracle APEX، وإدارة النسخ الاحتياطية Backups، وكتالوجات REST Source Catalogs.
5.20.1 الوصول إلى أدوات مساحة العمل #
يمكنك الوصول إلى أدوات مساحة العمل من خلال النقر فوق أيقونة أدوات مساحة العمل Workspace Utilities في وسط الصفحة الرئيسية لمُنشئ التطبيقات App Builder.
للوصول إلى أدوات مساحة العمل:
- تسجيل الدخول إلى Oracle APEX
- في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder. تظهر الصفحة الرئيسية لمُنشئ التطبيقات App Builder .
- في حزمة App Builder الرئيسية، انقر فوق أيقونة أدوات مساحة العمل Workspace Utilities. تظهر صفحة أدوات مساحة العمل.
5.20.2 صفحة أدوات مساحة العمل #
تحتوي صفحة أدوات مساحة العمل على روابط لأدوات مساحة العمل الشائعة بما في ذلك خدمات SQL الممكّنة REST Enabled SQL، والخوادم البعيدة Remote Servers، ومجموعات التطبيقات Application Groups، وبيانات اعتماد الويب Web Credentials، وقوالب مساحة العمل Workspace Themes، والتصدير Export، وعروض Oracle APEX، وإدارة النسخ الاحتياطية Backups، وكتالوجات REST Source Catalogs.
يوضح الجدول التالي الروابط الموجودة على صفحة أدوات مساحة العمل.
الرابط Link | الوصف Description | لمعرفة المزيد |
---|---|---|
خدمات SQL الممكّنة REST Enabled SQL Services | إدارة المراجع إلى خدمات SQL الخارجية الممكّنة لـ REST. | انظر: إدارة مراجع SQL الممكّنة لـ REST |
الذكاء الاصطناعي التوليدي Generative AI | إدارة خدمات الذكاء الاصطناعي التوليدي لتطبيقات APEX ومنشئ التطبيقات. | انظر: إدارة خدمات الذكاء الاصطناعي التوليدي |
الخوادم البعيدة Remote Servers | إدارة كائنات الخادم البعيد المستخدمة في مصادر بيانات REST والمصادقات. | انظر: إدارة الخوادم البعيدة |
مقدمو المتجهات Vector Providers | يتم تكوين موفري المتجهات لتحويل النص إلى تضمين. | انظر: إدارة موفري المتجهات |
مجموعات التطبيقات Application Groups | نظّم التطبيقات بتخصيصها لمجموعات تطبيقات. لاستخدام مجموعات التطبيقات، أنشئ مجموعةً أولًا، ثم خصِّص التطبيقات لها. | انظر: إدارة مجموعات التطبيقات |
بيانات اعتماد الويب Web Credentials | إدارة بيانات الاعتماد الآمنة للاتصال بخدمات SQL الممكّنة لـ REST أو خدمات REST الأخرى. | انظر: إدارة بيانات اعتماد الويب |
قوالب مساحة العمل Workspace Themes | إدارة قوالب مساحة العمل التي يمكن استخدامها بواسطة أي تطبيق داخل مساحة العمل. | انظر: إدارة قوالب مساحة العمل |
تصدير Export | تصدير مكونات مساحة العمل. | انظر: تصدير مساحات العمل والتطبيقات ومكونات التطبيقات |
عروض Oracle APEX Views | استعلام عن العروض المختلفة لبيانات APEX التعريفية meta data. | انظر: الوصول إلى APEX Views |
إدارة النسخ الاحتياطية Manage Backups | عرض وإدارة نسخ احتياطية للتطبيقات في مساحة العمل الحالية. تُتيح النسخ الاحتياطية طريقة سهلة لاستعادة التطبيقات التي قد تُعدّل أو تُحذف بشكل غير متوقع. | انظر: إدارة النسخ الاحتياطية للتطبيق |
كتالوجات مصادر REST Source Catalogs | إدارة كتالوجات مصادر REST للتكامل في التطبيقات. | انظر: إدارة كتالوجات مصادر REST |
القياس عن بعد المفتوح OpenTelemetry | قم بتكوين OpenTelemetry، وهو معيار لجمع بيانات تجربة المستخدم بما في ذلك أوقات تحميل الصفحة وتفاعلات المستخدم في تطبيقات الويب. | انظر: OpenTelemetry |
تقارير التطبيقات المتقاطعة Cross Application Reports | تظهر تقارير التطبيقات المتقاطعة في الشريط الجانبي بصفحة “أدوات مساحة العمل”. يمكنك الوصول إلى هذه التقارير لعرض وتحرير المعلومات عبر تطبيقات متعددة في مساحة العمل الحالية. | انظر: عرض تقارير التطبيقات المتقاطعة |
المهام، ذاكرة التخزين المؤقت لقاموس البيانات Tasks, Data Dictionary Cache | عرض الإحصائيات وتحليل البيانات لجداول المخططات والذاكرة المؤقتة في مساحة العمل. | راجع: عرض وتحديث ذاكرة التخزين المؤقت لقاموس البيانات لمساحة العمل في دليل إدارة Oracle APEX |
5.20.3 إدارة موفري المتجهات Vector Providers #
استخدم موفري المتجهات Vector Providers لإنشاء تضمينات متجهة لسلسلة نصية.
ملحوظة: يتطلب موفرو المتجهات قاعدة بيانات Oracle 23ai أو إصدارًا أحدث.
5.20.3.1 حول موفري المتجهات Vector Providers #
تعرف على موفري المتجهات Vector Providers.
بدءًا من قاعدة بيانات Oracle 23ai، يمكنك استخدام نوع البيانات المتجهة Vector لتخزين تضمينات المتجهات vector embeddings مع بيانات الأعمال في قاعدة البيانات. باستخدام نماذج التضمين، يمكنك تحويل البيانات غير المنظمة إلى تضمينات متجهة Vector Embeddings، والتي يمكن استخدامها لاحقًا للاستعلامات الدلالية semantic queries على بيانات الأعمال.
حول موفري المتجهات #
يُمكّنك مُزوّد المتجهات من تحويل النص إلى تضمين. يُمكن تغطية هذه الوظيفة بواسطة خدمة الذكاء الاصطناعي، أو محليًا بواسطة نموذج ONNX في قاعدة البيانات أو دالة PL/SQL مُعرّفة من قِبل المستخدم.
تُخزَّن مُوَفِّرات المتجهات Vector Providers على مستوى مساحة العمل، وهي متاحة في جميع التطبيقات. عند تصدير تطبيق، تُضاف مُوَفِّرات المتجهات المُستخدَمة إلى ملف التصدير. عند استيراد التطبيق إلى مساحة عمل أخرى، يتحقق Oracle APEX مما إذا كانت مساحة العمل المُستهدفة تحتوي بالفعل على مُوَفِّرات متجهات بنفس المُعرِّف الثابت. إذا كان مُوَفِّر المتجهات موجودًا بالفعل، فسيستخدمه التطبيق. وإلا، فسيتم إنشاء مُوَفِّر المتجهات من ملف الاستيراد في مساحة العمل المُستهدفة.
استرجاع التضمينات واستخدامها #
يمكنك استرداد التضمين من موفر متجه باستخدام الدوال GET_VECTOR_EMBEDDINGS
في حزمة APEX_AI
.
بعد استرجاع التضمين، يمكنك إنشاء تكوين بحث متجهات أوراكل Oracle Vector Search بناءً على موفر المتجهات الخاص بك. لمعرفة المزيد، راجع موضوع إنشاء بحث متجهات أوراكل .
5.20.3.2 إنشاء موفر متجه #
قم بإنشاء موفر متجه Creating a Vector Provider على صفحة موفري المتجهات Vector Providers page في أدوات مساحة العمل.
ملحوظة: يتطلب موفرو المتجهات قاعدة بيانات Oracle 23ai أو إصدارًا أحدث.
لإنشاء موفر متجه Vector Provider:
- انتقل إلى صفحة موفر المتجهات Vector Provider page:
- في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
- في الصفحة الرئيسية لـ App Builder ، انقر فوق أيقونة أدوات مساحة العمل Workspace Utilities.
- في صفحة أدوات مساحة العمل، انقر فوق موفرو المتجهات Vector Providers. تظهر صفحة موفري المتجهات.
- انقر فوق إنشاء Create. تظهر صفحة إنشاء/تحرير Create/Edit.
- تحت التعريف Identification:
- التعريف Identification، نوع المزوّد Provider Type – اختر نوع مزوّد المتجهات vector provider type. تشمل الخيارات:
- نموذج قاعدة بيانات Database ONNX Model
- خدمة الذكاء الاصطناعي التوليدي Generative AI Service
- PL/SQL مخصص Custom PL/SQL (لاحظ أن صفحات واجهة المستخدم تعتمد على نوع الموفر Provider Type الذي تحدده.
- التعريف Identification، الاسم Name – أدخل اسم مُقدِّم خدمة المتجهات. يجب أن يكون الاسم فريدًا، وسيظهر في صفحة نظرة عامة على مُقدِّم خدمة المتجهات Vector Provider overview page.
- التعريف Identification، مُعرِّف ثابت Static ID – أدخل مُعرِّفًا ثابتًا لمُزوِّد المتجه. يجب أن يكون المُعرِّف فريدًا، وسيتم الرجوع إليه عند استخدام الخدمة مع
APEX_AI
الحزمةAPEX_AI.GET_VECTOR_EMBEDDINGS
. مثال:VP_OPENAI_EMBEDDING
.
- التعريف Identification، نوع المزوّد Provider Type – اختر نوع مزوّد المتجهات vector provider type. تشمل الخيارات:
- إذا كان نوع الموفر هو نموذج قاعدة بيانات Database ONNX Model:
- التعريف Identification، الاسم Name – أدخل اسم مُقدِّم خدمة المتجهات. يجب أن يكون الاسم فريدًا، وسيظهر في صفحة نظرة عامة على مُقدِّم خدمة المتجهات.
- التعريف Identification، مُعرِّف ثابت Static ID – أدخل مُعرِّفًا ثابتًا لمُزوِّد المتجه. يجب أن يكون المُعرِّف فريدًا، وسيتم الرجوع إليه عند استخدام الخدمة مع حزمة
APEX_AI
,APEX_AI.GET_VECTOR_EMBEDDINGS
. - التضمين المحلي، مالك نموذج ONNX – حدد مالك نموذج ONNX الذي يجب استخدامه لمزود المتجهات. ستجد جميع المخططات المخصصة لمساحة عملك مُدرجة.
- التضمين المحلي Local Embedding، اسم مالك نموذج ONNX – حدد مالك نموذج ONNX الذي سيتم استخدامه للحصول على تضمين لمصطلح معين.
- إذا كان نوع المزود هو خدمة الذكاء الاصطناعي التوليدية Generative AI Service:
- التعريف Identification، الاسم Name – أدخل اسم مُقدِّم خدمة المتجهات. يجب أن يكون الاسم فريدًا، وسيظهر في صفحة نظرة عامة على مُقدِّم خدمة المتجهات.
- التعريف Identification، مُعرِّف ثابت Static ID – أدخل مُعرِّفًا ثابتًا لمُزوِّد المتجه. يجب أن يكون المُعرِّف فريدًا، وسيتم الرجوع إليه عند استخدام الخدمة مع حزمة
APEX_AI
,APEX_AI.GET_VECTOR_EMBEDDINGS
. - تحديد Identification موفر الذكاء الاصطناعي AI Provider – اختر موفر الذكاء الاصطناعي الذي ترغب باستخدامه مع موفر المتجهات هذا. تشمل الخيارات:
- خدمة الذكاء الاصطناعي التوليدي OCI Generative AI Service
- الذكاء الاصطناعي المفتوح Open AI
- Cohere
- إذا كان نوع الموفر هو PL/SQL مخصص Custom PL/SQL:
- التعريف Identification، الاسم Name – أدخل اسم مُقدِّم خدمة المتجهات. يجب أن يكون الاسم فريدًا، وسيظهر في صفحة نظرة عامة على مُقدِّم خدمة المتجهات.
- التعريف Identification، مُعرِّف ثابت Static ID – أدخل مُعرِّفًا ثابتًا لمُزوِّد المتجه. يجب أن يكون المُعرِّف فريدًا، وسيتم الرجوع إليه عند استخدام الخدمة مع حزمة
APEX_AI
,APEX_AI.GET_VECTOR_EMBEDDINGS
. - تضمين محلي Local Embedding، اسم دالة مخصصة Custom Function Name – حدد اسم دالة PL/SQL مخصصة تُحوّل مُدخلات المستخدم النهائي إلى تضمين. يجب أن تأخذ الدالة مُدخلات المستخدم النهائي الشكل،
VARCHAR2
وتُرجع نوع البياناتVECTOR
كنتيجة لذلك.
- انقر فوق إنشاء Create.
5.20.3.3 تحرير وحذف موفر المتجهات #
قم بتحرير أو حذف موفري المتجهات في صفحة تفاصيل مقدمي المتجهات Vector Providers Detail page في أدوات مساحة العمل.
لتحرير أو حذف موفر المتجهات:
- انتقل إلى صفحة موفر المتجهات:
- في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
- في الصفحة الرئيسية لـ App Builder، انقر فوق أيقونة أدوات مساحة العمل Workspace Utilities.
- في صفحة أدوات مساحة العمل، انقر فوق موفرو المتجهات Vector Providers. تظهر صفحة موفري المتجهات.
- لتحرير موفر المتجه:
- في صفحة موفري المتجهات، انقر فوق اسم موفري المتجهات. تظهر تفاصيل موفر المتجه.
- عدّل السمات المناسبة. لمعرفة المزيد عن سمة معينة، راجع قسم “المساعدة”.
- انقر فوق تطبيق التغييرات Apply Changes.
- لحذف موفر المتجه:
- في صفحة موفري المتجهات، انقر فوق اسم موفري المتجهات. تظهر تفاصيل موفر المتجه.
- انقر فوق حذف Delete.
- قم بتأكيد اختيارك ثم انقر فوق حذف Delete مرة أخرى.
5.20.3.4 عرض تقرير سجل تاريخي لموفري المتجهات #
اعرض تقريرًا بالتعديلات الأخيرة التي تم إجراؤها على Vector Provider في مساحة العمل هذه.
لتحرير أو حذف موفر المتجهات:
- انتقل إلى صفحة موفر المتجهات:
- في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
- في الصفحة الرئيسية لمُنشئ التطبيقات App Builder، انقر فوق أيقونة أدوات مساحة العمل Workspace Utilities.
- في صفحة أدوات مساحة العمل، انقر فوق موفرو المتجهات Vector Providers. تظهر صفحة موفري المتجهات.
- في صفحة موفري المتجهات، انقر فوق السجل التاريخي History. يظهر تقرير “سجل موفري المتجهات” Vector Providers History.
5.20.4 عرض تقارير التطبيقات المتقاطعة #
استخدم الروابط الموجودة ضمن صفحة تقارير التطبيقات المتقاطعة Cross Application Reports لعرض المعلومات وتحريرها عبر تطبيقات متعددة في مساحة العمل الحالية.
للوصول إلى تقارير التطبيقات المتقاطعة Cross Application Reports:
- سجّل الدخول إلى Oracle APEX. تظهر الصفحة الرئيسية لمساحة العمل.
- انقر على أيقونة “منشئ التطبيقات” App Builder. تظهر الصفحة الرئيسية لمنشئ التطبيقات App Builder.
- انقر على أيقونة أدوات مساحة العمل Workspace Utilities.
- حدد موقع قسم “تقارير التطبيقات المتقاطعة” Cross Application Reports على يمين النافذة. تشمل التقارير المتاحة:
- جميع التقاريرAll Reports
- سمات التطبيق Application Attributes
- خيارات البناء Build Options
- تعليقات المطور Developer Comments
- تقويم التعليقات Comments Calendar
- مقارنة التطبيقات Application Comparison
- مقارنة المكونات Component Comparison
- ملفات تعريف الأمان Security Profiles
- مخططات المصادقة Authentication Schemes
- عناصر كلمة المرور Password Items
- ملخص القالب Theme Summary
- لعرض كافة التقارير:
- انقر فوق كافة التقارير All Reports. تظهر صفحة تقارير التطبيقات المتقاطعة. تشمل التقارير المتاحة:
- سمات التطبيق Application Attributes:
- سمات التطبيق Application Attributes
- حالة البناء وحالة التطبيق Build Status and Application Status
- حالة البناء Build Status
- تعليقات المطور Developer Comments
- تقويم تعليقات المطورين Developer Comments Calendar
- تقارير مقارنة التطبيقات Application Comparison Reports:
- مقارنة التطبيقات Application Comparison
- ملخص أعداد المكونات Component Summary Counts
- الحماية Security:
- ملفات تعريف الأمان Security Profiles
- مخططات المصادقة Authentication Schemes
- عناصر كلمة المرور Password Items
- واجهة المستخدم User Interface:
- ملخص القالب Theme Summary
- سمات التطبيق Application Attributes:
- في صفحة تقارير التطبيقات المتقاطعة، حدد تقريرًا لمراجعته.
- انقر فوق كافة التقارير All Reports. تظهر صفحة تقارير التطبيقات المتقاطعة. تشمل التقارير المتاحة: