Merge branch 'oracle-samples:main' into main

Author: gargnipungarg

ai-quick-actions/README.md

@@ -22,6 +22,7 @@ Manager (ORM) or manually. For further information see [Policies](policies/READM
 - [Model Evaluation](evaluation-tips.md)
 - [Model Registration](register-tips.md)
 - [MultiModal Models Tips](multimodal-models-tips.md)
+- [Time Series Forecasting](time-series-forecasting/README.md)
 - [CLI](cli-tips.md)
 
 
@@ -115,5 +116,6 @@ In some cases a more sophisticated solution is needed, for example [fine tuning.
 - [Model Evaluation](evaluation-tips.md)
 - [Model Registration](register-tips.md)
 - [MultiModal Models Tips](multimodal-models-tips.md)
+- [Time Series Forecasting](time-series-forecasting/README.md)
 - [CLI](cli-tips.md)
 

ai-quick-actions/feedback-submission-tips.md

@@ -0,0 +1,150 @@
+# Feedback/Feature Request Submission
+
+The **AI Quick Actions (AQUA)** interface provides a simple way to offer feedback directly from the UI. If you’ve spotted a bug or want to suggest a feature, you can easily submit it through GitHub.
+
+This guide shows you how to do that step-by-step, using the example:
+> **"AQUA UI doesn't show container version for model deployment"**
+
+---
+
+## Table of Contents
+
+- [Where to Find the Feedback Link](#where-to-find-the-feedback-link)
+- [Filling Out the Feedback Form](#filling-out-the-feedback-form)
+    - [1. Add a title](#1-add-a-title)
+    - [2. Feedback Type](#2-feedback-type)
+    - [3. Summary](#3-summary)
+    - [4. Steps to Reproduce](#4-steps-to-reproduce)
+    - [5. Expected Behavior](#5-expected-behavior)
+    - [6. Actual Behavior](#6-actual-behavior)
+    - [7. Version or AI Quick Actions](#7-version-or-ai-quick-actions)
+    - [8. Suggestions or Additional Notes](#8-suggestions-or-additional-notes)
+- [Submitting the Feedback](#submitting-the-feedback)
+
+## Where to Find the Feedback Link
+
+At the bottom of the **AI quick actions** banner, you’ll see:
+
+> **"Have ideas or feedback? Let us know!"**
+
+Clicking this link opens a pre-filled GitHub issue template:
+[Submit AQUA Feedback](https://github.com/oracle-samples/oci-data-science-ai-samples/issues/new?template=feedback_aqua.yml)
+
+AQUA UI with feedback link
+![Feedback_Link](web_assets/feedback-link-banner.png)
+
+---
+
+## Filling Out the Feedback Form
+
+Clicking the link will open a GitHub issue template with several fields. Below is how to fill it using our example: **Container Version Visibility**
+
+> **Tip:** You can attach screenshots, logs, or any other relevant files to most section of the form to make your feedback clearer and more actionable.
+---
+
+### 1. Add a title
+
+Select the type of issue you want to report. For this example, it will be a:
+
+> **Container Version Visibility**
+
+
+_Feedback type dropdown_  
+![Title](web_assets/feedback-title.png)
+
+---
+
+### 2. Feedback Type
+
+Select the type of issue you want to report. For this example, it will be a:
+
+> **Feature Request**
+
+
+_Feedback type dropdown_  
+![Dropdown](web_assets/feedback-type-dropdown.png)
+
+---
+
+### 3. Summary
+
+Use a concise title that clearly states the issue or feature request.
+
+> `AQUA UI doesn't show container version for model deployment`
+
+_Summary_
+![Summary](web_assets/feedback-summary.png)
+---
+
+### 4. Steps to Reproduce
+Describe the exact steps you took that led you to notice the issue or missing feature. This helps others reproduce the scenario and understand where it occurs in the UI. For this example, it will be:
+```text
+1. Open AQUA UI
+2. Go to "Model Deployments"
+3. Select a deployed model
+4. Notice that the container version is not shown in the UI
+```
+
+_Deployment details view with missing container version:_ 
+![MDMissingVersion](web_assets/feedback-md-missing-version.png)
+
+_Steps to Reproduce_
+![StepsToReproduce](web_assets/feedback-steps-to-reproduce.png)
+
+---
+
+### 5. Expected Behavior
+This helps the team understand what the user expects to see.
+```text
+The model deployment page should show:
+Container Version: v1.8.5
+```
+_Expected Behavior_
+![ExpectedBehavior](web_assets/feedback-expected-behavior.png)
+
+---
+
+### 6. Actual Behavior
+Describe what you observed in the UI or behavior that was unexpected or incorrect. This helps the team understand the problem from the user's perspective.
+```text
+The container version field is not visible. Users cannot confirm which version of the container is deployed.
+```
+_Actual Behavior_
+![ActualBehavior](web_assets/feedback-actual-behavior.png)
+
+---
+
+### 7. Version or AI QUick Actions
+
+Provide details about your environment.
+
+```text
+AQUA Version: v1.0.7
+```
+_Version or AI QUick Actions_
+![Version](web_assets/feedback-version.png)
+---
+
+### 8. Suggestions or Additional Notes
+This optional section lets you suggest improvements, explain why the feature is important, or attach helpful context like screenshots or logs.
+```text
+Add a new field labeled “Container Version” in the model deployment details card.  
+This helps with debugging and auditability.
+```
+
+_Suggestions or Additional Notes_
+![Suggestions](web_assets/feedback-additional-info.png)
+
+---
+
+## Submitting the Feedback
+
+After filling out all fields:
+
+- Review your inputs for clarity
+- Click **Create** button
+
+---
+
+
+

ai-quick-actions/policies/README.md

@@ -7,6 +7,7 @@
   - [Setting Up Policies Manually](#setting-up-policies-manually)
     - [Dynamic Groups](#dynamic-groups)
     - [Policies](#policies-1)
+  - [Aqua Policy Verification Tool](#aqua-policy-verification-tool)
 
 
 ---
@@ -121,6 +122,163 @@ These policies and dynamic groups set up the necessary permissions to enable AI
 > **Note:** To save fine-tuned models, versioning has to be enabled in the selected Object Storage bucket. See [here](https://docs.oracle.com/iaas/data-science/using/ai-quick-actions-fine-tuning.htm) for more information.
 
 ![Setup 3](../web_assets/policies3.png)
+
+## Aqua Policy Verification Tool
+
+The **Aqua Policy Verification Tool** is a command-line utility designed to **validate IAM  policies** required to use key features of AI Quick action (AQUA) platform.
+
+It simulates actual operations — like registering models, creating job runs, or accessing object storage — to determine whether the currently configured IAM user/group has sufficient permissions.
+
+Before running real workloads (deploying, fine-tuning, etc.), users can verify they have the **right access privileges**. This tool provides:
+- Immediate feedback on missing policies
+- Policy hints to help fix permission issues
+
+
+### How to Use
+
+To run the policy-checks from Notebook terminal:
+
+```bash
+ads aqua verify_policies <operation> [OPTIONS]
+```
+
+Where `<operation>` is one of:
+- `common_policies`
+- `model_register`
+- `model_deployment`
+- `evaluation`
+- `finetune`
+
+
+### Description of Policy Verification Operations
+
+Each operation simulates certain actions in AQUA and checks whether those succeed. Here’s what each one does:
+
+####  1. `common_policies`
+
+**Purpose**: Verifies basic **read-level permissions** across key Data Science resources.
+
+**Simulated actions**:
+- Listing compartments
+- Listing models and model version sets
+- Listing jobs and job runs
+- Listing object storage buckets
+- Listing logging groups
+- Getting service limits
+
+**Examples:**
+
+```bash
+ads aqua verify_policies common_policies
+```
+
+
+####  2. `model_register`
+
+**Purpose**: Verifies ability to **register a model**, which includes writing artifacts to Object Storage.
+
+**Simulated actions**:
+- Managing a specified Object Storage bucket
+- Registering a new model in the OCI Data Science platform
+- Deleting the test model (cleanup)
+
+>**Note**: This operation will create and delete the following temporary resources, which may incur charges. [[See pricing]](https://www.oracle.com/artificial-intelligence/data-science/pricing/)
+>  - A model with name `AQUA Policy Verification - Model` in OCI Data Science 
+>  - A test file with name  `AQUA Policy Verification - OBJECT STORAGE` to your specified bucket. The model and object will be deleted after verification.
+
+**Examples:**
+
+```bash
+ads aqua verify_policies model_register
+```
+or
+```bash
+ads aqua verify_policies model_register --bucket my-model-artifacts-bucket
+```
+
+
+#### 3. `model_deployment`
+
+**Purpose**: Verifies ability to **deploy a model** after registration.
+
+**Simulated actions**:
+- Registering a model (same as `model_register`)
+- Creating a model deployment
+- Deleting the deployment and the model (cleanup)
+
+> **Note**: This operation will create and delete the following temporary resources, which may incur charges. [[See pricing]](https://www.oracle.com/artificial-intelligence/data-science/pricing/):
+> - A model with name `AQUA Policy Verification - Model`
+> - A test file with name  `AQUA Policy Verification - OBJECT STORAGE` to your specified bucket. 
+> - A model deployment named `AQUA Policy Verification - Model Deployment`  
+> 	   These will be deleted after verification is complete.     
+
+**Examples:**
+
+```bash
+ads aqua verify_policies model_deployment
+```
+or
+```bash
+ads aqua verify_policies model_deployment --bucket my-model-bucket
+```
+
+#### 4. `evaluation`
+
+**Purpose**: Verifies policies required for **evaluation workflows**, such as automated testing or validation.
+
+**Simulated actions**:
+- Creating and deleting a Model Version Set (MVS)
+- Registering a model
+- Running a job and job run
+- Deleting all test resources
+
+> **Note**: This operation will create and delete the following temporary resources, which may incur charges. [[See pricing]](https://www.oracle.com/artificial-intelligence/data-science/pricing/):
+> - A **Model Version Set** named `AQUA Policy Verification - Model Version Set`
+> - A model with name `AQUA Policy Verification - Model`
+> - A test file with name  `AQUA Policy Verification - OBJECT STORAGE` to your specified bucket. 
+> - A test model (as in `model_register`)
+> - A **Job** and **Job Run** named `AQUA Policy Verification - Job` and `AQUA Policy Verification - Job Run`
+
+**Examples:**
+
+```bash
+ads aqua verify_policies evaluation
+```
+or
+```bash
+ads aqua verify_policies evaluation --bucket eval-bucket
+```
+
+
+#### 5. `finetune`
+
+**Purpose**: Verifies whether you can run a **fine-tuning workflow**, typically involving training jobs, storage, and networking.
+
+**Simulated actions**:
+- Validates bucket access (datasets, scripts, model output)
+- Optionally verifies subnet access for job runs
+- Creates and deletes MVS
+- Runs finetune jobs
+
+> **Note**: This operation will create and delete the following temporary resources, which may incur charges. [[See pricing]](https://www.oracle.com/artificial-intelligence/data-science/pricing/):
+> - A **Model Version Set** named `AQUA Policy Verification - Model Version Set`
+> - A test file with name  `AQUA Policy Verification - OBJECT STORAGE` to your specified bucket. 
+> - A **Job** and **Job Run** named `AQUA Policy Verification - Job` and `AQUA Policy Verification - Job Run`
+
+**Examples:**
+
+```bash
+ads aqua verify_policies finetune
+```
+or
+```bash
+ads aqua verify_policies finetune --bucket fine-tune-data --ignore_subnet
+```
+or
+```bash
+ads aqua verify_policies finetune --bucket fine-tune-data --subnet_id ocid1.subnet.oc1..examplesubnetID
+```
+
 - [Home](../README.md)
 - [CLI](../cli-tips.md)
 - [Model Deployment](../model-deployment-tips.md)