Skip to content

Commit 48d5849

Browse files
committed
docs
1 parent 2d8e12a commit 48d5849

File tree

1 file changed

+20
-110
lines changed

1 file changed

+20
-110
lines changed

docs/docs/includes/introduction-self-guided.md

Lines changed: 20 additions & 110 deletions
Original file line numberDiff line numberDiff line change
@@ -88,127 +88,37 @@ The following resources will be created in the **rg-agent-workshop-****** resour
8888
8989
!!! warning "You will need 140K TPM quota availability for the gpt-4o-mini Global Standard SKU, not because the agent uses lots of tokens, but due to the frequency of calls made by the agent to the model. Review your quota availability in the [AI Foundry Management Center](https://ai.azure.com/managementCenter/quota){:target="_blank"}."
9090
91-
We have provided a bash script to automate the deployment of the resources required for the workshop. Alternatively, you may deploy resources manually using Azure AI Foundry studio. Select the desired tab.
91+
We have provided a bash script to automate the deployment of the resources required for the workshop.
9292
9393
=== "Automated deployment"
9494
95-
The script `deploy.sh` deploys to the `eastus2` region by default; edit the file to change the region or resource names. To run the script, open the VS Code terminal and run the following command:
95+
The script `deploy.sh` deploys to the `westus` region by default; edit the file to change the region or resource names. To run the script, open the VS Code terminal and run the following command:
9696
97-
```bash
98-
cd infra && ./deploy.sh
99-
```
100-
101-
<!-- !!! note "On Windows, run `deploy.ps1` instead of `deploy.sh`" -->
102-
103-
### Workshop Configuration
104-
105-
=== "Python"
106-
107-
The deploy script generates the **.env** file, which contains the project endpoint, model deployment name, and Bing connection name.
108-
109-
You'll see this file when you open the Python workspace in VS Code. Your **.env** file will look similar to this but with your project endpoint.
110-
111-
```python
112-
MODEL_DEPLOYMENT_NAME="gpt-4o-mini"
113-
PROJECT_ENDPOINT="<your_project_endpoint>"
114-
```
115-
=== "C#"
116-
117-
The automated deployment script stores project variables securely by using the Secret Manager feature for [safe storage of app secrets in development in ASP.NET Core](https://learn.microsoft.com/aspnet/core/security/app-secrets){:target="_blank"}.
118-
119-
You can view the secrets by running the following command after you have opened the C# workspace in VS Code:
120-
121-
```bash
122-
dotnet user-secrets list
123-
```
124-
125-
=== "Manual deployment"
126-
127-
Alternatively, if you prefer not to use the `deploy.sh` script you can deploy the resources manually using the Azure AI Foundry portal as follows:
128-
129-
1. Navigate to the [Azure AI Foundry](https://ai.azure.com){:target="_blank"} web portal using your browser and sign in with your account.
130-
2. Select **+ Create project**.
131-
132-
- Name the project
133-
134-
```text
135-
agent-workshop
136-
```
137-
138-
- Create a new hub named
139-
140-
```text
141-
agent-workshop-hub
142-
```
143-
144-
- Select **Create** and wait for the project to be created.
145-
3. From **My assets**, select **Models + endpoints**.
146-
4. Select **Deploy Model / Deploy Base Model**.
97+
```bash
98+
cd infra && ./deploy.sh
99+
```
147100
148-
- Select **gpt-4o-mini** from the model list, then select **Confirm**.
149-
- Name the deployment
101+
### Workshop Configuration
150102
151-
```text
152-
gpt-4o-mini
153-
```
154-
155-
- Deployment type: Select **Global Standard**.
156-
- Select **Customize**.
157-
- Model version: Select **2024-08-06**.
158-
- Tokens Per Minute Rate Limit: Select **140k**.
159-
- Select **Deploy**.
160-
161-
!!! note
162-
A specific version of GPT-4o may be required depending on your the region where you deployed your project.
163-
See [Models: Assistants (Preview)](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models?tabs=global-standard%2Cstandard-chat-completions#assistants-preview){:target="_blank"} for details.
164-
165-
### Workshop Configuration
166-
167-
You'll need the project endpoint to connect the agent app to the Azure AI Foundry project. You can find this string in the Azure AI Foundry portal in the Overview page for your Project `agent-workshop` (look in the Project details section).
168-
169-
=== "Python"
170-
171-
Create the workshop configuration file with the following command:
172-
173-
```bash
174-
cp src/python/workshop/.env.sample src/python/workshop/.env
175-
```
176-
177-
Then edit the file `src/python/workshop/.env` to provide the Project endpoint.
178-
179-
=== "C#"
180-
181-
1. Open a new terminal window in VS Code.
182-
2. Run the following command to set the C# project path $CSHARP_PROJECT_PATH variable:
183-
184-
```bash
185-
CSHARP_PROJECT_PATH="src/csharp/workshop/AgentWorkshop.Client/AgentWorkshop.Client.csproj"
186-
```
187-
188-
3. Run the following command to set the [ASP.NET Core safe secret](https://learn.microsoft.com/aspnet/core/security/app-secrets){:target="_blank"} for the project endpoint:
189-
190-
!!! warning "Replace `<your_project_endpoint>` with the actual connection string"
103+
=== "Python"
191104
192-
```bash
193-
dotnet user-secrets set "ConnectionStrings:AiAgentService" "<your_project_endpoint>" --project "$CSHARP_PROJECT_PATH"
194-
```
105+
The deploy script generates the **.env** file, which contains the project endpoint, model deployment name.
106+
107+
You'll see this file when you open the Python workspace in VS Code. Your **.env** file will look similar to this but with your project endpoint.
195108

196-
4. Run the following command to set the [ASP.NET Core safe secret](https://learn.microsoft.com/aspnet/core/security/app-secrets){:target="_blank"} for the model deployment name:
109+
```python
110+
MODEL_DEPLOYMENT_NAME="gpt-4o-mini"
111+
PROJECT_ENDPOINT="<your_project_endpoint>"
112+
```
113+
=== "C#"
197114

198-
```bash
199-
dotnet user-secrets set "Azure:ModelName" "gpt-4o-mini" --project "$CSHARP_PROJECT_PATH"
200-
```
115+
The automated deployment script stores project variables securely by using the Secret Manager feature for [safe storage of app secrets in development in ASP.NET Core](https://learn.microsoft.com/aspnet/core/security/app-secrets){:target="_blank"}.
201116

202-
5. Add the **Bing connection ID** to the user secrets for grounding with Bing search.
117+
You can view the secrets by running the following command after you have opened the C# workspace in VS Code:
203118

204-
```powershell
205-
$subId = $(az account show --query id --output tsv)
206-
$rgName = "rg-agent-workshop"
207-
$aiAccount = "<ai_account_name>" # Replace with the actual AI account name
208-
$aiProject = "<ai_project_name>" # Replace with the actual AI project name
209-
$bingConnectionId = "/subscriptions/$subId/resourceGroups/$rgName/providers/Microsoft.CognitiveServices/accounts/$aiAccount/projects/$aiProject/connections/groundingwithbingsearch"
210-
dotnet user-secrets set "Azure:BingConnectionId" "$bingConnectionId" --project "$CSHARP_PROJECT_PATH"
211-
```
119+
```bash
120+
dotnet user-secrets list
121+
```
212122

213123
## Selecting the Language Workspace
214124

0 commit comments

Comments
 (0)