# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ADEM data Agent Controller API
  version: 1.0.0
extends: openapi/palo-alto-networks-agent-controller-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/adem/telemetry/v2/agent/properties'].get
  update:
    x-apievangelist-phrasing:
      intent: Get ADEM agent properties
      effect: read
      questions:
      - What properties are reported by Autonomous DEM agents on user endpoints?
      - Can I filter ADEM agent properties to certain endpoints?
      instructions:
      - text: Get agent properties for tenant {tenant} with filter {filter}, endpoint type {endpointType}, response type {responseType}.
        slots:
          tenant: header.Prisma-Tenant
          filter: query.filter
          endpointType: query.endpoint-type
          responseType: query.response-type
      - text: Show {endpointType} agent properties as {responseType} for tenant {tenant}, filter {filter}, over {timerange}.
        slots:
          endpointType: query.endpoint-type
          responseType: query.response-type
          tenant: header.Prisma-Tenant
          filter: query.filter
          timerange: query.timerange
      method: generated
      generated: '2026-10-01'
- target: $.paths['/adem/telemetry/v2/measure/agent/metric'].get
  update:
    x-apievangelist-phrasing:
      intent: Get ADEM agent metrics
      effect: read
      questions:
      - What performance metrics are my ADEM agents reporting?
      - Can I group ADEM agent metrics over a time range?
      instructions:
      - text: Get agent metrics for tenant {tenant}, endpoint type {endpointType}, response type {responseType}.
        slots:
          tenant: header.Prisma-Tenant
          endpointType: query.endpoint-type
          responseType: query.response-type
      - text: Show agent metrics grouped by {group} for tenant {tenant} ({endpointType}, {responseType}).
        slots:
          group: query.group
          tenant: header.Prisma-Tenant
          endpointType: query.endpoint-type
          responseType: query.response-type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/adem/telemetry/v2/measure/agent/score'].get
  update:
    x-apievangelist-phrasing:
      intent: Get ADEM agent experience scores
      effect: read
      questions:
      - Which users have the worst digital experience scores?
      - Can I see the distribution of ADEM agent scores?
      instructions:
      - text: Get agent experience scores for tenant {tenant}, endpoint type {endpointType}, response type {responseType}.
        slots:
          tenant: header.Prisma-Tenant
          endpointType: query.endpoint-type
          responseType: query.response-type
      - text: Show agent score distribution by {distributionBy} for tenant {tenant} ({endpointType}, {responseType}).
        slots:
          distributionBy: query.distribution-by
          tenant: header.Prisma-Tenant
          endpointType: query.endpoint-type
          responseType: query.response-type
      method: generated
      generated: '2026-10-01'