ذكاء Oracle APEX: المساعد الذكي وبناء التطبيقات التوليدي

منذ APEX 24.1 أصبح الذكاء التوليدي مدمجًا في المنشئ وفي التطبيقات التي تنشرها. يربط هذا الدليل (المُراجَع على APEX 26.1 و26.2) مزوّدًا ويستعرض مواضع استخدامه: مساعد APEX في محررات الكود، وCreate App Using Generative AI، والذكاء داخل تطبيقاتك عبر الإجراء الديناميكي Show AI Assistant وحزمة APEX_AI.

اربط خدمة ذكاء توليدي

1. اذهب إلى App Builder ← Workspace Utilities ← Generative AI واضغط Create. (ويمكن الوصول إليها أيضًا من Shared Components ← Generative AI ← AI Services في أي تطبيق.)
2. اختر AI Provider: ‏OCI Generative AI أو OpenAI أو Cohere أو Google Gemini أو Anthropic Claude أو Mistral AI أو Ollama أو نقطة نهاية عامة متوافقة مع OpenAI (قائمة 26.1).
3. أعطها Name وStatic ID — والـ Static ID هو ما تمرّره إلى APEX_AI.
4. في Credentials أدخل API Key الخاص بالمزوّد (أو اختر Web Credential موجودًا). ويمكنك تحديد AI Model (ضمن Advanced في 26.1)؛ وإن تُرك فارغًا يُستخدم النموذج الافتراضي للمزوّد.
5. فعّل Used by App Builder إن أردت أن تستخدم ميزات المنشئ الذكية هذه الخدمة. ولا يُسمح بتفعيله إلا لخدمة واحدة في كل مساحة عمل.
6. اضغط Test Connection (المتوقع *Connection Succeeded!*)، ثم Create.

استخدم مساعد APEX في محررات الكود

مساعد APEX (‏APEX Assistant) لوحة محادثة داخل محررات الكود في المنشئ (مثل مصدر SQL لمنطقة في Page Designer). اضغط APEX Assistant في شريط قوائم المحرر، واقبل نافذة الموافقة أول مرة، ثم اختر وضعًا:

• Query Builder — صِف البيانات واحصل على استعلام: *«أفضل 5 عملاء بالإيراد هذا العام»*.
• General Assistance — حدّد كودًا واسأل *«Explain this»* أو *«Improve this code»*.

أنشئ تطبيقًا من موجّه

يبني Create App Using Generative AI الصفحات على جداول موجودة فعلًا (أو على مجموعة بيانات نموذجية). وإن احتجت جداول جديدة فولّدها أولًا عبر Create Data Model Using AI:

SQL Workshop → Utilities → Create Data Model Using AI
  › Expense tracking: employees, expenses with receipt files,
    approval status and approver, expense categories.
  → review the generated script → Run

App Builder → Create → Create App Using Generative AI
  › Create an app on the EXPENSES tables with an interactive report,
    a form, and a monthly dashboard by category.
  → review the summary → Create Application

يلخّص مساعد APEX الصفحات التي ينوي إنشاءها؛ فتنقّحها بالمحادثة، ثم تُكمل في معالج Create Application المعتاد. ويبقى الخياران مخفيين حتى تُفعَّل Used by App Builder لإحدى الخدمات. اقرنه بـدليل البرمجة بالمحادثة لسير العمل الملفّي.

أضف محادثة ذكية إلى تطبيقك

1. حدّد خدمة التطبيق من Edit Application Definition ← AI.
2. اختياريًا، أنشئ AI Agent من Shared Components ← Generative AI ← AI Agents للموجّه النظامي ورسالة الترحيب وأدوات الذكاء (في 26.1 أُعيدت تسمية *AI Configurations* إلى *AI Agents*).
3. في Page Designer أضف زرًا وإجراءً ديناميكيًا على Click يكون إجراؤه الصحيح Show AI Assistant. اختر الـ Agent، واضبط Display As على Dialog أو Inline.

من PL/SQL تُعيد APEX_AI.GENERATE قيمة CLOB. يُترجَم الاستدعاءان أدناه بنجاح على APEX 26.1؛ ويجب تشغيلهما داخل جلسة APEX (عملية في التطبيق، أو بعد APEX_SESSION.CREATE_SESSION):

declare
    l_answer clob;
begin
    -- استخدام خدمة ذكاء توليدي عبر الـ Static ID
    l_answer := apex_ai.generate (
        p_prompt            => 'Summarize this ticket in two sentences: ' || :P10_TICKET_TEXT,
        p_system_prompt     => 'You are a concise support analyst.',
        p_service_static_id => 'MY_AI_SERVICE',
        p_temperature       => 0.2 );

    -- أو إعادة استخدام AI Agent (‏APEX 26.1+)
    l_answer := apex_ai.generate (
        p_agent_static_id => 'SUPPORT_AGENT',
        p_prompt          => :P10_QUESTION );
end;

اختبر فهمك