refactor: Agent framework v2 changes.

README.md

@@ -22,7 +22,7 @@ Analysts working with large volumes of conversational data can use this solution
 Solution overview
 </h2>
 
-Leverages Azure Content Understanding, Foundry IQ, Azure OpenAI Service, Semantic Kernel, Azure SQL Database, and Cosmos DB to process large volumes of conversational data. Audio and text inputs are analyzed through event-driven pipelines to extract and vectorize key information, orchestrate intelligent responses, and power an interactive web front-end for exploring insights using natural language.
+Leverages Azure Content Understanding, Foundry IQ, Azure OpenAI Service, Azure AI Agent Framework, Azure SQL Database, and Cosmos DB to process large volumes of conversational data. Audio and text inputs are analyzed through event-driven pipelines to extract and vectorize key information, orchestrate intelligent responses, and power an interactive web front-end for exploring insights using natural language.
 
 ### Solution architecture
 |![image](./documents/Images/ReadMe/solution-architecture.png)|
@@ -101,14 +101,13 @@ _Note: This is not meant to outline all costs as selected SKUs, scaled use, cust
 | [Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry) | Used to orchestrate and build AI workflows that combine Azure AI services. | Free Tier | [Pricing](https://azure.microsoft.com/pricing/details/ai-studio/) |
 | [Foundry IQ](https://learn.microsoft.com/en-us/azure/search/search-what-is-azure-search) | Powers vector-based semantic search for retrieving indexed conversation data. | Standard S1; costs scale with document count and replica/partition settings. | [Pricing](https://azure.microsoft.com/pricing/details/search/) |
 | [Azure Storage Account](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-overview) | Stores transcripts, intermediate outputs, and application assets. | Standard LRS; usage-based cost by storage/operations. | [Pricing](https://azure.microsoft.com/pricing/details/storage/blobs/) |
-| [Azure Key Vault](https://learn.microsoft.com/en-us/azure/key-vault/general/overview) | Secures secrets, credentials, and keys used across the application. | Standard Tier; cost per operation (e.g., secret retrieval). | [Pricing](https://azure.microsoft.com/pricing/details/key-vault/) |
+
 | [Azure AI Services (OpenAI)](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/overview) | Enables language understanding, summarization, entity extraction, and chat capabilities using GPT models. | S0 Tier; pricing depends on token volume and model used (e.g., GPT-4o-mini). | [Pricing](https://azure.microsoft.com/pricing/details/cognitive-services/) |
 | [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview) | Hosts microservices and APIs powering the front-end and backend orchestration. | Consumption plan with 0.5 vCPU, 1GiB memory; includes a free usage tier. | [Pricing](https://azure.microsoft.com/pricing/details/container-apps/) |
 | [Azure Container Registry](https://learn.microsoft.com/en-us/azure/container-registry/container-registry-intro) | Stores and serves container images used by Azure Container Apps. | Basic Tier; fixed daily cost per registry. | [Pricing](https://azure.microsoft.com/pricing/details/container-registry/) |
 | [Azure Monitor / Log Analytics](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/log-analytics-overview) | Collects and analyzes telemetry and logs from services and containers. | Pay-as-you-go; charges based on data ingestion volume. | [Pricing](https://azure.microsoft.com/pricing/details/monitor/) |
 | [Azure SQL Database](https://learn.microsoft.com/en-us/azure/azure-sql/database/sql-database-paas-overview) | Stores structured data including insights, metadata, and indexed results. | General Purpose Tier; can be provisioned or serverless. Fixed cost if provisioned. | [Pricing](https://azure.microsoft.com/pricing/details/azure-sql-database/single/) |
 | [Azure Cosmos DB](https://learn.microsoft.com/en-us/azure/cosmos-db/introduction) | Used for fast, globally distributed NoSQL data storage for chat history and vector metadata. | Autoscale or provisioned throughput; fixed minimum cost if provisioned. | [Pricing](https://azure.microsoft.com/en-us/pricing/details/cosmos-db/autoscale-provisioned/) |
-| [Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/functions-overview) | Executes lightweight, serverless backend logic and event-driven workflows. | Consumption Tier; billed per execution and duration. | [Pricing](https://azure.microsoft.com/en-us/pricing/details/functions/) |
 
 
 <br/>
@@ -173,9 +172,7 @@ Supporting documentation
 
 ### Security guidelines
 
-This solution uses [Azure Key Vault](https://learn.microsoft.com/en-us/azure/key-vault/general/overview) to securely store secrets, connection strings, and API keys required by application components.
-
-It also leverages [Managed Identity](https://learn.microsoft.com/en-us/entra/identity/managed-identities-azure-resources/overview) for secure access to Azure resources during local development and production deployment, eliminating the need for hard-coded credentials.
+This solution leverages [Managed Identity](https://learn.microsoft.com/en-us/entra/identity/managed-identities-azure-resources/overview) for secure access to Azure resources during local development and production deployment, eliminating the need for hard-coded credentials.
 
 To maintain strong security practices, it is recommended that GitHub repositories built on this solution enable [GitHub secret scanning](https://docs.github.com/code-security/secret-scanning/about-secret-scanning) to detect accidental secret exposure.
 

azure.yaml

@@ -18,7 +18,10 @@ hooks:
       run: |
         Write-Host "Web app URL: "
         Write-Host "$env:WEB_APP_URL" -ForegroundColor Cyan
-        Write-Host "`nCreate and activate a virtual environment if not already done, then run the following command in your Bash terminal. It will grant the necessary permissions between resources and your user account, and also process and load the sample data into the application."
+
+        Write-Host "`nCreate and activate a virtual environment if not already done, then run the following command in the bash terminal to create agents:"
+        Write-Host "bash ./infra/scripts/run_create_agents_scripts.sh" -ForegroundColor Cyan
+        Write-Host "`nRun the following command in your Bash terminal. It will grant the necessary permissions between resources and your user account, and also process and load the sample data into the application."
         Write-Host "bash ./infra/scripts/process_sample_data.sh" -ForegroundColor Cyan
       shell: pwsh
       continueOnError: false
@@ -27,8 +30,11 @@ hooks:
       run: |
         echo "Web app URL: "
         echo $WEB_APP_URL
+
+        echo "\nCreate and activate a virtual environment if not already done, then run the following command in the bash terminal to create agents:"
+        echo "bash ./infra/scripts/run_create_agents_scripts.sh"
         echo ""
-        echo "Create and activate a virtual environment if not already done, then run the following command in your Bash terminal. It will grant the necessary permissions between resources and your user account, and also process and load the sample data into the application."
+        echo "\nRun the following command in your Bash terminal. It will grant the necessary permissions between resources and your user account, and also process and load the sample data into the application."
         echo "bash ./infra/scripts/process_sample_data.sh"
       shell: sh
       continueOnError: false

documents/CustomizeData.md

@@ -31,7 +31,7 @@ If you would like to update the solution to leverage your own data please follow
       <AI-Search-Name> <Search-Endpoint> \
       <AI-Foundry-Resource-ID> <CU-Foundry-Resource-ID> \
       <OpenAI-Endpoint> <Embedding-Model> <Deployment-Model> \
-      <CU-Endpoint> <AI-Agent-Endpoint> <CU-API-Version>
+      <CU-Endpoint> <CU-API-Version> <AI-Agent-Endpoint>
     ```
 
 ## How to Login to VM Using Azure Bastion

documents/DeploymentGuide.md

@@ -345,7 +345,33 @@ az login
 az login --use-device-code
 ```
 
-**4. Run the sample data processing script:**
+**4. Run the create agent script:**
+
+The `azd up` deployment output includes a ready-to-use bash script command. Look for the script in the deployment output and run it:
+
+```bash
+bash ./infra/scripts/run_create_agents_scripts.sh
+```
+
+**If you don't have `azd env` configured**, you'll need to pass parameters manually. The parameters are grouped by service for clarity:
+
+```bash
+bash ./infra/scripts/run_create_agents_scripts.sh \
+   <project-endpoint> <solution-name> <gpt-model-name> \
+   <ai-foundry-resource-id> <api-app-name> <azure-ai-search-connection-name> \
+   <azure-ai-search-index> <resource-group>
+```
+
+**Parameter Descriptions:**
+- **AI Foundry Parameters:** AI Foundry project endpoint URL and resource ID
+- **Solution Parameters:** Solution deployment name
+- **AI Model Parameters:** Deployed GPT model name
+- **Application Parameters:** API application name
+- **Search Parameters:** Azure AI Search connection name and index name
+- **Resource Group Parameters:** Azure resource group name
+
+
+**5. Run the sample data processing script:**
 
 The `azd up` deployment output includes a ready-to-use bash script command. Look for the script in the deployment output and run it:
 
@@ -363,7 +389,7 @@ bash ./infra/scripts/process_sample_data.sh \
   <AI-Search-Name> <Search-Endpoint> \
   <AI-Foundry-Resource-ID> <CU-Foundry-Resource-ID> \
   <OpenAI-Endpoint> <Embedding-Model> <Deployment-Model> \
-  <CU-Endpoint> <AI-Agent-Endpoint> <CU-API-Version> <Use-Case>
+  <CU-Endpoint> <CU-API-Version> <AI-Agent-Endpoint> <Use-Case>
 ```
 
 **Parameter Descriptions:**

documents/LocalDevelopmentSetup.md

@@ -532,6 +532,12 @@ AZURE_EXISTING_AI_PROJECT_RESOURCE_ID=<ai-project-resource-id>
 AZURE_AI_AGENT_ENDPOINT=<ai-agent-endpoint>
 AZURE_AI_AGENT_MODEL_DEPLOYMENT_NAME=<agent-model-deployment>
 
+# Agent Framework v2 Configuration (Set by deployment)
+AI_FOUNDRY_RESOURCE_ID=<ai-foundry-resource-id>
+API_APP_NAME=<api-app-name>
+AGENT_NAME_CONVERSATION=<conversation-agent-name>
+AGENT_NAME_TITLE=<title-agent-name>
+
 # Azure AI Search Configuration
 AZURE_AI_SEARCH_ENDPOINT=<search-endpoint>
 AZURE_AI_SEARCH_INDEX=call_transcripts_index
@@ -573,6 +579,7 @@ REACT_APP_LAYOUT_CONFIG=<layout-config-json>
 > - Set `APP_ENV=dev` for local development. This enables Azure CLI authentication.
 > - Ensure you're logged in via `az login` before running the backend.
 > - Set `APP_ENV=prod` only when deploying to Azure App Service with Managed Identity.
+> - **Agent Framework v2 Variables**: The `AI_FOUNDRY_RESOURCE_ID` and `API_APP_NAME` are automatically set during `azd up`. The `AGENT_NAME_CONVERSATION` and `AGENT_NAME_TITLE` are populated when you run the `run_create_agents_scripts.sh` script (see Step 4.4 in [Deployment Guide](./DeploymentGuide.md)).
 
 ### 4.3. Install Backend API Dependencies
 

infra/main.bicep

@@ -742,6 +742,8 @@ module cognitiveServicesCu 'br/public:avm/res/cognitive-services/account:0.14.1'
 // ========== AVM WAF ========== //
 // ========== AI Foundry: AI Search ========== //
 var aiSearchName = 'srch-${solutionSuffix}'
+var aiSearchConnectionName = 'foundry-search-connection-${solutionSuffix}'
+
 resource searchService 'Microsoft.Search/searchServices@2024-06-01-preview' = {
   name: aiSearchName
   location: location
@@ -847,7 +849,7 @@ resource searchServiceToAiServicesRoleAssignment 'Microsoft.Authorization/roleAs
 }
 
 resource projectAISearchConnection 'Microsoft.CognitiveServices/accounts/projects/connections@2025-10-01-preview' = if (!useExistingAiFoundryAiProject) {
-  name: '${aiFoundryAiServicesResourceName}/${aiFoundryAiServicesAiProjectResourceName}/${aiSearchName}'
+  name: '${aiFoundryAiServicesResourceName}/${aiFoundryAiServicesAiProjectResourceName}/${aiSearchConnectionName}'
   properties: {
     category: 'CognitiveSearch'
     target: 'https://${aiSearchName}.search.windows.net'
@@ -873,7 +875,7 @@ module existing_AIProject_SearchConnectionModule 'modules/deploy_aifp_aisearch_c
     aiSearchName: aiSearchName
     aiSearchResourceId: searchService.id
     aiSearchLocation: searchService.location
-    aiSearchConnectionName: aiSearchName
+    aiSearchConnectionName: aiSearchConnectionName
   }
 }
 
@@ -1298,6 +1300,10 @@ module webSiteBackend 'modules/web-sites.bicep' = {
         name: 'appsettings'
         properties: {
           REACT_APP_LAYOUT_CONFIG: reactAppLayoutConfig
+          AGENT_NAME_CONVERSATION: ''
+          AGENT_NAME_TITLE: ''
+          API_APP_NAME: 'api-${solutionSuffix}'
+          AZURE_AI_FOUNDRY_RESOURCE_ID: !empty(existingAiFoundryAiProjectResourceId) ? existingAiFoundryAiProjectResourceId : aiFoundryAiServices.outputs.resourceId
           AZURE_OPENAI_DEPLOYMENT_MODEL: gptModelName
           AZURE_OPENAI_ENDPOINT: !empty(existingOpenAIEndpoint) ? existingOpenAIEndpoint : 'https://${aiFoundryAiServices.outputs.name}.openai.azure.com/'
           AZURE_OPENAI_API_VERSION: azureOpenAIApiVersion
@@ -1414,7 +1420,7 @@ output AZURE_AI_SEARCH_ENDPOINT string = 'https://${aiSearchName}.search.windows
 output AZURE_AI_SEARCH_INDEX string = 'call_transcripts_index'
 
 @description('Contains Azure AI Search connection name.')
-output AZURE_AI_SEARCH_CONNECTION_NAME string = aiSearchName
+output AZURE_AI_SEARCH_CONNECTION_NAME string = aiSearchConnectionName
 
 @description('Contains Azure Cosmos DB account name.')
 output AZURE_COSMOSDB_ACCOUNT string = cosmosDb.outputs.name
@@ -1518,5 +1524,17 @@ output CU_FOUNDRY_RESOURCE_ID string = cognitiveServicesCu.outputs.resourceId
 @description('Azure OpenAI Content Understanding endpoint URL.')
 output AZURE_OPENAI_CU_ENDPOINT string = cognitiveServicesCu.outputs.endpoint
 
+@description('Contains API application name.')
+output API_APP_NAME string = 'api-${solutionSuffix}'
+
+@description('Contains AI Foundry resource ID.')
+output AZURE_AI_FOUNDRY_RESOURCE_ID string = !empty(existingAiFoundryAiProjectResourceId) ? existingAiFoundryAiProjectResourceId : aiFoundryAiServices.outputs.resourceId
+
+@description('Contains Conversation Agent name.')
+output AGENT_NAME_CONVERSATION string = ''
+
+@description('Contains Title Agent name.')
+output AGENT_NAME_TITLE string = ''
+
 @description('Industry Use Case.')
 output USE_CASE string = usecase