# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Recommendations Details API
  version: 1.0.0
extends: openapi/harness-recommendations-details-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: 5
- target: $.paths['/ccm/api/recommendation/details/azure-vm'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure VM rightsizing recommendation
      effect: read
      questions:
      - What does a cost recommendation suggest for one of my Azure VMs?
      - Can I see the details behind an Azure VM recommendation?
      instructions:
      - text: Show Azure VM recommendation {id}.
        slots:
          id: query.id
      - text: Get the details of Azure VM recommendation {id}.
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/details/ec2-instance'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an EC2 instance recommendation
      effect: read
      questions:
      - What instance change is recommended for an EC2 machine?
      - Can I see the savings detail of an EC2 or AWS passthrough recommendation?
      instructions:
      - text: Show EC2 recommendation {id}.
        slots:
          id: query.id
      - text: Get the details of EC2 instance recommendation {id}.
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/details/ecs-service'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an ECS service recommendation
      effect: read
      questions:
      - What CPU and memory does a recommendation suggest for my ECS service?
      - Can I add a buffer percentage to an ECS recommendation over a date range?
      instructions:
      - text: Show ECS service recommendation {id}.
        slots:
          id: query.id
      - text: Get ECS recommendation {id} from {from} to {to} with a {buffer} percent buffer.
        slots:
          id: query.id
          from: query.from
          to: query.to
          buffer: query.bufferPercentage
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/details/node-pool'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Kubernetes node pool recommendation
      effect: read
      questions:
      - What node pool sizing is recommended for my cluster?
      - Can I view the details of a node pool cost recommendation?
      instructions:
      - text: Show node pool recommendation {id}.
        slots:
          id: query.id
      - text: Get the details of node pool recommendation {id}.
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/details/workload'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Kubernetes workload recommendation
      effect: read
      questions:
      - What resource requests are recommended for a Kubernetes workload?
      - Can I see a workload recommendation for a specific time window?
      instructions:
      - text: Show workload recommendation {id}.
        slots:
          id: query.id
      - text: Get workload recommendation {id} between {from} and {to}.
        slots:
          id: query.id
          from: query.from
          to: query.to
      method: generated
      generated: '2026-09-26'