Skip to content

Commit 7d8a485

Browse files
authored
[azure-ai-projects] Emit SDK from TypeSpec (feature/foundry-release 10482dd) (#47185)
1 parent 3b34514 commit 7d8a485

34 files changed

Lines changed: 4075 additions & 1967 deletions

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

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,27 +7,35 @@
77
* Support integration of external Agents (in preview). See new `ExternalAgentDefinition` class.
88
* New Agent tool in preview `FabricIQPreviewTool`.
99
* New Agent tool in preview `ToolboxSearchPreviewTool`.
10-
* New optional string properties `description` and `name` added to Agent tools classes which did not have them before.
11-
* New optional `tool_configs` added to Agent tool classes.
1210
* 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`.
1311
* New `.beta.models` sub-client to handle AI model weights: `list_versions`, `list`, `get`, `delete`, `update`, `pending_create_version`, `pending_upload`, `get_credentials`.
1412
* New `.beta.routines` sub-client with routine operations: `create_or_update`, `get`, `enable`, `disable`, `list`, `delete`, `list_runs`, `dispatch`.
1513
* New methods on `.beta.evaluators` for evaluator generation jobs: `create_generation_job`, `get_generation_job`, `list_generation_jobs`, `cancel_generation_job`, `delete_generation_job`.
1614
* New methods on `.beta.agents` for code-based hosted agents: `create_version_from_code`, `download_code`.
1715
* New methods on `.beta.agents` for optimization jobs: `create_optimization_job`, `get_optimization_job`, `list_optimization_jobs`, `cancel_optimization_job`, `list_optimization_candidates`.
16+
* New methods on `.beta.agents` for optimization candidate management: `get_candidate_file`, `promote_candidate`.
17+
* New method `beta.agents.stop_session` to stop a running agent session.
1818
* New methods on `.beta.memory_stores` to handle individual memory items:`.beta.memory_stores`: `get_memory`, `delete_memory`.
19+
* New convenience method `.beta.models.create()` that wraps the spec's three-step upload-first sequence (`pending_upload` --> `azcopy copy` --> `pending_create_version`) and polls `get()` until the new `ModelVersion` is observable.
20+
* New methods on `.beta.skills` for versioned skill management: `create`, `list_versions`, `get_version`, `download_version`, `delete_version`.
21+
* New optional string properties `description` and `name` added to Agent tools classes which did not have them before.
22+
* New optional `tool_configs` added to Agent tool classes.
1923
* New read-only property `content_hash` on `CodeConfiguration`, returning the SHA-256 hex digest of the uploaded code zip.
2024
* New optional `force` parameter on `agents.delete` and `agents.delete_version` methods.
2125
* New optional `blueprint_reference` parameters on `agents.create_version` method.
22-
* 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.
23-
* New convenience method `.beta.models.create()` that wraps the spec's three-step upload-first sequence (`pending_upload``azcopy copy``pending_create_version`) and polls `get()` until the new `ModelVersion` is observable.
26+
2427

2528
### Breaking Changes
2629

2730
Breaking changes in beta methods:
2831
* Required keyword `isolation_key` removed from `.beta.agents.create_session()` and `.beta.agents.delete_session()` methods.
2932
* Argument `body` in methods `.beta.evaluation_taxonomies.create()` and `.beta.evaluation_taxonomies.update()` renamed to `taxonomy`.
30-
* Argument `body` in method `.beta.skills.create_from_package()` renamed to `content`.
33+
* Argument `body` in method `.beta.skills.create_from_files()` renamed to `content`.
34+
* Method `.beta.agents.get_session_files` renamed to `.beta.agents.list_session_files`.
35+
* Method `.beta.skills.create` signature changed — now takes `name` and keyword `inline_content: SkillInlineContent`; returns `SkillVersion`.
36+
* Method `.beta.skills.create_from_package` renamed to `.beta.skills.create_from_files`.
37+
* Method `.beta.skills.create_from_files` signature changed — now takes `name` and `content: CreateSkillVersionFromFilesBody`; returns `SkillVersion`.
38+
* Method `.beta.skills.update` signature changed — now only accepts keyword `default_version`; returns `SkillDetails`.
3139

3240
Breaking changes in beta classes:
3341
* Required property `isolation_key_source` removed from class `EntraAuthorizationScheme`.
@@ -40,6 +48,13 @@ Breaking changes in beta classes:
4048
* Renamed class `TargetConfig` to `RedTeamTargetConfig`.
4149
* Removed class `FabricIQPreviewToolParameters`.
4250
* Removed class `WorkIQPreviewToolParameters`.
51+
* Enum values `ContainerMemoryLimit.MEMORY_1GB/4GB/16GB/64GB` renamed to `MEMORY1_GB/MEMORY4_GB/MEMORY16_GB/MEMORY64_GB`.
52+
* Renamed class `GitHubIssueOpenedRoutineTrigger` to `GitHubIssueRoutineTrigger`.
53+
* Renamed enum value `RoutineTriggerType.GITHUB_ISSUE_OPENED` to `GITHUB_ISSUE`.
54+
* Removed enum value `DataGenerationJobSourceType.DATASET`.
55+
* Removed classes: `DatasetDataGenerationJobSource`, `DatasetItem`, `EvalRunOutputItemResultStatus`, `EvaluationCriterion`, `OptimizationAgentSkill`, `RoutineRunDiagnostics`.
56+
* Removed enums: `OptimizationMode`, `OptimizationStrategy`.
57+
* Removed properties `has_blob`, `skill_id`, `metadata` from class `SkillDetails`.
4358

4459
### Bugs Fixed
4560

@@ -56,6 +71,7 @@ Breaking changes in beta classes:
5671
* `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`.
5772
* `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`.
5873
* `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`.
74+
* 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.
5975

6076
## 2.1.0 (2026-04-20)
6177

sdk/ai/azure-ai-projects/apiview-properties.json

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@
2020
"azure.ai.projects.models.AgentEvaluatorGenerationJobSource": "Azure.AI.Projects.AgentEvaluatorGenerationJobSource",
2121
"azure.ai.projects.models.BaseCredentials": "Azure.AI.Projects.BaseCredentials",
2222
"azure.ai.projects.models.AgenticIdentityPreviewCredentials": "Azure.AI.Projects.AgenticIdentityPreviewCredentials",
23+
"azure.ai.projects.models.AgentIdentifier": "Azure.AI.Projects.AgentIdentifier",
2324
"azure.ai.projects.models.AgentIdentity": "Azure.AI.Projects.AgentIdentity",
2425
"azure.ai.projects.models.AgentObjectVersions": "Azure.AI.Projects.AgentObject.versions.anonymous",
2526
"azure.ai.projects.models.AgentSessionResource": "Azure.AI.Projects.AgentSessionResource",
@@ -63,6 +64,8 @@
6364
"azure.ai.projects.models.BrowserAutomationToolConnectionParameters": "Azure.AI.Projects.BrowserAutomationToolConnectionParameters",
6465
"azure.ai.projects.models.BrowserAutomationToolParameters": "Azure.AI.Projects.BrowserAutomationToolParameters",
6566
"azure.ai.projects.models.CandidateDeployConfig": "Azure.AI.Projects.CandidateDeployConfig",
67+
"azure.ai.projects.models.CandidateFileInfo": "Azure.AI.Projects.CandidateFileInfo",
68+
"azure.ai.projects.models.CandidateMetadata": "Azure.AI.Projects.CandidateMetadata",
6669
"azure.ai.projects.models.CandidateResults": "Azure.AI.Projects.CandidateResults",
6770
"azure.ai.projects.models.CaptureStructuredOutputsTool": "Azure.AI.Projects.CaptureStructuredOutputsTool",
6871
"azure.ai.projects.models.ChartCoordinate": "Azure.AI.Projects.ChartCoordinate",
@@ -92,11 +95,14 @@
9295
"azure.ai.projects.models.CreateAgentVersionFromCodeContent": "Azure.AI.Projects.CreateAgentVersionFromCodeContent",
9396
"azure.ai.projects.models.CreateAgentVersionFromCodeMetadata": "Azure.AI.Projects.CreateAgentVersionFromCodeMetadata",
9497
"azure.ai.projects.models.CreateAsyncResponse": "Azure.AI.Projects.createAsync.Response.anonymous",
98+
"azure.ai.projects.models.CreateSkillVersionFromFilesBody": "Azure.AI.Projects.CreateSkillVersionFromFilesBody",
9599
"azure.ai.projects.models.Trigger": "Azure.AI.Projects.Trigger",
96100
"azure.ai.projects.models.CronTrigger": "Azure.AI.Projects.CronTrigger",
97101
"azure.ai.projects.models.CustomCredential": "Azure.AI.Projects.CustomCredential",
98102
"azure.ai.projects.models.CustomToolParamFormat": "OpenAI.CustomToolParamFormat",
99103
"azure.ai.projects.models.CustomGrammarFormatParam": "OpenAI.CustomGrammarFormatParam",
104+
"azure.ai.projects.models.RoutineTrigger": "Azure.AI.Projects.RoutineTrigger",
105+
"azure.ai.projects.models.CustomRoutineTrigger": "Azure.AI.Projects.CustomRoutineTrigger",
100106
"azure.ai.projects.models.CustomTextFormatParam": "OpenAI.CustomTextFormatParam",
101107
"azure.ai.projects.models.CustomToolParam": "OpenAI.CustomToolParam",
102108
"azure.ai.projects.models.RecurrenceSchedule": "Azure.AI.Projects.RecurrenceSchedule",
@@ -111,9 +117,8 @@
111117
"azure.ai.projects.models.DataGenerationTokenUsage": "Azure.AI.Projects.DataGenerationTokenUsage",
112118
"azure.ai.projects.models.DatasetCredential": "Azure.AI.Projects.AssetCredentialResponse",
113119
"azure.ai.projects.models.DatasetDataGenerationJobOutput": "Azure.AI.Projects.DatasetDataGenerationJobOutput",
114-
"azure.ai.projects.models.DatasetDataGenerationJobSource": "Azure.AI.Projects.DatasetDataGenerationJobSource",
115120
"azure.ai.projects.models.DatasetEvaluatorGenerationJobSource": "Azure.AI.Projects.DatasetEvaluatorGenerationJobSource",
116-
"azure.ai.projects.models.DatasetItem": "Azure.AI.Projects.DatasetItem",
121+
"azure.ai.projects.models.DatasetInfo": "Azure.AI.Projects.DatasetInfo",
117122
"azure.ai.projects.models.DatasetRef": "Azure.AI.Projects.DatasetRef",
118123
"azure.ai.projects.models.DatasetReference": "Azure.AI.Projects.DatasetReference",
119124
"azure.ai.projects.models.DatasetVersion": "Azure.AI.Projects.DatasetVersion",
@@ -122,6 +127,7 @@
122127
"azure.ai.projects.models.DeleteMemoryResult": "Azure.AI.Projects.DeleteMemoryResponse",
123128
"azure.ai.projects.models.DeleteMemoryStoreResult": "Azure.AI.Projects.DeleteMemoryStoreResponse",
124129
"azure.ai.projects.models.DeleteSkillResult": "Azure.AI.Projects.DeleteSkillResponse",
130+
"azure.ai.projects.models.DeleteSkillVersionResponse": "Azure.AI.Projects.DeleteSkillVersionResponse",
125131
"azure.ai.projects.models.Deployment": "Azure.AI.Projects.Deployment",
126132
"azure.ai.projects.models.Dimension": "Azure.AI.Projects.Dimension",
127133
"azure.ai.projects.models.DispatchRoutineResult": "Azure.AI.Projects.DispatchRoutineResponse",
@@ -131,13 +137,11 @@
131137
"azure.ai.projects.models.IsolationKeySource": "Azure.AI.Projects.IsolationKeySource",
132138
"azure.ai.projects.models.EntraIsolationKeySource": "Azure.AI.Projects.EntraIsolationKeySource",
133139
"azure.ai.projects.models.EvalResult": "Azure.AI.Projects.EvalResult",
134-
"azure.ai.projects.models.EvalRunOutputItemResult": "Azure.AI.Projects.EvalRunOutputItemResult",
135140
"azure.ai.projects.models.EvalRunResultCompareItem": "Azure.AI.Projects.EvalRunResultCompareItem",
136141
"azure.ai.projects.models.EvalRunResultComparison": "Azure.AI.Projects.EvalRunResultComparison",
137142
"azure.ai.projects.models.EvalRunResultSummary": "Azure.AI.Projects.EvalRunResultSummary",
138143
"azure.ai.projects.models.EvaluationComparisonInsightRequest": "Azure.AI.Projects.EvaluationComparisonInsightRequest",
139144
"azure.ai.projects.models.EvaluationComparisonInsightResult": "Azure.AI.Projects.EvaluationComparisonInsightResult",
140-
"azure.ai.projects.models.EvaluationCriterion": "Azure.AI.Projects.EvaluationCriterion",
141145
"azure.ai.projects.models.InsightSample": "Azure.AI.Projects.InsightSample",
142146
"azure.ai.projects.models.EvaluationResultSample": "Azure.AI.Projects.EvaluationResultSample",
143147
"azure.ai.projects.models.EvaluationRule": "Azure.AI.Projects.EvaluationRule",
@@ -170,8 +174,7 @@
170174
"azure.ai.projects.models.FunctionShellToolParamEnvironmentContainerReferenceParam": "OpenAI.FunctionShellToolParamEnvironmentContainerReferenceParam",
171175
"azure.ai.projects.models.FunctionShellToolParamEnvironmentLocalEnvironmentParam": "OpenAI.FunctionShellToolParamEnvironmentLocalEnvironmentParam",
172176
"azure.ai.projects.models.FunctionTool": "OpenAI.FunctionTool",
173-
"azure.ai.projects.models.RoutineTrigger": "Azure.AI.Projects.RoutineTrigger",
174-
"azure.ai.projects.models.GitHubIssueOpenedRoutineTrigger": "Azure.AI.Projects.GitHubIssueOpenedRoutineTrigger",
177+
"azure.ai.projects.models.GitHubIssueRoutineTrigger": "Azure.AI.Projects.GitHubIssueRoutineTrigger",
175178
"azure.ai.projects.models.HeaderIsolationKeySource": "Azure.AI.Projects.HeaderIsolationKeySource",
176179
"azure.ai.projects.models.TelemetryEndpointAuth": "Azure.AI.Projects.TelemetryEndpointAuth",
177180
"azure.ai.projects.models.HeaderTelemetryEndpointAuth": "Azure.AI.Projects.HeaderTelemetryEndpointAuth",
@@ -238,7 +241,6 @@
238241
"azure.ai.projects.models.OpenApiProjectConnectionSecurityScheme": "Azure.AI.Projects.OpenApiProjectConnectionSecurityScheme",
239242
"azure.ai.projects.models.OpenApiTool": "Azure.AI.Projects.OpenApiTool",
240243
"azure.ai.projects.models.OptimizationAgentDefinition": "Azure.AI.Projects.OptimizationAgentDefinition",
241-
"azure.ai.projects.models.OptimizationAgentSkill": "Azure.AI.Projects.OptimizationAgentSkill",
242244
"azure.ai.projects.models.OptimizationCandidate": "Azure.AI.Projects.OptimizationCandidate",
243245
"azure.ai.projects.models.OptimizationJob": "Azure.AI.Projects.OptimizationJob",
244246
"azure.ai.projects.models.OptimizationJobInputs": "Azure.AI.Projects.OptimizationJobInputs",
@@ -251,6 +253,9 @@
251253
"azure.ai.projects.models.PendingUploadRequest": "Azure.AI.Projects.PendingUploadRequest",
252254
"azure.ai.projects.models.PendingUploadResponse": "Azure.AI.Projects.PendingUploadResponse",
253255
"azure.ai.projects.models.ProceduralMemoryItem": "Azure.AI.Projects.ProceduralMemoryItem",
256+
"azure.ai.projects.models.PromoteCandidateRequest": "Azure.AI.Projects.PromoteCandidateRequest",
257+
"azure.ai.projects.models.PromoteCandidateResponse": "Azure.AI.Projects.PromoteCandidateResponse",
258+
"azure.ai.projects.models.PromotionInfo": "Azure.AI.Projects.PromotionInfo",
254259
"azure.ai.projects.models.PromptAgentDefinition": "Azure.AI.Projects.PromptAgentDefinition",
255260
"azure.ai.projects.models.PromptAgentDefinitionTextOptions": "Azure.AI.Projects.PromptAgentDefinitionTextOptions",
256261
"azure.ai.projects.models.PromptBasedEvaluatorDefinition": "Azure.AI.Projects.PromptBasedEvaluatorDefinition",
@@ -266,21 +271,21 @@
266271
"azure.ai.projects.models.ResponseUsageOutputTokensDetails": "OpenAI.ResponseUsageOutputTokensDetails",
267272
"azure.ai.projects.models.Routine": "Azure.AI.Projects.Routine",
268273
"azure.ai.projects.models.RoutineRun": "Azure.AI.Projects.RoutineRun",
269-
"azure.ai.projects.models.RoutineRunDiagnostics": "Azure.AI.Projects.RoutineRunDiagnostics",
270274
"azure.ai.projects.models.RubricBasedEvaluatorDefinition": "Azure.AI.Projects.RubricBasedEvaluatorDefinition",
271275
"azure.ai.projects.models.SASCredentials": "Azure.AI.Projects.SASCredentials",
272276
"azure.ai.projects.models.Schedule": "Azure.AI.Projects.Schedule",
273277
"azure.ai.projects.models.ScheduleRoutineTrigger": "Azure.AI.Projects.ScheduleRoutineTrigger",
274278
"azure.ai.projects.models.ScheduleRun": "Azure.AI.Projects.ScheduleRun",
275279
"azure.ai.projects.models.SessionDirectoryEntry": "Azure.AI.Projects.SessionDirectoryEntry",
276-
"azure.ai.projects.models.SessionDirectoryListResult": "Azure.AI.Projects.SessionDirectoryListResponse",
277280
"azure.ai.projects.models.SessionFileWriteResult": "Azure.AI.Projects.SessionFileWriteResponse",
278281
"azure.ai.projects.models.SessionLogEvent": "Azure.AI.Projects.SessionLogEvent",
279282
"azure.ai.projects.models.SharepointGroundingToolParameters": "Azure.AI.Projects.SharepointGroundingToolParameters",
280283
"azure.ai.projects.models.SharepointPreviewTool": "Azure.AI.Projects.SharepointPreviewTool",
281284
"azure.ai.projects.models.SimpleQnADataGenerationJobOptions": "Azure.AI.Projects.SimpleQnADataGenerationJobOptions",
282-
"azure.ai.projects.models.SkillDetails": "Azure.AI.Projects.SkillObject",
285+
"azure.ai.projects.models.SkillDetails": "Azure.AI.Projects.Skill",
286+
"azure.ai.projects.models.SkillInlineContent": "Azure.AI.Projects.SkillInlineContent",
283287
"azure.ai.projects.models.SkillReferenceParam": "OpenAI.SkillReferenceParam",
288+
"azure.ai.projects.models.SkillVersion": "Azure.AI.Projects.SkillVersion",
284289
"azure.ai.projects.models.ToolChoiceParam": "OpenAI.ToolChoiceParam",
285290
"azure.ai.projects.models.SpecificApplyPatchParam": "OpenAI.SpecificApplyPatchParam",
286291
"azure.ai.projects.models.SpecificFunctionShellParam": "OpenAI.SpecificFunctionShellParam",
@@ -298,6 +303,8 @@
298303
"azure.ai.projects.models.ToolboxObject": "Azure.AI.Projects.ToolboxObject",
299304
"azure.ai.projects.models.ToolboxPolicies": "Azure.AI.Projects.ToolboxPolicies",
300305
"azure.ai.projects.models.ToolboxSearchPreviewTool": "Azure.AI.Projects.ToolboxSearchPreviewTool",
306+
"azure.ai.projects.models.ToolboxSkill": "Azure.AI.Projects.ToolboxSkill",
307+
"azure.ai.projects.models.ToolboxSkillReference": "Azure.AI.Projects.ToolboxSkillReference",
301308
"azure.ai.projects.models.ToolboxVersionObject": "Azure.AI.Projects.ToolboxVersionObject",
302309
"azure.ai.projects.models.ToolChoiceAllowed": "OpenAI.ToolChoiceAllowed",
303310
"azure.ai.projects.models.ToolChoiceCodeInterpreter": "OpenAI.ToolChoiceCodeInterpreter",
@@ -364,10 +371,8 @@
364371
"azure.ai.projects.models.AgentSessionStatus": "Azure.AI.Projects.AgentSessionStatus",
365372
"azure.ai.projects.models.PageOrder": "Azure.AI.Projects.PageOrder",
366373
"azure.ai.projects.models.SessionLogEventType": "Azure.AI.Projects.SessionLogEventType",
367-
"azure.ai.projects.models.EvalRunOutputItemResultStatus": "Azure.AI.Projects.EvalRunOutputItemResultStatus",
368-
"azure.ai.projects.models.OptimizationStrategy": "Azure.AI.Projects.OptimizationStrategy",
369-
"azure.ai.projects.models.OptimizationMode": "Azure.AI.Projects.OptimizationMode",
370374
"azure.ai.projects.models.JobStatus": "Azure.AI.Projects.JobStatus",
375+
"azure.ai.projects.models.EvaluationLevel": "Azure.AI.Projects.EvaluationLevel",
371376
"azure.ai.projects.models.EvaluationTaxonomyInputType": "Azure.AI.Projects.EvaluationTaxonomyInputType",
372377
"azure.ai.projects.models.RiskCategory": "Azure.AI.Projects.RiskCategory",
373378
"azure.ai.projects.models.EvaluatorType": "Azure.AI.Projects.EvaluatorType",
@@ -392,6 +397,7 @@
392397
"azure.ai.projects.models.FoundryModelWarningCode": "Azure.AI.Projects.FoundryModelWarningCode",
393398
"azure.ai.projects.models.AttackStrategy": "Azure.AI.Projects.AttackStrategy",
394399
"azure.ai.projects.models.RoutineTriggerType": "Azure.AI.Projects.RoutineTriggerType",
400+
"azure.ai.projects.models.GitHubIssueEvent": "Azure.AI.Projects.GitHubIssueEvent",
395401
"azure.ai.projects.models.RoutineActionType": "Azure.AI.Projects.RoutineActionType",
396402
"azure.ai.projects.models.RoutineRunPhase": "Azure.AI.Projects.RoutineRunPhase",
397403
"azure.ai.projects.models.RoutineAttemptSource": "Azure.AI.Projects.RoutineAttemptSource",
@@ -468,5 +474,6 @@
468474
"azure.ai.projects.aio.operations.IndexesOperations.delete": "Azure.AI.Projects.Indexes.deleteVersion",
469475
"azure.ai.projects.operations.IndexesOperations.create_or_update": "Azure.AI.Projects.Indexes.createOrUpdateVersion",
470476
"azure.ai.projects.aio.operations.IndexesOperations.create_or_update": "Azure.AI.Projects.Indexes.createOrUpdateVersion"
471-
}
477+
},
478+
"CrossLanguageVersion": "19d141e20299"
472479
}

0 commit comments

Comments
 (0)