Skip to content

Commit 874b8f7

Browse files
ferantiverockittel
andauthored
topic (docs): [general] rebrand Azure AI Agent service to Azure AI Foundry Agent Service (#50)
* rebrand Azure AI Agent service to Azure AI Foundry Agent Service * fix: include bicep files * Address PR Feedback: shorten texts and caps fixes Co-authored-by: Chad Kittel <[email protected]> --------- Co-authored-by: Chad Kittel <[email protected]>
1 parent fa3ecb5 commit 874b8f7

File tree

6 files changed

+25
-25
lines changed

6 files changed

+25
-25
lines changed

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Contributing to the Azure OpenAI and AI Agent service chat basic reference implementatio
1+
# Contributing to the Azure AI Foundry Agent service chat basic reference implementatio
22

33
This project welcomes contributions and suggestions. Most contributions require you to agree to a
44
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us

README.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,30 @@
1-
# Azure OpenAI and AI Agent service chat basic reference implementation
1+
# Azure AI Foundry Agent service chat basic reference implementation
22

3-
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 [Basic end-to-end chat reference architecture](https://learn.microsoft.com/azure/architecture/ai-ml/architecture/basic-openai-e2e-chat) on Microsoft Learn.
3+
This reference implementation illustrates an approach running a chat application and an AI orchestration layer in a single region. It uses Azure AI Foundry Agent service as the orchestrator and Azure OpenAI foundation models. This repository directly supports the [Basic end-to-end chat reference architecture](https://learn.microsoft.com/azure/architecture/ai-ml/architecture/basic-openai-e2e-chat) on Microsoft Learn.
44

5-
The reference implementation illustrates a basic example of a chat application. For a reference implementation that implements more enterprise requirements, please see the [OpenAI end-to-end baseline reference implementation](https://github.com/Azure-Samples/openai-end-to-end-baseline). That implementation addresses many of the [production readiness changes](https://github.com/search?q=repo%3AAzure-Samples%2Fopenai-end-to-end-basic+%22Production+readiness+change%22&type=code) identified in this code.
5+
The reference implementation illustrates a basic example of a chat application. For a reference implementation that implements more enterprise requirements, please see the [Azure AI Foundry Agent service end-to-end baseline reference implementation](https://github.com/Azure-Samples/openai-end-to-end-baseline). That implementation addresses many of the [production readiness changes](https://github.com/search?q=repo%3AAzure-Samples%2Fopenai-end-to-end-basic+%22Production+readiness+change%22&type=code) identified in this code.
66

77
## Architecture
88

99
The implementation covers the following scenarios:
1010

1111
- [Setting up Azure AI Foundry to host agents](#setting-up-azure-ai-foundry-to-host-agents)
12-
- [Deploying an agent into Azure AI Agent service](#deploying-an-agent-into-azure-ai-agent-service)
12+
- [Deploying an agent into Azure AI Foundry Agent service](#deploying-an-agent-into-azure-ai-agent-service)
1313
- [Invoking the agent from .NET code hosted in an Azure Web App](#invoking-the-agent-from-net-code-hosted-in-an-azure-web-app)
1414

1515
### Setting up Azure AI Foundry to host agents
1616

17-
Azure AI Foundry hosts Azure AI Agent service as a capability. Azure AI Agent service's REST APIs are exposed as a AI Foundry internet facing endpoing. This architecture deploys the Azure AI Agent service your own Azure subscription.
17+
Azure AI Foundry hosts Azure AI Foundry Agent service as a capability. Foundry Agent Service's REST APIs are exposed as an internet facing endpoint.
1818

19-
### Deploying an agent into Azure AI Agent service
19+
### Deploying an agent into Azure AI Foundry Agent service
2020

21-
Agents can be created via the Azure AI Foundry portal, [Azure AI Agents SDK](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/ai/Azure.AI.Agents.Persistent), or the [REST API](https://learn.microsoft.com/rest/api/aifoundry/aiagents/). The creation and invocation of agents are a data plane operation.
21+
Agents can be created via the Azure AI Foundry portal, [Azure AI Persistent Agents client library](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/ai/Azure.AI.Agents.Persistent), or the [REST API](https://learn.microsoft.com/rest/api/aifoundry/aiagents/). The creation and invocation of agents are a data plane operation.
2222

2323
Ideally agents should be source-controlled and a versioned asset. You then can deploy agents in a coordinated way with the rest of your workload's code. In this deployment guide, you'll create an agent through the REST API to simulate a deployment pipeline which could have created the agent.
2424

2525
### Invoking the agent from .NET code hosted in an Azure Web App
2626

27-
A chat UI application is deployed into Azure App Service. The .NET code uses the [Azure AI Agents SDK](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/ai/Azure.AI.Agents.Persistent) to connect to the workload's agent. The endpoint for the agent is exposed over internet through the Azure AI Foundry.
27+
A chat UI application is deployed into Azure App Service. The .NET code uses the [Azure AI Persistent Agents client library](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/ai/Azure.AI.Agents.Persistent) to connect to the workload's agent. The endpoint for the agent is exposed over internet through the Azure AI Foundry.
2828

2929
## Deployment guide
3030

@@ -105,7 +105,7 @@ The following steps are required to deploy the infrastructure from the command l
105105
-p yourPrincipalId=$PRINCIPAL_ID
106106
```
107107

108-
### 2. Deploy an agent in the Azure AI Agent service
108+
### 2. Deploy an agent in the Azure AI Foundry Agent service
109109

110110
To test this scenario, you'll be deploying an AI agent. The agent uses a GPT model combined with a Bing search for grounding data. Deploying an AI agent requires data plane access to Azure AI Foundry. In this architecture, you will interact with the Azure AI Foundry portal and its resources over internet.
111111

@@ -123,7 +123,7 @@ To test this scenario, you'll be deploying an AI agent. The agent uses a GPT mod
123123

124124
1. Click **+ Add** button in the Knowledge section.
125125

126-
1. From the popup window select the knowledge type 'Grounding with Bing Search'.
126+
1. From the popup window select the knowledge type 'Grounding with Bing Search'.
127127

128128
1. Then choose the existing connection named 'bingaiagent' and click the **Connect** button.
129129

@@ -177,7 +177,7 @@ Workloads build chat functionality into an application. Those interfaces usually
177177

178178
> Sometimes the prior command will fail with a `GatewayTimeout`. If you receive that error, you're safe to simply execute the command again.
179179
180-
### 5. Try it out! Test the deployed application that calls into the Azure AI Agent service
180+
### 5. Try it out! Test the deployed application that calls into the Azure AI Foundry Agent service
181181

182182
After the deployment is complete, you can try the deployed application by navigating to the Web App's URL in a web browser.
183183

@@ -209,4 +209,4 @@ Please see our [Contributor guide](./CONTRIBUTING.md).
209209

210210
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact <[email protected]> with any additional questions or comments.
211211

212-
With :heart: from Azure Patterns & Practices, [Azure Architecture Center](https://azure.com/architecture).
212+
With :heart: from Azure Patterns & Practices, [Azure Architecture Center](https://azure.com/architecture).

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ param location string = resourceGroup().location
88
@minLength(2)
99
param existingAiFoundryName string
1010

11-
@description('The existing Bing grounding data account that is available to Azure AI Agent agents in this project.')
11+
@description('The existing Bing grounding data account that is available to Azure AI Foundry Agent agents in this project.')
1212
@minLength(1)
1313
param existingBingAccountName string
1414

@@ -40,7 +40,7 @@ resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' exi
4040
type: 'SystemAssigned'
4141
}
4242
properties: {
43-
description: 'Chat using internet data in your Azure AI Agent.'
43+
description: 'Chat using internet data in your Azure AI Foundry Agent.'
4444
displayName: 'Chat with Internet Data'
4545
}
4646

@@ -62,7 +62,7 @@ resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' exi
6262
}
6363
}
6464
}
65-
65+
6666
@description('Create project connection to Bing grounding data. Useful for future agents that get created.')
6767
resource bingGroundingConnection 'connections' = {
6868
name: replace(existingBingAccountName, '-', '')

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2025-02
3535

3636
// ---- New resources ----
3737

38-
@description('Deploy Azure AI Foundry (account) with Azure AI Agent service capability.')
38+
@description('Deploy Azure AI Foundry (account) with Azure AI Foundry Agent service capability.')
3939
resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' = {
4040
name: aiFoundryName
4141
location: location
@@ -59,7 +59,7 @@ resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' = {
5959
publicNetworkAccess: 'Enabled'
6060
}
6161

62-
@description('Models are managed at the account level. Deploy the GPT model that will be used for the Azure AI Agent logic.')
62+
@description('Models are managed at the account level. Deploy the GPT model that will be used for the Azure AI Foundry Agent logic.')
6363
resource model 'deployments' = {
6464
name: 'agent-model'
6565
sku: {

infra-as-code/bicep/main.bicep

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -40,9 +40,9 @@ resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2025-02
4040
}
4141
}
4242

43-
// Deploy the Azure AI Foundry account and Azure AI Agent service components.
43+
// Deploy the Azure AI Foundry account and Azure AI Foundry Agent service components.
4444

45-
@description('Deploy Azure AI Foundry with Azure AI Agent capability. No projects yet deployed.')
45+
@description('Deploy Azure AI Foundry with Azure AI Foundry Agent capability. No projects yet deployed.')
4646
module deployAzureAIFoundry 'ai-foundry.bicep' = {
4747
scope: resourceGroup()
4848
name: 'aiFoundryDeploy'
@@ -54,13 +54,13 @@ module deployAzureAIFoundry 'ai-foundry.bicep' = {
5454
}
5555
}
5656

57-
@description('Deploy the Bing account for Internet grounding data to be used by agents in the Azure AI Agent service.')
57+
@description('Deploy the Bing account for Internet grounding data to be used by agents in the Azure AI Foundry Agent Service.')
5858
module deployBingAccount 'bing-grounding.bicep' = {
5959
scope: resourceGroup()
6060
name: 'bingAccountDeploy'
6161
}
6262

63-
@description('Deploy the Azure AI Foundry project into the AI Foundry account. This is the project is the home of the Azure AI Agent service.')
63+
@description('Deploy the Azure AI Foundry project into the AI Foundry account. This is the project is the home of the Foundry Agent Service.')
6464
module deployAzureAiFoundryProject 'ai-foundry-project.bicep' = {
6565
scope: resourceGroup()
6666
name: 'aiFoundryProjectDeploy'
@@ -85,7 +85,7 @@ module deployApplicationInsights 'application-insights.bicep' = {
8585
}
8686
}
8787

88-
@description('Deploy the web app for the front end demo UI. The web application will call into the Azure AI Agent service.')
88+
@description('Deploy the web app for the front end demo UI. The web application will call into the Azure AI Foundry Agent Service.')
8989
module deployWebApp 'web-app.bicep' = {
9090
scope: resourceGroup()
9191
name: 'webAppDeploy'

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ param logAnalyticsWorkspaceName string
2121
@minLength(1)
2222
param existingWebApplicationInsightsResourceName string
2323

24-
@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.')
24+
@description('The name of the existing Azure AI Foundry instance that the Azure Web App code will be calling for Foundry Agent Service agents.')
2525
@minLength(2)
2626
param existingAzureAiFoundryResourceName string
2727

@@ -49,7 +49,7 @@ resource azureAiUserRole 'Microsoft.Authorization/roleDefinitions@2022-04-01' ex
4949
scope: subscription()
5050
}
5151

52-
@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.')
52+
@description('Existing Azure AI Foundry account. This account is where the agents hosted in Foundry Agent Service will be deployed. The web app code calls to these agents.')
5353
resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-04-01-preview' existing = {
5454
name: existingAzureAiFoundryResourceName
5555

0 commit comments

Comments
 (0)