added apex and policy (#355)

* added apex and policy

* images changed removed root

Author: anshoracle

multichannel-oci-genaiagents/2-setup/setup.md

@@ -117,9 +117,10 @@ Next, we will create the access policies:
   allow group <your-user-group-name> to manage genai-agent-family in tenancy
   allow group <your-user-group-name> to manage object-family in tenancy
   allow dynamic-group <dynamic-group-name-created-above> to manage all-resources in tenancy
+  allow any-user to manage genai-agent-family in tenancy where request.principal.id=<ODA OCID> 
   </copy>
   ```
-
+  Make sure to put the ODA OCID in the above policy in single inverted commas instead of <ODA OCID>
   Make sure to replace `<your-user-group-name>` with the user group your user is associated with (for example: `Administrators`).
   Also, please replace `<dynamic-group-name-created-above>` with the name you've provided for the dynamic group created above.
 

multichannel-oci-genaiagents/9-connect-apex-with-agents/connect-apex-with-agents.md

@@ -0,0 +1,96 @@
+# Connect APEX with GenAI Agent
+## Introduction
+
+In this lab, we will learn how to expose Gen AI Agents via Oracle APEX. This involves retrieving the Agent Endpoint ID and configuring APEX to interact with the Gen AI Agent.
+
+Estimated Time: 20 minutes
+
+### Objectives
+
+In this lab, you will:
+- Retrieve the Agent Endpoint ID.
+- Configure a Digital Assistant to interact with the Gen AI Agent.
+
+### Prerequisites
+
+This lab assumes you have:
+- Access to the Gen AI Agent dashboard.
+- GenerativeAI Agent Endpoint ID. See Lab: Connect ODA with GenAI Agent - Task 1
+- [Download the APEX app, here](https://objectstorage.eu-frankfurt-1.oraclecloud.com/n/frpj5kvxryk1/b/genAiAgents/o/apex_ai_agent_2024_11_19.sql)
+
+Note: The lab should work also with any Database 19c+ with APEX and DBMS_CLOUD. Here, we use Autonomous database since both are preinstalled. 
+
+## Task 1: Policies
+
+1. Click the hamburger menu on the left-hand corner and go to **Oracle Database > Autonomous Transaction Processing**.
+
+    ![Autonomous Database](./images/ai_agent_atp.png)
+
+2. Click on the Autonomous Database name (or create a new one with all default) and find the OCID (something like ocid1.autonomousdatabase.oc1.eu-frankfurt-1.abcdefghj..)
+
+    ![ATP OCID](./images/ai_agent_atp_ocid.png)
+
+3. Click the hamburger menu on the left-hand corner and go to **Identity and Security > Policies**.
+
+    ![Policy](./images/ai_agent_policy.png)
+
+4. Change to the root compartment. Create a policy with rules like this one (use your OCID found above)
+
+    ![Policy](./images/ai_agent_policy_create.png)
+
+    ```
+    allow any-user to manage genai-agent-family in tenancy where request.principal.id='ocid1.autonomousdatabase.oc1.eu-frankfurt-1.abcdefghj...'
+    allow any-user to read object-family in tenancy where request.principal.id='ocid1.autonomousdatabase.oc1.eu-frankfurt-1.abcdefghj...'
+    allow any-user to manage object-family in tenancy where ALL { request.principal.id='ocid1.autonomousdatabase.oc1.eu-frankfurt-1.abcdefghj...', request.permission = 'PAR_MANAGE' }
+    ```   
+
+## Task 2: Configure Autonomous Database 
+
+1. Click the hamburger menu on the left-hand corner and go to **Oracle Database > Autonomous Transaction Processing**.
+
+    ![Autonomous Database](./images/ai_agent_atp.png)
+
+2. Click on your database name   
+3. Click on the button **Database Actions / View All Database Actions**
+
+    ![Database Actions](./images/ai_agent_db_action.png)
+
+4. Choose **APEX**. Click **Open**
+5. If you have already an existing APEX workspace, log in it. If not, create one with Administration Services.
+6. Click **Application Builder / Import**. Choose the APEX app that your downloaded above (apex_ai_agent_xx.sql). Then **Next**.
+
+    ![APEX](./images/ai_agent_apex.png)
+
+7. Click **Install Application**
+
+    ![Import](./images/ai_agent_apex_import.png)
+
+8. Click **Install Supporting Objects**
+9. When the installation is done, click **Edit Application**.
+
+    ![Edit](./images/ai_agent_apex_edit.png)
+
+10. Click on page 1
+11. Open Pre-rendering / CREATE_SESSION
+12. Edit the agent endpoint id. Save and Run
+    ![Endpoint](./images/ai_agent_apex_endpoint.png)
+ 
+ ## Task 3: Test the application
+
+1. Type your question in message. Then Send
+
+    ![Test](./images/ai_agent_apex_test.png)
+
+2. Check the response. Hover the mouse to see the citations of the original documents.
+3. Click on the link of the original document to see it.
+
+## Learn More
+
+- [Gen AI Agent Documentation](https://docs.oracle.com/en-us/iaas/Content/genAI/getting-started.htm)
+- [Autonomous Database Documentation](https://docs.oracle.com/en-us/iaas/digital-assistant/getting-started.htm)
+
+## Acknowledgements
+
+* **Author** - Anshuman Panda, Marc Gueury, Alexandru Negrea
+
+* **Last Updated By/Date** - Marc Gueury - Nov 2024

multichannel-oci-genaiagents/9-connect-apex-with-agents/images/ai_agent_apex.png

@@ -38,6 +38,10 @@
             "title": "LAB 6: Connect ODA with Slack",
             "filename": "../../8-connect-oda-with-slack/connect-oda-with-slack.md"
         },
+        {
+            "title": "LAB 7: Connect APEX with GenAI Agent",
+            "filename": "../../9-connect-apex-with-agents/connect-apex-with-agents.md"
+        },        
         {
             "title": "Need Help?",
             "filename": "https://oracle-livelabs.github.io/common/labs/need-help/need-help-freetier.md"

multichannel-oci-genaiagents/9-connect-apex-with-agents/images/ai_agent_apex_edit.png

@@ -38,6 +38,10 @@
             "title": "LAB 6: Connect ODA with Slack",
             "filename": "../../8-connect-oda-with-slack/connect-oda-with-slack.md"
         },
+        {
+            "title": "LAB 7: Connect APEX with GenAI Agent",
+            "filename": "../../9-connect-apex-with-agents/connect-apex-with-agents.md"
+        },        
         {
             "title": "Need Help?",
             "filename": "https://oracle-livelabs.github.io/common/labs/need-help/need-help-freetier.md"