# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Azure Machine Learning Model Management…
  version: 1.0.0
extends: openapi/microsoft-azure-asset-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/assets'].get
  update:
    x-apievangelist-phrasing:
      intent: Query assets in an ML workspace
      effect: read
      questions:
      - How do I list the model assets registered in a Machine Learning workspace?
      - Can I find assets produced by a particular training run?
      - Is it possible to filter workspace assets by name or tags?
      instructions:
      - text: List assets in workspace {workspace} in resource group {resourceGroup} of subscription {subscriptionId}.
        slots:
          workspace: path.workspace
          resourceGroup: path.resourceGroup
          subscriptionId: path.subscriptionId
      - text: Find assets from run {runId} in workspace {workspace}.
        slots:
          runId: query.runId
          workspace: path.workspace
      - text: Query workspace {workspace} for assets named {name}, {count} per page.
        slots:
          workspace: path.workspace
          name: query.name
          count: query.count
      method: generated
      generated: '2026-09-26'
- target: $.paths['/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/assets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an asset in an ML workspace
      effect: write
      questions:
      - How do I register a new asset with its artifacts in the model management service?
      - Can I attach tags and a run id when creating an asset?
      instructions:
      - text: Create asset {name} in workspace {workspace}, resource group {resourceGroup}, subscription {subscriptionId}.
        slots:
          name: requestBody.name
          workspace: path.workspace
          resourceGroup: path.resourceGroup
          subscriptionId: path.subscriptionId
      - text: Register asset {name} with artifacts {artifacts} from run {runid} in workspace {workspace}.
        slots:
          name: requestBody.name
          artifacts: requestBody.artifacts
          runid: requestBody.runid
          workspace: path.workspace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/assets/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an asset by id
      effect: read
      questions:
      - How do I look up a single workspace asset when I have its id?
      - What artifacts and tags does a specific asset carry?
      instructions:
      - text: Get asset {id} in workspace {workspace}, resource group {resourceGroup}, subscription {subscriptionId}.
        slots:
          id: path.id
          workspace: path.workspace
          resourceGroup: path.resourceGroup
          subscriptionId: path.subscriptionId
      - text: Show the artifacts attached to asset {id} in {workspace}.
        slots:
          id: path.id
          workspace: path.workspace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/assets/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an asset from an ML workspace
      effect: destructive
      questions:
      - How do I remove an asset I registered by mistake?
      - Can I delete a workspace asset by its id?
      instructions:
      - text: Delete asset {id} from workspace {workspace} in {resourceGroup}, subscription {subscriptionId}.
        slots:
          id: path.id
          workspace: path.workspace
          resourceGroup: path.resourceGroup
          subscriptionId: path.subscriptionId
      - text: Remove the asset {id} out of workspace {workspace}.
        slots:
          id: path.id
          workspace: path.workspace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/assets/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing asset
      effect: write
      questions:
      - Can I modify an asset after it's registered instead of recreating it?
      - How do I apply a partial update to a workspace asset?
      instructions:
      - text: Patch asset {id} in workspace {workspace}, resource group {resourceGroup}, subscription {subscriptionId}.
        slots:
          id: path.id
          workspace: path.workspace
          resourceGroup: path.resourceGroup
          subscriptionId: path.subscriptionId
      - text: Apply a partial update to existing asset {id} in {workspace}.
        slots:
          id: path.id
          workspace: path.workspace
      method: generated
      generated: '2026-09-26'