# 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 Weather API
  version: 1.0.0
extends: openapi/microsoft-azure-weather-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: 13
- target: $.paths['/weather'].get
  update:
    x-apievangelist-phrasing:
      intent: List ingested weather data for a farm boundary
      effect: read
      questions:
      - How do I pull the weather data I've ingested for a farm boundary in Data Manager for Agriculture?
      - Can I list historical versus forecast weather for a party's boundary at daily granularity?
      instructions:
      - text: List {weatherDataType} weather for party {partyId} boundary {boundaryId} from extension {extensionId} at {granularity} granularity.
        slots:
          weatherDataType: query.weatherDataType
          partyId: query.partyId
          boundaryId: query.boundaryId
          extensionId: query.extensionId
          granularity: query.granularity
      - text: Show stored {weatherDataType} weather since {startDateTime} for boundary {boundaryId}, party {partyId}, via {extensionId} at {granularity}.
        slots:
          boundaryId: query.boundaryId
          partyId: query.partyId
          extensionId: query.extensionId
          startDateTime: query.startDateTime
          weatherDataType: query.weatherDataType
          granularity: query.granularity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/delete-data/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a weather data delete job
      effect: read
      questions:
      - Has my job to delete stored farm weather data finished?
      - What status is a weather data deletion job in?
      instructions:
      - text: Check the status of weather delete job {jobId}.
        slots:
          jobId: path.jobId
      - text: Show details of weather data deletion job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/delete-data/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a job to delete stored weather data
      effect: destructive
      questions:
      - How do I delete weather data I ingested for a farm boundary?
      - Can I delete only forecast weather within a date range?
      instructions:
      - text: Create delete job {jobId} to remove weather for party {partyId} boundary {boundaryId} from extension {extensionId}.
        slots:
          jobId: path.jobId
          partyId: requestBody.partyId
          boundaryId: requestBody.boundaryId
          extensionId: requestBody.extensionId
      - text: Start job {jobId} deleting {weatherDataType} weather for boundary {boundaryId}, party {partyId}, extension {extensionId}.
        slots:
          jobId: path.jobId
          weatherDataType: requestBody.weatherDataType
          boundaryId: requestBody.boundaryId
          partyId: requestBody.partyId
          extensionId: requestBody.extensionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/ingest-data/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a weather ingestion job
      effect: read
      questions:
      - Did my weather data ingestion job for a farm succeed?
      - Where can I see the progress of a weather ingest job?
      instructions:
      - text: Check the status of weather ingestion job {jobId}.
        slots:
          jobId: path.jobId
      - text: Show details of weather ingest job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/ingest-data/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a job to ingest weather data
      effect: write
      questions:
      - How do I pull weather from a provider extension like DTN into my farm data?
      - Can I pass the weather provider's own API key when ingesting weather?
      instructions:
      - text: Create ingest job {jobId} for party {partyId} boundary {boundaryId} using extension {extensionId} API {extensionApiName} with input {extensionApiInput}.
        slots:
          jobId: path.jobId
          partyId: requestBody.partyId
          boundaryId: requestBody.boundaryId
          extensionId: requestBody.extensionId
          extensionApiName: requestBody.extensionApiName
          extensionApiInput: requestBody.extensionApiInput
      - text: Ingest weather into boundary {boundaryId} as job {jobId} via {extensionId} {extensionApiName}, party {partyId}, input {extensionApiInput}.
        slots:
          boundaryId: requestBody.boundaryId
          jobId: path.jobId
          extensionId: requestBody.extensionId
          extensionApiName: requestBody.extensionApiName
          partyId: requestBody.partyId
          extensionApiInput: requestBody.extensionApiInput
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/forecast/hourly/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an hour-by-hour weather forecast
      effect: read
      questions:
      - What will the temperature be each hour for the next day at these coordinates?
      - Can I get an hourly forecast up to 10 days out in imperial units?
      instructions:
      - text: Get the hourly forecast for {query} as {format}.
        slots:
          query: query.query
          format: path.format
      - text: Give me the next {duration} hours of forecast for {query} in {format}.
        slots:
          duration: query.duration
          query: query.query
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/forecast/minute/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a minute-by-minute precipitation forecast
      effect: read
      questions:
      - Will it start raining in the next two hours at my location?
      - Can I get forecasts in 1, 5 or 15 minute intervals?
      instructions:
      - text: Get the minute-by-minute forecast for {query} in {format}.
        slots:
          query: query.query
          format: path.format
      - text: Show the next 120 minutes of weather for {query} at {interval}-minute intervals as {format}.
        slots:
          query: query.query
          interval: query.interval
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/forecast/quarterDay/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a morning/afternoon/evening/overnight forecast
      effect: read
      questions:
      - What's the weather looking like this afternoon and overnight at these coordinates?
      - Can I get a forecast broken into quarters of the day for the next 5 days?
      instructions:
      - text: Get the quarter-day forecast for {query} as {format}.
        slots:
          query: query.query
          format: path.format
      - text: Show morning, afternoon, evening and overnight weather for {query} over {duration} days in {format}.
        slots:
          query: query.query
          duration: query.duration
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/currentConditions/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get current weather conditions at a location
      effect: read
      questions:
      - What's the weather right now at these coordinates?
      - Can I also see observations from the past 24 hours for a location?
      instructions:
      - text: Get current weather conditions at {query} as {format}.
        slots:
          query: query.query
          format: path.format
      - text: Show current conditions at {query} plus the past {duration} hours of observations, in {format}.
        slots:
          query: query.query
          duration: query.duration
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/forecast/daily/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a day-by-day weather forecast
      effect: read
      questions:
      - What's the daily high and low forecast for the next 10 days here?
      - How far ahead can a daily forecast go, up to 45 days?
      instructions:
      - text: Get the daily forecast for {query} as {format}.
        slots:
          query: query.query
          format: path.format
      - text: Show a {duration}-day daily forecast for {query} in {format} with {unit} units.
        slots:
          duration: query.duration
          query: query.query
          format: path.format
          unit: query.unit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/route/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get weather along a driving route
      effect: read
      questions:
      - Will my delivery route run into hazardous weather along the way?
      - Can I get nowcasts for each waypoint of a trip?
      instructions:
      - text: Get weather along the route through waypoints {query} as {format}.
        slots:
          query: query.query
          format: path.format
      - text: Check weather hazards for each waypoint in {query}, returning {format}.
        slots:
          query: query.query
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/severe/alerts/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get active severe weather alerts
      effect: read
      questions:
      - Are there any active severe weather warnings like storms or flooding near this location?
      - Can I get full alert details for tropical storm warnings?
      instructions:
      - text: Get severe weather alerts for {query} as {format}.
        slots:
          query: query.query
          format: path.format
      - text: Show full details of any storm or flood alerts at {query} in {format}.
        slots:
          query: query.query
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/weather/indices/daily/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get daily weather activity indices
      effect: read
      questions:
      - Is the weather good for running or outdoor construction over the next few days?
      - Can I get soil moisture or farming indices for a location?
      instructions:
      - text: Get daily weather indices for {query} as {format}.
        slots:
          query: query.query
          format: path.format
      - text: Show index {indexId} for {query} over {duration} days in {format}.
        slots:
          indexId: query.indexId
          query: query.query
          duration: query.duration
          format: path.format
      method: generated
      generated: '2026-09-26'