# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Palo Alto Networks 3.0 Sites API
  version: 1.0.0
extends: openapi/palo-alto-networks-sites-api-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['/insights/v3.0/resource/query/sites/bandwidth_consumption_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a site bandwidth consumption histogram
      effect: read
      questions:
      - How is bandwidth consumption distributed across my Prisma Access sites?
      - Can I see a histogram of site bandwidth usage?
      instructions:
      - text: Get the site bandwidth consumption histogram in region {region}.
        slots:
          region: header.PANW-Region
      - text: Show bandwidth histogram data for region {region} filtered by {filter}.
        slots:
          region: header.PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/sites/session_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count sessions across sites
      effect: read
      questions:
      - How many sessions are my sites handling?
      - What is the session count for sites in a region?
      instructions:
      - text: Count sessions for sites in region {region}.
        slots:
          region: header.PANW-Region
      - text: Get site session counts in {region} matching {filter}.
        slots:
          region: header.PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/sites/site_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count sites
      effect: read
      questions:
      - How many sites do I have in Prisma Access Insights?
      - What is my total site count for a region?
      instructions:
      - text: Count my sites in region {region}.
        slots:
          region: header.PANW-Region
      - text: Get the number of sites in {region} matching {filter}.
        slots:
          region: header.PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/sites/site_location_search_contains'].post
  update:
    x-apievangelist-phrasing:
      intent: Search sites by location
      effect: read
      questions:
      - Which sites are in a particular city or location?
      - Can I search site locations by partial text?
      instructions:
      - text: Search site locations in region {region} with filter {filter}.
        slots:
          region: header.PANW-Region
          filter: requestBody.filter
      - text: Find site location data in {region}.
        slots:
          region: header.PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/sites/site_traffic'].post
  update:
    x-apievangelist-phrasing:
      intent: Get detailed site traffic
      effect: read
      questions:
      - What does traffic look like at each of my sites?
      - Can I get detailed per-site traffic information?
      instructions:
      - text: Show site traffic details for region {region}.
        slots:
          region: header.PANW-Region
      - text: Get traffic details for sites in {region} matching {filter}.
        slots:
          region: header.PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'