docs: Updated Workshop folder: Clearer Docs, Refactored Plugin, and Better Quota Instructions

docs: Updated Workshop folder: Clearer Docs, Refactored Plugin, and Better Quota Instructions

Author: Avijit-Microsoft

workshop/docs/workshop/.env.sample

@@ -0,0 +1,3 @@
+AZURE_AI_SEARCH_API_KEY=""
+AZURE_OPENAI_API_KEY=""
+

workshop/docs/workshop/Challenge-3-and-4/knowledge_mining_api.ipynb

@@ -42,8 +42,8 @@
    "outputs": [],
    "source": [
     "\"\"\"\n",
-    "The following sample demonstrates how to create an Azure AI agent that answers\n",
-    "questions about a sample menu using a Semantic Kernel Plugin.\n",
+    "The following sample demonstrates how to create an Azure AI agent that answers \n",
+    "questions about conversational data using a Semantic Kernel Plugin.\n",
     "\"\"\"\n",
     "\n",
     "async def get_db_connection():\n",
@@ -96,8 +96,8 @@
     "            cursor.close()\n",
     "        conn.close()\n",
     "\n",
-    "# Define a sample plugin for the sample\n",
-    "class MenuPlugin:\n",
+    "# Define a chat with data plugin for the conversational data\n",
+    "class ChatWithDataPlugin:\n",
     "    def __init__(self):\n",
     "        self.azure_openai_deployment_model = os.getenv(\"AZURE_OPEN_AI_DEPLOYMENT_MODEL\")\n",
     "        self.azure_openai_endpoint = os.getenv(\"AZURE_OPEN_AI_ENDPOINT\")\n",
@@ -109,8 +109,6 @@
     "        self.use_ai_project_client = os.getenv(\"USE_AI_PROJECT_CLIENT\", \"False\").lower() == \"true\"\n",
     "        self.azure_ai_project_conn_string = os.getenv(\"AZURE_AI_PROJECT_CONN_STRING\")\n",
     "    \n",
-    "    \"\"\"A sample Menu Plugin used for the concept sample.\"\"\"\n",
-    "\n",
     "            \n",
     "    @kernel_function(name=\"Greeting\",\n",
     "                     description=\"Respond to any greeting or general questions\")\n",
@@ -207,7 +205,7 @@
     "                )\n",
     "                sql_query = completion.choices[0].message.content\n",
     "                sql_query = sql_query.replace(\"```sql\", '').replace(\"```\", '')\n",
-    "                print(\"SQL Query: \", sql_query, flush=True)\n",
+    "                # print(\"SQL Query: \", sql_query, flush=True)\n",
     "\n",
     "            answer = await execute_sql_query(sql_query)\n",
     "            answer = answer[:20000] if len(answer) > 20000 else answer\n",
@@ -342,7 +340,7 @@
     "            agent = AzureAIAgent(\n",
     "                client=client,\n",
     "                definition=agent_definition,\n",
-    "                plugins=[MenuPlugin()],  # Add the plugin to the agent\n",
+    "                plugins=[ChatWithDataPlugin()],  # Add the plugin to the agent\n",
     "            )\n",
     "\n",
     "            # 3. Create a thread for the agent\n",
@@ -370,15 +368,6 @@
     "                await thread.delete() if thread else None\n",
     "                await client.agents.delete_agent(agent.id)\n",
     "\n",
-    "            \"\"\"\n",
-    "            Sample Output:\n",
-    "            # User: Hello\n",
-    "            # Agent: Hello! How can I assist you today?\n",
-    "            # User: What is the special soup?\n",
-    "            # ...\n",
-    "            \"\"\"\n",
-    "\n",
-    "\n",
     "if __name__ == \"__main__\":\n",
     "    await main()"
    ]

workshop/docs/workshop/Challenge-5/docs/create_azure_ai_service.md

@@ -1,5 +1,5 @@
 # How To Create Azure AI Service
-1. Navigate to https://aka.ms/CognitiveServicesAIServices .
+1. Navigate to https://portal.azure.com/#create/Microsoft.CognitiveServicesAIServices .
 2. Select your Azure subscription.
 3. Select the available Resource group.
 4. Choose the region which support Content Understanding service from below tables.

workshop/docs/workshop/support-docs/AzureGPTQuotaSettings.md

@@ -1,10 +1,26 @@
 ## How to Check & Update Quota
 
-1. **Navigate** to the [Azure AI Foundry portal](https://ai.azure.com/).  
-2. **Select** the AI Project associated with this accelerator.  
-3. **Go to** the `Management Center` from the bottom-left navigation menu.  
-4. Select `Quota`  
-   - Click on the `GlobalStandard` dropdown.  
-   - Select the required **GPT model** (`GPT-4, GPT-4o, GPT-4o Mini`) or **Embeddings model** (`text-embedding-ada-002`).  
-   - Choose the **region** where the deployment is hosted.  
-5. Request More Quota or delete any unused model deployments as needed.  
+1. Go to the [Azure Portal](https://portal.azure.com).
+2. In the **search bar**, type the name of the **Resource Group** you created during **Challenge 1**.
+3. Within the resource group, look for the **Azure AI services** ending in -aiservices.
+4. In the AI services, Click on **Go to Azure AI Foundry portal**.  
+4. **Navigate** to `Shared resources` in the bottom-left menu.
+
+---
+
+### 🔍 To Check Quota
+
+- Click on the `Quota` tab.
+- In the `GlobalStandard` dropdown:
+  - Select the desired model (e.g., **GPT-4**, **GPT-4o**, **GPT-4o Mini**, or **text-embedding-ada-002**).
+  - Choose the **region** where your deployment is hosted.
+- You can:
+  **Request more quota**, or **Delete unused deployments** to free up capacity.
+
+---
+
+### ✏️ To Update Quota
+
+- Go to the `Deployments` tab.
+- Select the deployment of the desired model.
+- Click **Edit**, update the **Tokens per Minute (TPM) Rate Limit**, then **Submit Changes**.

workshop/docs/workshop/support-docs/quota_check.md

@@ -4,8 +4,6 @@ Before deploying the accelerator, **ensure sufficient quota availability** for t
 Use one of the following scripts based on your needs:  
 
 - **`quota_check_params.sh`** → If you **know the model and capacity** required.  
-- **`quota_check_all_regions.sh`** → If you **want to check available capacity across all regions** for supported models.  
-
 ---
 ## **If using Azure Portal and Cloud Shell**
 
@@ -20,14 +18,6 @@ Use one of the following scripts based on your needs:
     chmod +x quota_check_params.sh
     ./quota_check_params.sh <model_name:capacity> [<model_region>] (e.g., gpt-4o-mini:30,text-embedding-ada-002:20 eastus)
     ```
-
-   **To check available quota across all regions for supported models:**  
-
-    ```sh
-    curl -L -o quota_check_all_regions.sh "https://raw.githubusercontent.com/microsoft/Conversation-Knowledge-Mining-Solution-Accelerator/main/infra/scripts/quota_check_all_regions.sh"
-    chmod +x quota_check_all_regions.sh
-    ./quota_check_all_regions.sh
-    ```
 
 ## **If using VS Code or Codespaces**
 
@@ -39,11 +29,6 @@ Use one of the following scripts based on your needs:
     ./quota_check_params.sh <model_name:capacity> [<model_region>] (e.g., gpt-4o-mini:30,text-embedding-ada-002:20 eastus)
     ```
 
-   **To check available quota across all regions for supported models:**  
-
-    ```sh
-    ./quota_check_all_regions.sh
-    ```
 2. If you see the error `_bash: az: command not found_`, install Azure CLI:  
 
     ```sh