# 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 Languages API
  version: 1.0.0
extends: openapi/microsoft-azure-languages-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: 3
- target: $.paths['/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages supported by Translator (v3 lowercase path)
      effect: read
      questions:
      - Which languages can Translator translate or transliterate, on the lowercase /languages endpoint?
      - Can I get language names localized and skip the download if my cached ETag is current?
      instructions:
      - text: List Translator languages for scope {scope} with names in {uiLang}.
        slots:
          scope: query.scope
          uiLang: header.Accept-Language
      - text: Get supported translation languages only if they changed from ETag {etag}.
        slots:
          etag: header.If-None-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/languages'].post
  update:
    x-apievangelist-phrasing:
      intent: Detect the language of text
      effect: read
      questions:
      - What language is this piece of text written in?
      - How confident is the language detection score for my documents?
      instructions:
      - text: Detect the language of documents {input}.
        slots:
          input: body.input
      - text: Identify the language of {input} using model version {model} with statistics {stats}.
        slots:
          input: body.input
          model: query.model-version
          stats: query.showStats
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List Translator Text languages (capitalized path)
      effect: read
      questions:
      - Does the Translator Text /Languages resource need authentication to call?
      - Which dictionary languages does the Translator Text API support on the capitalized /Languages path?
      instructions:
      - text: Get Translator Text API languages for groups {scope}.
        slots:
          scope: query.scope
      - text: Fetch the Translator Text language list with display names in {uiLang} and trace ID {trace}.
        slots:
          uiLang: header.Accept-Language
          trace: header.X-ClientTraceId
      method: generated
      generated: '2026-09-26'