API Evangelist conversational phrasing for Microsoft Azure Custom Speech Datasets for Model…

# 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 Custom Speech Datasets for Model…
  version: 1.0.0
extends: openapi/microsoft-azure-custom-speech-datasets-for-model-adaptation-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: 12
- target: $.paths['/datasets/locales'].get
  update:
    x-apievangelist-phrasing:
      intent: List locales supported for speech datasets
      effect: read
      questions:
      - Which languages and locales can I upload Custom Speech training datasets in?
      - Is a given locale supported for dataset import before I create one?
      instructions:
      - text: List the locales supported for Custom Speech datasets.
      - text: Show which languages I can create adaptation datasets for.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Custom Speech datasets
      effect: read
      questions:
      - What Custom Speech datasets have I already uploaded to my subscription?
      - How can I see all my model adaptation datasets and their status?
      instructions:
      - text: List all my Custom Speech datasets.
      - text: Show every adaptation dataset in this speech subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a speech dataset from a URL
      effect: write
      questions:
      - How do I create a Custom Speech dataset from audio and transcripts hosted at a URL?
      - What kind, locale and display name do I need to import a dataset by link?
      instructions:
      - text: Create a {kind} dataset named {display_name} in locale {locale} from {content_url}.
        slots:
          kind: requestBody.kind
          display_name: requestBody.displayName
          locale: requestBody.locale
          content_url: requestBody.contentUrl
      - text: Import training data from URL {content_url} as a new dataset called {display_name}.
        slots:
          content_url: requestBody.contentUrl
          display_name: requestBody.displayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one speech dataset
      effect: read
      questions:
      - How do I check the processing status of one Custom Speech dataset?
      - What details are stored for a dataset I already created?
      instructions:
      - text: Get Custom Speech dataset {id}.
        slots:
          id: path.id
      - text: Show the status and properties of dataset {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a speech dataset
      effect: destructive
      questions:
      - How do I delete a Custom Speech dataset I no longer need?
      - Can I remove a dataset that failed to import?
      instructions:
      - text: Delete Custom Speech dataset {id}.
        slots:
          id: path.id
      - text: Remove the adaptation dataset {id} permanently.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename or redescribe a speech dataset
      effect: write
      questions:
      - Can I rename a Custom Speech dataset after it has been created?
      - How do I change the description on an existing dataset?
      instructions:
      - text: Rename dataset {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Set the name of dataset {id} to {name} and its description to {description}.
        slots:
          id: path.id
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/upload'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload files to create a speech dataset
      effect: write
      questions:
      - How do I upload local audio files and transcriptions directly to make a dataset?
      - Can I upload language data rather than audio for model adaptation?
      instructions:
      - text: Upload audio {audiodata} with transcriptions {transcriptions} as a new dataset named {name} in locale {locale}.
        slots:
          audiodata: requestBody.audiodata
          transcriptions: requestBody.transcriptions
          name: requestBody.name
          locale: requestBody.locale
      - text: Upload language data file {languagedata} as dataset {name}.
        slots:
          languagedata: requestBody.languagedata
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{id}/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List the files in a speech dataset
      effect: read
      questions:
      - What files make up a Custom Speech dataset, and can I get download links for them?
      - How long can the SAS download URLs for dataset files stay valid?
      instructions:
      - text: List the files in dataset {id}.
        slots:
          id: path.id
      - text: List the first {top} files of dataset {id} with download links valid for {sas_seconds} seconds.
        slots:
          top: query.top
          id: path.id
          sas_seconds: query.sasValidityInSeconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{id}/files/{fileId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one file from a speech dataset
      effect: read
      questions:
      - How do I fetch the details and download link of one specific file in a dataset?
      - Can I get a single dataset file by its file ID?
      instructions:
      - text: Get file {file_id} from dataset {id}.
        slots:
          file_id: path.fileId
          id: path.id
      - text: Give me a download link for file {file_id} in dataset {id} valid for {sas_seconds} seconds.
        slots:
          file_id: path.fileId
          id: path.id
          sas_seconds: query.sasValidityInSeconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{id}/blocks'].get
  update:
    x-apievangelist-phrasing:
      intent: List uploaded blocks for a dataset
      effect: read
      questions:
      - Which data blocks have already been uploaded for a dataset I'm uploading in chunks?
      - How can I resume a chunked dataset upload by seeing what blocks arrived?
      instructions:
      - text: List the uploaded blocks for dataset {id}.
        slots:
          id: path.id
      - text: Show which chunks of dataset {id} have been received so far.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{id}/blocks'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload one block of dataset data
      effect: write
      questions:
      - How do I upload a large speech dataset in pieces?
      - What is the maximum size of a single dataset upload block?
      instructions:
      - text: Upload block {block_id} of data for dataset {id}.
        slots:
          block_id: query.blockid
          id: path.id
      - text: Send the next chunk (up to 8 MiB) for dataset {id} as block {block_id}.
        slots:
          id: path.id
          block_id: query.blockid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{id}/blocks:commit'].post
  update:
    x-apievangelist-phrasing:
      intent: Commit uploaded blocks to finish a dataset
      effect: write
      questions:
      - How do I finalize a dataset after uploading all of its blocks?
      - What step completes a chunked Custom Speech dataset upload?
      instructions:
      - text: Commit the uploaded blocks for dataset {id}.
        slots:
          id: path.id
      - text: Finish the chunked upload of dataset {id} by committing its block list.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'