# 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 Logs V1Dot1 Preview2 API
  version: 1.0.0
extends: openapi/microsoft-azure-logsv1dot1preview2-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['/logs/interactions'].post
  update:
    x-apievangelist-phrasing:
      intent: Log Personalizer interactions from an SDK
      effect: write
      questions:
      - Which endpoint does the Personalizer SDK use to log interaction events?
      - Is the interactions log endpoint meant to be called directly by customers?
      instructions:
      - text: Post an interactions batch to the Personalizer logs on API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Send SDK interaction events to the interactions log.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/logs/observations'].post
  update:
    x-apievangelist-phrasing:
      intent: Log Personalizer observations from an SDK
      effect: write
      questions:
      - Where does the Personalizer SDK send observation events?
      - What format must logged observations follow for Personalizer?
      instructions:
      - text: Post an observations batch to the Personalizer logs on API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Send SDK observation events to the observations log.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/logs'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete all Personalizer logs
      effect: destructive
      questions:
      - How do I wipe all stored Rank and Reward logs from Personalizer?
      - Can I clear Personalizer's logged data completely?
      instructions:
      - text: Delete all Personalizer Rank and Reward logs on API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Clear every stored log in my Personalizer resource.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/logs/properties'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Personalizer log properties
      effect: read
      questions:
      - What date range do my stored Personalizer logs cover?
      - Can I check the properties of Personalizer's logs before exporting them?
      instructions:
      - text: Get the properties of my Personalizer logs on API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Show the log metadata for my Personalizer resource.
      method: generated
      generated: '2026-09-26'