# 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 CognitiveServicesManagementClient Cognitive…
  version: 1.0.0
extends: openapi/microsoft-azure-cognitiveservicesaccounts-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Cognitive Services account
      effect: read
      questions:
      - What SKU, kind and endpoint does my Cognitive Services account have?
      - Can I look up one Cognitive Services account by name?
      instructions:
      - text: Get Cognitive Services account {account} in group {group}, subscription {subscription}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the properties of Cognitive Services account {account} in {group}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Cognitive Services account
      effect: write
      questions:
      - How do I create a Cognitive Services account to get API keys?
      - What must I choose when creating an account — SKU, kind and location?
      instructions:
      - text: Create a {kind} Cognitive Services account {account} in {group} ({subscription}) with SKU {sku} in {location} and properties {properties}.
        slots:
          kind: requestBody.kind
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
          sku: requestBody.sku
          location: requestBody.location
          properties: requestBody.properties
      - text: Provision account {account} of kind {kind}, SKU {sku}, in {location} under group {group}, properties {properties}.
        slots:
          account: path.accountName
          kind: requestBody.kind
          sku: requestBody.sku
          location: requestBody.location
          group: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Cognitive Services account
      effect: destructive
      questions:
      - How can I delete a Cognitive Services account I no longer use?
      - Can I remove a Cognitive Services account from its resource group?
      instructions:
      - text: Delete Cognitive Services account {account} in group {group}, subscription {subscription}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove the Cognitive Services account {account} from {group}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a Cognitive Services account's SKU or tags
      effect: write
      questions:
      - Can I upgrade my Cognitive Services account to a different pricing tier?
      - What can I change on an existing account — just the SKU and tags?
      instructions:
      - text: Change the SKU of account {account} in {group} ({subscription}) to {sku}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
          sku: requestBody.sku
      - text: Set tags {tags} on Cognitive Services account {account} in {group}.
        slots:
          tags: requestBody.tags
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Cognitive Services accounts in a group
      effect: read
      questions:
      - Which Cognitive Services accounts are in one resource group?
      - Can I narrow the account list to a single resource group?
      instructions:
      - text: List the Cognitive Services accounts in group {group}, subscription {subscription}.
        slots:
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show accounts that belong to resource group {group}.
        slots:
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.CognitiveServices/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Cognitive Services accounts in a subscription
      effect: read
      questions:
      - What Cognitive Services accounts do I have across my entire subscription?
      - Can I list every AI services account in a subscription at once?
      instructions:
      - text: List all Cognitive Services accounts in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every account across all resource groups of {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/listKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the access keys of a Cognitive Services account
      effect: read
      questions:
      - Where do I find the API keys for my Cognitive Services account?
      - Can I read both access keys for an account programmatically?
      instructions:
      - text: List the keys for Cognitive Services account {account} in group {group}, subscription {subscription}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Give me the access keys of {account} in {group}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/regenerateKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a Cognitive Services account key
      effect: destructive
      questions:
      - How do I rotate a leaked Cognitive Services key?
      - Can I regenerate just Key1 or Key2 on an account?
      instructions:
      - text: Regenerate key {key_name} for account {account} in group {group}, subscription {subscription}.
        slots:
          key_name: requestBody.keyName
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Rotate the {key_name} access key of Cognitive Services account {account} in {group}.
        slots:
          key_name: requestBody.keyName
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List SKUs available to a Cognitive Services account
      effect: read
      questions:
      - Which pricing tiers can my existing Cognitive Services account move to?
      - What SKUs are available for a specific account?
      instructions:
      - text: List available SKUs for account {account} in group {group}, subscription {subscription}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the tiers Cognitive Services account {account} in {group} can use.
        slots:
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'