API Evangelist conversational phrasing for Microsoft Azure Authoring API

# 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 Authoring API
  version: 1.0.0
extends: openapi/microsoft-azure-authoring-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 113
- target: $.paths['/authoring/analyze-conversations/projects'].get
  update:
    x-apievangelist-phrasing:
      intent: List conversational language projects
      effect: read
      questions:
      - Which conversational language understanding projects exist on my Language resource?
      - Can I see all my CLU and orchestration authoring projects at once?
      instructions:
      - text: List my conversational language understanding projects.
      - text: Show every analyze-conversations authoring project on this resource.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a conversational language project
      effect: read
      questions:
      - What settings and language does my conversation understanding project use?
      - Can I check when a CLU project was last trained or modified?
      instructions:
      - text: Show the details of conversational language project {projectName}.
        slots:
          projectName: path.projectName
      - text: Get the metadata for the CLU project I'm working on.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a conversational language project
      effect: destructive
      questions:
      - What happens to deployments when I delete a conversation understanding project?
      - Can I permanently remove a CLU project I no longer need?
      instructions:
      - text: Delete conversational language understanding project {projectName}.
        slots:
          projectName: path.projectName
      - text: Remove this CLU authoring project entirely.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a conversational language project
      effect: write
      questions:
      - How do I create a new conversational language understanding project?
      - Can I make a CLU or orchestration project multilingual when I set it up?
      instructions:
      - text: Create conversation project {projectName} of kind {projectKind} in language {language}.
        slots:
          projectName: path.projectName
          projectKind: requestBody.projectKind
          language: requestBody.language
      - text: Set up CLU project {projectName} in {language} as {projectKind}, multilingual {multilingual}.
        slots:
          projectName: requestBody.projectName
          language: requestBody.language
          projectKind: requestBody.projectKind
          multilingual: requestBody.multilingual
      - text: Update the description of conversation project {projectName} ({projectKind}, {language}) to {description}.
        slots:
          projectName: requestBody.projectName
          projectKind: requestBody.projectKind
          language: requestBody.language
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/:authorize-copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Authorize copying a conversation project here
      effect: write
      questions:
      - What do I need on the target resource before copying a CLU project into it?
      - Can I allow a conversation project copy to overwrite an existing project?
      instructions:
      - text: Generate a copy authorization so a {projectKind} conversation project can be copied in as {projectName}.
        slots:
          projectKind: requestBody.projectKind
          projectName: path.projectName
      - text: Authorize an incoming CLU project copy of kind {projectKind} with overwrite set to {allowOverwrite}.
        slots:
          projectKind: requestBody.projectKind
          allowOverwrite: requestBody.allowOverwrite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/:copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy a conversation project to another resource
      effect: write
      questions:
      - How can I move a conversational language project to a Language resource in another region?
      - What does the copy call need from the target resource's authorization?
      instructions:
      - text: Copy CLU project {projectName} to {targetProjectName} on {targetResourceId} ({targetResourceRegion}), token {accessToken} until {expiresAt}, kind {projectKind}.
        slots:
          projectName: path.projectName
          targetProjectName: requestBody.targetProjectName
          targetResourceId: requestBody.targetResourceId
          targetResourceRegion: requestBody.targetResourceRegion
          accessToken: requestBody.accessToken
          expiresAt: requestBody.expiresAt
          projectKind: requestBody.projectKind
      - text: Start a conversation project copy job targeting {targetProjectName} in region {targetResourceRegion} with access token {accessToken}.
        slots:
          targetProjectName: requestBody.targetProjectName
          targetResourceRegion: requestBody.targetResourceRegion
          accessToken: requestBody.accessToken
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/:export'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a conversation project's data
      effect: write
      questions:
      - Can I back up a CLU project's intents, entities and utterances to a file?
      - Is it possible to export a specific trained model version of a conversation project?
      instructions:
      - text: Export conversational language project {projectName} with string index type {stringIndexType}.
        slots:
          projectName: path.projectName
          stringIndexType: query.stringIndexType
      - text: Export CLU model {trainedModelLabel} in format {format} using {stringIndexType} offsets.
        slots:
          trainedModelLabel: query.trainedModelLabel
          format: query.format
          stringIndexType: query.stringIndexType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/:import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import data into a conversation project
      effect: write
      questions:
      - Can I load a CLU project from an exported JSON file?
      - What happens if I import a conversation project that already exists?
      instructions:
      - text: Import into conversation project {projectName} from file version {projectFileVersion} with metadata {metadata} and {stringIndexType} offsets.
        slots:
          projectName: path.projectName
          projectFileVersion: requestBody.projectFileVersion
          metadata: requestBody.metadata
          stringIndexType: requestBody.stringIndexType
      - text: Replace my CLU project's data with assets {assets}, metadata {metadata}, file version {projectFileVersion}, offsets {stringIndexType}.
        slots:
          assets: requestBody.assets
          metadata: requestBody.metadata
          projectFileVersion: requestBody.projectFileVersion
          stringIndexType: requestBody.stringIndexType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/:train'].post
  update:
    x-apievangelist-phrasing:
      intent: Train a conversational language model
      effect: write
      questions:
      - How do I train a new model for my conversational language understanding project?
      - Can I choose between standard and advanced training modes for a CLU model?
      instructions:
      - text: Train CLU model {modelLabel} in project {projectName} using {trainingMode} mode.
        slots:
          modelLabel: requestBody.modelLabel
          projectName: path.projectName
          trainingMode: requestBody.trainingMode
      - text: Start conversation model training for {modelLabel} in {trainingMode} mode with config version {trainingConfigVersion}.
        slots:
          modelLabel: requestBody.modelLabel
          trainingMode: requestBody.trainingMode
          trainingConfigVersion: requestBody.trainingConfigVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/copy/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation project copy job
      effect: read
      questions:
      - Has my CLU project copy to the other resource finished yet?
      - Did the conversation project copy job fail?
      instructions:
      - text: Check the status of copy job {jobId} for conversation project {projectName}.
        slots:
          jobId: path.jobId
          projectName: path.projectName
      - text: Get progress on CLU copy job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List a conversation project's deployments
      effect: read
      questions:
      - Which deployments does my CLU project have right now?
      - Can I see what model each conversation project deployment is serving?
      instructions:
      - text: List the deployments of conversational language project {projectName}.
        slots:
          projectName: path.projectName
      - text: Show all CLU project deployments.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/deployments/:swap'].post
  update:
    x-apievangelist-phrasing:
      intent: Swap two conversation project deployments
      effect: write
      questions:
      - Can I swap my staging and production CLU deployments in one step?
      - How do I promote a conversation model by exchanging two deployments?
      instructions:
      - text: Swap CLU deployments {firstDeploymentName} and {secondDeploymentName} in project {projectName}.
        slots:
          firstDeploymentName: requestBody.firstDeploymentName
          secondDeploymentName: requestBody.secondDeploymentName
          projectName: path.projectName
      - text: Exchange conversation deployment {firstDeploymentName} with {secondDeploymentName}.
        slots:
          firstDeploymentName: requestBody.firstDeploymentName
          secondDeploymentName: requestBody.secondDeploymentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a conversation project deployment
      effect: read
      questions:
      - Which trained model is behind one of my CLU deployments?
      - When was a particular conversation deployment last deployed?
      instructions:
      - text: Show details of deployment {deploymentName} in conversational language project {projectName}.
        slots:
          deploymentName: path.deploymentName
          projectName: path.projectName
      - text: Get the CLU deployment I name, including its model and expiry.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Deploy a trained conversation model
      effect: write
      questions:
      - How do I publish a trained CLU model so it can be called for predictions?
      - Can I deploy a conversation model to several assigned resources?
      instructions:
      - text: Deploy CLU model {trainedModelLabel} as deployment {deploymentName} of project {projectName}.
        slots:
          trainedModelLabel: requestBody.trainedModelLabel
          deploymentName: path.deploymentName
          projectName: path.projectName
      - text: Deploy conversation model {trainedModelLabel} to resources {assignedResourceIds}.
        slots:
          trainedModelLabel: requestBody.trainedModelLabel
          assignedResourceIds: requestBody.assignedResourceIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a conversation project deployment
      effect: destructive
      questions:
      - Can I take down a CLU deployment I no longer use?
      - What happens to prediction traffic when a conversation deployment is deleted?
      instructions:
      - text: Delete deployment {deploymentName} from conversational language project {projectName}.
        slots:
          deploymentName: path.deploymentName
          projectName: path.projectName
      - text: Remove the CLU deployment entirely from the project.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/:delete-from-resources'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a conversation deployment from resources
      effect: destructive
      questions:
      - Can I remove a CLU deployment from only some of its assigned resources?
      - Which resources lose a conversation deployment when I delete it selectively?
      instructions:
      - text: Delete CLU deployment {deploymentName} of project {projectName} from resources {assignedResourceIds}.
        slots:
          deploymentName: path.deploymentName
          projectName: path.projectName
          assignedResourceIds: requestBody.assignedResourceIds
      - text: Pull the conversation deployment off assigned resources {assignedResourceIds} only.
        slots:
          assignedResourceIds: requestBody.assignedResourceIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/delete-from-resources/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation delete-from-resources job
      effect: read
      questions:
      - Has removing my CLU deployment from specific resources completed?
      - Did the conversation deployment delete-from-resources job hit errors?
      instructions:
      - text: Check CLU delete-from-resources job {jobId} for deployment {deploymentName} in project {projectName}.
        slots:
          jobId: path.jobId
          deploymentName: path.deploymentName
          projectName: path.projectName
      - text: Get the status of conversation deployment removal job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation deployment job
      effect: read
      questions:
      - Is my CLU deployment finished and ready for predictions?
      - Why did deploying a conversation model fail?
      instructions:
      - text: Check the status of CLU deployment job {jobId} for {deploymentName} in project {projectName}.
        slots:
          jobId: path.jobId
          deploymentName: path.deploymentName
          projectName: path.projectName
      - text: Get progress on conversation deploy job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/deployments/swap/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation deployment swap job
      effect: read
      questions:
      - Did my CLU deployment swap complete successfully?
      - Is the conversation deployments swap still running?
      instructions:
      - text: Check CLU swap job {jobId} in project {projectName}.
        slots:
          jobId: path.jobId
          projectName: path.projectName
      - text: Get the result of conversation deployment swap job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/export/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation project export job
      effect: read
      questions:
      - Where do I get the exported CLU project file once the export finishes?
      - Is my conversation project export ready to download?
      instructions:
      - text: Check export job {jobId} for conversation project {projectName}.
        slots:
          jobId: path.jobId
          projectName: path.projectName
      - text: Get the CLU project export result for job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/import/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation project import job
      effect: read
      questions:
      - Did my CLU project import succeed?
      - Is the conversation project import still in progress?
      instructions:
      - text: Check import job {jobId} for conversation project {projectName}.
        slots:
          jobId: path.jobId
          projectName: path.projectName
      - text: Get the status of CLU import job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/models'].get
  update:
    x-apievangelist-phrasing:
      intent: List a conversation project's trained models
      effect: read
      questions:
      - Which trained models exist in my CLU project?
      - Can I compare the model labels I've trained for a conversation project?
      instructions:
      - text: List the trained models in conversational language project {projectName}.
        slots:
          projectName: path.projectName
      - text: Show every CLU model I've trained.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a trained conversation model
      effect: read
      questions:
      - When was a specific CLU model trained and does it expire?
      - What training config version did one of my conversation models use?
      instructions:
      - text: Show CLU trained model {trainedModelLabel} in project {projectName}.
        slots:
          trainedModelLabel: path.trainedModelLabel
          projectName: path.projectName
      - text: Get details for conversation model {trainedModelLabel}.
        slots:
          trainedModelLabel: path.trainedModelLabel
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a trained conversation model
      effect: destructive
      questions:
      - Can I delete an old CLU model to clean up my project?
      - Is removing a trained conversation model reversible?
      instructions:
      - text: Delete CLU trained model {trainedModelLabel} from project {projectName}.
        slots:
          trainedModelLabel: path.trainedModelLabel
          projectName: path.projectName
      - text: Remove conversation model {trainedModelLabel} from the project.
        slots:
          trainedModelLabel: path.trainedModelLabel
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/:evaluate'].post
  update:
    x-apievangelist-phrasing:
      intent: Evaluate a trained conversation model
      effect: write
      questions:
      - Can I re-run evaluation on a CLU model with a different train/test split?
      - What split percentages can I set when evaluating a conversation model?
      instructions:
      - text: Evaluate CLU model {trainedModelLabel} in project {projectName}.
        slots:
          trainedModelLabel: path.trainedModelLabel
          projectName: path.projectName
      - text: Evaluate conversation model {trainedModelLabel} with {trainingSplitPercentage}% training and {testingSplitPercentage}% testing.
        slots:
          trainedModelLabel: path.trainedModelLabel
          trainingSplitPercentage: requestBody.trainingSplitPercentage
          testingSplitPercentage: requestBody.testingSplitPercentage
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/:load-snapshot'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a conversation model snapshot
      effect: write
      questions:
      - Can I roll my CLU project's working copy back to what an earlier model was trained on?
      - What does loading a conversation model snapshot replace?
      instructions:
      - text: Load the snapshot of CLU model {trainedModelLabel} into the working copy of project {projectName}.
        slots:
          trainedModelLabel: path.trainedModelLabel
          projectName: path.projectName
      - text: Restore my conversation project to the data behind model {trainedModelLabel}.
        slots:
          trainedModelLabel: path.trainedModelLabel
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluate/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation model evaluation job
      effect: read
      questions:
      - Is the evaluation of my CLU model done?
      - Did re-evaluating a conversation model fail?
      instructions:
      - text: Check evaluation job {jobId} for CLU model {trainedModelLabel} in project {projectName}.
        slots:
          jobId: path.jobId
          trainedModelLabel: path.trainedModelLabel
          projectName: path.projectName
      - text: Get the status of conversation model {trainedModelLabel} evaluation job {jobId}.
        slots:
          trainedModelLabel: path.trainedModelLabel
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluation/result'].get
  update:
    x-apievangelist-phrasing:
      intent: Get per-utterance conversation evaluation results
      effect: read
      questions:
      - Which test utterances did my CLU model predict wrongly?
      - Can I see the raw predicted vs expected intents from a conversation model evaluation?
      instructions:
      - text: Show detailed evaluation results for CLU model {trainedModelLabel} in project {projectName} with {stringIndexType} offsets.
        slots:
          trainedModelLabel: path.trainedModelLabel
          projectName: path.projectName
          stringIndexType: query.stringIndexType
      - text: Get per-utterance predictions from evaluating conversation model {trainedModelLabel}.
        slots:
          trainedModelLabel: path.trainedModelLabel
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluation/summary-result'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a conversation model's evaluation scores
      effect: read
      questions:
      - What F1, precision and recall did my CLU model score?
      - How well does each intent perform in my conversation model's evaluation summary?
      instructions:
      - text: Show the evaluation summary for CLU model {trainedModelLabel} in project {projectName}.
        slots:
          trainedModelLabel: path.trainedModelLabel
          projectName: path.projectName
      - text: Get precision and recall for conversation model {trainedModelLabel}.
        slots:
          trainedModelLabel: path.trainedModelLabel
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/load-snapshot/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation snapshot load job
      effect: read
      questions:
      - Has restoring my CLU model snapshot finished?
      - Is the conversation snapshot load still running?
      instructions:
      - text: Check snapshot load job {jobId} for CLU model {trainedModelLabel} in project {projectName}.
        slots:
          jobId: path.jobId
          trainedModelLabel: path.trainedModelLabel
          projectName: path.projectName
      - text: Get the status of loading conversation model {trainedModelLabel} snapshot job {jobId}.
        slots:
          trainedModelLabel: path.trainedModelLabel
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/resources'].get
  update:
    x-apievangelist-phrasing:
      intent: List resources assigned to a conversation project
      effect: read
      questions:
      - Which Azure resources can my CLU project deploy to?
      - Can I see the regions of resources assigned to a conversation project?
      instructions:
      - text: List the deployment resources assigned to CLU project {projectName}.
        slots:
          projectName: path.projectName
      - text: Show which resources my conversation project can deploy to.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/resources/:assign'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign resources to a conversation project
      effect: write
      questions:
      - Can I deploy a CLU project to Language resources in other regions?
      - Does assigning deployment resources to a conversation project need Entra ID auth?
      instructions:
      - text: Assign resources {resourcesMetadata} to CLU project {projectName}.
        slots:
          resourcesMetadata: requestBody.resourcesMetadata
          projectName: path.projectName
      - text: Let my conversation project deploy to resources {resourcesMetadata}.
        slots:
          resourcesMetadata: requestBody.resourcesMetadata
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/resources/:unassign'].post
  update:
    x-apievangelist-phrasing:
      intent: Unassign resources from a conversation project
      effect: destructive
      questions:
      - What happens to existing CLU deployments when I unassign a resource?
      - Can I stop a conversation project from deploying to certain resources?
      instructions:
      - text: Unassign resources {assignedResourceIds} from CLU project {projectName}.
        slots:
          assignedResourceIds: requestBody.assignedResourceIds
          projectName: path.projectName
      - text: Remove conversation project access to resources {assignedResourceIds}.
        slots:
          assignedResourceIds: requestBody.assignedResourceIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/resources/assign/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation resource assign job
      effect: read
      questions:
      - Did assigning resources to my CLU project succeed?
      - Is the conversation resource assignment job complete?
      instructions:
      - text: Check CLU resource assign job {jobId} for project {projectName}.
        slots:
          jobId: path.jobId
          projectName: path.projectName
      - text: Get the status of conversation assign-resources job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/resources/unassign/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation resource unassign job
      effect: read
      questions:
      - Has unassigning resources from my CLU project finished?
      - Did the conversation unassign-resources job fail?
      instructions:
      - text: Check CLU resource unassign job {jobId} for project {projectName}.
        slots:
          jobId: path.jobId
          projectName: path.projectName
      - text: Get the status of conversation unassign job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/train/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List a conversation project's training jobs
      effect: read
      questions:
      - Which CLU training jobs are still on record for my project?
      - Can I see recent conversation model training runs and their states?
      instructions:
      - text: List training jobs for CLU project {projectName}.
        slots:
          projectName: path.projectName
      - text: Show the non-expired conversation training jobs.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/train/jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation training job
      effect: read
      questions:
      - How far along is my CLU model training?
      - Did training a conversation model finish or fail?
      instructions:
      - text: Check CLU training job {jobId} in project {projectName}.
        slots:
          jobId: path.jobId
          projectName: path.projectName
      - text: Get progress of conversation training job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/{projectName}/train/jobs/{jobId}/:cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a conversation training job
      effect: destructive
      questions:
      - Can I stop a CLU training run that's taking too long?
      - What happens to a conversation model when I cancel its training?
      instructions:
      - text: Cancel CLU training job {jobId} in project {projectName}.
        slots:
          jobId: path.jobId
          projectName: path.projectName
      - text: Stop conversation model training job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/authoring/analyze-conversations/projects/global/deletion-jobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a conversation project deletion job
      effect: read
      questions:
      - Has my CLU project deletion completed?
      - Is the conversation project still being deleted?
      instructions:
      - text: Check CLU project deletion job {jobId}.
        slots:
          jobId: path.jobId
      - text: Get the status of conversation project delete job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (86 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/overlays/microsoft-azure-authoring-api-phrasing-overlay.yaml