# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Azure Service Bot API
  version: 1.0.0
extends: openapi/microsoft-azure-bot-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BotService/botServices/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Bot Service resource
      effect: read
      questions:
      - How do I look up the configuration of one of my Azure bots?
      - What SKU and kind is a particular Bot Service resource running?
      instructions:
      - text: Get bot {resourceName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the settings of bot {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BotService/botServices/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Bot Service resource
      effect: write
      questions:
      - How do I register a new bot in Azure Bot Service?
      - Can I pick the SKU, kind and location when creating a bot?
      instructions:
      - text: Create bot {resourceName} in resource group {resourceGroupName}, subscription {subscriptionId}, located in {location}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: Create bot {resourceName} with SKU {sku} and kind {kind}.
        slots:
          resourceName: path.resourceName
          sku: requestBody.sku
          kind: requestBody.kind
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BotService/botServices/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Bot Service resource
      effect: destructive
      questions:
      - Can I remove a bot I no longer need from its resource group?
      - What happens to a bot's channels when the Bot Service resource is deleted?
      instructions:
      - text: Delete bot {resourceName} from resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the Bot Service resource {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BotService/botServices/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Bot Service resource
      effect: write
      questions:
      - Can I change the tags or SKU on an existing bot?
      - How do I update the properties of a bot that's already deployed?
      instructions:
      - text: Update bot {resourceName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Set the tags on bot {resourceName} to {tags}.
        slots:
          resourceName: path.resourceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BotService/botServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List bots in a resource group
      effect: read
      questions:
      - Which bots live in a particular resource group?
      - Can I list Bot Service resources scoped to one resource group?
      instructions:
      - text: List all bots in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the Bot Service resources inside {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.BotService/botServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List bots across a subscription
      effect: read
      questions:
      - How do I see every bot in my Azure subscription?
      - Is there a subscription-wide inventory of Bot Service resources?
      instructions:
      - text: List all bots in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every Bot Service resource in my subscription using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.BotService/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether a bot name is available
      effect: read
      questions:
      - Is a bot name I want already taken?
      - Can I test a bot name before creating the resource?
      instructions:
      - text: Check if bot name {name} is available.
        slots:
          name: requestBody.name
      - text: Check availability of name {name} for resource type {type} with API version {apiVersion}.
        slots:
          name: requestBody.name
          type: requestBody.type
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'