Skip to content

C# Azure AI Projects SDK for new 1DP endpoint #49432

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 38 commits into from
May 16, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
bfdd018
adding agents v2
Apr 7, 2025
9a8f590
updating to latest typespec
Apr 9, 2025
5cb2cff
adding persistent agent deletion to sample
Apr 9, 2025
2d2a7bb
adding conveniency functions and samples that use them
Apr 10, 2025
dc4e751
update to sample
Apr 10, 2025
0b6c830
Custom code + samples for datasets and deployments
sophia-ramsey Apr 15, 2025
084456c
Add ci/cd config (#49469)
nick863 Apr 17, 2025
a86b3bb
Regenerate code + add custom code (#49523)
sophia-ramsey Apr 22, 2025
6edfcb7
remove sample app (#49625)
sophia-ramsey Apr 24, 2025
5a032ec
update sample files (#49635)
sophia-ramsey Apr 24, 2025
2698e24
Add evaluations sample (#49729)
sophia-ramsey Apr 29, 2025
9c746be
Remove 1DP (#49760)
sophia-ramsey May 1, 2025
1d7480e
Merge branch 'main' of https://github.com/Azure/azure-sdk-for-net int…
sophia-ramsey May 6, 2025
3c8abf3
regenerate code and update samples
sophia-ramsey May 6, 2025
4ce9ddf
[AI] [Projects] add ConnectionProvider to AIProjectClient (#49798)
glharper May 9, 2025
2d1ab6f
[AI] [Projects] Add openai sample using authenticated client (#50000)
glharper May 12, 2025
b6e6d1b
update ci.projects_1dp.yml (#50002)
sophia-ramsey May 12, 2025
0db13c3
update connections and indexes samples (#50022)
sophia-ramsey May 13, 2025
cbfe05c
update samples in samples folder (#50023)
sophia-ramsey May 13, 2025
a1af768
remove duplicate AssemblyInfo (#50025)
sophia-ramsey May 13, 2025
58529cd
regenerate code from typespec (#50027)
sophia-ramsey May 13, 2025
63db9de
update snippets (#50029)
sophia-ramsey May 13, 2025
a18f7da
Fix cspell. (#50035)
nick863 May 14, 2025
581e117
add telemetry samples and update connections sample (#50040)
sophia-ramsey May 14, 2025
97da571
Fix generated code (#50075)
nick863 May 14, 2025
ab8ea3b
merge conflicts
sophia-ramsey May 15, 2025
c883b5b
Merge branch 'main' of https://github.com/Azure/azure-sdk-for-net int…
sophia-ramsey May 15, 2025
335669a
resolve merge conflicts and fix project setup
sophia-ramsey May 15, 2025
f67808b
add inference samples and custom code (#50104)
sophia-ramsey May 15, 2025
ba63d96
update changelog (#50107)
sophia-ramsey May 15, 2025
a96c10b
readme update (#50110)
sophia-ramsey May 15, 2025
3ebda1e
Merge branch 'main' of https://github.com/Azure/azure-sdk-for-net int…
nick863 May 16, 2025
373917b
Merge branch 'main' of https://github.com/Azure/azure-sdk-for-net int…
nick863 May 16, 2025
69560a4
Upgrade the Agents (#50106)
nick863 May 16, 2025
9a4a327
Small fixes
nick863 May 16, 2025
62abd6f
Merge branch 'feature/azure-ai-projects-1dp' of https://github.com/Az…
nick863 May 16, 2025
6aeda1b
addressing comments (#50127)
sophia-ramsey May 16, 2025
dd77434
update snippet (#50130)
sophia-ramsey May 16, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
10 changes: 9 additions & 1 deletion .vscode/cspell.json
Original file line number Diff line number Diff line change
Expand Up @@ -197,7 +197,15 @@
{
"filename": "**/sdk/ai/**/*.cs",
"words": [
"Ubinary"
"Ubinary",
"Ansii",
"Atbash",
"Bleu",
"azureai",
"bleu",
"azureai",
"Gleu",
"gleu"
]
},
{
Expand Down
19 changes: 16 additions & 3 deletions sdk/ai/Azure.AI.Projects/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,25 @@
## 1.0.0-beta.9 (Unreleased)

### Features Added
* `Deployments` methods to enumerate AI models deployed to your AI Foundry Project.
* `Datasets` methods to upload documents and reference them. To be used with Evaluations.
* `Indexes` methods to handle Search Indexes.

### Breaking Changes
* Azure AI Foundry Project endpoint is now required to construct the `AIProjectClient`. It has the form
`https://<your-ai-services-account-name>.services.ai.azure.com/api/projects/<your-project-name>`. Find it in your AI Foundry Project Overview page.
* Agents are now implemented in a separate package `Azure.AI.Agents.Persistent`. Use the `GetPersistentAgentsClient` method on the
`AIProjectsClient` to create, run and delete agents. However there have been some breaking changes in these operations. See [Agents package document and samples](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/ai/Azure.AI.Agents.Persistent) for more details.
* Several changes to the `Connections` methods, including the response object (now it is simply called `Connection`). The class `ConnectionProperties` was renamed to `Connection`, and its properties have changed.
* `GetAzureOpenAIChatClient` now supports returning an authenticated `AzureOpenAI` ChatClient to be used with
AI models deployed to the Project's AI Services.
* The method `UploadFileRequest` on `AIProjectClient` had been removed, use `UploadFile` in `Datasets` instead.
* Property `scope` on `AIProjectClient` is removed.
* Evaluator Ids are available using the class `EvaluatorIDs` and no longer require `Azure.AI.Evaluation` package to be installed.
* Property `Id` on Evaluation is replaced with `name`.

### Bugs Fixed

### Other Changes
### Sample Updates
* All samples have been updated. New ones have been added for Deployments, Datasets, and Indexes.

## 1.0.0-beta.8 (2025-04-23)

Expand Down
971 changes: 193 additions & 778 deletions sdk/ai/Azure.AI.Projects/README.md

Large diffs are not rendered by default.

4,016 changes: 640 additions & 3,376 deletions sdk/ai/Azure.AI.Projects/api/Azure.AI.Projects.net8.0.cs

Large diffs are not rendered by default.

4,016 changes: 640 additions & 3,376 deletions sdk/ai/Azure.AI.Projects/api/Azure.AI.Projects.netstandard2.0.cs

Large diffs are not rendered by default.

45 changes: 14 additions & 31 deletions sdk/ai/Azure.AI.Projects/samples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,41 +8,24 @@ products:
name: Azure.AI.Projects samples for .NET
description: Samples for the Azure.AI.Projects client library.
---

# Azure.AI.Projects Samples for Agents

| Sample | Description |
| ------ | ----------- |
| [Sample5_Sample_Agent_Additional_messages](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample5_Sample_Agent_Additional_messages.md) | Sample for using additional messages while creating agent run. |
| [Sample6_Sample_Agent_Azure_Functions](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample6_Sample_Agent_Azure_Functions.md) | Sample for using Azure Functions with agents. |
| [Sample7_Agent_Basics](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample7_Agent_Basics.md) | Sample for basic use of an agent. |
| [Sample8_Agent_Bing_Grounding](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample8_Agent_Bing_Grounding.md) | Sample for use of an agent with Bing grounding. |
| [Sample9_Agent_Enterprise_File_Search](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample9_Agent_Enterprise_File_Search.md) | Sample enterprise file search with agent. |
| [Sample10_Agent_FileSearch](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample10_Agent_FileSearch.md) | Sample file search with agent. |
| [Sample11_Functions](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample11_Functions.md) | Sample using agents with functions. |
| [Sample12_FunctionsWithStreaming](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample12_FunctionsWithStreaming.md) | Sample using agents with functions and streaming. |
| [Sample13_Streaming](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample13_Streaming.md) | Sample using agents with streaming. |
| [Sample14_Agent_Vector_Store_Batch_File_Search](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample14_Agent_Vector_Store_Batch_File_Search.md) | Sample for batch file search. |
| [Sample15_Agents_Code_Interpreter_Enterprise_File_Search](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample15_Agents_Code_Interpreter_Enterprise_File_Search.md) | Sample enterprise file search on agent with message attachment and code interpreter. |
| [Sample16_Agents_Code_Interpreter_File_Attachment](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample16_Agents_Code_Interpreter_File_Attachment.md) | Sample file search on agent with message attachment and code interpreter. |
| [Sample17_Agents_ImageUrlInputs](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample17_Agents_ImageUrlInputs.md) | Sample using image url input with agents. |
| [Sample18_Agents_ImageFileInputs](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample18_Agents_ImageFileInputs.md) | Sample using image file input with agents. |
| [Sample19_Agent_OpenAPI](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample19_Agent_OpenAPI.md) | Sample using agents with OpenAPI tool. |
| [Sample20_Agents_Azure_AI_Search](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample20_Agents_Azure_AI_Search.md) | Sample using agents with Azure AI Search tool. |
| [Sample21_Agent_Vector_Store_Batch_Enterprise_File_Search](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample21_Agent_Vector_Store_Batch_Enterprise_File_Search.md) | Sample for enterprise batch file search. |
| [Sample22_Agents_Azure_AI_Search_Streaming](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample22_Agents_Azure_AI_Search_Streaming.md) | Sample using agents with Azure AI Search tool with streaming. |
| [Sample23_Agent_Fabric](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample23_Agent_Fabric.md) | Sample using agents with Fabric tool. |

# Azure.AI.Projects Samples for Connections
<!-- TODO: update the links once the samples are in main (currently linking to feature/azure-ai-projects-1dp branch) -->
# Azure.AI.Projects samples

| Sample | Description |
| ------ | ----------- |
| [Sample3_Connection.md](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample3_Connection.md) | Sample for `ConnectionsClient`. |
| [Sample1_Datasets](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample1_Datasets.md) | Sample for dataset functions. |
| [Sample2_Deployments](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample2_Deployments.md) | Sample for deployment functions. |
| [Sample3_Connections](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample3_Connections.md) | Sample for connections functions. |
| [Sample4_Indexes](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample4_Indexes.md) | Sample for indexes functions. |
| [Sample5_Evaluations](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample5_Evaluations.md) | Sample for evaluations functions. |
| [Sample8_Telemetry](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample8_Telemetry.md) | Sample for telemetry functions. |

# Azure.AI.Projects Samples for Extensions
# Azure.AI.Projects samples for Agents and Inference extensions

| Sample | Description |
| ------ | ----------- |
| [Sample1_AIInference](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample1_AIInference.md) | Sample for `Azure.AI.Inference` extensions. |
| [Sample2_AzureOpenAI](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample2_AzureOpenAI.md) | Sample for `Azure.AI.OpenAI` extensions. |
| [Sample4_Search](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/ai/Azure.AI.Projects/samples/Sample4_Search.md) | Sample for `Azure.Search.Documents` extensions. |
| [Sample6_Agents](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample6_Agents.md) | Sample for `Azure.AI.Agents.Persistent` extensions. |
| [Sample7_AzureOpenAI](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample7_AzureOpenAI.md) | Sample for `Azure.AI.OpenAI` extensions. |
| [Sample9_InferenceChatClient](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample9_InferenceChatClient.md) | Sample for `Azure.AI.Inference` Chat Client extensions. |
| [Sample10_InferenceEmbedding](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample10_InferenceEmbedding.md) | Sample for `Azure.AI.Inference` Embeddings extensions. |
| [Sample11_InferenceImageEmbedding](https://github.com/Azure/azure-sdk-for-net/blob/feature/azure-ai-projects-1dp/sdk/ai/Azure.AI.Projects/samples/Sample11_InferenceImageEmbedding.md) | Sample for `Azure.AI.Inference` Image Embeddings extensions. |
227 changes: 0 additions & 227 deletions sdk/ai/Azure.AI.Projects/samples/Sample10_Agent_FileSearch.md

This file was deleted.

Loading
Loading