# 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 Events API
  version: 1.0.0
extends: openapi/microsoft-azure-events-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events'].get
  update:
    x-apievangelist-phrasing:
      intent: List service health events for a subscription
      effect: read
      questions:
      - Are there any Azure service health incidents affecting my subscription?
      - Can I see service health events that started after a certain date?
      instructions:
      - text: List service health events in my subscription.
      - text: Show subscription service health events since {queryStartTime}.
        slots:
          queryStartTime: query.queryStartTime
      - text: List subscription health events matching filter {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ResourceHealth/events'].get
  update:
    x-apievangelist-phrasing:
      intent: List service health events for the tenant
      effect: read
      questions:
      - What current service health events affect my whole Azure tenant?
      - Is there a tenant-level view of ongoing Azure outages?
      instructions:
      - text: List current service health events across my tenant.
      - text: Show tenant-wide health events starting from {queryStartTime}.
        slots:
          queryStartTime: query.queryStartTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ResourceHealth/events'].get
  update:
    x-apievangelist-phrasing:
      intent: List service health events for a resource
      effect: read
      questions:
      - Is a specific resource of mine impacted by an Azure service health event?
      - Can I check health events for just one resource?
      instructions:
      - text: List current service health events for resource {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Show health events affecting {resourceUri} filtered by {filter}.
        slots:
          resourceUri: path.resourceUri
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{eventId}/reward'].post
  update:
    x-apievangelist-phrasing:
      intent: Report a Personalizer reward for an event
      effect: write
      questions:
      - How do I tell Personalizer how well a recommended action worked?
      - What range must a reward score fall in when reporting it for an event?
      instructions:
      - text: Report reward {value} for event {eventId}.
        slots:
          value: requestBody.value
          eventId: path.eventId
      - text: Send a reward score of {value} for Personalizer event {eventId}.
        slots:
          value: requestBody.value
          eventId: path.eventId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/{eventId}/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate a Personalizer event
      effect: write
      questions:
      - What marks a deferred Personalizer event as actually shown to the user?
      - When should I activate an event so a reward is expected?
      instructions:
      - text: Activate event {eventId}.
        slots:
          eventId: path.eventId
      - text: Mark Personalizer event {eventId} as used so a reward is expected.
        slots:
          eventId: path.eventId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/history/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/batch/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Batch post events to experiment runs
      effect: write
      questions:
      - Can I post events for several machine learning runs in one request?
      - Is there a batch call for sending run events to an Azure ML experiment?
      instructions:
      - text: Batch post events {events} to experiment {experimentName} in workspace {workspaceName} ({resourceGroupName}).
        slots:
          events: requestBody.events
          experimentName: path.experimentName
          workspaceName: path.workspaceName
          resourceGroupName: path.resourceGroupName
      - text: Send a batch of run events to ML experiment {experimentName}, workspace {workspaceName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          experimentName: path.experimentName
          workspaceName: path.workspaceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/history/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/runs/{runId}/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Post an event to a single run
      effect: write
      questions:
      - Can I record a single event against one Azure ML run?
      - Can I attach a named event with data to a specific experiment run?
      instructions:
      - text: Post event {name} to run {runId} of experiment {experimentName} in workspace {workspaceName} ({resourceGroupName}).
        slots:
          name: requestBody.name
          runId: path.runId
          experimentName: path.experimentName
          workspaceName: path.workspaceName
          resourceGroupName: path.resourceGroupName
      - text: Log one event for run {runId}, experiment {experimentName}, workspace {workspaceName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          runId: path.runId
          experimentName: path.experimentName
          workspaceName: path.workspaceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'