Generated by API Evangelist
Written by API Evangelist tooling for Microsoft Azure's API. It is a proposal applied on top of the contract, not a document Microsoft Azure publishes.
# 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'
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.