# 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 Findsimilars API
  version: 1.0.0
extends: openapi/microsoft-azure-findsimilars-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['/findsimilars'].post
  update:
    x-apievangelist-phrasing:
      intent: Find faces similar to a face
      effect: read
      questions:
      - How do I find similar-looking faces to a detected face?
      - Can I search for matches within a face list or a large face list?
      - What is the difference between matchPerson and matchFace modes?
      instructions:
      - text: Find faces similar to {face_id} among {face_ids}.
        slots:
          face_id: requestBody.faceId
          face_ids: requestBody.faceIds
      - text: Find the top {max} faces in face list {list} similar to {face_id}.
        slots:
          max: requestBody.maxNumOfCandidatesReturned
          list: requestBody.faceListId
          face_id: requestBody.faceId
      - text: Search large face list {large_list} for faces like {face_id} in {mode} mode.
        slots:
          large_list: requestBody.largeFaceListId
          face_id: requestBody.faceId
          mode: requestBody.mode
      method: generated
      generated: '2026-09-26'