# 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 Personalizer Client 2022-09-01-preview…
  version: 1.0.0
extends: openapi/microsoft-azure-evaluations20220901preview-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['/evaluations/{evaluationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Personalizer offline evaluation
      effect: read
      questions:
      - How do I check the results of an offline evaluation?
      - Can I view an evaluation's results for a specific time window?
      instructions:
      - text: Get offline evaluation {evaluation} from {start} to {end}.
        slots:
          evaluation: path.evaluationId
          start: query.startTime
          end: query.endTime
      - text: Show evaluation {evaluation} results between {start} and {end} in {interval}-minute buckets.
        slots:
          evaluation: path.evaluationId
          start: query.startTime
          end: query.endTime
          interval: query.intervalInMinutes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/evaluations/{evaluationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Submit an offline evaluation job
      effect: write
      questions:
      - How do I start an offline evaluation of learning policies?
      - Can an offline evaluation also run policy optimization?
      instructions:
      - text: Create offline evaluation {evaluation} named {name} from {start} to {end} with policies {policies}.
        slots:
          evaluation: path.evaluationId
          name: requestBody.name
          start: requestBody.startTime
          end: requestBody.endTime
          policies: requestBody.policies
      - text: Submit evaluation {evaluation} called {name} over {start} to {end} with policies {policies} and optimization {optimize}.
        slots:
          evaluation: path.evaluationId
          name: requestBody.name
          start: requestBody.startTime
          end: requestBody.endTime
          policies: requestBody.policies
          optimize: requestBody.enablePolicyOptimization
      method: generated
      generated: '2026-09-26'
- target: $.paths['/evaluations/{evaluationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an offline evaluation
      effect: destructive
      questions:
      - How do I delete an old offline evaluation?
      - Can I remove an evaluation by its ID?
      instructions:
      - text: Delete offline evaluation {evaluation}.
        slots:
          evaluation: path.evaluationId
      - text: Remove the evaluation with ID {evaluation}.
        slots:
          evaluation: path.evaluationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/evaluations'].get
  update:
    x-apievangelist-phrasing:
      intent: List offline evaluations
      effect: read
      questions:
      - What offline evaluations have I run?
      - Can I page through or filter my offline evaluations?
      instructions:
      - text: List all offline evaluations.
      - text: List the top {top} offline evaluations matching {filter}.
        slots:
          top: query.top
          filter: query.filter
      method: generated
      generated: '2026-09-26'