Changes for azure-ai-project relase version 2.1.0

sdk/ai/azure-ai-projects/.env.template

@@ -20,9 +20,11 @@ AZURE_AI_PROJECTS_CONSOLE_LOGGING=
 
 # Project endpoint has the format: 
 #  `https://<your-ai-services-account-name>.services.ai.azure.com/api/projects/<your-project-name>`
-AZURE_AI_PROJECT_ENDPOINT=
-AZURE_AI_MODEL_DEPLOYMENT_NAME=
-AZURE_AI_AGENT_NAME=
+FOUNDRY_PROJECT_ENDPOINT=
+FOUNDRY_PROJECT_API_KEY=
+FOUNDRY_MODEL_NAME=
+FOUNDRY_AGENT_NAME=
+FOUNDRY_AGENT_CONTAINER_IMAGE=
 CONVERSATION_ID=
 CONNECTION_NAME=
 MEMORY_STORE_CHAT_MODEL_DEPLOYMENT_NAME=
@@ -65,6 +67,9 @@ PAUSED_FINE_TUNING_JOB_ID=
 AZURE_SUBSCRIPTION_ID=
 AZURE_RESOURCE_GROUP=
 
+# Used in all samples
+LLM_VALIDATION_PROJECT_ENDPOINT=
+
 # Used in Fine-tuning samples
 AZURE_AI_PROJECTS_AZURE_SUBSCRIPTION_ID=
 AZURE_AI_PROJECTS_AZURE_RESOURCE_GROUP=

sdk/ai/azure-ai-projects/CHANGELOG.md

@@ -1,5 +1,75 @@
 # Release History
 
+## 2.1.0 (2026-04-17)
+
+### Features Added
+
+* `get_openai_client()` on `AIProjectClient` now takes an optional input argument `agent_name`. If provided, the returned OpenAI
+client will use a base URL of Agent endpoint instead of Foundry Project endpoint. As Agent endpoints are a preview feature, you
+need to set `allow_preview=True` on the `AIProjectClient` constructor.
+* New `.beta.agents` sub-client added, with Session operations (those only work with Hosted Agents)
+  * `create_session()`
+  * `delete_session()`
+  * `delete_session_file()`
+  * `download_session_file()`
+  * `get_session()`
+  * `get_session_files()`
+  * `list_sessions()`
+  * `upload_session_file()`
+* Also on `.beta.agents` sub-client, a new method `patch_agent_details()`.
+* New `beta.skills` sub-client added, with Skills operations:
+  * `create()`
+  * `create_from_package()`
+  * `delete()`
+  * `download()`
+  * `get()`
+  * `list()`
+  * `update()`
+* New `beta.toolboxes` sub-client added, with Toolboxes operations:
+  * `create_version()`
+  * `delete()`
+  * `delete_version()`
+  * `get()`
+  * `get_version()`
+  * `list()`
+  * `list_versions()`
+  * `update()`
+* Type hinting support for OpenAI client operations `.evals.create()` and `.evals.runs.create()`, when you
+get the OpenAI client using `get_openai_client()` method of `AIProjectClient`. This includes new TypedDicts
+classes to help you author the input to these methods. See new TypedDict classes `ModelSamplingConfigParam`, 
+`ToolDescriptionParam`, `AzureAIAgentTargetParam`, `AzureAIModelTargetParam`,
+`ResponseRetrievalItemGenerationParams`, `AzureAIResponsesEvalRunDataSource`, `AzureAIDataSourceConfig`,
+`TargetCompletionEvalRunDataSource`, `TestingCriterionAzureAIEvaluator`, `AzureAIBenchmarkPreviewEvalRunDataSource`,
+`EvalCsvFileIdSource`, `EvalCsvRunDataSource`, `RedTeamEvalRunDataSource`, `TracesPreviewEvalRunDataSource`.
+
+
+### Breaking Changes
+
+* Tracing: trace context propagation is enabled by default when tracing is enabled.
+
+### Bugs Fixed
+
+* Fix missing type hinting on the returned OpenAI client from method 'get_openai_client()`.
+
+### Sample updates
+
+* Evaluation samples updated to use TypedDicts to specify inputs to `.evals.create()` and `.evals.runs.create()` methods.
+* Renamed environment variable `AZURE_AI_PROJECT_ENDPOINT` to `FOUNDRY_PROJECT_ENDPOINT` in all samples.
+* Renamed environment variable `AZURE_AI_MODEL_DEPLOYMENT_NAME` to `FOUNDRY_MODEL_NAME` in all samples.
+* Renamed environment variable `AZURE_AI_MODEL_AGENT_NAME` to `FOUNDRY_AGENT_NAME` in all samples.
+* Added Hosted Agents related samples: `sample_agent_endpoint.py`, `sample_agent_endpoint_async.py`, `sample_sessions_crud.py`, `sample_sessions_crud_async.py`, `sample_sessions_files_upload_download.py`, `sample_sessions_files_upload_download_async.py`, `sample_skills_crud.py`, `sample_skills_crud_async.py`, `sample_skills_upload_and_download.py`, `sample_skills_upload_and_download_async.py`, `sample_toolboxes_crud.py`, and `sample_toolboxes_crud_async.py`.
+* Added structured inputs + file upload sample (`sample_agent_structured_inputs_file_upload.py`) demonstrating passing an uploaded file ID to an agent at runtime.
+* Added structured inputs + File Search sample (`sample_agent_file_search_structured_inputs.py`) demonstrating configuring File Search tool resources via structured inputs.
+* Added structured inputs + Code Interpreter sample (`sample_agent_code_interpreter_structured_inputs.py`) demonstrating passing an uploaded file ID to Code Interpreter via structured inputs.
+* Added CSV evaluation sample (`sample_evaluations_builtin_with_csv.py`) demonstrating evaluation with an uploaded CSV dataset.
+* Added synthetic data evaluation samples (`sample_synthetic_data_agent_evaluation.py`) and (`sample_synthetic_data_model_evaluation.py`).
+* Added Chat Completions basic samples (`sample_chat_completions_basic.py`, `sample_chat_completions_basic_async.py`) demonstrating chat completions calls using `AIProjectClient` + the OpenAI-compatible client.
+* Added Toolboxes CRUD samples (`sample_toolboxes_crud.py`, `sample_toolboxes_crud_async.py`) demonstrating `project_client.beta.toolboxes` create/get/update/list/delete.
+* Simplified `sample_memory_basic.py` and `sample_agent_memory_search.py` (and their async equivalent) by removing 
+`options=MemoryStoreDefaultOptions(user_profile_enabled=True, chat_summary_enabled=True)` when constructing `MemoryStoreDefaultDefinition`,
+since this is now redundant (it's the service default).
+
+
 ## 2.0.1 (2026-03-12)
 
 ### Bugs Fixed
@@ -44,8 +114,9 @@ to `datetime.datetime` with format="rfc3339".
 ### Other Changes
 
 * The input `items` argument in the methods `.beta.memory_stores.begin_update_memories()` and `.beta.memory_stores.search_memories`
-was change from type `Optional[List[dict[str, Any]]]` to `Optional[Union[str, ResponseInputParam]]`. The class `ResponseInputParam`
-can be imported using `from openai.types.responses import EasyInputMessageParam`. This is not a breaking change, since the caller
+was changed from type `Optional[List[dict[str, Any]]]` to `Optional[Union[str, ResponseInputParam]]`, where `ResponseInputParam`
+is defined in the openai package. This allows passing in, for example, a list of `EasyInputMessageParam`. Import it using
+`from openai.types.responses import EasyInputMessageParam`. This is not a breaking change, since the caller
 can still pass in `List[dict[str, Any]`.
 
 ## 2.0.0b4 (2026-02-24)