# 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 v1.1-preview.3…
  version: 1.0.0
extends: openapi/microsoft-azure-evaluationsv1dot1preview1-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/evaluations/{evaluationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an offline evaluation
      effect: read
      questions:
      - How do I check the status and results of one Personalizer offline evaluation?
      - Can I look up an offline evaluation by its ID?
      instructions:
      - text: Get offline evaluation {evaluation_id}.
        slots:
          evaluation_id: path.evaluationId
      - text: Show me the results of evaluation {evaluation_id}.
        slots:
          evaluation_id: path.evaluationId
      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 remove an old offline evaluation I no longer need?
      - Can I delete a finished Personalizer evaluation job?
      instructions:
      - text: Delete offline evaluation {evaluation_id}.
        slots:
          evaluation_id: path.evaluationId
      - text: Remove evaluation {evaluation_id} from the Personalizer resource.
        slots:
          evaluation_id: path.evaluationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/evaluations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Personalizer offline evaluations
      effect: read
      questions:
      - Which offline evaluations have I run on my Personalizer resource?
      - Can I see all Personalizer offline evaluations at once?
      instructions:
      - text: List all my Personalizer offline evaluations.
      - text: Show every offline evaluation for this Personalizer resource.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/evaluations'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a Personalizer offline evaluation
      effect: write
      questions:
      - How do I run an offline evaluation of Personalizer learning policies over past events?
      - Can I test candidate policies against a specific time window of logged events?
      instructions:
      - text: Create offline evaluation {name} from {startTime} to {endTime} testing policies {policies}.
        slots:
          name: requestBody.name
          startTime: requestBody.startTime
          endTime: requestBody.endTime
          policies: requestBody.policies
      - text: Start a Personalizer offline evaluation named {name} over events between {startTime} and {endTime}, policies {policies}.
        slots:
          name: requestBody.name
          startTime: requestBody.startTime
          endTime: requestBody.endTime
          policies: requestBody.policies
      method: generated
      generated: '2026-10-01'