# 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 Face Client Identify API
  version: 1.0.0
extends: openapi/microsoft-azure-identify-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: 1
- target: $.paths['/identify'].post
  update:
    x-apievangelist-phrasing:
      intent: Identify who detected faces belong to
      effect: read
      questions:
      - How do I match a detected face against people in a person group?
      - Can I set a confidence threshold when identifying faces?
      instructions:
      - text: Identify faces {faceIds} against person group {personGroupId}.
        slots:
          faceIds: requestBody.faceIds
          personGroupId: requestBody.personGroupId
      - text: Find up to {maxNumOfCandidatesReturned} candidates for faces {faceIds} in large person group {largePersonGroupId}.
        slots:
          maxNumOfCandidatesReturned: requestBody.maxNumOfCandidatesReturned
          faceIds: requestBody.faceIds
          largePersonGroupId: requestBody.largePersonGroupId
      method: generated
      generated: '2026-09-26'