WMS - 11918 (#412)

* OCI Generatvie AI agent with ADK

* 0.0.0a

* 0.0.0a

* Configuration step

* 0.0.0 Introduction

* adk installation steps

* Rag tools

* added custom tools

* added custom tools

* final alpha

Author: RahulMR42

generative-ai-agent-adk/adk-installation/adk_install.md

@@ -0,0 +1,111 @@
+# Setup OCI Agent Development Kit (ADK)
+
+## Introduction
+
+This lab will take you through the steps needed to install ADK using python installer .We recommend to use *OCI DATA Science* based notebook to run the operation as it comes with all the necessary software in place,however we have added an optional steps to follow local machine for ADK client setup.
+
+Estimated Time: 30 minutes
+
+
+
+## Task 1: Setup OCI Data Science notebook for **ADK** usage.
+
+1. From OCI Console > *AI & Analytics* > *Data science*
+
+    ![Data science view](images/datascience_view.png)
+1. Select *Create project*.Provide name and description.
+
+    ![Data science project](images/create_ds_project.png)
+
+1. With in the project,click *Create notebook session*.
+
+    ![Create notebook](images/create_nb.png)
+
+1. Provide a name and retain all the other default settings and click *Create*.
+
+    ![Create notebook completed](images/create_nb_final.png)
+
+1. Wait for the resource to become active.
+
+    ![Active notebook](images/nb_active.png)
+
+1. Open the notebook detail page and click *Open*.
+
+    ![NB details](images/nb_detail_page.png)
+
+1. Provide credentials and multi factor auth when prompted.Wait for the notebook to be opened.
+
+    ![NB Opened](images/nb_open_view.png)
+    
+1. Click *extend* and extend the notebook timeout.
+
+**You can skip the next section and follow to Task 3** 
+
+
+## Task 2: (Optional) Setup a local machine for **ADK** usage.
+
+1. Python ADK requires Python 3.10 or later. Ensure you have the correct version of Python installed in your environment.
+1. Follow below and installed *OCI* with *ADK*
+
+   ```
+   <copy>
+    # Create a project folder with name of your choice
+    mkdir <your-project-name>
+    cd <your-project-name>
+    # Create and activate a virtual environment under `<myenv>` subfolder
+    python -m venv <myenv>
+    source <myenv>/bin/activate
+   </copy>
+   ```
+1. After you create a project and a virtual environment, install the latest version of ADK:
+
+   ```
+   <copy>
+    pip install "oci[adk]"
+    pip install oci-cli
+   </copy>
+   ```
+1. Create an *API Signing Key* and store for further usage. Refer [here](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#two) for detailed steps.
+
+## Task 3: Validate ADK installation using OCI Data science.
+
+1. Follow below steps if you are using a data science notebook.If not move to Task 4.
+
+* Click File > New >Notebook.
+
+    ![New Notebook](images/new_notbook.png)
+
+1. Right click on Untitled notebook and rename the same.
+
+    ![Rename the NB](images/rename_nb.png)
+
+1. Run below and validate it returns the correct name reference.
+
+   ```
+   <copy>
+    from oci.addons import adk
+    adk.__name__
+   </copy>
+   ```
+    ![ADK Validation](images/adk_validate.png)
+
+## Task 3: Validate ADK installation for local setup.
+
+1. Follow below steps for local machine
+
+   ```
+   <copy>
+    from oci.addons import adk
+    adk.__name__
+   </copy>
+   ```
+1. Validate the name reference.
+
+**Proceed to the next lab.**
+
+## Acknowledgements
+
+* **Author**
+    * **Rahul MR**, Principal Solutions Architect - OCI 
+* **Contributors**
+    * **Sanjeeva Kalva**, Principal Data Scientist - OCI