added logs

Author: AjitPadhi-Microsoft

infra/main.bicep

@@ -745,7 +745,7 @@ module aiSearch 'br/public:avm/res/search/search-service:0.11.1' = {
 }
 
 resource aiSearchFoundryConnection 'Microsoft.CognitiveServices/accounts/projects/connections@2025-04-01-preview' = if (!useExistingAiFoundryAiProject) {
-  name: '${aiFoundryAiServicesResourceName}/${aiFoundryAiProjectResourceName}/${aiSearchName}'
+  name: '${aiFoundryAiServicesResourceName}/${aiFoundryAiProjectResourceName}/${aiSearchConnectionName}'
   properties: {
     category: 'CognitiveSearch'
     target: 'https://${aiSearchName}.search.windows.net'

src/backend/api/agent/template_agent_factory.py

@@ -18,11 +18,35 @@ async def create_or_get_agent(cls):
         Returns:
             object: The created agent instance.
         """
-        project_client = AIProjectClient(
-            endpoint=app_settings.azure_ai.agent_endpoint,
-            credential=await get_azure_credential_async(client_id=app_settings.base_settings.azure_client_id),
-            api_version=app_settings.azure_ai.agent_api_version
-        )
+        try:
+            project_client = AIProjectClient(
+                endpoint=app_settings.azure_ai.agent_endpoint,
+                credential=await get_azure_credential_async(client_id=app_settings.base_settings.azure_client_id),
+                api_version=app_settings.azure_ai.agent_api_version
+            )
+            
+            # Test the connection early to provide better error messages
+            agents_list = project_client.agents.list_agents()
+            await agents_list.__anext__()  # Try to get first agent to test connectivity
+            
+        except Exception as e:
+            error_msg = f"Failed to connect to Azure AI Project endpoint '{app_settings.azure_ai.agent_endpoint}'. "
+            
+            if "Cannot connect to host" in str(e):
+                error_msg += "This is likely a private endpoint DNS resolution issue. Please ensure:\n"
+                error_msg += "1. The private endpoint has a DNS zone group configured\n"
+                error_msg += "2. The private DNS zone 'privatelink.cognitiveservices.azure.com' is linked to your VNet\n"
+                error_msg += "3. Your App Service has VNet integration enabled\n"
+            
+            error_msg += f"Original error: {str(e)}"
+            
+            track_event_if_configured("TemplateAgentConnectionError", {
+                "error": str(e),
+                "endpoint": app_settings.azure_ai.agent_endpoint,
+                "error_type": "connection_failed"
+            })
+            
+            raise Exception(error_msg)
 
         agent_name = f"DG-TemplateAgent-{app_settings.base_settings.solution_name}"
         # 1. Check if the agent already exists
@@ -44,16 +68,40 @@ async def create_or_get_agent(cls):
             "titleField": "sourceurl",
         }
 
-        project_index = await project_client.indexes.create_or_update(
-            name=index_name,
-            version=index_version,
-            body={
-                "connectionName": app_settings.datasource.connection_name,
-                "indexName": app_settings.datasource.index,
-                "type": "AzureSearch",
-                "fieldMapping": field_mapping
-            }
-        )
+        try:
+            project_index = await project_client.indexes.create_or_update(
+                name=index_name,
+                version=index_version,
+                body={
+                    "connectionName": app_settings.datasource.connection_name,
+                    "indexName": app_settings.datasource.index,
+                    "type": "AzureSearch",
+                    "fieldMapping": field_mapping
+                }
+            )
+        except Exception as e:
+            error_msg = f"Failed to create or update project index '{index_name}'. "
+            
+            if "Cannot connect to host" in str(e) and "search.windows.net" in str(e):
+                error_msg += "This is likely a private endpoint DNS resolution issue for Azure AI Search. Please ensure:\n"
+                error_msg += "1. The Azure AI Search private endpoint has a DNS zone group configured\n"
+                error_msg += "2. The private DNS zone 'privatelink.search.windows.net' exists and is linked to your VNet\n"
+                error_msg += "3. Your App Service has VNet integration to the same VNet as the private endpoints\n"
+                error_msg += f"4. The search service endpoint resolves correctly from within the VNet\n"
+                
+            error_msg += f"Connection name: {app_settings.datasource.connection_name}, "
+            error_msg += f"Index: {app_settings.datasource.index}, "
+            error_msg += f"Original error: {str(e)}"
+            
+            track_event_if_configured("TemplateAgentIndexCreationError", {
+                "error": str(e),
+                "index_name": index_name,
+                "connection_name": app_settings.datasource.connection_name,
+                "index": app_settings.datasource.index,
+                "error_type": "search_connection_failed"
+            })
+            
+            raise Exception(error_msg)
 
         ai_search = AzureAISearchTool(
             index_asset_id=f"{project_index.name}/versions/{project_index.version}",