Branding push

Author: ckittel

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing to the Azure OpenAI and AI Agent Service chat baseline reference implementation
+# Contributing to the Azure OpenAI and AI Agent service chat baseline reference implementation
 
 This project welcomes contributions and suggestions.  Most contributions require you to agree to a
 Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us

README.md

@@ -1,6 +1,6 @@
-# Azure OpenAI and AI Agent Service chat baseline reference implementation
+# Azure OpenAI and AI Agent service chat baseline reference implementation
 
-This reference implementation illustrates an approach running a chat application and an AI orchstration layer in a single region. It uses Azure AI Agent service as the orchestrator and Azure OpenAI foundation models. This repository directly supports the [Baseline end-to-end chat reference architecture](https://learn.microsoft.com/azure/architecture/ai-ml/architecture/baseline-openai-e2e-chat) on Microsoft Learn.
+This reference implementation illustrates an approach running a chat application and an AI orchestration layer in a single region. It uses Azure AI Agent service as the orchestrator and Azure OpenAI foundation models. This repository directly supports the [Baseline end-to-end chat reference architecture](https://learn.microsoft.com/azure/architecture/ai-ml/architecture/baseline-openai-e2e-chat) on Microsoft Learn.
 
 Follow this implementation to deploy an agent in [Azure AI Foundry](https://learn.microsoft.com/azure/ai-studio/how-to/prompt-flow) and uses Bing for grounding data. You'll be exposed to common generative AI chat application characteristics such as:
 
@@ -13,15 +13,15 @@ Follow this implementation to deploy an agent in [Azure AI Foundry](https://lear
 This implementation builds off the [basic implementation](https://github.com/Azure-Samples/openai-end-to-end-basic), and adds common production requirements such as:
 
 - Network isolation
-- Bring-your-own Azure AI Agent service depdendencies (for security and BC/DR control)
+- Bring-your-own Azure AI Agent service dependencies (for security and BC/DR control)
 - Added availability zone reliability
 
 ## Architecture
 
 The implementation covers the following scenarios:
 
 - [Setting up Azure AI Foundry to host agents](#setting-up-azure-ai-foundry-to-host-agents)
-- [Deploying an agent into Azure AI Agent Service](#deploying-an-agent-into-azure-ai-agent-service)
+- [Deploying an agent into Azure AI Agent service](#deploying-an-agent-into-azure-ai-agent-service)
 - [Invoking the agent from .NET code hosted in an Azure Web App](#invoking-the-agent-from-net-code-hosted-in-an-azure-web-app)
 
 ### Setting up Azure AI Foundry to host agents
@@ -34,7 +34,7 @@ The authoring architecture diagram illustrates how flow authors [connect to an A
 
 The diagram further illustrates how AI Foundry is configured for [managed virtual network isolation](https://learn.microsoft.com/azure/ai-studio/how-to/configure-managed-network). With this configuration, a managed virtual network is created, along with managed private endpoints enabling connectivity to private resources such as the project's Azure Storage and Azure Container Registry. You can also create user-defined connections like private endpoints to connect to resources like Azure OpenAI service and Azure AI Search.
 
-### Deploying an agent into Azure AI Agent Service
+### Deploying an agent into Azure AI Agent service
 
 TODO: Write this
 
@@ -209,7 +209,7 @@ The AI agent definition would likely be deployed from your application's pipelin
    $LOCATION="eastus2"
    ```
 
-1. Generate some varibles to set context within your jump box.
+1. Generate some variables to set context within your jump box.
 
    *The following variables align with the defaults in this deployment. Update them if you customized anything.*
 
@@ -252,7 +252,7 @@ Here you'll test your orchestration agent by invoking it directly from the Azure
 
 1. Open the Azure portal to your subscription.
 
-   You'll need to sign in to the Azure portal, and resolve any Entra ID Conditional Acces policies on your account, if this is the first time you are connecting through the jump box.
+   You'll need to sign in to the Azure portal, and resolve any Entra ID Conditional Access policies on your account, if this is the first time you are connecting through the jump box.
 
 1. Navigate to the Azure AI Foundry project named **projchat** in your resource group and open the Azure AI Foundry portal by clicking the **Go to Azure AI Foundry portal** button.
 
@@ -295,7 +295,7 @@ For this deployment guide, you'll continue using your jump box to simulate part
 1. Update the app configuration to use the agent you deployed.
 
    ```powershell
-   // TODO -- Fill this out once the code is no longer creating the agent.
+   # TODO -- Fill this out once the code is no longer creating the agent.
    ```
 
 1. Restart the web app to launch the site.
@@ -352,11 +352,11 @@ az cognitiveservices account purge -g $RESOURCE_GROUP -l $LOCATION -n aif${BASE_
 ```
 
 > [!TIP]
-> The `vnet-workload` and associated networking resources are sometimes blocked from being deleted with the above instructions. This is because the Azure AI Agent subnet (`snet-agentsEgress`) retains a latent Microsoft-managed deletgated connection (`serviceAssociationLink`) to the deleted AI Agent Service backend. The virtual network and associated resources typically become free to delete about an hour after purging the Azure AI Foundry account.
+> The `vnet-workload` and associated networking resources are sometimes blocked from being deleted with the above instructions. This is because the Azure AI Agent subnet (`snet-agentsEgress`) retains a latent Microsoft-managed deletgated connection (`serviceAssociationLink`) to the deleted AI Agent service backend. The virtual network and associated resources typically become free to delete about an hour after purging the Azure AI Foundry account.
 >
 > The lingering resources do not have a cost associated with them existing in your subscription.
 >
-> If the resource group didn't fully delete, reexeucte the `az group delete -n $RESOURCE_GROUP -y` command after an hour to complete the cleanup.
+> If the resource group didn't fully delete, re-execute the `az group delete -n $RESOURCE_GROUP -y` command after an hour to complete the cleanup.
 
 ## Contributions
 

infra-as-code/bicep/ai-agent-service-dependencies.bicep

@@ -24,7 +24,7 @@ param privateEndpointSubnetResourceId string
 
 // ---- New resources ----
 
-@description('Deploy Azure Storage account for the Azure AI Agent Service (dependency). This is used for binaries uploaded within threads or as "knowledge" uploaded as part of an agent.')
+@description('Deploy Azure Storage account for the Azure AI Agent service (dependency). This is used for binaries uploaded within threads or as "knowledge" uploaded as part of an agent.')
 module deployAgentStorageAccount 'ai-agent-blob-storage.bicep' = {
   scope: resourceGroup()
   params: {
@@ -36,7 +36,7 @@ module deployAgentStorageAccount 'ai-agent-blob-storage.bicep' = {
   }
 }
 
-@description('Deploy Azure Cosmos DB account for the Azure AI Agent Service (dependency). This is used for storing agent definitions and threads.')
+@description('Deploy Azure Cosmos DB account for the Azure AI Agent service (dependency). This is used for storing agent definitions and threads.')
 module deployCosmosDbThreadStorageAccount 'cosmos-db.bicep' = {
   scope: resourceGroup()
   params: {
@@ -48,7 +48,7 @@ module deployCosmosDbThreadStorageAccount 'cosmos-db.bicep' = {
   }
 }
 
-@description('Deploy Azure AI Search instance for the Azure AI Agent Service (dependency). This is used when a user uploads a file to the agent, and the agent needs to search for information in that file.')
+@description('Deploy Azure AI Search instance for the Azure AI Agent service (dependency). This is used when a user uploads a file to the agent, and the agent needs to search for information in that file.')
 module deployAzureAISearchService 'ai-search.bicep' = {
   scope: resourceGroup()
   params: {

infra-as-code/bicep/ai-foundry-project.bicep

@@ -151,7 +151,7 @@ resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' exi
       displayName: 'ChatWithInternetData'
     }
 
-    @description('Create project connection to CosmosDB (thread storage); dependency for Azure AI Agent Service.')
+    @description('Create project connection to CosmosDB (thread storage); dependency for Azure AI Agent service.')
     resource threadStorageConnection 'connections' = {
       name: cosmosDbAccount.name
       properties: {
@@ -169,7 +169,7 @@ resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' exi
       ]
     }
 
-    @description('Create project connection to the Azure Storage account; dependency for Azure AI Agent Service.')
+    @description('Create project connection to the Azure Storage account; dependency for Azure AI Agent service.')
     resource storageConnection 'connections' = {
       name: agentStorageAccount.name
       properties: {
@@ -189,7 +189,7 @@ resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' exi
       ]
     }
 
-    @description('Create project connection to Azure AI Search; dependency for Azure AI Agent Service.')
+    @description('Create project connection to Azure AI Search; dependency for Azure AI Agent service.')
     resource aiSearchConnection 'connections' = {
       name: azureAISearchService.name
       properties: {
@@ -232,7 +232,7 @@ resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' exi
     }
 
 
-    @description('Create the Azure AI Agent Service.')
+    @description('Create the Azure AI Agent service.')
     resource aiAgentService 'capabilityHosts' = {
       name: 'projectagents'
       properties: {
@@ -265,7 +265,7 @@ resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' exi
         isSharedToAll: false
       }
       dependsOn: [
-        aiAgentService  // Deploy after the Azure AI Agent Service is provisioned, not a dependency.
+        aiAgentService  // Deploy after the Azure AI Agent service is provisioned, not a dependency.
       ]
     }
   }

infra-as-code/bicep/cosmos-db.bicep

@@ -40,7 +40,7 @@ resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2025-02
 
 // ---- New resources ----
 
-@description('Deploy an Azure Cosmos DB account. This is a BYO dependency for the Azure AI Agent Service. It\'s used to store threads and agent definitions.')
+@description('Deploy an Azure Cosmos DB account. This is a BYO dependency for the Azure AI Agent service. It\'s used to store threads and agent definitions.')
 resource cosmosDbAccount 'Microsoft.DocumentDB/databaseAccounts@2024-12-01-preview' = {
   name: 'cdb-ai-agent-threads-${baseName}'
   location: location

infra-as-code/bicep/network.bicep

@@ -8,7 +8,7 @@ targetScope = 'resourceGroup'
 @minLength(1)
 param location string = resourceGroup().location
 
-// Azure AI Agent Service currently has a limitation on subnet prefixes.
+// Azure AI Agent service currently has a limitation on subnet prefixes.
 // 10.x was not supported, as such 192.168.x.x was used.
 var virtualNetworkAddressPrefix = '192.168.0.0/16'
 var appGatewaySubnetPrefix = '192.168.1.0/24'

infra-as-code/bicep/web-app.bicep

@@ -41,7 +41,7 @@ param existingWebAppDeploymentStorageAccountName string
 @minLength(1)
 param existingWebApplicationInsightsResourceName string
 
-@description('The name of the existing Azure AI Foundry instance that the the Azure Web App code will be calling for Azure AI Agent Service agents.')
+@description('The name of the existing Azure AI Foundry instance that the the Azure Web App code will be calling for Azure AI Agent service agents.')
 @minLength(2)
 param existingAzureAiFoundryResourceName string
 
@@ -102,7 +102,7 @@ resource appServiceExistingPrivateDnsZone 'Microsoft.Network/privateDnsZones@202
   name: 'privatelink.azurewebsites.net'
 }
 
-@description('Existing Azure AI Foundry account. This account is where the agents hosted in Azure AI Agent Service will be deployed. The web app code calls to these agents.')
+@description('Existing Azure AI Foundry account. This account is where the agents hosted in Azure AI Agent service will be deployed. The web app code calls to these agents.')
 resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' existing = {
   name: existingAzureAiFoundryResourceName
 }