Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
0d299e8
added files for vscode web
Ragini-Microsoft Nov 25, 2025
66b61aa
added branch name for validation
Ragini-Microsoft Nov 25, 2025
67204d7
Merge pull request #747 from microsoft/dev
Prajwal-Microsoft Nov 25, 2025
7c07bad
Revert "added branch name for validation"
Ragini-Microsoft Nov 25, 2025
c9cdb8d
Merge branch 'main' of https://github.com/microsoft/Build-your-own-co…
Ragini-Microsoft Nov 25, 2025
d55b473
chore: Files addition for VS code web support
Avijit-Microsoft Nov 25, 2025
b3a1b26
Use device code for Azure CLI login in process_sample_data.sh
Ragini-Microsoft Nov 25, 2025
40b7a72
added branch name for validation
Ragini-Microsoft Nov 25, 2025
27fe7f3
Merge branch 'main' of https://github.com/microsoft/Build-your-own-co…
Ragini-Microsoft Nov 26, 2025
74d56d0
removed feat branch name
Ragini-Microsoft Nov 26, 2025
f9bc39c
Added Vs code web button in main readme
Ragini-Microsoft Nov 26, 2025
561be5e
chore: Added VS code web button in readme
Avijit-Microsoft Nov 26, 2025
e114999
updated readme for vs code web in deployment
Ragini-Microsoft Nov 27, 2025
b42e004
add Visual Studio Code Web button to deployment guide
Ragini-Microsoft Nov 27, 2025
8be487e
minor change in numbers
Ragini-Microsoft Nov 27, 2025
e91b9a6
docs: updated readme for vs code web in deployment
Avijit-Microsoft Nov 27, 2025
ba06440
add Visual Studio Code (WEB) instructions to deployment guide
Ragini-Microsoft Nov 27, 2025
894b2b7
Update docs/DeploymentGuide.md
Ragini-Microsoft Nov 27, 2025
7912c58
docs: minor update to add Visual Studio Code (WEB) instructions to de…
Avijit-Microsoft Nov 27, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,8 +72,8 @@ Follow the quick deploy steps on the deployment guide to deploy this solution
<br/><br/>


| [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/microsoft/Build-your-own-copilot-Solution-Accelerator) | [![Open in Dev Containers](https://img.shields.io/static/v1?style=for-the-badge&label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator) |
|---|---|
| [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/microsoft/Build-your-own-copilot-Solution-Accelerator) | [![Open in Dev Containers](https://img.shields.io/static/v1?style=for-the-badge&label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator) | [![Open in Visual Studio Code Web](https://img.shields.io/static/v1?style=for-the-badge&label=Visual%20Studio%20Code%20(Web)&message=Open&color=blue&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/azure/?vscode-azure-exp=foundry&agentPayload=eyJiYXNlVXJsIjogImh0dHBzOi8vcmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbS9taWNyb3NvZnQvQnVpbGQteW91ci1vd24tY29waWxvdC1Tb2x1dGlvbi1BY2NlbGVyYXRvci9yZWZzL2hlYWRzL21haW4vaW5mcmEvdnNjb2RlX3dlYiIsICJpbmRleFVybCI6ICIvaW5kZXguanNvbiIsICJ2YXJpYWJsZXMiOiB7ImFnZW50SWQiOiAiIiwgImNvbm5lY3Rpb25TdHJpbmciOiAiIiwgInRocmVhZElkIjogIiIsICJ1c2VyTWVzc2FnZSI6ICIiLCAicGxheWdyb3VuZE5hbWUiOiAiIiwgImxvY2F0aW9uIjogIiIsICJzdWJzY3JpcHRpb25JZCI6ICIiLCAicmVzb3VyY2VJZCI6ICIiLCAicHJvamVjdFJlc291cmNlSWQiOiAiIiwgImVuZHBvaW50IjogIiJ9LCAiY29kZVJvdXRlIjogWyJhaS1wcm9qZWN0cy1zZGsiLCAicHl0aG9uIiwgImRlZmF1bHQtYXp1cmUtYXV0aCIsICJlbmRwb2ludCJdfQ==) |
|---|---|---|

<br/>

Expand Down
41 changes: 37 additions & 4 deletions docs/DeploymentGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,10 +63,10 @@ azd env set AZURE_ENV_VM_ADMIN_PASSWORD <your-password>

## Deployment Options & Steps

Pick from the options below to see step-by-step instructions for GitHub Codespaces, VS Code Dev Containers, and Local Environments.
Pick from the options below to see step-by-step instructions for GitHub Codespaces, VS Code Dev Containers, Visual Studio Code (WEB), and Local Environments.

| [![Open in Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?repo=microsoft/Build-your-own-copilot-Solution-Accelerator) | [![Open in Dev Containers](https://img.shields.io/static/v1?style=for-the-badge&label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator) |
|---|---|
| [![Open in Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?repo=microsoft/Build-your-own-copilot-Solution-Accelerator) | [![Open in Dev Containers](https://img.shields.io/static/v1?style=for-the-badge&label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator) | [![Open in Visual Studio Code Web](https://img.shields.io/static/v1?style=for-the-badge&label=Visual%20Studio%20Code%20(Web)&message=Open&color=blue&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/azure/?vscode-azure-exp=foundry&agentPayload=eyJiYXNlVXJsIjogImh0dHBzOi8vcmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbS9taWNyb3NvZnQvQnVpbGQteW91ci1vd24tY29waWxvdC1Tb2x1dGlvbi1BY2NlbGVyYXRvci9yZWZzL2hlYWRzL21haW4vaW5mcmEvdnNjb2RlX3dlYiIsICJpbmRleFVybCI6ICIvaW5kZXguanNvbiIsICJ2YXJpYWJsZXMiOiB7ImFnZW50SWQiOiAiIiwgImNvbm5lY3Rpb25TdHJpbmciOiAiIiwgInRocmVhZElkIjogIiIsICJ1c2VyTWVzc2FnZSI6ICIiLCAicGxheWdyb3VuZE5hbWUiOiAiIiwgImxvY2F0aW9uIjogIiIsICJzdWJzY3JpcHRpb25JZCI6ICIiLCAicmVzb3VyY2VJZCI6ICIiLCAicHJvamVjdFJlc291cmNlSWQiOiAiIiwgImVuZHBvaW50IjogIiJ9LCAiY29kZVJvdXRlIjogWyJhaS1wcm9qZWN0cy1zZGsiLCAicHl0aG9uIiwgImRlZmF1bHQtYXp1cmUtYXV0aCIsICJlbmRwb2ludCJdfQ==) |
|---|---|---|

<details>
<summary><b>Deploy in GitHub Codespaces</b></summary>
Expand Down Expand Up @@ -100,6 +100,39 @@ You can run this solution in [VS Code Dev Containers](https://code.visualstudio.
3. In the VS Code window that opens, once the project files show up (this may take several minutes), open a terminal window.
4. Continue with the [deploying steps](#deploying-with-azd).

</details>

<details>
<summary><b>Deploy in Visual Studio Code (WEB)</b></summary>

### Visual Studio Code (WEB)

You can run this solution in VS Code Web. The button will open a web-based VS Code instance in your browser:

1. Open the solution accelerator (this may take several minutes):

[![Open in Visual Studio Code Web](https://img.shields.io/static/v1?style=for-the-badge&label=Visual%20Studio%20Code%20(Web)&message=Open&color=blue&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/azure/?vscode-azure-exp=foundry&agentPayload=eyJiYXNlVXJsIjogImh0dHBzOi8vcmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbS9taWNyb3NvZnQvQnVpbGQteW91ci1vd24tY29waWxvdC1Tb2x1dGlvbi1BY2NlbGVyYXRvci9yZWZzL2hlYWRzL21haW4vaW5mcmEvdnNjb2RlX3dlYiIsICJpbmRleFVybCI6ICIvaW5kZXguanNvbiIsICJ2YXJpYWJsZXMiOiB7ImFnZW50SWQiOiAiIiwgImNvbm5lY3Rpb25TdHJpbmciOiAiIiwgInRocmVhZElkIjogIiIsICJ1c2VyTWVzc2FnZSI6ICIiLCAicGxheWdyb3VuZE5hbWUiOiAiIiwgImxvY2F0aW9uIjogIiIsICJzdWJzY3JpcHRpb25JZCI6ICIiLCAicmVzb3VyY2VJZCI6ICIiLCAicHJvamVjdFJlc291cmNlSWQiOiAiIiwgImVuZHBvaW50IjogIiJ9LCAiY29kZVJvdXRlIjogWyJhaS1wcm9qZWN0cy1zZGsiLCAicHl0aG9uIiwgImRlZmF1bHQtYXp1cmUtYXV0aCIsICJlbmRwb2ludCJdfQ==)

2. When prompted, sign in using your Microsoft account linked to your Azure subscription.

Select the appropriate subscription to continue.

3. Once the solution opens, the **AI Foundry terminal** will automatically start running the following command to install the required dependencies:

```shell
sh install.sh
```
During this process, you’ll be prompted with the message:
```
What would you like to do with these files?
- Overwrite with versions from template
- Keep my existing files unchanged
```
Choose “**Overwrite with versions from template**” and provide a unique environment name when prompted.

4. Continue with the [deploying steps](#deploying-with-azd).


</details>

<details>
Expand Down Expand Up @@ -168,7 +201,7 @@ To adjust quota settings, follow these [steps](./AzureGPTQuotaSettings.md).

### Deploying with AZD

Once you've opened the project in [Codespaces](#github-codespaces), [Dev Containers](#vs-code-dev-containers), or [locally](#local-environment), you can deploy it to Azure by following these steps:
Once you've opened the project in [Codespaces](#github-codespaces), [Dev Containers](#vs-code-dev-containers), [Visual Studio Code (WEB)](#visual-studio-code-web), or [locally](#local-environment), you can deploy it to Azure by following these steps:

1. Login to Azure:

Expand Down
2 changes: 1 addition & 1 deletion infra/scripts/process_sample_data.sh
Original file line number Diff line number Diff line change
Expand Up @@ -485,7 +485,7 @@ if [ -n "$managedIdentityClientId" ]; then
else
# Use Azure CLI login if running locally
echo "Authenticating with Azure CLI..."
az login
az login --use-device-code
fi
echo ""

Expand Down
7 changes: 7 additions & 0 deletions infra/vscode_web/.env
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
AZURE_EXISTING_AGENT_ID="<%= agentId %>"
AZURE_ENV_NAME="<%= playgroundName %>"
# AZURE_LOCATION="<%= location %>"
AZURE_SUBSCRIPTION_ID="<%= subscriptionId %>"
AZURE_EXISTING_AIPROJECT_ENDPOINT="<%= endpoint %>"
AZURE_EXISTING_AIPROJECT_RESOURCE_ID="<%= projectResourceId %>"
AZD_ALLOW_NON_EMPTY_FOLDER=true
85 changes: 85 additions & 0 deletions infra/vscode_web/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
# ========== .NET ========== #
## Build results
bin/
obj/
[Bb]uild/
[Ll]ogs/
*.log
## User-specific files
*.user
*.suo
*.userosscache
*.sln.docstates
*.vsp
*.vspx
*.vspscc
## Rider / VS Code / Visual Studio
.idea/
.vscode/
.vs/
## NuGet packages
*.nupkg
packages/
*.snupkg
project.lock.json
project.assets.json
## Dotnet tools
.tools/
# ========== Java ========== #
## Compiled class files
*.class
## Logs
*.log
## Maven
target/
## Gradle
.gradle/
build/
## Eclipse
.project
.classpath
.settings/
.loadpath
## IntelliJ IDEA
*.iml
*.ipr
*.iws
out/
.idea/
# ========== Python ========== #
## Byte-compiled / cache
__pycache__/
*.py[cod]
*$py.class
## Virtual environment
env/
venv/
ENV/
.venv/
.env*
## PyInstaller
*.spec
dist/
build/
## Jupyter Notebook
.ipynb_checkpoints/
## Misc
*.log
*.pot
*.pyc
.DS_Store
*.sqlite3
# ========== General ========== #
## OS generated
Thumbs.db
ehthumbs.db
Desktop.ini
.DS_Store
*.swp
*.swo
*.bak
*.tmp
*.old
## Node (just in case mixed project)
node_modules/
# End
21 changes: 21 additions & 0 deletions infra/vscode_web/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) Microsoft Corporation.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
2 changes: 2 additions & 0 deletions infra/vscode_web/README-noazd.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# VS Code for the Web - Azure AI Foundry Templates

43 changes: 43 additions & 0 deletions infra/vscode_web/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# VS Code for the Web - Azure AI Foundry Templates

We've generated a simple development environment for you to deploy the templates.

The Azure AI Foundry extension provides tools to help you build, test, and deploy AI models and AI Applications directly from VS Code. It offers simplified operations for interacting with your models, agents, and threads without leaving your development environment. Click on the Azure AI Foundry Icon on the left to see more.

Follow the instructions below to get started!

You should see a terminal opened with the template code already cloned.

## Deploy the template

You can provision and deploy this template using:

```bash
azd up
```

Follow any instructions from the deployment script and launch the application.


If you need to delete the deployment and stop incurring any charges, run:

```bash
azd down
```

## Continuing on your local desktop

You can keep working locally on VS Code Desktop by clicking "Continue On Desktop..." at the bottom left of this screen. Be sure to take the .env file with you using these steps:

- Right-click the .env file
- Select "Download"
- Move the file from your Downloads folder to the local git repo directory
- For Windows, you will need to rename the file back to .env using right-click "Rename..."

## More examples

Check out [Azure AI Projects client library for Python](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/ai/azure-ai-projects/README.md) for more information on using this SDK.

## Troubleshooting

- If you are instantiating your client via endpoint on an Azure AI Foundry project, ensure the endpoint is set in the `.env` as https://{your-foundry-resource-name}.services.ai.azure.com/api/projects/{your-foundry-project-name}`
25 changes: 25 additions & 0 deletions infra/vscode_web/codeSample.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

project_client = AIProjectClient.from_connection_string(
credential=DefaultAzureCredential(),
conn_str="<%= connectionString %>")

agent = project_client.agents.get_agent("<%= agentId %>")

thread = project_client.agents.create_thread()
print(f"Created thread, ID: {thread.id}")

message = project_client.agents.create_message(
thread_id=thread.id,
role="user",
content="<%= userMessage %>"
)

run = project_client.agents.create_and_process_run(
thread_id=thread.id,
agent_id=agent.id)
messages = project_client.agents.list_messages(thread_id=thread.id)

for text_message in messages.text_messages:
print(text_message.as_dict())
3 changes: 3 additions & 0 deletions infra/vscode_web/endpoint-requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
azure-ai-projects==1.0.0b12
azure-identity==1.20.0
ansible-core~=2.17.0
31 changes: 31 additions & 0 deletions infra/vscode_web/endpointCodeSample.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential
from azure.ai.agents.models import ListSortOrder

project = AIProjectClient(
credential=DefaultAzureCredential(),
endpoint="<%= endpoint %>")

agent = project.agents.get_agent("<%= agentId %>")

thread = project.agents.threads.create()
print(f"Created thread, ID: {thread.id}")

message = project.agents.messages.create(
thread_id=thread.id,
role="user",
content="<%= userMessage %>"
)

run = project.agents.runs.create_and_process(
thread_id=thread.id,
agent_id=agent.id)

if run.status == "failed":
print(f"Run failed: {run.last_error}")
else:
messages = project.agents.messages.list(thread_id=thread.id, order=ListSortOrder.ASCENDING)

for message in messages:
if message.text_messages:
print(f"{message.role}: {message.text_messages[-1].text.value}")
72 changes: 72 additions & 0 deletions infra/vscode_web/index.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
{
"ai-projects-sdk": {
"python": {
"default-azure-auth": {
"connectionString": [
{
"name": "run_agent.py",
"type": "code",
"path": "/codeSample.py"
},
{
"name": "INSTRUCTIONS.md",
"type": "readme",
"path": "/README-noazd.md"
},
{
"name": "requirements.txt",
"type": "dependencies",
"path": "/requirements.txt"
},
{
"name": ".env",
"type": "env",
"path": "/.env"
},
{
"name": "install.sh",
"type": "install",
"path": "/install.sh"
},
{
"name": ".gitignore",
"type": "code",
"path": "/.gitignore"
}
],
"endpoint": [
{
"name": "run_agent.py",
"type": "code",
"path": "/endpointCodeSample.py"
},
{
"name": "INSTRUCTIONS.md",
"type": "readme",
"path": "/README.md"
},
{
"name": "requirements.txt",
"type": "dependencies",
"path": "/endpoint-requirements.txt"
},
{
"name": ".env",
"type": "env",
"path": "/.env"
},
{
"name": "install.sh",
"type": "install",
"path": "/install.sh"
},
{
"name": ".gitignore",
"type": "code",
"path": "/.gitignore"
}
]
}
}
}
}
3 changes: 3 additions & 0 deletions infra/vscode_web/install.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
pip install -r requirements.txt --user -q

azd init -t microsoft/Build-your-own-copilot-Solution-Accelerator
3 changes: 3 additions & 0 deletions infra/vscode_web/requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
azure-ai-projects==1.0.0b12
azure-identity==1.20.0
ansible-core~=2.17.0
Loading