Skip to content

[azure-ai-projects] Emit SDK from TypeSpec (feature/foundry-release 10482dd) #47185

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.

Sign up for GitHub

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
dargilco merged 9 commits into from
May 28, 2026
Merged

[azure-ai-projects] Emit SDK from TypeSpec (feature/foundry-release 10482dd) #47185

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
acf3271
Part 1: Emit SDK from TypeSpec
dargilco May 28, 2026
2c95819
Part 2: Apply post-emitter-fixes.cmd
dargilco May 28, 2026
e20caca
Part 3: Additional edits
dargilco May 28, 2026
4ff9664
Fix quality gates
dargilco May 28, 2026
8b7796d
Fix emitter bug
dargilco May 28, 2026
60668c9
Rename skill methods. Update report
dargilco May 28, 2026
ecb41b1
updates
dargilco May 28, 2026
2047ae8
disable test samples
dargilco May 28, 2026
b0efb34
Update change log. Fix test
dargilco May 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 21 additions & 5 deletions sdk/ai/azure-ai-projects/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,27 +7,35 @@
* Support integration of external Agents (in preview). See new `ExternalAgentDefinition` class.
* New Agent tool in preview `FabricIQPreviewTool`.
* New Agent tool in preview `ToolboxSearchPreviewTool`.
* 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 `.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: `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.agents` for code-based hosted agents: `create_version_from_code`, `download_code`.
* New methods on `.beta.agents` for optimization jobs: `create_optimization_job`, `get_optimization_job`, `list_optimization_jobs`, `cancel_optimization_job`, `list_optimization_candidates`.
* New methods on `.beta.agents` for optimization candidate management: `get_candidate_file`, `promote_candidate`.
* New method `beta.agents.stop_session` to stop a running agent session.
* New methods on `.beta.memory_stores` to handle individual memory items:`.beta.memory_stores`: `get_memory`, `delete_memory`.
* 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.
* 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.
* 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.
* 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.


### Breaking Changes

Breaking changes in beta methods:
* Required keyword `isolation_key` removed from `.beta.agents.create_session()` and `.beta.agents.delete_session()` methods.
* Argument `body` in methods `.beta.evaluation_taxonomies.create()` and `.beta.evaluation_taxonomies.update()` renamed to `taxonomy`.
* Argument `body` in method `.beta.skills.create_from_package()` renamed to `content`.
* 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`.
Expand All @@ -40,6 +48,13 @@ Breaking changes in beta classes:
* Renamed class `TargetConfig` to `RedTeamTargetConfig`.
* Removed class `FabricIQPreviewToolParameters`.
* Removed class `WorkIQPreviewToolParameters`.
* Enum values `ContainerMemoryLimit.MEMORY_1GB/4GB/16GB/64GB` renamed to `MEMORY1_GB/MEMORY4_GB/MEMORY16_GB/MEMORY64_GB`.
* Renamed class `GitHubIssueOpenedRoutineTrigger` to `GitHubIssueRoutineTrigger`.
* Renamed enum value `RoutineTriggerType.GITHUB_ISSUE_OPENED` to `GITHUB_ISSUE`.
* Removed enum value `DataGenerationJobSourceType.DATASET`.
* Removed classes: `DatasetDataGenerationJobSource`, `DatasetItem`, `EvalRunOutputItemResultStatus`, `EvaluationCriterion`, `OptimizationAgentSkill`, `RoutineRunDiagnostics`.
* Removed enums: `OptimizationMode`, `OptimizationStrategy`.
* Removed properties `has_blob`, `skill_id`, `metadata` from class `SkillDetails`.

### Bugs Fixed

Expand All @@ -56,6 +71,7 @@ Breaking changes in beta classes:
* `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`.
* 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.

## 2.1.0 (2026-04-20)

Expand Down
35 changes: 21 additions & 14 deletions sdk/ai/azure-ai-projects/apiview-properties.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@
"azure.ai.projects.models.AgentEvaluatorGenerationJobSource": "Azure.AI.Projects.AgentEvaluatorGenerationJobSource",
"azure.ai.projects.models.BaseCredentials": "Azure.AI.Projects.BaseCredentials",
"azure.ai.projects.models.AgenticIdentityPreviewCredentials": "Azure.AI.Projects.AgenticIdentityPreviewCredentials",
"azure.ai.projects.models.AgentIdentifier": "Azure.AI.Projects.AgentIdentifier",
"azure.ai.projects.models.AgentIdentity": "Azure.AI.Projects.AgentIdentity",
"azure.ai.projects.models.AgentObjectVersions": "Azure.AI.Projects.AgentObject.versions.anonymous",
"azure.ai.projects.models.AgentSessionResource": "Azure.AI.Projects.AgentSessionResource",
Expand Down Expand Up @@ -63,6 +64,8 @@
"azure.ai.projects.models.BrowserAutomationToolConnectionParameters": "Azure.AI.Projects.BrowserAutomationToolConnectionParameters",
"azure.ai.projects.models.BrowserAutomationToolParameters": "Azure.AI.Projects.BrowserAutomationToolParameters",
"azure.ai.projects.models.CandidateDeployConfig": "Azure.AI.Projects.CandidateDeployConfig",
"azure.ai.projects.models.CandidateFileInfo": "Azure.AI.Projects.CandidateFileInfo",
"azure.ai.projects.models.CandidateMetadata": "Azure.AI.Projects.CandidateMetadata",
"azure.ai.projects.models.CandidateResults": "Azure.AI.Projects.CandidateResults",
"azure.ai.projects.models.CaptureStructuredOutputsTool": "Azure.AI.Projects.CaptureStructuredOutputsTool",
"azure.ai.projects.models.ChartCoordinate": "Azure.AI.Projects.ChartCoordinate",
Expand Down Expand Up @@ -92,11 +95,14 @@
"azure.ai.projects.models.CreateAgentVersionFromCodeContent": "Azure.AI.Projects.CreateAgentVersionFromCodeContent",
"azure.ai.projects.models.CreateAgentVersionFromCodeMetadata": "Azure.AI.Projects.CreateAgentVersionFromCodeMetadata",
"azure.ai.projects.models.CreateAsyncResponse": "Azure.AI.Projects.createAsync.Response.anonymous",
"azure.ai.projects.models.CreateSkillVersionFromFilesBody": "Azure.AI.Projects.CreateSkillVersionFromFilesBody",
"azure.ai.projects.models.Trigger": "Azure.AI.Projects.Trigger",
"azure.ai.projects.models.CronTrigger": "Azure.AI.Projects.CronTrigger",
"azure.ai.projects.models.CustomCredential": "Azure.AI.Projects.CustomCredential",
"azure.ai.projects.models.CustomToolParamFormat": "OpenAI.CustomToolParamFormat",
"azure.ai.projects.models.CustomGrammarFormatParam": "OpenAI.CustomGrammarFormatParam",
"azure.ai.projects.models.RoutineTrigger": "Azure.AI.Projects.RoutineTrigger",
"azure.ai.projects.models.CustomRoutineTrigger": "Azure.AI.Projects.CustomRoutineTrigger",
"azure.ai.projects.models.CustomTextFormatParam": "OpenAI.CustomTextFormatParam",
"azure.ai.projects.models.CustomToolParam": "OpenAI.CustomToolParam",
"azure.ai.projects.models.RecurrenceSchedule": "Azure.AI.Projects.RecurrenceSchedule",
Expand All @@ -111,9 +117,8 @@
"azure.ai.projects.models.DataGenerationTokenUsage": "Azure.AI.Projects.DataGenerationTokenUsage",
"azure.ai.projects.models.DatasetCredential": "Azure.AI.Projects.AssetCredentialResponse",
"azure.ai.projects.models.DatasetDataGenerationJobOutput": "Azure.AI.Projects.DatasetDataGenerationJobOutput",
"azure.ai.projects.models.DatasetDataGenerationJobSource": "Azure.AI.Projects.DatasetDataGenerationJobSource",
"azure.ai.projects.models.DatasetEvaluatorGenerationJobSource": "Azure.AI.Projects.DatasetEvaluatorGenerationJobSource",
"azure.ai.projects.models.DatasetItem": "Azure.AI.Projects.DatasetItem",
"azure.ai.projects.models.DatasetInfo": "Azure.AI.Projects.DatasetInfo",
"azure.ai.projects.models.DatasetRef": "Azure.AI.Projects.DatasetRef",
"azure.ai.projects.models.DatasetReference": "Azure.AI.Projects.DatasetReference",
"azure.ai.projects.models.DatasetVersion": "Azure.AI.Projects.DatasetVersion",
Expand All @@ -122,6 +127,7 @@
"azure.ai.projects.models.DeleteMemoryResult": "Azure.AI.Projects.DeleteMemoryResponse",
"azure.ai.projects.models.DeleteMemoryStoreResult": "Azure.AI.Projects.DeleteMemoryStoreResponse",
"azure.ai.projects.models.DeleteSkillResult": "Azure.AI.Projects.DeleteSkillResponse",
"azure.ai.projects.models.DeleteSkillVersionResponse": "Azure.AI.Projects.DeleteSkillVersionResponse",
"azure.ai.projects.models.Deployment": "Azure.AI.Projects.Deployment",
"azure.ai.projects.models.Dimension": "Azure.AI.Projects.Dimension",
"azure.ai.projects.models.DispatchRoutineResult": "Azure.AI.Projects.DispatchRoutineResponse",
Expand All @@ -131,13 +137,11 @@
"azure.ai.projects.models.IsolationKeySource": "Azure.AI.Projects.IsolationKeySource",
"azure.ai.projects.models.EntraIsolationKeySource": "Azure.AI.Projects.EntraIsolationKeySource",
"azure.ai.projects.models.EvalResult": "Azure.AI.Projects.EvalResult",
"azure.ai.projects.models.EvalRunOutputItemResult": "Azure.AI.Projects.EvalRunOutputItemResult",
"azure.ai.projects.models.EvalRunResultCompareItem": "Azure.AI.Projects.EvalRunResultCompareItem",
"azure.ai.projects.models.EvalRunResultComparison": "Azure.AI.Projects.EvalRunResultComparison",
"azure.ai.projects.models.EvalRunResultSummary": "Azure.AI.Projects.EvalRunResultSummary",
"azure.ai.projects.models.EvaluationComparisonInsightRequest": "Azure.AI.Projects.EvaluationComparisonInsightRequest",
"azure.ai.projects.models.EvaluationComparisonInsightResult": "Azure.AI.Projects.EvaluationComparisonInsightResult",
"azure.ai.projects.models.EvaluationCriterion": "Azure.AI.Projects.EvaluationCriterion",
"azure.ai.projects.models.InsightSample": "Azure.AI.Projects.InsightSample",
"azure.ai.projects.models.EvaluationResultSample": "Azure.AI.Projects.EvaluationResultSample",
"azure.ai.projects.models.EvaluationRule": "Azure.AI.Projects.EvaluationRule",
Expand Down Expand Up @@ -170,8 +174,7 @@
"azure.ai.projects.models.FunctionShellToolParamEnvironmentContainerReferenceParam": "OpenAI.FunctionShellToolParamEnvironmentContainerReferenceParam",
"azure.ai.projects.models.FunctionShellToolParamEnvironmentLocalEnvironmentParam": "OpenAI.FunctionShellToolParamEnvironmentLocalEnvironmentParam",
"azure.ai.projects.models.FunctionTool": "OpenAI.FunctionTool",
"azure.ai.projects.models.RoutineTrigger": "Azure.AI.Projects.RoutineTrigger",
"azure.ai.projects.models.GitHubIssueOpenedRoutineTrigger": "Azure.AI.Projects.GitHubIssueOpenedRoutineTrigger",
"azure.ai.projects.models.GitHubIssueRoutineTrigger": "Azure.AI.Projects.GitHubIssueRoutineTrigger",
"azure.ai.projects.models.HeaderIsolationKeySource": "Azure.AI.Projects.HeaderIsolationKeySource",
"azure.ai.projects.models.TelemetryEndpointAuth": "Azure.AI.Projects.TelemetryEndpointAuth",
"azure.ai.projects.models.HeaderTelemetryEndpointAuth": "Azure.AI.Projects.HeaderTelemetryEndpointAuth",
Expand Down Expand Up @@ -238,7 +241,6 @@
"azure.ai.projects.models.OpenApiProjectConnectionSecurityScheme": "Azure.AI.Projects.OpenApiProjectConnectionSecurityScheme",
"azure.ai.projects.models.OpenApiTool": "Azure.AI.Projects.OpenApiTool",
"azure.ai.projects.models.OptimizationAgentDefinition": "Azure.AI.Projects.OptimizationAgentDefinition",
"azure.ai.projects.models.OptimizationAgentSkill": "Azure.AI.Projects.OptimizationAgentSkill",
"azure.ai.projects.models.OptimizationCandidate": "Azure.AI.Projects.OptimizationCandidate",
"azure.ai.projects.models.OptimizationJob": "Azure.AI.Projects.OptimizationJob",
"azure.ai.projects.models.OptimizationJobInputs": "Azure.AI.Projects.OptimizationJobInputs",
Expand All @@ -251,6 +253,9 @@
"azure.ai.projects.models.PendingUploadRequest": "Azure.AI.Projects.PendingUploadRequest",
"azure.ai.projects.models.PendingUploadResponse": "Azure.AI.Projects.PendingUploadResponse",
"azure.ai.projects.models.ProceduralMemoryItem": "Azure.AI.Projects.ProceduralMemoryItem",
"azure.ai.projects.models.PromoteCandidateRequest": "Azure.AI.Projects.PromoteCandidateRequest",
"azure.ai.projects.models.PromoteCandidateResponse": "Azure.AI.Projects.PromoteCandidateResponse",
"azure.ai.projects.models.PromotionInfo": "Azure.AI.Projects.PromotionInfo",
"azure.ai.projects.models.PromptAgentDefinition": "Azure.AI.Projects.PromptAgentDefinition",
"azure.ai.projects.models.PromptAgentDefinitionTextOptions": "Azure.AI.Projects.PromptAgentDefinitionTextOptions",
"azure.ai.projects.models.PromptBasedEvaluatorDefinition": "Azure.AI.Projects.PromptBasedEvaluatorDefinition",
Expand All @@ -266,21 +271,21 @@
"azure.ai.projects.models.ResponseUsageOutputTokensDetails": "OpenAI.ResponseUsageOutputTokensDetails",
"azure.ai.projects.models.Routine": "Azure.AI.Projects.Routine",
"azure.ai.projects.models.RoutineRun": "Azure.AI.Projects.RoutineRun",
"azure.ai.projects.models.RoutineRunDiagnostics": "Azure.AI.Projects.RoutineRunDiagnostics",
"azure.ai.projects.models.RubricBasedEvaluatorDefinition": "Azure.AI.Projects.RubricBasedEvaluatorDefinition",
"azure.ai.projects.models.SASCredentials": "Azure.AI.Projects.SASCredentials",
"azure.ai.projects.models.Schedule": "Azure.AI.Projects.Schedule",
"azure.ai.projects.models.ScheduleRoutineTrigger": "Azure.AI.Projects.ScheduleRoutineTrigger",
"azure.ai.projects.models.ScheduleRun": "Azure.AI.Projects.ScheduleRun",
"azure.ai.projects.models.SessionDirectoryEntry": "Azure.AI.Projects.SessionDirectoryEntry",
"azure.ai.projects.models.SessionDirectoryListResult": "Azure.AI.Projects.SessionDirectoryListResponse",
"azure.ai.projects.models.SessionFileWriteResult": "Azure.AI.Projects.SessionFileWriteResponse",
"azure.ai.projects.models.SessionLogEvent": "Azure.AI.Projects.SessionLogEvent",
"azure.ai.projects.models.SharepointGroundingToolParameters": "Azure.AI.Projects.SharepointGroundingToolParameters",
"azure.ai.projects.models.SharepointPreviewTool": "Azure.AI.Projects.SharepointPreviewTool",
"azure.ai.projects.models.SimpleQnADataGenerationJobOptions": "Azure.AI.Projects.SimpleQnADataGenerationJobOptions",
"azure.ai.projects.models.SkillDetails": "Azure.AI.Projects.SkillObject",
"azure.ai.projects.models.SkillDetails": "Azure.AI.Projects.Skill",
"azure.ai.projects.models.SkillInlineContent": "Azure.AI.Projects.SkillInlineContent",
"azure.ai.projects.models.SkillReferenceParam": "OpenAI.SkillReferenceParam",
"azure.ai.projects.models.SkillVersion": "Azure.AI.Projects.SkillVersion",
"azure.ai.projects.models.ToolChoiceParam": "OpenAI.ToolChoiceParam",
"azure.ai.projects.models.SpecificApplyPatchParam": "OpenAI.SpecificApplyPatchParam",
"azure.ai.projects.models.SpecificFunctionShellParam": "OpenAI.SpecificFunctionShellParam",
Expand All @@ -298,6 +303,8 @@
"azure.ai.projects.models.ToolboxObject": "Azure.AI.Projects.ToolboxObject",
"azure.ai.projects.models.ToolboxPolicies": "Azure.AI.Projects.ToolboxPolicies",
"azure.ai.projects.models.ToolboxSearchPreviewTool": "Azure.AI.Projects.ToolboxSearchPreviewTool",
"azure.ai.projects.models.ToolboxSkill": "Azure.AI.Projects.ToolboxSkill",
"azure.ai.projects.models.ToolboxSkillReference": "Azure.AI.Projects.ToolboxSkillReference",
"azure.ai.projects.models.ToolboxVersionObject": "Azure.AI.Projects.ToolboxVersionObject",
"azure.ai.projects.models.ToolChoiceAllowed": "OpenAI.ToolChoiceAllowed",
"azure.ai.projects.models.ToolChoiceCodeInterpreter": "OpenAI.ToolChoiceCodeInterpreter",
Expand Down Expand Up @@ -364,10 +371,8 @@
"azure.ai.projects.models.AgentSessionStatus": "Azure.AI.Projects.AgentSessionStatus",
"azure.ai.projects.models.PageOrder": "Azure.AI.Projects.PageOrder",
"azure.ai.projects.models.SessionLogEventType": "Azure.AI.Projects.SessionLogEventType",
"azure.ai.projects.models.EvalRunOutputItemResultStatus": "Azure.AI.Projects.EvalRunOutputItemResultStatus",
"azure.ai.projects.models.OptimizationStrategy": "Azure.AI.Projects.OptimizationStrategy",
"azure.ai.projects.models.OptimizationMode": "Azure.AI.Projects.OptimizationMode",
"azure.ai.projects.models.JobStatus": "Azure.AI.Projects.JobStatus",
"azure.ai.projects.models.EvaluationLevel": "Azure.AI.Projects.EvaluationLevel",
"azure.ai.projects.models.EvaluationTaxonomyInputType": "Azure.AI.Projects.EvaluationTaxonomyInputType",
"azure.ai.projects.models.RiskCategory": "Azure.AI.Projects.RiskCategory",
"azure.ai.projects.models.EvaluatorType": "Azure.AI.Projects.EvaluatorType",
Expand All @@ -392,6 +397,7 @@
"azure.ai.projects.models.FoundryModelWarningCode": "Azure.AI.Projects.FoundryModelWarningCode",
"azure.ai.projects.models.AttackStrategy": "Azure.AI.Projects.AttackStrategy",
"azure.ai.projects.models.RoutineTriggerType": "Azure.AI.Projects.RoutineTriggerType",
"azure.ai.projects.models.GitHubIssueEvent": "Azure.AI.Projects.GitHubIssueEvent",
"azure.ai.projects.models.RoutineActionType": "Azure.AI.Projects.RoutineActionType",
"azure.ai.projects.models.RoutineRunPhase": "Azure.AI.Projects.RoutineRunPhase",
"azure.ai.projects.models.RoutineAttemptSource": "Azure.AI.Projects.RoutineAttemptSource",
Expand Down Expand Up @@ -468,5 +474,6 @@
"azure.ai.projects.aio.operations.IndexesOperations.delete": "Azure.AI.Projects.Indexes.deleteVersion",
"azure.ai.projects.operations.IndexesOperations.create_or_update": "Azure.AI.Projects.Indexes.createOrUpdateVersion",
"azure.ai.projects.aio.operations.IndexesOperations.create_or_update": "Azure.AI.Projects.Indexes.createOrUpdateVersion"
}
},
"CrossLanguageVersion": "19d141e20299"
}
Loading
Loading