# 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 Solution Inference API
  version: 1.0.0
extends: openapi/microsoft-azure-solutioninference-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['/solutions/{solutionId}:cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a solution inference job
      effect: destructive
      questions:
      - How do I cancel a running job for a partner solution in Data Manager for Agriculture?
      - Can I stop a solution inference job I already triggered?
      instructions:
      - text: Cancel the job for solution {solution} at request path {path}.
        slots:
          solution: path.solutionId
          path: requestBody.requestPath
      - text: Stop solution {solution}'s job with partner request body {body}.
        slots:
          solution: path.solutionId
          body: requestBody.partnerRequestBody
      method: generated
      generated: '2026-09-26'
- target: $.paths['/solutions/{solutionId}:create'].post
  update:
    x-apievangelist-phrasing:
      intent: Trigger a solution inference job
      effect: write
      questions:
      - How do I trigger a partner solution job to run on my farm data?
      - What do I pass to start a solution inference job?
      instructions:
      - text: Trigger a job for solution {solution} at request path {path}.
        slots:
          solution: path.solutionId
          path: requestBody.requestPath
      - text: Start solution {solution} with partner request body {body}.
        slots:
          solution: path.solutionId
          body: requestBody.partnerRequestBody
      method: generated
      generated: '2026-09-26'
- target: $.paths['/solutions/{solutionId}:fetch'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch results of a solution inference job
      effect: read
      questions:
      - What are the results of a solution job I triggered?
      - Has my partner solution inference job finished?
      instructions:
      - text: Fetch the triggered job details for solution {solution} at request path {path}.
        slots:
          solution: path.solutionId
          path: requestBody.requestPath
      - text: Get the output of solution {solution}'s job.
        slots:
          solution: path.solutionId
      method: generated
      generated: '2026-09-26'