# 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 Data Manager for Agriculture Data Plane…
  version: 1.0.0
extends: openapi/microsoft-azure-farmequipments-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: 4
- target: $.paths['/farm-equipments'].get
  update:
    x-apievangelist-phrasing:
      intent: List farm equipment
      effect: read
      questions:
      - What farm equipment is registered in my Azure Data Manager for Agriculture instance?
      - Can I filter farm equipment by brand, model or serial number?
      - Can I find equipment that was modified after a certain date?
      instructions:
      - text: List all farm equipment.
      - text: List farm equipment from brand {brand} with model {model}.
        slots:
          brand: query.brands
          model: query.models
      - text: Find farm equipment with serial {serial}.
        slots:
          serial: query.serial
      - text: List farm equipment modified since {since}, {pageSize} per page.
        slots:
          since: query.minLastModifiedDateTime
          pageSize: query.maxPageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/farm-equipments/{farmEquipmentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a farm equipment record
      effect: read
      questions:
      - How do I look up one piece of farm equipment by its ID?
      - Can I read the brand, model and ownership of a specific machine?
      instructions:
      - text: Get farm equipment {id}.
        slots:
          id: path.farmEquipmentId
      - text: Show the details of machine {id}.
        slots:
          id: path.farmEquipmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/farm-equipments/{farmEquipmentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a farm equipment record
      effect: destructive
      questions:
      - Can I delete a piece of farm equipment I sold or retired?
      - Does deleting a farm equipment ID remove its dataset?
      instructions:
      - text: Delete farm equipment {id}.
        slots:
          id: path.farmEquipmentId
      - text: Remove the dataset for machine {id}.
        slots:
          id: path.farmEquipmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/farm-equipments/{farmEquipmentId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a farm equipment record
      effect: write
      questions:
      - How do I register a new tractor or implement as farm equipment?
      - Can I update the ownership or status of an existing machine?
      instructions:
      - text: Create farm equipment {id} of brand {brand}, model {model}, serial {serial}.
        slots:
          id: path.farmEquipmentId
          brand: requestBody.brand
          model: requestBody.model
          serial: requestBody.serial
      - text: Set ownership of machine {id} to {ownership}.
        slots:
          id: path.farmEquipmentId
          ownership: requestBody.ownership
      - text: Mark farm equipment {id} with status {status}.
        slots:
          id: path.farmEquipmentId
          status: requestBody.status
      method: generated
      generated: '2026-09-26'