Microsoft Azure Computer Vision Client — Operations

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Computer Vision Client — Operations
  description: 'Microsoft Azure Computer Vision Client — Operations. 9 operations. Lead operation: Microsoft Azure Analyze
    The Input Image The Request Either Contains Image Stream With Any Content Type [ Image * , Application Octet Stream ],
    Or A Json Payload Which Includes An Url Property To Be Used To Retrieve The Image Stream. Self-contained Naftiko capability
    covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Operations
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: computer-vision-client-operations
    baseUri: ''
    description: Microsoft Azure Computer Vision Client — Operations business capability. Self-contained, no shared references.
    resources:
    - name: imageanalysis:analyze
      path: /imageanalysis:analyze
      operations:
      - name: microsoftazureimageanalysisanalyze
        method: POST
        description: Microsoft Azure Analyze The Input Image The Request Either Contains Image Stream With Any Content Type
          [ Image * , Application Octet Stream ], Or A Json Payload Which Includes An Url Property To Be Used To Retrieve
          The Image Stream
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: features
          in: query
          type: array
          description: 'The visual features requested: tags, objects, caption, denseCaptions, read, smartCrops, people. This
            parameter needs to be specified if the parameter "model-nam'
        - name: model-name
          in: query
          type: string
          description: The name of the custom trained model. This parameter needs to be specified if the parameter "features"
            is not specified.
        - name: language
          in: query
          type: string
          description: The desired language for output generation. If this parameter is not specified, the default value is
            "en". See https://aka.ms/cv-languages for a list of support
        - name: smartcrops-aspect-ratios
          in: query
          type: string
          description: A list of aspect ratios to use for smartCrops feature. Aspect ratios are calculated by dividing the
            target crop width by the height. Supported values are betwee
        - name: gender-neutral-caption
          in: query
          type: boolean
          description: Boolean flag for enabling gender-neutral captioning for caption and denseCaptions features. If this
            parameter is not specified, the default value is "false".
        - name: body
          in: body
          type: string
          description: A JSON document with a URL pointing to the image that is to be analyzed.
          required: true
    - name: imageanalysis:segment
      path: /imageanalysis:segment
      operations:
      - name: microsoftazureimageanalysissegment
        method: POST
        description: Microsoft Azure Analyze The Input Image The Request Either Contains An Image Stream With Any Content
          Type [ Image * , Application Octet Stream ], Or A Json Payload Which Includes A Url Property To Be Used To Retrieve
          The Image Stream An Ima
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: mode
          in: query
          type: string
          description: The analysis mode requested.
        - name: body
          in: body
          type: string
          description: A JSON document with a URL pointing to the image that is to be analyzed.
          required: true
    - name: imagecomposition:rectify
      path: /imagecomposition:rectify
      operations:
      - name: microsoftazureimagecompositionrectify
        method: POST
        description: Microsoft Azure Run The Image Rectification Operation Against An Image With 4 Control Points Provided
          In The Parameter
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: string
          description: Input image url and control points that are passed into rectification operation.
          required: true
    - name: imagecomposition:stitch
      path: /imagecomposition:stitch
      operations:
      - name: microsoftazureimagecompositionstitch
        method: POST
        description: Microsoft Azure Run The Image Stitching Operation Against A Sequence Of Images
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: string
          description: Input images urls that pass into image stitching operation.
          required: true
    - name: planogramcompliance:match
      path: /planogramcompliance:match
      operations:
      - name: microsoftazureplanogramcompliancematch
        method: POST
        description: Microsoft Azure Run The Planogram Matching Operation Against A Planogram And A Product Understanding
          Result
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: string
          description: Input to pass into the planogram matching operation.
    - name: productrecognition-modelName-runs
      path: /productrecognition/{modelName}/runs
      operations:
      - name: microsoftazureproductrecognitionlist
        method: GET
        description: Microsoft Azure List All Product Recognition Run Of A Model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: modelName
          in: path
          type: string
          description: The name of the model the product recognition runs belongs to.
          required: true
        - name: skip
          in: query
          type: integer
          description: Number of product recognition runs to be skipped.
        - name: top
          in: query
          type: integer
          description: Number of product recognition runs to be returned after skipping. The maximum allowed value is 30.
    - name: productrecognition-modelName-runs-runName
      path: /productrecognition/{modelName}/runs/{runName}
      operations:
      - name: microsoftazureproductrecognitioncreate
        method: PUT
        description: Microsoft Azure Run The Product Recognition Against A Model With An Image
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: modelName
          in: path
          type: string
          description: The name of the model to run product recognition with.
          required: true
        - name: runName
          in: path
          type: string
          description: The name of the product recognition run.
          required: true
      - name: microsoftazureproductrecognitionget
        method: GET
        description: Microsoft Azure Get Information About A Specific Product Recognition Run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: modelName
          in: path
          type: string
          description: The name of the model the product recognition run belongs to.
          required: true
        - name: runName
          in: path
          type: string
          description: The name of the product recognition run.
          required: true
      - name: microsoftazureproductrecognitiondelete
        method: DELETE
        description: "Microsoft Azure Delete A Product Recognition Run A Product Recognition Run Can Be Deleted If It Is In\
          \ The Succeeded Or Failed States \r"
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: modelName
          in: path
          type: string
          description: The name of the model to delete the product recognition run for.
          required: true
        - name: runName
          in: path
          type: string
          description: The name of the product recognition run.
          required: true
  exposes:
  - type: rest
    namespace: computer-vision-client-operations-rest
    port: 8080
    description: REST adapter for Microsoft Azure Computer Vision Client — Operations. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/imageanalysis-analyze
      name: imageanalysis-analyze
      description: REST surface for imageanalysis:analyze.
      operations:
      - method: POST
        name: microsoftazureimageanalysisanalyze
        description: Microsoft Azure Analyze The Input Image The Request Either Contains Image Stream With Any Content Type
          [ Image * , Application Octet Stream ], Or A Json Payload Which Includes An Url Property To Be Used To Retrieve
          The Image Stream
        call: computer-vision-client-operations.microsoftazureimageanalysisanalyze
        with:
          features: rest.features
          model-name: rest.model-name
          language: rest.language
          smartcrops-aspect-ratios: rest.smartcrops-aspect-ratios
          gender-neutral-caption: rest.gender-neutral-caption
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/imageanalysis-segment
      name: imageanalysis-segment
      description: REST surface for imageanalysis:segment.
      operations:
      - method: POST
        name: microsoftazureimageanalysissegment
        description: Microsoft Azure Analyze The Input Image The Request Either Contains An Image Stream With Any Content
          Type [ Image * , Application Octet Stream ], Or A Json Payload Which Includes A Url Property To Be Used To Retrieve
          The Image Stream An Ima
        call: computer-vision-client-operations.microsoftazureimageanalysissegment
        with:
          mode: rest.mode
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/imagecomposition-rectify
      name: imagecomposition-rectify
      description: REST surface for imagecomposition:rectify.
      operations:
      - method: POST
        name: microsoftazureimagecompositionrectify
        description: Microsoft Azure Run The Image Rectification Operation Against An Image With 4 Control Points Provided
          In The Parameter
        call: computer-vision-client-operations.microsoftazureimagecompositionrectify
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/imagecomposition-stitch
      name: imagecomposition-stitch
      description: REST surface for imagecomposition:stitch.
      operations:
      - method: POST
        name: microsoftazureimagecompositionstitch
        description: Microsoft Azure Run The Image Stitching Operation Against A Sequence Of Images
        call: computer-vision-client-operations.microsoftazureimagecompositionstitch
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/planogramcompliance-match
      name: planogramcompliance-match
      description: REST surface for planogramcompliance:match.
      operations:
      - method: POST
        name: microsoftazureplanogramcompliancematch
        description: Microsoft Azure Run The Planogram Matching Operation Against A Planogram And A Product Understanding
          Result
        call: computer-vision-client-operations.microsoftazureplanogramcompliancematch
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/productrecognition/{modelname}/runs
      name: productrecognition-modelname-runs
      description: REST surface for productrecognition-modelName-runs.
      operations:
      - method: GET
        name: microsoftazureproductrecognitionlist
        description: Microsoft Azure List All Product Recognition Run Of A Model
        call: computer-vision-client-operations.microsoftazureproductrecognitionlist
        with:
          modelName: rest.modelName
          skip: rest.skip
          top: rest.top
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/productrecognition/{modelname}/runs/{runname}
      name: productrecognition-modelname-runs-runname
      description: REST surface for productrecognition-modelName-runs-runName.
      operations:
      - method: PUT
        name: microsoftazureproductrecognitioncreate
        description: Microsoft Azure Run The Product Recognition Against A Model With An Image
        call: computer-vision-client-operations.microsoftazureproductrecognitioncreate
        with:
          modelName: rest.modelName
          runName: rest.runName
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: microsoftazureproductrecognitionget
        description: Microsoft Azure Get Information About A Specific Product Recognition Run
        call: computer-vision-client-operations.microsoftazureproductrecognitionget
        with:
          modelName: rest.modelName
          runName: rest.runName
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazureproductrecognitiondelete
        description: "Microsoft Azure Delete A Product Recognition Run A Product Recognition Run Can Be Deleted If It Is In\
          \ The Succeeded Or Failed States \r"
        call: computer-vision-client-operations.microsoftazureproductrecognitiondelete
        with:
          modelName: rest.modelName
          runName: rest.runName
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: computer-vision-client-operations-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Computer Vision Client — Operations. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-analyze-input-image
      description: Microsoft Azure Analyze The Input Image The Request Either Contains Image Stream With Any Content Type
        [ Image * , Application Octet Stream ], Or A Json Payload Which Includes An Url Property To Be Used To Retrieve The
        Image Stream
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: computer-vision-client-operations.microsoftazureimageanalysisanalyze
      with:
        features: tools.features
        model-name: tools.model-name
        language: tools.language
        smartcrops-aspect-ratios: tools.smartcrops-aspect-ratios
        gender-neutral-caption: tools.gender-neutral-caption
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-analyze-input-image-2
      description: Microsoft Azure Analyze The Input Image The Request Either Contains An Image Stream With Any Content Type
        [ Image * , Application Octet Stream ], Or A Json Payload Which Includes A Url Property To Be Used To Retrieve The
        Image Stream An Ima
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: computer-vision-client-operations.microsoftazureimageanalysissegment
      with:
        mode: tools.mode
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-run-image-rectification
      description: Microsoft Azure Run The Image Rectification Operation Against An Image With 4 Control Points Provided In
        The Parameter
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: computer-vision-client-operations.microsoftazureimagecompositionrectify
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-run-image-stitching
      description: Microsoft Azure Run The Image Stitching Operation Against A Sequence Of Images
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: computer-vision-client-operations.microsoftazureimagecompositionstitch
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-run-planogram-matching
      description: Microsoft Azure Run The Planogram Matching Operation Against A Planogram And A Product Understanding Result
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: computer-vision-client-operations.microsoftazureplanogramcompliancematch
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-list-all-product
      description: Microsoft Azure List All Product Recognition Run Of A Model
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: computer-vision-client-operations.microsoftazureproductrecognitionlist
      with:
        modelName: tools.modelName
        skip: tools.skip
        top: tools.top
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-run-product-recognition
      description: Microsoft Azure Run The Product Recognition Against A Model With An Image
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: computer-vision-client-operations.microsoftazureproductrecognitioncreate
      with:
        modelName: tools.modelName
        runName: tools.runName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-information-about
      description: Microsoft Azure Get Information About A Specific Product Recognition Run
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: computer-vision-client-operations.microsoftazureproductrecognitionget
      with:
        modelName: tools.modelName
        runName: tools.runName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-product-recognition
      description: "Microsoft Azure Delete A Product Recognition Run A Product Recognition Run Can Be Deleted If It Is In\
        \ The Succeeded Or Failed States \r"
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: computer-vision-client-operations.microsoftazureproductrecognitiondelete
      with:
        modelName: tools.modelName
        runName: tools.runName
      outputParameters:
      - type: object
        mapping: $.