# 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' - target: $.paths['/authoring/analyze-conversations/projects/global/deployments/resources'].get update: x-apievangelist-phrasing: intent: List CLU deployments assigned to this resource effect: read questions: - Which other projects' CLU deployments are hosted on my resource? - Can I see conversation deployments assigned to this resource from projects it doesn't own? instructions: - text: List conversation deployments assigned to this resource from other projects. - text: Show CLU deployments this resource hosts for projects owned elsewhere. method: generated generated: '2026-09-26' - target: $.paths['/authoring/analyze-conversations/projects/global/languages'].get update: x-apievangelist-phrasing: intent: List languages for a conversation project kind effect: read questions: - Which languages does conversational language understanding support? - Is my language available for an orchestration project? instructions: - text: List supported languages for conversation project kind {projectKind}. slots: projectKind: query.projectKind - text: Show which languages a {projectKind} CLU project can use. slots: projectKind: query.projectKind method: generated generated: '2026-09-26' - target: $.paths['/authoring/analyze-conversations/projects/global/prebuilt-entities'].get update: x-apievangelist-phrasing: intent: List prebuilt entities for conversation projects effect: read questions: - What prebuilt entities can I use in a CLU composed entity? - Are the conversation prebuilt entities different for multilingual projects? instructions: - text: List CLU prebuilt entities for language {language}. slots: language: query.language - text: Show conversation prebuilt entities with multilingual set to {multilingual}. slots: multilingual: query.multilingual method: generated generated: '2026-09-26' - target: $.paths['/authoring/analyze-conversations/projects/global/training-config-versions'].get update: x-apievangelist-phrasing: intent: List conversation training config versions effect: read questions: - Which training configuration versions can I pick for a CLU model? - What's the latest training config version for orchestration projects? instructions: - text: List training config versions for conversation project kind {projectKind}. slots: projectKind: query.projectKind - text: Show CLU training config versions available for {projectKind}. slots: projectKind: query.projectKind method: generated generated: '2026-09-26' - target: $.paths['/authoring/analyze-text/projects'].get update: x-apievangelist-phrasing: intent: List custom text projects effect: read questions: - Which custom text classification and NER projects do I have? - Can I see all my analyze-text authoring projects? instructions: - text: List my custom text authoring projects. - text: Show every custom classification and entity recognition project. method: generated generated: '2026-09-26' - target: $.paths['/authoring/analyze-text/projects/{projectName}'].get update: x-apievangelist-phrasing: intent: Get a custom text project effect: read questions: - What storage container and language does my custom text project use? - When was my custom NER project last trained? instructions: - text: Show the details of custom text project {projectName}. slots: projectName: path.projectName - text: Get the metadata for this custom classification project. method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}'].delete update: x-apievangelist-phrasing: intent: Delete a custom text project effect: destructive questions: - Can I permanently delete a custom text classification project? - Does deleting a custom NER project also remove its deployments? instructions: - text: Delete custom text project {projectName}. slots: projectName: path.projectName - text: Remove this custom entity recognition project. method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}'].patch update: x-apievangelist-phrasing: intent: Create or update a custom text project effect: write questions: - How do I create a custom text classification project linked to my blob container? - Can I make a custom NER project multilingual? instructions: - text: Create custom text project {projectName} of kind {projectKind} in {language} using container {storageInputContainerName}. slots: projectName: path.projectName projectKind: requestBody.projectKind language: requestBody.language storageInputContainerName: requestBody.storageInputContainerName - text: Set up a {projectKind} project named {projectName} in {language} from container {storageInputContainerName}, multilingual {multilingual}. slots: projectKind: requestBody.projectKind projectName: requestBody.projectName language: requestBody.language storageInputContainerName: requestBody.storageInputContainerName multilingual: requestBody.multilingual method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/:authorize-copy'].post update: x-apievangelist-phrasing: intent: Authorize copying a custom text project here effect: write questions: - What must the target resource generate before I copy a custom text project to it? - Can a custom classification project copy overwrite an existing one? instructions: - text: Generate a copy authorization so a {projectKind} custom text project can be copied in as {projectName}. slots: projectKind: requestBody.projectKind projectName: path.projectName - text: Authorize a custom text project copy of kind {projectKind} into container {storageInputContainerName}, overwrite {allowOverwrite}. slots: projectKind: requestBody.projectKind storageInputContainerName: requestBody.storageInputContainerName allowOverwrite: requestBody.allowOverwrite method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/:copy'].post update: x-apievangelist-phrasing: intent: Copy a custom text project to another resource effect: write questions: - Can I move a custom NER project to a Language resource in another region? - Which authorization values does the custom text project copy need? instructions: - text: Copy custom text project {projectName} to {targetProjectName} on {targetResourceId} in {targetResourceRegion} with token {accessToken}, kind {projectKind}. slots: projectName: path.projectName targetProjectName: requestBody.targetProjectName targetResourceId: requestBody.targetResourceId targetResourceRegion: requestBody.targetResourceRegion accessToken: requestBody.accessToken projectKind: requestBody.projectKind - text: Start a custom classification copy to {targetProjectName} in {targetResourceRegion} using token {accessToken}. slots: targetProjectName: requestBody.targetProjectName targetResourceRegion: requestBody.targetResourceRegion accessToken: requestBody.accessToken method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/:export'].post update: x-apievangelist-phrasing: intent: Export a custom text project's data effect: write questions: - Can I export my custom text project's labels and documents list? - Is it possible to export the data behind one trained custom NER model? instructions: - text: Export custom text project {projectName} with {stringIndexType} string offsets. slots: projectName: path.projectName stringIndexType: query.stringIndexType - text: Export custom text model {trainedModelLabel} assets of kind {assetKind} using {stringIndexType} offsets. slots: trainedModelLabel: query.trainedModelLabel assetKind: query.assetKind stringIndexType: query.stringIndexType method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/:import'].post update: x-apievangelist-phrasing: intent: Import data into a custom text project effect: write questions: - Can I import a custom text project from JSON or AML format? - Will importing a custom classification project replace the existing one? instructions: - text: Import into custom text project {projectName} with metadata {metadata}, file version {projectFileVersion} and {stringIndexType} offsets. slots: projectName: path.projectName metadata: requestBody.metadata projectFileVersion: requestBody.projectFileVersion stringIndexType: requestBody.stringIndexType - text: Import custom text assets {assets} in {format} format, metadata {metadata}, version {projectFileVersion}, offsets {stringIndexType}. slots: assets: requestBody.assets format: header.format metadata: requestBody.metadata projectFileVersion: requestBody.projectFileVersion stringIndexType: requestBody.stringIndexType method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/:train'].post update: x-apievangelist-phrasing: intent: Train a custom text model effect: write questions: - How do I train a custom text classification model? - Which training config version should I pass when training a custom NER model? instructions: - text: Train custom text model {modelLabel} in project {projectName} with config version {trainingConfigVersion}. slots: modelLabel: requestBody.modelLabel projectName: path.projectName trainingConfigVersion: requestBody.trainingConfigVersion - text: Start custom NER training for {modelLabel} using config {trainingConfigVersion} and evaluation options {evaluationOptions}. slots: modelLabel: requestBody.modelLabel trainingConfigVersion: requestBody.trainingConfigVersion evaluationOptions: requestBody.evaluationOptions method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/copy/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text project copy job effect: read questions: - Has my custom text project copy finished? - Did copying the custom classification project fail? instructions: - text: Check copy job {jobId} for custom text project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the status of custom classification project copy {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/deployments'].get update: x-apievangelist-phrasing: intent: List a custom text project's deployments effect: read questions: - Which deployments does my custom text project have? - Can I see what model each custom NER deployment serves? instructions: - text: List the deployments of custom text project {projectName}. slots: projectName: path.projectName - text: Show all custom classification deployments. method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/deployments/:swap'].post update: x-apievangelist-phrasing: intent: Swap two custom text deployments effect: write questions: - Can I swap two custom text deployments to promote a new model? - Is there a one-step way to exchange custom NER production and staging deployments? instructions: - text: Swap custom text deployments {firstDeploymentName} and {secondDeploymentName} in project {projectName}. slots: firstDeploymentName: requestBody.firstDeploymentName secondDeploymentName: requestBody.secondDeploymentName projectName: path.projectName - text: Exchange custom classification deployment {firstDeploymentName} with {secondDeploymentName}. slots: firstDeploymentName: requestBody.firstDeploymentName secondDeploymentName: requestBody.secondDeploymentName method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}'].get update: x-apievangelist-phrasing: intent: Get a custom text deployment effect: read questions: - Which model is behind one of my custom text deployments? - When does the model in a custom NER deployment expire? instructions: - text: Show details of deployment {deploymentName} in custom text project {projectName}. slots: deploymentName: path.deploymentName projectName: path.projectName - text: Get the custom classification deployment I name. method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}'].put update: x-apievangelist-phrasing: intent: Deploy a trained custom text model effect: write questions: - How do I deploy a trained custom text model for inference? - Can I deploy a custom NER model to multiple assigned resources? instructions: - text: Deploy custom text model {trainedModelLabel} as deployment {deploymentName} of project {projectName}. slots: trainedModelLabel: requestBody.trainedModelLabel deploymentName: path.deploymentName projectName: path.projectName - text: Deploy custom classification model {trainedModelLabel} to resources {assignedResourceIds}. slots: trainedModelLabel: requestBody.trainedModelLabel assignedResourceIds: requestBody.assignedResourceIds method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}'].delete update: x-apievangelist-phrasing: intent: Delete a custom text deployment effect: destructive questions: - Can I delete a custom text deployment I no longer call? - Will deleting a custom NER deployment break live predictions? instructions: - text: Delete deployment {deploymentName} from custom text project {projectName}. slots: deploymentName: path.deploymentName projectName: path.projectName - text: Remove the custom classification deployment from the project. method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}/:delete-from-resources'].post update: x-apievangelist-phrasing: intent: Remove a custom text deployment from resources effect: destructive questions: - Can I remove a custom text deployment from just some assigned resources? - How do I pull a custom NER deployment out of one region only? instructions: - text: Delete custom text deployment {deploymentName} of project {projectName} from resources {assignedResourceIds}. slots: deploymentName: path.deploymentName projectName: path.projectName assignedResourceIds: requestBody.assignedResourceIds - text: Remove the custom classification deployment from assigned resources {assignedResourceIds} only. slots: assignedResourceIds: requestBody.assignedResourceIds method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}/delete-from-resources/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text delete-from-resources job effect: read questions: - Has the custom text deployment been removed from those resources yet? - Did the custom NER delete-from-resources job fail? instructions: - text: Check custom text 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 custom classification deployment removal {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text deployment job effect: read questions: - Is my custom text deployment live yet? - Why did deploying my custom NER model fail? instructions: - text: Check custom text deployment job {jobId} for {deploymentName} in project {projectName}. slots: jobId: path.jobId deploymentName: path.deploymentName projectName: path.projectName - text: Get progress on custom classification deploy job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/deployments/swap/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text deployment swap job effect: read questions: - Did swapping my custom text deployments succeed? - Is the custom NER deployment swap still running? instructions: - text: Check custom text swap job {jobId} in project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the result of custom classification swap job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/export/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text project export job effect: read questions: - Is my custom text project export ready? - Where are the exported custom NER assets once the job completes? instructions: - text: Check export job {jobId} for custom text project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the custom classification export result for job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/exported-models'].get update: x-apievangelist-phrasing: intent: List a custom text project's exported models effect: read questions: - Which exported models exist in my custom text project? - Can I see all custom text models I've exported for offline use? instructions: - text: List exported models in custom text project {projectName}. slots: projectName: path.projectName - text: Show every exported custom classification model. method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/exported-models/{exportedModelName}'].get update: x-apievangelist-phrasing: intent: Get an exported custom text model effect: read questions: - Which trained model was an exported custom text model created from? - When was a particular exported model last updated? instructions: - text: Show exported model {exportedModelName} in custom text project {projectName}. slots: exportedModelName: path.exportedModelName projectName: path.projectName - text: Get details of custom text exported model {exportedModelName}. slots: exportedModelName: path.exportedModelName method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/exported-models/{exportedModelName}'].put update: x-apievangelist-phrasing: intent: Create or replace an exported custom text model effect: write questions: - How do I export a trained custom text model so I can download it? - Can I replace an exported model with a newer trained model? instructions: - text: Create exported model {exportedModelName} in project {projectName} from trained model {trainedModelLabel}. slots: exportedModelName: path.exportedModelName projectName: path.projectName trainedModelLabel: requestBody.trainedModelLabel - text: Point exported model {exportedModelName} at custom text model {trainedModelLabel}. slots: exportedModelName: path.exportedModelName trainedModelLabel: requestBody.trainedModelLabel method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/exported-models/{exportedModelName}'].delete update: x-apievangelist-phrasing: intent: Delete an exported custom text model effect: destructive questions: - Can I delete an exported custom text model I no longer need? - Does deleting an exported model affect the trained model it came from? instructions: - text: Delete exported model {exportedModelName} from custom text project {projectName}. slots: exportedModelName: path.exportedModelName projectName: path.projectName - text: Remove custom text exported model {exportedModelName}. slots: exportedModelName: path.exportedModelName method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/exported-models/{exportedModelName}/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check an exported model job effect: read questions: - Is my exported custom text model finished being created? - Did the job to update an exported model fail? instructions: - text: Check job {jobId} for exported model {exportedModelName} in project {projectName}. slots: jobId: path.jobId exportedModelName: path.exportedModelName projectName: path.projectName - text: Get the status of creating exported model {exportedModelName}, job {jobId}. slots: exportedModelName: path.exportedModelName jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/exported-models/{exportedModelName}/manifest'].get update: x-apievangelist-phrasing: intent: Get the download manifest for an exported model effect: read questions: - Where do I download the files for an exported custom text model? - What URLs does an exported model's manifest give me? instructions: - text: Get the download manifest for exported model {exportedModelName} in project {projectName}. slots: exportedModelName: path.exportedModelName projectName: path.projectName - text: Give me the download URL for custom text exported model {exportedModelName}. slots: exportedModelName: path.exportedModelName method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/import/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text project import job effect: read questions: - Did my custom text project import work? - Is the custom classification import still running? instructions: - text: Check import job {jobId} for custom text project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the status of custom NER import job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/models'].get update: x-apievangelist-phrasing: intent: List a custom text project's trained models effect: read questions: - Which trained models are in my custom text project? - Can I list every custom NER model label I've trained? instructions: - text: List trained models in custom text project {projectName}. slots: projectName: path.projectName - text: Show all custom classification models I've trained. method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}'].get update: x-apievangelist-phrasing: intent: Get a trained custom text model effect: read questions: - When was a specific custom text model trained? - Does one of my custom NER models have an expiry date? instructions: - text: Show custom text trained model {trainedModelLabel} in project {projectName}. slots: trainedModelLabel: path.trainedModelLabel projectName: path.projectName - text: Get details for custom classification model {trainedModelLabel}. slots: trainedModelLabel: path.trainedModelLabel method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}'].delete update: x-apievangelist-phrasing: intent: Delete a trained custom text model effect: destructive questions: - Can I delete an old custom text model? - Is deleting a trained custom NER model permanent? instructions: - text: Delete custom text trained model {trainedModelLabel} from project {projectName}. slots: trainedModelLabel: path.trainedModelLabel projectName: path.projectName - text: Remove custom classification model {trainedModelLabel}. slots: trainedModelLabel: path.trainedModelLabel method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/:evaluate'].post update: x-apievangelist-phrasing: intent: Evaluate a trained custom text model effect: write questions: - Can I re-evaluate a custom text model with a new train/test split? - What split settings are allowed when evaluating a custom NER model? instructions: - text: Evaluate custom text model {trainedModelLabel} in project {projectName}. slots: trainedModelLabel: path.trainedModelLabel projectName: path.projectName - text: Evaluate custom classification model {trainedModelLabel} with a {trainingSplitPercentage}/{testingSplitPercentage} train/test split. slots: trainedModelLabel: path.trainedModelLabel trainingSplitPercentage: requestBody.trainingSplitPercentage testingSplitPercentage: requestBody.testingSplitPercentage method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/:load-snapshot'].post update: x-apievangelist-phrasing: intent: Restore a custom text model snapshot effect: write questions: - Can I roll my custom text project back to the data an earlier model used? - What does loading a custom NER model snapshot overwrite? instructions: - text: Load the snapshot of custom text model {trainedModelLabel} into project {projectName}. slots: trainedModelLabel: path.trainedModelLabel projectName: path.projectName - text: Restore my custom classification project to model {trainedModelLabel}'s data. slots: trainedModelLabel: path.trainedModelLabel method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluate/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text evaluation job effect: read questions: - Is the evaluation of my custom text model finished? - Did the custom NER model evaluation fail? instructions: - text: Check evaluation job {jobId} for custom text model {trainedModelLabel} in project {projectName}. slots: jobId: path.jobId trainedModelLabel: path.trainedModelLabel projectName: path.projectName - text: Get the status of custom classification model {trainedModelLabel} evaluation {jobId}. slots: trainedModelLabel: path.trainedModelLabel jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluation/result'].get update: x-apievangelist-phrasing: intent: Get per-document custom text evaluation results effect: read questions: - Which test documents did my custom text model misclassify? - Can I see raw expected vs predicted entities from a custom NER evaluation? instructions: - text: Show detailed evaluation results for custom text model {trainedModelLabel} in project {projectName} with {stringIndexType} offsets. slots: trainedModelLabel: path.trainedModelLabel projectName: path.projectName stringIndexType: query.stringIndexType - text: Get per-document predictions from custom classification model {trainedModelLabel}'s evaluation. slots: trainedModelLabel: path.trainedModelLabel method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluation/summary-result'].get update: x-apievangelist-phrasing: intent: Get a custom text model's evaluation scores effect: read questions: - What F1 score did my custom text classification model get? - Can I see precision and recall per entity for a custom NER model? instructions: - text: Show the evaluation summary for custom text model {trainedModelLabel} in project {projectName}. slots: trainedModelLabel: path.trainedModelLabel projectName: path.projectName - text: Get F1, precision and recall for custom classification model {trainedModelLabel}. slots: trainedModelLabel: path.trainedModelLabel method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/load-snapshot/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text snapshot load job effect: read questions: - Has loading my custom text model snapshot completed? - Is the custom NER snapshot restore still running? instructions: - text: Check snapshot load job {jobId} for custom text model {trainedModelLabel} in project {projectName}. slots: jobId: path.jobId trainedModelLabel: path.trainedModelLabel projectName: path.projectName - text: Get the status of restoring custom classification model {trainedModelLabel}, job {jobId}. slots: trainedModelLabel: path.trainedModelLabel jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/resources'].get update: x-apievangelist-phrasing: intent: List resources assigned to a custom text project effect: read questions: - Which resources can my custom text project deploy to? - Can I see the assigned regions for a custom NER project? instructions: - text: List deployment resources assigned to custom text project {projectName}. slots: projectName: path.projectName - text: Show which resources my custom classification project can deploy to. method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/resources/:assign'].post update: x-apievangelist-phrasing: intent: Assign resources to a custom text project effect: write questions: - Can I deploy a custom text model to resources in other regions? - Does assigning resources to a custom NER project require Entra ID authentication? instructions: - text: Assign resources {resourcesMetadata} to custom text project {projectName}. slots: resourcesMetadata: requestBody.resourcesMetadata projectName: path.projectName - text: Let my custom classification project deploy to {resourcesMetadata}. slots: resourcesMetadata: requestBody.resourcesMetadata method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/resources/:unassign'].post update: x-apievangelist-phrasing: intent: Unassign resources from a custom text project effect: destructive questions: - What happens to custom text deployments on a resource I unassign? - Can I stop a custom NER project from deploying to some resources? instructions: - text: Unassign resources {assignedResourceIds} from custom text project {projectName}. slots: assignedResourceIds: requestBody.assignedResourceIds projectName: path.projectName - text: Remove custom classification project access to {assignedResourceIds}. slots: assignedResourceIds: requestBody.assignedResourceIds method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/resources/assign/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text resource assign job effect: read questions: - Did assigning resources to my custom text project finish? - Is the custom NER assign-resources job done? instructions: - text: Check custom text resource assign job {jobId} for project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the status of custom classification assign job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/resources/unassign/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text resource unassign job effect: read questions: - Has unassigning resources from my custom text project completed? - Did the custom NER unassign job fail? instructions: - text: Check custom text resource unassign job {jobId} for project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the status of custom classification unassign job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/train/jobs'].get update: x-apievangelist-phrasing: intent: List a custom text project's training jobs effect: read questions: - Which custom text training jobs are still recorded? - Can I see recent custom NER training runs? instructions: - text: List training jobs for custom text project {projectName}. slots: projectName: path.projectName - text: Show the non-expired custom classification training jobs. method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/train/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text training job effect: read questions: - How far along is my custom text model training? - Did my custom NER training job succeed? instructions: - text: Check custom text training job {jobId} in project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get progress of custom classification training {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/{projectName}/train/jobs/{jobId}/:cancel'].post update: x-apievangelist-phrasing: intent: Cancel a custom text training job effect: destructive questions: - Can I cancel a custom text training run in progress? - What happens to a custom NER model if I stop its training? instructions: - text: Cancel custom text training job {jobId} in project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Stop custom classification training job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/analyze-text/projects/global/deletion-jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a custom text project deletion job effect: read questions: - Has my custom text project finished deleting? - Is the custom NER project deletion still running? instructions: - text: Check custom text project deletion job {jobId}. slots: jobId: path.jobId - text: Get the status of custom classification project delete job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-09-26' - target: $.paths['/authoring/analyze-text/projects/global/deployments/resources'].get update: x-apievangelist-phrasing: intent: List custom text deployments assigned to this resource effect: read questions: - Which custom text deployments from other resources' projects are hosted here? - Can I see custom NER deployments assigned to my resource by projects it doesn't own? instructions: - text: List custom text deployments assigned to this resource from other projects. - text: Show custom classification deployments this resource hosts for projects owned elsewhere. method: generated generated: '2026-09-26' - target: $.paths['/authoring/analyze-text/projects/global/languages'].get update: x-apievangelist-phrasing: intent: List languages for custom text projects effect: read questions: - Which languages does custom text classification support? - Is my language available for custom named entity recognition? instructions: - text: List supported languages for custom text projects. - text: Show languages available for custom text project kind {projectKind}. slots: projectKind: query.projectKind method: generated generated: '2026-09-26' - target: $.paths['/authoring/analyze-text/projects/global/prebuilt-entities'].get update: x-apievangelist-phrasing: intent: List prebuilt entities for custom text projects effect: read questions: - What prebuilt entities can I use in custom text composed entities? - Do custom text prebuilt entities differ by language? instructions: - text: List custom text prebuilt entities for language {language}. slots: language: query.language - text: Show prebuilt entities for {projectKind} custom text projects, multilingual {multilingual}. slots: projectKind: query.projectKind multilingual: query.multilingual method: generated generated: '2026-09-26' - target: $.paths['/authoring/analyze-text/projects/global/training-config-versions'].get update: x-apievangelist-phrasing: intent: List custom text training config versions effect: read questions: - Which training config versions are available for custom text models? - What's the newest training config for custom NER? instructions: - text: List training config versions for custom text project kind {projectKind}. slots: projectKind: query.projectKind - text: Show custom text training configs available for {projectKind}. slots: projectKind: query.projectKind method: generated generated: '2026-09-26' - target: $.paths['/authoring/query-knowledgebases/projects'].get update: x-apievangelist-phrasing: intent: List question answering projects effect: read questions: - Which question answering knowledge base projects do I have? - Can I see all my custom question answering projects? instructions: - text: List my question answering projects. - text: Show every knowledge base project on this resource. method: generated generated: '2026-09-26' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}'].get update: x-apievangelist-phrasing: intent: Get a question answering project effect: read questions: - What language and settings does my question answering project use? - When was my knowledge base project last deployed? instructions: - text: Show the details of question answering project {projectName}. slots: projectName: path.projectName - text: Get the metadata for this knowledge base project. method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}'].delete update: x-apievangelist-phrasing: intent: Delete a question answering project effect: destructive questions: - Can I delete a question answering project and its knowledge base? - Is deleting a knowledge base project reversible? instructions: - text: Delete question answering project {projectName}. slots: projectName: path.projectName - text: Remove this knowledge base project entirely. method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}'].patch update: x-apievangelist-phrasing: intent: Create or update a question answering project effect: write questions: - How do I create a new question answering knowledge base project? - Can a question answering project support multiple languages? instructions: - text: Create question answering project {projectName} in language {language}. slots: projectName: path.projectName language: requestBody.language - text: Set up a knowledge base project in {language} described as {description} with settings {settings}. slots: language: requestBody.language description: requestBody.description settings: requestBody.settings method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/deletion-jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a question answering project deletion job effect: read questions: - Has my knowledge base project deletion finished? - Is the question answering project still being deleted? instructions: - text: Check question answering delete job {jobId}. slots: jobId: path.jobId - text: Get the status of knowledge base project deletion {jobId}. slots: jobId: path.jobId method: generated generated: '2026-09-26' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/:export'].post update: x-apievangelist-phrasing: intent: Export a question answering project effect: write questions: - Can I export my knowledge base as a TSV or Excel file? - Is there a way to export only the QnAs of a question answering project? instructions: - text: Export question answering project {projectName}. slots: projectName: path.projectName - text: Export my knowledge base in {format} format with asset kind {assetKind}. slots: format: query.format assetKind: query.assetKind method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/export/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a question answering export job effect: read questions: - Is my knowledge base export ready to download? - Where do I find exported question answering assets when the job finishes? instructions: - text: Check export job {jobId} for question answering project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the knowledge base export result for job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/:import'].post update: x-apievangelist-phrasing: intent: Import into a question answering project effect: write questions: - Can I import a knowledge base from a file URL? - Which formats can I import question answering assets from? instructions: - text: Import knowledge base assets from {fileUri} in {format} format into project {projectName}. slots: fileUri: requestBody.fileUri format: query.format projectName: path.projectName - text: Import QnA assets {assets} with metadata {metadata} into my question answering project. slots: assets: requestBody.assets metadata: requestBody.metadata method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/import/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a question answering import job effect: read questions: - Did my knowledge base import succeed? - Is the question answering import still running? instructions: - text: Check import job {jobId} for question answering project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the status of knowledge base import {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/deployments/{deploymentName}'].put update: x-apievangelist-phrasing: intent: Deploy a question answering project effect: write questions: - How do I publish my knowledge base to production? - Can I push the latest QnA edits live so the query endpoint uses them? instructions: - text: Deploy question answering project {projectName} to deployment {deploymentName}. slots: projectName: path.projectName deploymentName: path.deploymentName - text: Publish the knowledge base project's current QnAs. method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/deployments/{deploymentName}/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a question answering deploy job effect: read questions: - Is my knowledge base deployment complete? - Did publishing the question answering project fail? instructions: - text: Check deploy job {jobId} for deployment {deploymentName} of question answering project {projectName}. slots: jobId: path.jobId deploymentName: path.deploymentName projectName: path.projectName - text: Get the status of knowledge base publish job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/deployments'].get update: x-apievangelist-phrasing: intent: List a question answering project's deployments effect: read questions: - Which deployments does my knowledge base project have? - When was each question answering deployment last published? instructions: - text: List deployments of question answering project {projectName}. slots: projectName: path.projectName - text: Show all knowledge base deployments. method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/synonyms'].get update: x-apievangelist-phrasing: intent: List a knowledge base's synonyms effect: read questions: - What synonyms are defined in my question answering project? - Can I review the word alterations my knowledge base uses? instructions: - text: Show all synonyms in question answering project {projectName}. slots: projectName: path.projectName - text: List knowledge base synonym groups. method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/synonyms'].put update: x-apievangelist-phrasing: intent: Replace a knowledge base's synonyms effect: write questions: - Can I replace all synonyms in my knowledge base at once? - How do I add word alterations to a question answering project? instructions: - text: Set the synonyms of question answering project {projectName} to {value}. slots: projectName: path.projectName value: requestBody.value - text: Replace my knowledge base synonym list with {value}. slots: value: requestBody.value method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/sources'].get update: x-apievangelist-phrasing: intent: List a knowledge base's sources effect: read questions: - Which URLs and files feed my question answering project? - Can I see the sources behind my knowledge base? instructions: - text: List sources of question answering project {projectName}. slots: projectName: path.projectName - text: Show the knowledge base's source documents and URLs. method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/sources'].patch update: x-apievangelist-phrasing: intent: Add, change or remove knowledge base sources effect: write questions: - Can I add a new URL source to my knowledge base? - How do I refresh or remove a source in a question answering project? instructions: - text: Update the sources of question answering project {projectName}. slots: projectName: path.projectName - text: Add or remove knowledge base sources. method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/sources/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a knowledge base source update job effect: read questions: - Has my knowledge base source update finished? - Did adding sources to the question answering project fail? instructions: - text: Check source update job {jobId} for project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the status of knowledge base sources job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/qnas'].get update: x-apievangelist-phrasing: intent: List a knowledge base's question-answer pairs effect: read questions: - What question and answer pairs are in my knowledge base? - Can I list only the QnAs that came from one source? instructions: - text: List all QnAs in question answering project {projectName}. slots: projectName: path.projectName - text: Show knowledge base QnA pairs from source {source}. slots: source: query.source method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/qnas'].patch update: x-apievangelist-phrasing: intent: Add, edit or delete knowledge base QnAs effect: write questions: - Can I edit an answer in my knowledge base through the API? - How do I add new question-answer pairs to a question answering project? instructions: - text: Update the QnA pairs in question answering project {projectName}. slots: projectName: path.projectName - text: Add, edit or delete knowledge base question-answer pairs. method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/qnas/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Check a knowledge base QnA update job effect: read questions: - Did my knowledge base QnA edits get applied? - Is the question answering QnA update job done? instructions: - text: Check QnA update job {jobId} for project {projectName}. slots: jobId: path.jobId projectName: path.projectName - text: Get the status of knowledge base QnA edit job {jobId}. slots: jobId: path.jobId method: generated generated: '2026-10-01' - target: $.paths['/authoring/query-knowledgebases/projects/{projectName}/feedback'].post update: x-apievangelist-phrasing: intent: Submit active learning feedback effect: write questions: - Can I send user feedback to improve my knowledge base's answers? - What does active learning feedback for a question answering project contain? instructions: - text: Submit active learning feedback records {records} to project {projectName}. slots: records: requestBody.records projectName: path.projectName - text: Send knowledge base feedback {records} to my question answering project. slots: records: requestBody.records method: generated generated: '2026-10-01'