WMS 11825 - Feedback added new lab with more explanation on customization (#386)

* ocw feedback

* genai1

* Update manifest.json

* GenAI + Opensearch 2.11

* GENAI

* Known issues

* Update integration.md

* Several fixes mostly for multi region.

* a

* Create genai_agent.md

* Create images folder

* Add files via upload

* Update genai_agent.md

* added Lab 4 (Optional): GenAI Agent

* Update genai_agent.md

* Add files via upload

* Delete a.txt

* completed genai_agent.md

* added genai agent screenshots

* formating changes genai_agent.md

* postgres v1

* v2

* initial  discover.md

* Delete oci-postgresql-genai-lab/3-discover/images directory

* Create images folder

* added screenshots for lab3

* Update discover.md

* PostgresLab

* Update test.md

* -

* Hybrid

* qa

* Create .gitignore

* remove genai agent

* hybrid

* screenshot

* pgvector

* -

* Update integration.md

rsa key

* Missing grants

* Update connect-apex-with-agents.md

* Fixes

* not used

* date

* OCI Agent Lab V1

* Image OCID

* images lowercase

* Zip file location

* Typos

* feedback

* feedback

* feedback

* feedback

* feedback

* Feedback

* added Lab5

---------

Co-authored-by: mkratky <[email protected]>
Co-authored-by: Hope Fisher <[email protected]>

Author: 3 people

oci-genai-agent-ext-lab/2-apex/apex.md

@@ -26,7 +26,7 @@ Estimated time: 10 min
 
 1. Type "what is Oracle Analytics", then *Enter*
 
-    ![Test Jazz](images/test-video.png)  
+    ![Test Video](images/test-video.png)  
 
 1. Try more questions:
 

oci-genai-agent-ext-lab/5-customize/customize.md

@@ -0,0 +1,100 @@
+# Customize (Adding new files...)
+
+## Introduction
+In this lab, we add our own files to the RAG Agent
+
+Estimated time: 10 min
+
+### Objectives
+
+- Customize the demo
+
+### Prerequisites
+- The lab 1 must have been completed.
+
+## Task 1: Recap
+
+When the installation is done, it has created a several resources.
+
+![Integration](../0-intro/images/physical-architecture.png)
+
+## Task 2: Components
+
+Let's assume that the prefix of the installation is "agext" 
+
+**Virtual Machine**
+
+In OCI Console, click on the Hamburger menu:
+- Compute/Instance
+- There is a VM "agext-bastion"
+
+**Object storage**
+
+In OCI Console, click on the Hamburger menu:
+- Storage/Buckets
+
+There are 2 buckets:
+- agext-public-bucket: where you upload your own files
+- agext-agent-bucket: used by the RAG agent for searching. Containing only PDF or text files.
+
+The files from the agext-public-bucket are copied or transformed to PDF or text files automatically and stored in the "agent-bucket"
+
+## Task 3 - Upload new files
+In OCI Console, click on the Hamburger menu:
+- Storage/Buckets
+- agext-public-bucket
+
+Upload a new file.
+    ![Agent Ingestion](images/bucket-upload.png)    
+
+- Wait 4/5 mins before to ask a question to the chat.
+
+In the meanwhile,
+- Bucket:
+    - After 1/2 mins check that it is copied in the Agent Bucket.
+- AI Agent Ingestion
+    - In OCI Console, click on the Hamburger menu
+    - Analytics & AI/ Generative AI Agents
+    - Knowledge Base - agent-agent-kb
+    - In datasources - agent-agent-ds
+    - Check the ingestion jobs.
+  
+      ![Agent Ingestion](images/agent-ingestion.png)    
+
+What will happen internally, depending of the file type, it will be processed in different ways:
+- If the file has the extension **.pdf**, **.txt**, **.csv**, **.md**, the file is copied to the AGENT Object Storage.
+- If the file has the extension **.png**, **.jpg**, **.jpeg**, or **.gif**, it is processed by OCI Vision. The output is stored in the AGENT Object storage 
+- If the file has the extension **.mp4**, **.avi**, **.mp3**, **.wav**, or **.m4a**, it is processed by OCI Speech.
+- If the file has the extension **.tif**, it is processed by OCI Document Understanding.
+- If the file has the extension **.json**, this is an output of the asynchronous AI services such as OCI Speech or OCI Document Understanding. 
+- All other file types like **.doc**, **.docx**, **,xlsx**, **.pptx** are sent to OCI Function with a document parser.
+
+## Known issues
+
+- For debugging purpose if you want to login on the VM and see why it could fail
+
+```
+In OCI Cloud Shell
+cd oci-genai-agent-ext/starter
+
+See commands available
+./starter.sh 
+Navigate to Advanced/SSH
+
+SSH Key
+cat target/ssh_key_starter
+
+SSH to Bastion
+./starter.sh ssh bastion
+
+cd app
+cat ingest.log
+```
+
+## Acknowledgements
+
+- **Author**
+    - Marc Gueury, Generative AI Specialist
+    - Anshuman Panda, Generative AI Specialist
+    - Maurits Dijkens, Generative AI Specialist
+

oci-genai-agent-ext-lab/5-customize/images/agent-ingestion.png

@@ -26,6 +26,10 @@
             "title": "Lab 4: Digital Assistant",
             "filename": "./../../4-digital-assistant/digital-assistant.md"
         },        
+        {
+            "title": "Lab 5: Customize",
+            "filename": "./../../5-customize/customize.md"
+        },        
         {
             "title": "Need Help",
             "filename": "https://oracle-livelabs.github.io/common/labs/need-help/need-help-freetier.md"