azure-ai-projects

Sample updates

• Added sample_agent_insights_on_demand.py and sample_agent_insights_scheduled.py under samples/agent_insights/ to demonstrate on-demand analysis, insight lifecycle updates, and scheduled monitor setup with temporary external agents, fictional traces, and owned-resource cleanup.
• Added sample_agent_web_iq.py under samples/agents/tools/, demonstrating a Prompt Agent using the WebIQPreviewTool.

Bugs Fixed

• Fixed Agent Insights run pollers to stop and raise an error when the service reports a cancelled run.
• Fixed Agent Insights run pollers to preserve request headers, including the preview feature header, on polling requests.

Features Added

• Added supporting AgentInsight* models and enums covering monitors, runs, generated insights, proposed fixes, highlighted and linked traces, costs, token usage, severity, status, and run triggers.
• Added Microsoft 365 agent publishing.
• Added optional Hosted Agent session defaults through HostedAgentDefinition.session_configuration and SessionConfiguration, including idle-timeout configuration.
• Added content-safety moderation support for custom request, response, and streaming invocation body formats.
• Added the optional authorization argument to .beta.routines.create_or_update, with RoutineAuthorization and RoutineDispatchIdentity for selecting the agent or routine creator identity.
• Added ShellToolboxTool and supporting container environment and network policy models, with the new ToolboxToolType.SHELL enum member.
• Added WebIQPreviewTool and WebIQPreviewToolboxTool, with new ToolType.WEB_IQ_PREVIEW and ToolboxToolType.WEB_IQ_PREVIEW enum members.
• Added the optional external_web_access property to WebSearchTool and WebSearchToolboxTool for disabling live internet access.

Sample updates

• Added sample_toolbox_with_shell.py under samples/agents/tools/, demonstrating a Prompt Agent invoking a ShellToolboxTool.
• Added sample_toolbox_with_shipping_skill.py under samples/agents/tools/, demonstrating a Prompt Agent using a skill through a Toolbox MCP endpoint.
• Added sample_toolbox_with_shell_and_skill.py under samples/agents/tools/, demonstrating a Prompt Agent using a skill with a ShellToolboxTool through a Toolbox MCP endpoint.
• Added sample_synthetic_multiturn_evaluation.py under samples/evaluations/, demonstrating simulation seed generation from an agent followed by multi-turn conversation simulation and evaluation.
• Added sample_responses_model_router.py under samples/responses/, demonstrating a Responses API request to a model router deployment and selection of a model by the router.

Bugs Fixed

• Fixed Responses API instrumentation for with_raw_response streaming calls (GitHub issue 48646).

Dependency update

• Dependency on openai has changed to openai>=3.0.0, which requires httpx2 instead of httpx.
• Support for Python 3.9 was dropped. The new minimum supported Python version is 3.10.

Features Added

• Added stable Agent-to-Agent (A2A) tools A2ATool and A2AToolboxTool, with the new A2AProtocolVersion enum for selecting protocol version 1.0.
• Method .beta.agents.begin_create_optimization_job now returns a custom LRO poller named AgentOptimizationLROPoller. Its details property exposes the created job ID as job_id.
• Method .beta.datasets.begin_create_generation_job now returns a custom LRO poller named DatasetGenerationLROPoller. Its details property exposes the created job ID as job_id.
• Method .beta.evaluators.begin_create_generation_job now returns a custom LRO poller named EvaluatorGenerationLROPoller. Its details property exposes the created job ID as job_id.
• Added the optional read-only state_source property to AgentDetails and the new AgentStateSource enum.
• Added programmatic tool calling through ProgrammaticToolCallingParam and SpecificProgrammaticToolCallingParam, with new ToolType.PROGRAMMATIC_TOOL_CALLING and ToolChoiceParamType.PROGRAMMATIC_TOOL_CALLING enum members.
• Added the optional allowed_callers property to ApplyPatchToolParam, CodeInterpreterTool, CodeInterpreterToolboxTool, CustomToolParam, FunctionShellToolParam, FunctionTool, FunctionToolParam, MCPTool, and MCPToolboxTool. Added the new CallableToolAllowedCaller enum values direct and programmatic.
• Expanded Reasoning with optional mode and context properties. Added ReasoningModeEnum for standard and pro; effort now uses the new ReasoningEffort enum, including the new max effort.

Breaking Changes

All breaking changes are associated with beta features.

• Methods .beta.routines.list and .beta.routines.list_runs replaced the before argument with after and now use the service-provided next_link for continuation.
• Renamed class TaskGenerationDataGenerationJobOptions to SimulationSeedDataGenerationJobOptions. The corresponding DataGenerationJobType.TASK_GENERATION enum member was renamed to DataGenerationJobType.SIMULATION_SEED, and its wire value changed from task_generation to simulation_seed.
• Renamed enum OptimizationDatasetInputType to AgentOptimizationDatasetInputType.
• Renamed class OptimizationAgentIdentifier to OptimizedAgentIdentifier.
• Renamed class OptimizationCandidate to AgentOptimizationCandidate.
• Renamed class OptimizationDatasetCriterion to AgentOptimizationDatasetCriterion.
• Renamed class OptimizationDatasetInput to AgentOptimizationDatasetInput.
• Renamed class OptimizationDatasetItem to AgentOptimizationDatasetItem.
• Renamed class OptimizationEvaluatorRef to AgentOptimizationEvaluatorRef.
• Renamed class OptimizationInlineDatasetInput to AgentOptimizationInlineDatasetInput.
• Renamed class OptimizationJob to AgentOptimizationJob.
• Renamed class OptimizationJobInputs to AgentOptimizationJobInputs.
• Renamed class OptimizationJobListItem to AgentOptimizationJobListItem.
• Renamed class OptimizationJobProgress to AgentOptimizationJobProgress.
• Renamed class OptimizationJobResult to AgentOptimizationJobResult.
• Renamed class OptimizationOptions to AgentOptimizationOptions.
• Renamed class OptimizationReferenceDatasetInput to AgentOptimizationReferenceDatasetInput.

Sample updates

• Added sample_dataset_generation_job_simpleqna_for_finetuning_async.py under samples/datasets/, demonstrating asynchronous generation of a SimpleQnA dataset for fine-tuning.
• Added sample_dataset_generation_job_simpleqna_for_finetuning_with_app_polling.py under samples/datasets/, demonstrating application-managed polling for a SimpleQnA fine-tuning data generation job.
• Added logging samples under samples/logs/:
  • sample_log_all.py demonstrating combined logging for Azure SDK and .get_openai_client() operations.
  • sample_log_from_openai_client.py demonstrating logging for an OpenAI client created from .get_openai_client().
  • sample_log_from_sdk.py demonstrating logging for Azure AI Projects SDK client operations.
  • sample_log_to_console.py demonstrating console logging configuration.
  • sample_log_with_logging_disabled.py demonstrating redacted logging behavior when logging_enable is not enabled.
• Renamed optimization polling samples sample_optimization_job_basic_polling.py and sample_optimization_job_basic_polling_async.py to sample_optimization_job_advanced_app_polling.py and sample_optimization_job_advanced_app_polling_async.py.

Features Added

• New stable toolbox tool ToolSearchToolboxTool (discriminator toolbox_search) for storing a tool-search tool in a toolbox. This replaces ToolboxSearchPreviewToolboxTool, which is still present but will be removed in a future release of the package. Please migrate your code to use the stable tool.
• New class TaskGenerationDataGenerationJobOptions (discriminator task_generation) with data generation job options for multi-turn evaluation scenarios.
• Support for non-fatal input-quality advisories from rubric evaluator generation. See new class RubricGenerationInputQualityWarning and new enums RubricGenerationInputQualityWarningCode, RubricGenerationInputQualityWarningSeverity, and RubricGenerationInputQualityWarningSource.
• New enum GenerationWarningType.
• New enum AgentIdentityStatus and new optional status property on class AgentIdentity.
• New read-only property input_quality_warnings on class EvaluatorGenerationJob.
• New read-only properties generation_job_id and warnings on class EvaluatorVersion.
• New optional property max_stalls on class OptimizationOptions.

Breaking Changes

Breaking changes in beta methods:

• Method .beta.evaluators.create_generation_job renamed to .beta.evaluators.begin_create_generation_job and is now a long-running operation returning LROPoller[EvaluatorVersion] (previously returned EvaluatorGenerationJob).
• Method .beta.datasets.create_generation_job renamed to .beta.datasets.begin_create_generation_job and is now a long-running operation returning LROPoller[DataGenerationJobResult].
• Method .beta.agents.create_optimization_job renamed to .beta.agents.begin_create_optimization_job and is now a long-running operation returning LROPoller[OptimizationJobResult].

Sample updates

• Added new optimization polling samples sample_optimization_job_basic_polling.py and sample_optimization_job_basic_polling_async.py under samples/agents/optimization/.
• Added new evaluation samples sample_endpoint_evaluator_with_api_key.py and sample_endpoint_evaluator_with_entra_id.py under samples/evaluations/.
• Added new Hosted Agent sample sample_agent_user_identity_isolation.py under samples/hosted_agents/, demonstrating per-user response-chain isolation with delegated end-user identities sent in the x-ms-user-identity header.
• Added new Hosted Agent routine samples sample_routines_with_github_issue_trigger.py and sample_routines_with_teams_message_trigger.py, demonstrating GitHub issue and Microsoft Teams channel-message triggers for routines backed by a temporary Hosted Agent version.
• Added new Hosted Agent sample sample_toolbox_with_reminder_preview.py under samples/hosted_agents/, demonstrating a Reminder Preview toolbox tool wired through a Foundry Toolbox MCP endpoint.
• Updated Hosted Agent toolbox asset samples/hosted_agents/assets/toolbox-agent/main.py to use FoundryToolbox and as_skills_provider() for toolbox MCP skill discovery and wiring, replacing the earlier manual MCP session, auth, and HTTP client setup.
• Renamed toolbox tool-search samples sample_toolboxes_with_search_preview.py and sample_toolboxes_with_search_preview_async.py to sample_toolboxes_with_search.py and sample_toolboxes_with_search_async.py.
• Renamed the Hosted Agent image-based creation samples from sample_create_hosted_agent.py and sample_create_hosted_agent_async.py to sample_create_hosted_agent_from_image.py and sample_create_hosted_agent_from_image_async.py.
• Relocated Hosted Agent routine trigger samples sample_routines_with_dispatch.py, sample_routines_with_schedule_trigger.py, and sample_routines_with_timer_trigger.py from samples/routines/ to samples/hosted_agents/.
• Removed Hosted Agent endpoint samples sample_agent_endpoint.py and sample_agent_endpoint_async.py.
• Removed routine sample samples/routines/sample_routines_crud.py.
• Removed prompt-agent toolbox skill sample samples/agents/tools/sample_agent_toolbox_skill.py because skill-in-toolbox is not yet supported in Prompt Agents.
• Updated Hosted Agent toolbox samples to create temporary Hosted Agent versions for execution flows, assign Azure AI User RBAC before invoking Toolbox MCP endpoints, restore the prior endpoint, and clean up temporary resources during teardown.

Features Added

• Hosted Agent methods are now stable. There is no need to set allow_preview=True on the AIProjectClient constructor to create a Hosted Agent.
• Session and Session Files methods are now stable. They have moved from the .beta.agents subclient to the .agents subclient.
• Agent code methods are now stable. This includes .agents.create_version_from_code and .agents.download_code methods. They have moved from the .beta.agents subclient to the .agents subclient.
• Toolboxes methods are now stable. They have moved from .beta.toolboxes subclient to the .toolboxes subclient.
• Two new methods .agents.enable and .agents.disable.
• New toolbox tool ReminderPreviewToolboxTool.
• New concept of Draft Agent Version:
  • Optional boolean argument draft added to method .agents.create_version.
  • Optional boolean property draft added to class AgentVersionDetails.
  • Optional boolean argument include_drafts added to method .agents.list_versions.
• Optional property defer_loading added to a few Agent tool classes.
• Optional property supported_evaluation_levels added to class EvaluatorVersion.
• Class BotServiceTenantAuthorizationScheme added (derived from AgentEndpointAuthorizationScheme).
• Class EndpointBasedEvaluatorDefinition added (derived from EvaluatorDefinition).

Breaking Changes

All breaking changes are associated with beta features, or beta features that are being promoted to stable.

• Toolbox method create_version now defines tools of type List[ToolboxTool] instead of List[Tool]. A new set of Toolbox tools classes, all derived from ToolboxTool, have been defined.
• Input argument structure for method create_version_from_code has been simplified. The same information is passed in, but in a modified way. Also, the code type has changed from FileType to IO[bytes], and the code_zip_sha256 was made optional (it will be calculated by the method if not provided by the caller).
• Agent Optimization methods .beta.agents.*optimization* were re-written to better align with Foundry job guidelines and platform standards. The old version accumulated unused candidate sub-resources, internal-detail properties, and custom operation patterns inconsistent with the Foundry platform. The new version removes redundant models and operations, adopts shared Foundry job patterns (JobLike<>, standard job verbs), and introduces typed discriminated unions for dataset inputs and evaluator references.
• Argument agent_session_id on Session Files methods was renamed to session_id.
• Method .beta.agents.list_optimization_candidates now returns ItemPaged[OptimizationCandidate] instead of AgentsPagedResultOptimizationCandidate. The after parameter has been removed (use continuation-token-based paging instead).
• Method .agents.patch_agent_details was renamed to .agents.update_details.
• Optional property default_ttl_seconds on class MemoryStoreDefaultOptions has changed from type int to type datetime.timedelta.
• Optional properties description, name and tool_configs have been removed from preview tools (classes derived from class Tool, with name ending in PreviewTool).
• Optional properties description, name and tool_configs are now documented as deprecated in stable Agent tools, to be removed in a future version (classes derived from class Tool with names not ending with PreviewTool).
• Optional property protocols on class AgentEndpointConfig was renamed to protocol_configuration.
• Optional property tools removed from HostedAgentDefinition.
• Optional property system_data removed from ModelVersion.
• AgentProtocol class was removed. The protocol property in class ProtocolVersionRecord is now of type Union[str, AgentEndpointProtocol].

Sample updates

• Added agent optimization samples under samples/agents/optimization/:
  • sample_optimization_job_basic.py demonstrating how to create an optimization job, poll it to completion, and read the results.
  • sample_optimization_job_cancel.py demonstrating how to create and immediately cancel an optimization job.
  • sample_optimization_job_list_get_delete.py demonstrating how to list optimization jobs with filters, get a job by ID, and delete a job.
• Added sample_routines_crud.py to demonstrate routines CRUD operations.
• Added sample_routines_with_timer_trigger.py to demonstrate triggering a routine with a timer.
• Added sample_routines_with_schedule_trigger.py to demonstrate triggering a routine on a recurring Cron schedule via ScheduleRoutineTrigger.
• Added sample_routines_with_dispatch.py to demonstrate manually firing a routine on demand via routines.dispatch(...) using a CustomRoutineTrigger.
• Added new Hosted Agent sample sample_toolbox_with_skill.py under samples/hosted_agents/, demonstrating a code-based Hosted Agent that uses Toolbox MCP skills.
• Updated sample_dataset_generation_job_traces_for_evaluation.py and sample_dataset_generation_job_traces_for_finetuning.py to create a temporary agent, seed conversations, retry the data generation job over the trace window, and clean up all created resources.
• Updated the rubric evaluator generation samples (sample_rubric_evaluator_generation_basic.py, sample_rubric_evaluator_generation_iterate.py, sample_rubric_evaluator_generation_lifecycle.py, sample_rubric_evaluator_generation_all_sources.py) to use the typed EvaluatorGenerationJob / EvaluatorGenerationInputs / *EvaluatorGenerationJobSource models. The job inputs are now nested under inputs per the service contract, and the traces source uses datetime values for start_time / end_time.
• Updated Hosted Agent code-upload samples (sample_create_hosted_agent_from_code.py, sample_create_hosted_agent_from_code_async.py) to target runtime python_3_14, since python_3_12 is no longer supported.
• Updated Hosted Agent echo-agent assets (samples/hosted_agents/assets/echo-agent/main.py, echo-agent-prebuilt.zip) to use @app.response_handler, resolving a response-handling issue. The remote-build code-upload sample now builds the echo-agent zip from samples/hosted_agents/assets/echo-agent/ at runtime instead of relying on a checked-in echo-agent.zip, so users can update the agent code and rerun the sample with their changes.
• Updated Skills upload/download samples (sample_skills_upload_and_download.py, sample_skills_upload_and_download_async.py) to build the team-status-update.zip package from samples/skills/assets/team-status-update/ at runtime instead of relying on a checked-in zip archive, so users can update the skill content and rerun the sample with their changes.
• Updated scheduled evaluation samples (sample_scheduled_evaluations.py, sample_scheduled_agent_traces_evaluation_smart_filter.py) to import ResourceManagementClient from azure.mgmt.resource.resources.
• Relocated and renamed sample_skill_in_toolbox.py (from samples/hosted_agents/) to samples/agents/tools/sample_agent_toolbox_skill.py.
• Relocated Skills samples from samples/hosted_agents/ to samples/skills/:
  • sample_skills_crud.py.
  • sample_skills_upload_and_download.py.
• Relocated Toolbox sample from samples/hosted_agents/ to samples/toolboxes/sample_toolboxes_crud.py.

Features Added

• Support integration of external Agents (in preview). See new ExternalAgentDefinition class.
• New Agent tool in preview FabricIQPreviewTool.
• New Agent tool in preview ToolboxSearchPreviewTool.
• New methods on .beta.agents for
  • Code-based hosted agents: create_version_from_code, download_code.
  • Optimization jobs: create_optimization_job, get_optimization_job, list_optimization_jobs, cancel_optimization_job, list_optimization_candidates.
  • Optimization candidate management: list_optimization_candidates, get_optimization_candidate, get_optimization_candidate_config, get_optimization_candidate_results, get_candidate_file, promote_candidate.
  • stop_session to stop a running agent session.
• New .beta.datasets sub-client with data generation job operations: create_generation_job, get_generation_job, list_generation_jobs, cancel_generation_job, delete_generation_job.
• New .beta.models sub-client to handle AI model weights: create, list_versions, list, get, delete, update, pending_create_version, pending_upload, get_credentials.
• New .beta.routines sub-client with routine operations: create_or_update, get, enable, disable, list, delete, list_runs, dispatch.
• New methods on .beta.evaluators for evaluator generation jobs: create_generation_job, get_generation_job, list_generation_jobs, cancel_generation_job, delete_generation_job.
• New methods on .beta.memory_stores to handle individual memory items: create_memory, update_memory, list_memories, get_memory, delete_memory.
• New methods on .beta.skills for versioned skill management: create, list_versions, get_version, download_version, delete_version.
• New optional string properties description and name added to Agent tools classes which did not have them before.
• New optional tool_configs added to Agent tool classes.
• New read-only property content_hash on CodeConfiguration, returning the SHA-256 hex digest of the uploaded code zip.
• New optional force parameter on agents.delete and agents.delete_version methods.
• New optional blueprint_reference parameters on agents.create_version method.

Breaking Changes

Breaking changes in beta methods:

• Argument isolation_key in methods .beta.agents.create_session() and .beta.agents.delete_session() renamed to user_isolation_key.
• Argument body in methods .beta.evaluation_taxonomies.create() and .beta.evaluation_taxonomies.update() renamed to taxonomy.
• Argument body in method .beta.skills.create_from_files() renamed to content.
• Method .beta.agents.get_session_files renamed to .beta.agents.list_session_files.
• Method .beta.skills.create signature changed — now takes name and keyword inline_content: SkillInlineContent; returns SkillVersion.
• Method .beta.skills.create_from_package renamed to .beta.skills.create_from_files.
• Method .beta.skills.create_from_files signature changed — now takes name and content: CreateSkillVersionFromFilesBody; returns SkillVersion.
• Method .beta.skills.update signature changed — now only accepts keyword default_version; returns SkillDetails.

Breaking changes in beta classes:

• Required property isolation_key_source removed from class EntraAuthorizationScheme.
• Renamed class AgentEndpoint to AgentEndpointConfig.
• Renamed class DeleteSkillResponse to DeleteSkillResult.
• Renamed class SessionDirectoryListResponse to SessionDirectoryListResult.
• Renamed class SessionFileWriteResponse to SessionFileWriteResult.
• Renamed class SkillObject to SkillDetails. Property skill_id renamed to id. Properties has_blob and metadata were removed.
• Renamed class Target to EvaluationTarget.
• Renamed class TargetConfig to RedTeamTargetConfig.

Bugs Fixed

• Fixed telemetry instrumentor to correctly call is_recording() as a method on spans, ensuring non-recording spans are properly skipped (e.g., when sampling is configured) (GitHub issue 46544).

Sample updates

• Added new Agent tool samples sample_agent_work_iq.py and sample_agent_work_iq_async.py demonstrating use of WorkIQPreviewTool.
• Added new Agent tool samples sample_agent_fabric_iq.py and sample_agent_fabric_iq_async.py demonstrating use of FabricIQPreviewTool.
• Hosted Agents:
  • Added Hosted Agent creation samples sample_create_hosted_agent.py and sample_create_hosted_agent_async.py, demonstrating hosted agent version creation and retrieval with AIProjectClient.
  • Added Hosted Agent code-upload samples sample_create_hosted_agent_from_code.py and sample_create_hosted_agent_from_code_async.py, demonstrating uploading a code package (zip) as a new hosted agent version.
  • The Hosted Agent creation sample also demonstrates assigning the hosted agent managed identity the Azure AI User RBAC role on the backing Azure AI account.
  • Updated the other Hosted Agent samples to reuse an existing Hosted Agent as a prerequisite, instead of creating a new hosted agent version in each sample.
• Added Toolbox tool-search sample sample_toolboxes_with_search_preview.py and sample_toolboxes_with_search_preview_async.py, demonstrating creating a Toolbox version with ToolboxSearchPreviewTool and invoking MCPTool.
• Added .beta.models samples under samples/models/:
  • sample_models_basic.py — synchronous end-to-end registration via the create helper (uses azcopy), followed by get, list_versions, list, get_credentials, update, and delete.
  • sample_models_create_and_poll.py — alternative synchronous registration that hand-rolls the spec's three-step flow (pending_upload → upload via azure-storage-blob → pending_create_version + poll), without taking a dependency on azcopy.
  • sample_models_basic_async.py — asynchronous version of the same three-step flow using azure.ai.projects.aio.AIProjectClient and azure.storage.blob.aio.ContainerClient.
• Added new evaluation sample sample_model_evaluation_instant_model.py demonstrating model evaluation with an instant model.
• Refreshed evaluation samples under samples/evaluations/ and samples/evaluations/agentic_evaluators/ (including sample_agent_evaluation, sample_agent_response_evaluation, sample_eval_catalog_prompt_based_evaluators, sample_evaluations_ai_assisted, sample_evaluations_builtin_with_csv, sample_evaluations_builtin_with_dataset_id, sample_evaluations_builtin_with_inline_data, sample_evaluations_builtin_with_inline_data_oai, sample_scheduled_evaluations, sample_coherence, sample_fluency, sample_intent_resolution, sample_relevance, sample_response_completeness, sample_tool_call_accuracy, sample_tool_call_success, sample_tool_input_accuracy, sample_tool_output_utilization, sample_tool_selection, and sample_generic_agentic_evaluator).
• New sample sample_dataset_generation_job_simpleqna_with_prompt_source.py showing an end-to-end flow that generates a QnA dataset via .beta.datasets.create_generation_job and runs an OpenAI evaluation.

Features Added

• New WorkIQPreviewTool.
• 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).

Bugs Fixed

• Fix custom Memory Stores LRO poller operation to add the missing required "Foundry-Features": "MemoryStores=V1Preview" HTTP request header.

First stable release of the client library that uses the Generally Available (GA) version "v1" of the Foundry REST APIs.

Features Added

• To enable preview (beta) operations, a new optional boolean input argument named allow_preview was added to the constructor of AIProjectClient. Caller must set it to True to opt-in to preview features. This includes creating an Hosted Agent or Workflow Agent. Methods on the .beta sub-client (for example .beta.memory_stores.create()) do not require setting allow_preview=True since it's implied by the sub-client name. When preview features are enabled, the client libraries sends the HTTP request header Foundry-Features with the appropriate value in all relevant calls to the service.

Breaking Changes

• Input argument foundry_features was removed from all methods that supported it. Use the new allow_preview instead on client constructor (see above).
• Class TextResponseFormatConfiguration renamed to TextResponseFormat.
• Class TextResponseFormatConfigurationResponseFormatText renamed to TextResponseFormatTest.
• Class TextResponseFormatConfigurationResponseFormatJsonObject renamed to TextResponseFormatJsonObject.
• Class CodeInterpreterContainerAuto was renamed to AutoCodeInterpreterToolParam, and has a new optional property network_policy of type ContainerNetworkPolicyParam.
• class ImageGenActionEnum was renamed to ImageGenAction.
• Rename ToolChoiceParamType.WEB_SEARCH_PREVIEW2025_03_11 to ToolChoiceParamType.WEB_SEARCH_PREVIEW_2025_03_11.
• Rename RankerVersionType.DEFAULT2024_11_15 to RankerVersionType.DEFAULT_2024_11_15.
• Rename method .beta.evaluators.list_latest_versions() to .beta.evaluators.list().
• Rename property id on class Insight to insight_id.
• Rename property id on class Schedule to schedule_id.
• Rename input argument id to insight_id in .beta.insights.get() method.
• Rename input argument id to schedule_id in .beta.schedules methods.
• Updated datetime-typed fields (start_time, end_time, trigger_at, trigger_time, created_at, modified_at) across CronTrigger, RecurrenceTrigger, OneTimeTrigger, ScheduleRun, and EvaluatorVersion classes from str 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 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].

This is the first release that uses the Generally Available (GA) version "v1" of the Foundry REST APIs.

Features Added

• Tracing: included agent ID in response generation traces when available.
• Tracing: Added support for opt-in trace context propagation.

Breaking changes

• A Responses call on OpenAPI client (openai_client.responses.create()) that uses an Agent reference, now needs to specify extra_body={"agent_reference": {"name": agent_name, "type": "agent_reference"}} instead of extra_body={"agent": {"name": agent_name, "type": "agent_reference"}}.
• Agent methods .agents.create(), .agents.create_from_manifest(), .agents.update() and .agents.update_from_manifest() were removed. Use the remaining methods .agents.create_version() and .agents.create_version_from_manifest() instead.
• To align with OpenAI naming conventions, use "Tool" suffix for class names describing Azure tools that are generally available (stable release):
  • Rename class AzureAISearchAgentTool to AzureAISearchTool.
  • Rename class AzureFunctionAgentTool to AzureFunctionTool.
  • Rename class BingGroundingAgentTool to BingGroundingTool.
  • Rename class OpenApiAgentTool to OpenApiTool.
• To align with OpenAI naming conventions, use "PreviewTool" suffix for class names describing Azure tools in preview:
  • Rename class A2ATool to A2APreviewTool.
  • Rename class BingCustomSearchAgentTool to BingCustomSearchPreviewTool.
  • Rename class BrowserAutomationAgentTool to BrowserAutomationPreviewTool.
  • Rename class MemorySearchTool to MemorySearchPreviewTool.
  • Rename class MicrosoftFabricAgentTool to MicrosoftFabricPreviewTool.
  • Rename class SharepointAgentTool to SharepointPreviewTool.
• Other class renames:
  • Rename class PromptAgentDefinitionText to PromptAgentDefinitionTextOptions
  • Rename class EvaluationComparisonRequest to InsightRequest
• To use Workflow Agents, which are still in preview, you now need to set an additional input argument foundry_features=FoundryFeaturesOptInKeys.WORKFLOW_AGENTS_V1_PREVIEW when calling .agents.create_version().
• To use Hosted Agents, which are still in preview, you now need to set an additional input argument foundry_features=FoundryFeaturesOptInKeys.HOSTED_AGENTS_V1_PREVIEW when calling .agents.create_version().
• To use .evaluation_rules.create_or_update() with HumanEvaluationPreviewRuleAction, you now need to set an additional input argument foundry_features=FoundryFeaturesOptInKeys.EVALUATIONS_V1_PREVIEW.
• Operation sets that are still in preview now have the ".beta" subclient in their call path. So for example project_client.memory_stores.create() has changed to project_client.beta.memory_stores.create(). Similarly for the operation sets: evaluators, insights, evaluation_taxonomies, schedules and red_teams.
• The method begin_update_memories() in Memory Stores operation now accept optional items of type List[dict[str, Any]] instead of List[ItemParam]. Similarly for items in method search_memories(). As a result around 100 classes that are derived from ItemParam were removed as they are no longer used by the client library.
• Tracing instrumentation, is an experimental preview feature, now requires explicitly opt in by setting the environment variable: AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING=true
• Tracing: workflow actions in conversation item listings are now emitted as "gen_ai.conversation.item" events (with role="workflow") instead of "gen_ai.workflow.action" events in the list_conversation_items span.
• Tracing: response generation span names changed from "responses {model_name}" to "chat {model_name}" for model calls and from "responses {agent_name}" to "invoke_agent {agent_name}" for agent calls.
• Tracing: response generation operation names changed from "responses" to "chat" for model calls and from "responses" to "invoke_agent" for agent calls.
• Tracing: response generation uses gen_ai.input.messages and gen_ai.output.messages attributes directly under the span instead of events.
• Tracing: agent creation uses gen_ai.system_instructions attribute directly under the span instead of an event. Note that the attribute name is gen_ai.system_instructions not gen_ai.system.instructions.
• Tracing: "gen_ai.provider.name" attribute value changed to "microsoft.foundry".
• Tracing: the format of the function tool call related traces in input and output messages changed to {"type": "tool_call", "id": "...", "name": "...", "arguments": {...}} and {"type": "tool_call_response", "id": "...", "result": "..."}

Sample updates

• Add and update samples for AzureFunctionTool, WebSearchTool, and WebSearchPreviewTool
• All samples for agent tools call responses.create API with agent_reference instead of agent

Features Added

• The package now takes dependency on openai and azure-identity packages. No need to install them separately.
• Tracing: support for tracing the schema when an Agent is created with structured output definition.

Breaking changes

• Rename class AgentObject to AgentDetails
• Rename class AgentVersionObject to AgentVersionDetails
• Rename class MemoryStoreObject to MemoryStoreDetails
• Tracing: removed outer "content" from event content format wrapper and unified type-specific keys (e.g., "text", "image_url") to generic "content" key.
• Tracing: replaced "gen_ai.request.assistant_name" attribute with gen_ai.agent.name.
• Tracing: removed "gen_ai.system" - the "gen_ai.provider.name" provides same information.
• Tracing: changed "gen_ai.user.message" and "gen_ai.tool.message" to "gen_ai.input.messages". Changed "gen_ai.assistant.message" to "gen_ai.output.messages".
• Tracing: changed "gen_ai.system.instruction" to "gen_ai.system.instructions".
• Tracing: added the "parts" array to "gen_ai.input.messages" and "gen_ai.output.messages".
• Tracing: removed "role" as a separate attribute and added "role" to "gen_ai.input.messages" and "gen_ai.output.messages" content.
• Tracing: added "finish_reason" as part of "gen_ai.output.messages" content.
• Tracing: changed the tool calls to use the api definitions as the types in traces. For example "function_call" instead of "function" and "function_call_output" instead of "function"

Bugs Fixed

• Tracing: fixed a bug with computer use tool call output including screenshot binary data even when binary data tracing is off.

Sample updates

• Added OpenAPI tool sample. See sample_agent_openapi.py.
• Added OpenAPI with Project Connection sample. See sample_agent_openapi_with_project_connection.py.
• Added SharePoint grounding tool sample. See sample_agent_sharepoint.py.
• Improved MCP client sample showing direct MCP tool invocation. See samples/mcp_client/sample_mcp_tool_async.py.
• Samples that download generated files (code interpreter and image generation) now save files to the system temp directory instead of the current working directory. See sample_agent_code_interpreter.py, sample_agent_code_interpreter_async.py, sample_agent_image_generation.py, and sample_agent_image_generation_async.py.
• The Agent to Agent sample was updated to allow "Custom keys" connection type.
• Update Fine-Tuning supervised job samples to show waiting for model result instead of polling
• Add evaluations sample samples/evaluations/sample_evaluations_score_model_grader_with_image.py.
• Add basic steam event samples samples/agents/sample_agent_stream_events.py and samples/responses/sample_responses_stream_events.py

Features Added

• Tracing: support for workflow agent tracing.
• Agent Memory operations, including code for custom LRO poller. See methods on the ".memory_store" property of AIProjectClient.

Breaking changes

• get_openai_client() method on the asynchronous AIProjectClient is no longer an "async" method.
• Tracing: tool call output event content format updated to be in line with other events.

Bugs Fixed

• Tracing: operation name attribute added to create agent span, token usage added to streaming response generation span.

Sample updates

• Added samples to show usage of the Memory Search Tool (see sample_agent_memory_search.py) and its async equivalent.
• Added samples to show Memory management. See samples in the folder samples\memories.
• Added finetuning samples for operations create, retrieve, list, list_events, list_checkpoints, cancel, pause and resume. Also, these samples includes various finetuning techniques like Supervised (SFT), Reinforcement (RFT) and Direct performance optimization (DPO).
• In all most samples, credential, project client, and openai client are combined into one context manager.
• Remove await while calling get_openai_client() for samples using asynchronous clients.

Features added

• The client library now uses version 2025-11-15-preview of the Microsoft Foundry data plane REST APIs.
• New Agent operations (now built on top of OpenAI's Responses protocol) were added to the AIProjectClient. This package no longer depends on azure-ai-agents package. See samples\agents folder.
• New Evaluation operations. See methods on properties .evaluation_rules, .evaluation_taxonomies, .evaluators, .insights, and .schedules.
• New Memory Store operations. See methods on the property .memory_store.

Breaking changes

• The implementation of .get_openai_client() method was updated to return an authenticated OpenAI client from the openai package, configure to run Responses operations on your Foundry Project endpoint.

Sample updates

• Added new Agent samples. See samples\agents folder.
• Added new Evaluation samples. See samples\evaluations folder.
• Added files samples for operations create, delete, list, retrieve and content. See samples\files folder.

Bugs Fixed

• Fix getting secret keys for connections of type "Custom Keys" (GitHub issue 52355)

Features added

• File setup.py was updated to indicate the dependency azure-ai-agents>=1.2.0b3 instead of azure-ai-agents>=1.0.0. This means that in a clean environment, installing via pip install --pre azure-ai-projects will install latest beta version of azure-ai-agents (which has features in preview) instead of latest stable version (which does not include preview features).

Bugs Fixed

Fix regression in Red-Team operations, in the definition of the class AzureOpenAIModelConfiguration.

First beta version following the 1.0.0 stable release. It brings back the Evaluation and Red-Team operations which are still in preview.

Features added

• Evaluation and Red-Team operations (in preview) were restored.

First stable version of the client library. The client library now uses version v1 of the AI Foundry data plane REST APIs.

Breaking changes

• Features that are still in preview were removed from this stable release. This includes:
  • Evaluation operations (property .evaluations)
  • Red-Team operations (property .red_teams)
  • Class PromptTemplate.
  • Package function enable_telemetry()
• Classes were renamed:
  • Class Sku was renamed ModelDeploymentSku
  • Class SasCredential was renamed BlobReferenceSasCredential
  • Class AssetCredentialResponse was renamed DatasetCredential
• Method .inference.get_azure_openai_client() was renamed .get_openai_client(). The .inference property was removed. The method is documented as returning an object of type OpenAI, but it still returns an object of the derived type AzureOpenAI. The function implementation has not changed.
• Method .telemetry.get_connection_string() was renamed .telemetry.get_application_insights_connection_string()

Sample updates

• Added a new Dataset sample named sample_datasets_download.py to show how you can download all files referenced by a certain Dataset (following a question in this GitHub issue)
• Two samples added showing how to do a responses operation using an authenticated Azure OpenAI client created using get_openai_client().
• Existing inference samples that used the package function enable_telemetry() were updated to remove this call, and instead add the necessary tracing configuration calls to the sample.

Breaking changes

• These 3 methods on AIProjectClient were removed: .inference.get_chat_completions_client(), .inference.get_embeddings_client() and .inference.get_image_embeddings_client(). For guidance on obtaining an authenticated azure-ai-inference client for your AI Foundry Project, refer to the updated samples in the samples\inference directory. For example, sample_chat_completions_with_azure_ai_inference_client.py. Alternatively, use the .inference.get_azure_openai_client() method to perform chat completions with an Azure OpenAI client.
• Method argument name changes:
  • In method .indexes.create_or_update() argument body was renamed index.
  • In method .datasets.create_or_update() argument body was renamed dataset_version.
  • In method .datasets.pending_upload() argument body was renamed pending_upload_request.

Bugs Fixed

• Fix to package function enable_telemetry() to correctly instrument azure-ai-agents.
• Updated RedTeam target type visibility to allow for type being sent in the JSON for redteam run creation.

Other

• Set dependency on azure-ai-agents version 1.0.0 or above, now that we have a stable release of the Agents package.

There have been significant updates with the release of version 1.0.0b11, including breaking changes. Please see new samples and package README.md file.

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 your 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. The factory method from_connection_string was removed. Support for project connection string and hub-based projects has been discontinued. We recommend creating a new Azure AI Foundry resource utilizing project endpoint. If this is not possible, please pin the version of or pin the version of azure-ai-projects to 1.0.0b10 or earlier.
• Agents are now implemented in a separate package azure-ai-agents. Continue using the ".agents" operations on the AIProjectsClient to create, run and delete agents, as before. However there have been some breaking changes in these operations. See Agents package document and samples for more details.
• Several changes to the .connections methods, including the response object (now simply called Connection)
• The method .inference.get_azure_openai_client() now supports returning an authenticated AzureOpenAI client to be used with AI models deployed to the Project's AI Services. This is in addition to the existing option to get an AzureOpenAI client for one of the connected Azure OpenAI services.
• Import PromptTemplate from azure.ai.projects instead of azure.ai.projects.prompts.
• The class ConnectionProperties was renamed to Connection, and its properties have changed.
• The method .to_evaluator_model_config on ConnectionProperties is no longer required and does not have an equivalent method on Connection. When constructing the EvaluatorConfiguration class, the init_params element now requires deployment_name instead of model_config.
• The method upload_file on AIProjectClient had been removed, use datasets.upload_file instead.
• Evaluator Ids are available using the Enum EvaluatorIds and no longer require azure-ai-evaluation package to be installed.
• Property scope on AIProjectClient is removed, use AI Foundry Project endpoint instead.
• Property id on Evaluation is replaced with name.
• Please see the agents migration guide on how to use the new azure-ai-projects with azure-ai-agents package.

Sample updates

• All samples have been updated. New ones added for Deployments, Datasets and Indexes.

Features added

• Added ConnectedAgentTool class for better connected Agent support.
• Added Agent tool call tracing for all tool call types when streaming with AgentEventHandler based event handler.
• Added tracing for listing Agent run steps.
• Add a max_retry argument to the Agent's enable_auto_function_calls function to cancel the run if the maximum number of retries for auto function calls is reached.

Sample updates

• Added connected Agent tool sample.

Bugs Fixed

• Fix for filtering of Agent messages by run ID (see GitHub issue 49513).

Features added

• Utilities to load prompt template strings and Prompty file content
• Added BingCustomSearchTool class with sample
• Added list_threads API to agents namespace
• Added image input support for agents create_message

Sample updates

• Added project_client.agents.enable_auto_function_calls(toolset=toolset) to all samples that has toolcalls executed by azure-ai-project SDK
• New BingCustomSearchTool sample
• New samples added for image input from url, file and base64

Breaking Changes

Redesigned automatic function calls because agents retrieved by update_agent and get_agent do not support them. With the new design, the toolset parameter in create_agent no longer executes toolcalls automatically during create_and_process_run or create_stream. To retain this behavior, call enable_auto_function_calls without additional changes.

Features added

• New parameters added for Azure AI Search tool, with corresponding sample update.
• Fabric tool REST name updated, along with convenience code.

Sample updates

• Sample update demonstrating new parameters added for Azure AI Search tool.
• Sample added using OpenAPI tool against authenticated TripAdvisor API spec.

Bugs Fixed

• Fix for a bug in Agent tracing causing event handler return values to not be returned when tracing is enabled.
• Fix for a bug in Agent tracing causing tool calls not to be recorded in traces.
• Fix for a bug in Agent tracing causing function tool calls to not work properly when tracing is enabled.
• Fix for a bug in Agent streaming, where agent_id was not included in the response. This caused the SDK not to make function calls when the thread run status is requires_action.

Features added

• Add support for parsing URL citations in Agent text messages. See new classes MessageTextUrlCitationAnnotation and MessageDeltaTextUrlCitationAnnotation.
• Add enum value ConnectionType.API_KEY to support enumeration of generic connections that uses API Key authentication.

Sample updates

• Update sample sample_agents_bing_grounding.py with printout of URL citation.
• Add new samples sample_agents_stream_eventhandler_with_bing_grounding.py and sample_agents_stream_iteration_with_bing_grounding.py with printout of URL citation.

Bugs Fixed

• Fix a bug in deserialization of RunStepDeltaFileSearchToolCall returned during Agent streaming (see GitHub issue 48333).
• Fix for Exception raised while parsing Agent streaming response, in some rare cases, for multibyte UTF-8 languages like Chinese.

Breaking Changes

• Rename input argument assistant_id to agent_id in all Agent methods to align with the "Agent" terminology. Similarly, rename all assistant_id properties on classes.

Features added

• Added trace_function decorator for conveniently tracing function calls in Agents using OpenTelemetry. Please see the README.md for updated documentation.

Sample updates

• Added AzureLogicAppTool utility and Logic App sample under samples/agents, folder to make Azure Logic App integration with Agents easier.
• Added better observability for Azure AI Search sample for Agents via improved run steps information from the service.
• Added sample to demonstrate how to add custom attributes to telemetry span.

Bugs Fixed

• Lowered the logging level of "Toolset is not available in the client" from warning to debug to prevent unnecessary log entries in agent application runs.

Features added

• Add method .inference.get_image_embeddings_client on AIProjectClient to get an authenticated ImageEmbeddingsClient (from the package azure-ai-inference). You need to have azure-ai-inference package version 1.0.0b7 or above installed for this method to work.

Bugs Fixed

• Fix for events dropped in streamed Agent response (see GitHub issue 39028).
• In Agents, incomplete status thread run event is now deserialized into a ThreadRun object, during stream iteration, and invokes the correct function on_thread_run (instead of the wrong function on_unhandled_event).
• Fix an error when calling the to_evaluator_model_config method of class ConnectionProperties. See new input argument include_credentials.

Breaking Changes

• submit_tool_outputs_to_run returns None instead of ThreadRun (see GitHub issue 39028).

Bugs Fixed

• Fix for Agent streaming issue (see GitHub issue 38918)
• Fix for Agent async function send_email_async is not called (see GitHub issue 38898)
• Fix for Agent streaming with event handler fails with "AttributeError: 'MyEventHandler' object has no attribute 'buffer'" (see GitHub issue 38897)

Features Added

• Add optional input argument connection_name to methods .inference.get_chat_completions_client, .inference.get_embeddings_client and .inference.get_azure_openai_client.

Features Added

• Add support for Structured Outputs for Agents.
• Add option to include file contents, when index search is used for Agents.
• Added objects to inform Agents about Azure Functions.
• Redesigned streaming and event handlers for agents.
• Add parallel_tool_calls parameter to allow parallel tool execution for Agents.
• Added BingGroundingTool for Agents to use against a Bing API Key connection.
• Added AzureAiSearchTool for Agents to use against an Azure AI Search resource.
• Added OpenApiTool for Agents, which creates and executes a REST function defined by an OpenAPI spec.
• Added new helper properties in OpenAIPageableListOfThreadMessage, MessageDeltaChunk, and ThreadMessage.
• Rename "AI Studio" to "AI Foundry" in package documents and samples, following recent rebranding.

Breaking Changes

• The method .agents.get_messages was removed. Please use .agents.list_messages instead.

Bugs Fixed

• Fix a bug in the .inference operations when Entra ID authentication is used by the default connection.
• Fixed bugs occurring during streaming in function tool calls by asynchronous agents.
• Fixed bugs that were causing issues with tracing agent asynchronous functionality.
• Fix a bug causing warning about unclosed session, shown when using asynchronous credentials to create agent.
• Fix a bug that would cause agent function tool related function names and parameters to be included in traces even when content recording is not enabled.

Features Added

First beta version