# 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 Crops API
  version: 1.0.0
extends: openapi/microsoft-azure-crops-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['/crops'].get
  update:
    x-apievangelist-phrasing:
      intent: List crops in Data Manager for Agriculture
      effect: read
      questions:
      - What crops are defined in my Data Manager for Agriculture instance?
      - Can I filter crops by phenotype, breeding method or status?
      instructions:
      - text: List all crops for API version {api_version}.
        slots:
          api_version: query.api-version
      - text: List crops with phenotypes {phenotypes} and breeding methods {breedingMethods}.
        slots:
          phenotypes: query.phenotypes
          breedingMethods: query.breedingMethods
      method: generated
      generated: '2026-09-26'
- target: $.paths['/crops/{cropId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a crop
      effect: read
      questions:
      - How do I look up a single crop by its ID?
      - What measurements and breeding method are stored for a crop?
      instructions:
      - text: Get crop {cropId}.
        slots:
          cropId: path.cropId
      - text: Show details of crop {cropId}.
        slots:
          cropId: path.cropId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/crops/{cropId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a crop
      effect: destructive
      questions:
      - How do I delete a crop from Data Manager for Agriculture?
      - Can I remove a crop record I created by mistake?
      instructions:
      - text: Delete crop {cropId}.
        slots:
          cropId: path.cropId
      - text: Remove crop {cropId} permanently.
        slots:
          cropId: path.cropId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/crops/{cropId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a crop
      effect: write
      questions:
      - How do I add a new crop with its phenotype and breeding method?
      - Can I change a crop's name or status after creating it?
      instructions:
      - text: Create crop {cropId} named {name} with phenotype {phenotype}.
        slots:
          cropId: path.cropId
          name: requestBody.name
          phenotype: requestBody.phenotype
      - text: Update crop {cropId} to breeding method {breedingMethod} and status {status}.
        slots:
          cropId: path.cropId
          breedingMethod: requestBody.breedingMethod
          status: requestBody.status
      method: generated
      generated: '2026-09-26'