# 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 Solutions API
  version: 1.0.0
extends: openapi/microsoft-azure-solutions-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: 14
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AgFoodPlatform/farmBeats/{dataManagerForAgricultureResourceName}/solutions/{solutionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an installed agriculture solution
      effect: read
      questions:
      - What are the details of a solution installed on my Data Manager for Agriculture resource?
      - Can I check the status of one installed FarmBeats solution by its solution ID?
      instructions:
      - text: Get installed agriculture solution {solutionId} on Data Manager for Agriculture resource {dataManagerForAgricultureResourceName}.
        slots:
          solutionId: path.solutionId
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      - text: Show the FarmBeats solution {solutionId} installed on {dataManagerForAgricultureResourceName}.
        slots:
          solutionId: path.solutionId
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AgFoodPlatform/farmBeats/{dataManagerForAgricultureResourceName}/solutions/{solutionId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Install or update an agriculture solution
      effect: write
      questions:
      - How do I install a partner solution on my Data Manager for Agriculture resource?
      - Can I update an agriculture solution I already installed using its eTag?
      instructions:
      - text: Install agriculture solution {solutionId} on Data Manager for Agriculture resource {dataManagerForAgricultureResourceName}.
        slots:
          solutionId: path.solutionId
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      - text: Update the FarmBeats solution {solutionId} on {dataManagerForAgricultureResourceName} with properties {properties}.
        slots:
          solutionId: path.solutionId
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AgFoodPlatform/farmBeats/{dataManagerForAgricultureResourceName}/solutions/{solutionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Uninstall an agriculture solution
      effect: destructive
      questions:
      - How do I uninstall a solution from my Data Manager for Agriculture resource?
      - Can I remove a FarmBeats partner solution I no longer use?
      instructions:
      - text: Uninstall agriculture solution {solutionId} from {dataManagerForAgricultureResourceName}.
        slots:
          solutionId: path.solutionId
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      - text: Remove the FarmBeats solution {solutionId} installed on Data Manager for Agriculture resource {dataManagerForAgricultureResourceName}.
        slots:
          solutionId: path.solutionId
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AgFoodPlatform/farmBeats/{dataManagerForAgricultureResourceName}/solutions'].get
  update:
    x-apievangelist-phrasing:
      intent: List installed agriculture solutions
      effect: read
      questions:
      - Which solutions are installed on my Data Manager for Agriculture resource?
      - Can I filter installed FarmBeats solutions by status or creation date?
      - Is there a page size limit when listing installed agriculture solutions?
      instructions:
      - text: List all solutions installed on Data Manager for Agriculture resource {dataManagerForAgricultureResourceName}.
        slots:
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      - text: Show installed agriculture solutions on {dataManagerForAgricultureResourceName} with status {statuses}.
        slots:
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
          statuses: query.statuses
      - text: List FarmBeats solutions on {dataManagerForAgricultureResourceName} created after {minCreatedDateTime}.
        slots:
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
          minCreatedDateTime: query.minCreatedDateTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a self-help troubleshooting solution
      effect: read
      questions:
      - Can I retrieve a self-help troubleshooting solution I created for an Azure resource?
      - What does the Azure Help solution resource I generated for my subscription contain?
      instructions:
      - text: Get the self-help solution {solutionResourceName} at scope {scope}.
        slots:
          solutionResourceName: path.solutionResourceName
          scope: path.scope
      - text: Show the troubleshooting solution {solutionResourceName} for resource {scope}.
        slots:
          solutionResourceName: path.solutionResourceName
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a self-help troubleshooting solution
      effect: write
      questions:
      - How do I create a self-help troubleshooting solution for an Azure resource from discovery results?
      - Can I generate a curated troubleshooting guide for my subscription using a solution ID and required inputs?
      instructions:
      - text: Create self-help solution {solutionResourceName} at scope {scope} using {properties}.
        slots:
          solutionResourceName: path.solutionResourceName
          scope: path.scope
          properties: requestBody.properties
      - text: Generate a troubleshooting solution named {solutionResourceName} for resource {scope}.
        slots:
          solutionResourceName: path.solutionResourceName
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update inputs of a self-help solution
      effect: write
      questions:
      - Can I change the required inputs on a self-help solution I already created?
      - Is there a way to add more information to an existing troubleshooting solution so it can run?
      instructions:
      - text: Update the required inputs of self-help solution {solutionResourceName} at {scope} to {properties}.
        slots:
          solutionResourceName: path.solutionResourceName
          scope: path.scope
          properties: requestBody.properties
      - text: Patch troubleshooting solution {solutionResourceName} on resource {scope} with additional information.
        slots:
          solutionResourceName: path.solutionResourceName
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}/warmup'].post
  update:
    x-apievangelist-phrasing:
      intent: Warm up a self-help solution's diagnostics
      effect: write
      questions:
      - Can I preload a self-help solution's diagnostic results into cache before a user opens it?
      - How do I warm up an Azure Help solution so asynchronous diagnostics are ready?
      instructions:
      - text: Warm up self-help solution {solutionResourceName} at scope {scope}.
        slots:
          solutionResourceName: path.solutionResourceName
          scope: path.scope
      - text: Preload diagnostics for troubleshooting solution {solutionResourceName} on {scope} with {parameters}.
        slots:
          solutionResourceName: path.solutionResourceName
          scope: path.scope
          parameters: requestBody.parameters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.IoTOperationsOrchestrator/solutions'].get
  update:
    x-apievangelist-phrasing:
      intent: List IoT Operations solutions in a subscription
      effect: read
      questions:
      - Which IoT Operations Orchestrator solutions exist across my whole subscription?
      - Can I see every orchestrator solution resource without narrowing to a resource group?
      instructions:
      - text: List all IoT Operations Orchestrator solutions in my subscription.
      - text: Show every orchestrator solution resource across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/solutions'].get
  update:
    x-apievangelist-phrasing:
      intent: List IoT Operations solutions in a resource group
      effect: read
      questions:
      - Which IoT Operations Orchestrator solutions are in one resource group?
      - Can I list orchestrator solutions scoped to a single resource group?
      instructions:
      - text: List the IoT Operations Orchestrator solutions in this resource group.
      - text: Show orchestrator solution resources for my resource group only.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/solutions/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an IoT Operations orchestrator solution
      effect: read
      questions:
      - What are the details of a specific IoT Operations Orchestrator solution?
      - Can I fetch an orchestrator solution resource by name?
      instructions:
      - text: Get IoT Operations Orchestrator solution {name}.
        slots:
          name: path.name
      - text: Show the orchestrator solution resource named {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/solutions/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an IoT Operations orchestrator solution
      effect: write
      questions:
      - How do I create an IoT Operations Orchestrator solution at an edge extended location?
      - Does creating an orchestrator solution require an extended location?
      instructions:
      - text: Create IoT Operations Orchestrator solution {name} at extended location {extendedLocation}.
        slots:
          name: path.name
          extendedLocation: requestBody.extendedLocation
      - text: Create orchestrator solution {name} with properties {properties} at {extendedLocation}.
        slots:
          name: path.name
          properties: requestBody.properties
          extendedLocation: requestBody.extendedLocation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/solutions/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an IoT Operations orchestrator solution
      effect: destructive
      questions:
      - Can I delete an IoT Operations Orchestrator solution I no longer need?
      - What removes an orchestrator solution resource by name?
      instructions:
      - text: Delete IoT Operations Orchestrator solution {name}.
        slots:
          name: path.name
      - text: Remove the orchestrator solution resource {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/solutions/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an IoT Operations solution
      effect: write
      questions:
      - Can I change the tags on an existing IoT Operations Orchestrator solution?
      - Is it possible to patch an orchestrator solution without recreating it?
      instructions:
      - text: Update the tags on IoT Operations Orchestrator solution {name} to {tags}.
        slots:
          name: path.name
          tags: requestBody.tags
      - text: Patch orchestrator solution {name} with new tags.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'