WMS 11825 - Added new Agent features - RAG filter + Tools (#402)

* 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

* lab 6

* Update intro.md

* tools v2

* Update manifest.json

* Tools lab

* tools

* tools

---------

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

Author: 3 people

oci-genai-agent-ext-lab/0-intro/intro.md

@@ -25,7 +25,11 @@ From the lab 2/3/4, we will create 3 user interfaces for the above using the fol
 - APEX
 - A Python library Streamlit  
 - Oracle Digital Assistant
-  
+    
+Lab 5 explain how to customize the demo to your needs.
+
+Lab 6 shows how to change the Agent to have a RAG, SQL and Custom tool
+
 Estimated Workshop Time: 90 minutes
 
 ### Logical Architecture

oci-genai-agent-ext-lab/1-install/install.md

@@ -298,6 +298,29 @@ You can
     Solution:
     - Ask your administrator to increase your quota or the limits of the tenancy.
    
+7. Error: Attempt to index null value
+
+  ```
+  on datasource.tf line 64, in locals:
+  64:   idcs_url = (var.idcs_url!="")?var.idcs_url:data.oci_identity_domains.starter_domains.domains[0].url
+    ├────────────────
+    │ data.oci_identity_domains.starter_domains.domains is null
+  ```
+
+  Work-around:
+  - This is due to a lack of privilege to access the list of domains in your tenancy.
+  - edit file env.sh and add this line:
+    ```
+    export TF_VAR_idcs_url=https://idcs-xxxxxx.identity.oraclecloud.com:443
+    ````
+    You can find this URL by 
+    - going to OCI Console / Hamburger menu / Identity and Security / Domains 
+    - go to the root compartment
+    - choose the default Domain
+    - look for the Domain URL. It will look like this: https://idcs-xxxxxx.identity.oraclecloud.com:443
+  - Rerun ./starter.sh build
+
+
 ## Acknowledgements
 
 - **Author**

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

@@ -42,11 +42,43 @@ Estimated time: 10 min
     | Video     | .mp4      | What is Oracle Analytics                          | 
     | Audio     | .mp3      | Summarize the audio file Voice_SupportRobot.mp3   |
 
+
 **You may now proceed to the [next lab.](#next)**
 
+## Task 2. Filter
+
+One additional step is needed to use the RAG filter. We need to add a RAG tool.
+
+### 1. Rag Tool ###
+
+- In the hamburger menu, go to **Analytics and AI / Generative AI Agents**
+- Click on **Agents**
+- Choose your compartment
+- Open the agent created in Lab 1
+- Choose Tools / Create Tool
+- Choose **RAG** 
+   ![Custom tool](../6-tools/images/rag-tool.png)
+- Enter:
+    - **Name** = rag-tool
+    - **Description** = Use this tool for any question that are not covered by the other tools. It contains generic documentation.
+- Select the knowledge base - agext-agent-kb
+- Click **Create Tool**
+
+### 2. Test again ###
+- Go back to the APEX app. 
+- Refresh the browser to start a new session. 
+- Set the filter to */oracle*.
+- Ask again the same questions. You will see that based on the metadata, you can filter files. 
+
 ## Known issues
 
-None
+1. Conversation history 
+    Notice, do not change the filter in the middle of the conversation, or you can have funny effect. Ex:
+    - Ask "what is jazz ?" without filter -> you get the answer from the RAG (with a citation)
+    - Stay in the same conversation: 
+    - Ask "what is jazz ?" with filter "/music" -> you get the answer from the RAG (with a citation) 
+    - Ask "what is jazz ?" with filter "/oracle" -> you get an answer... from the conversation history... 
+    - The correct way was to reset the conversation to get another chat session.  
 
 ## Acknowledgements