# 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 Detect API
  version: 1.0.0
extends: openapi/microsoft-azure-detect-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: 2
- target: $.paths['/detect'].post
  update:
    x-apievangelist-phrasing:
      intent: Detect faces in an image
      effect: read
      questions:
      - How do I find the faces in an image and get their bounding rectangles?
      - Can face detection also return landmarks and attributes like head pose or glasses?
      - How long is a detected faceId kept before it expires?
      instructions:
      - text: Detect faces in this image and return face rectangles.
      - text: Detect faces with landmarks set to {returnFaceLandmarks} and attributes {returnFaceAttributes}.
        slots:
          returnFaceLandmarks: query.returnFaceLandmarks
          returnFaceAttributes: query.returnFaceAttributes
      - text: Detect faces using detection model {detectionModel} and cache faceIds for {faceIdTimeToLive} seconds.
        slots:
          detectionModel: query.detectionModel
          faceIdTimeToLive: query.faceIdTimeToLive
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Detect'].post
  update:
    x-apievangelist-phrasing:
      intent: Identify the language of text
      effect: read
      questions:
      - What language is this piece of text written in?
      - Can the Translator service tell me which language a string is in before I translate it?
      instructions:
      - text: Detect the language of this text using Translator API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      - text: Identify which language a customer message is written in.
      method: generated
      generated: '2026-09-26'