# 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 Agent Users API
  version: 1.0.0
extends: openapi/palo-alto-networks-agent-users-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: 12
- target: $.paths['/insights/v3.0/resource/export/query/users/agent/user_list'].post
  update:
    x-apievangelist-phrasing:
      intent: Export the list of agent users
      effect: read
      questions:
      - Can I export the full list of GlobalProtect agent users to a file?
      - How do I download agent users for offline analysis?
      instructions:
      - text: Export the agent user list for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Export agent users matching filter {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/client_version_distribution'].post
  update:
    x-apievangelist-phrasing:
      intent: Show agent client version distribution
      effect: read
      questions:
      - Which agent client versions are my users running, and how many of each?
      - Are many endpoints still on an old agent client release?
      instructions:
      - text: Show the distribution of agent client versions in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Break down agent client versions for tenant {tenant} in region {region}.
        slots:
          tenant: header.Prisma-Tenant
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/connected_entity_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count connected entities
      effect: read
      questions:
      - How many entities are connected through the agent right now under a given filter?
      - Can I count connected entities for just part of my environment?
      instructions:
      - text: Count connected entities in region {region} matching filter {filter}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      - text: Give me the connected entity count for region {region}.
        slots:
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/connected_user_count_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart connected users over time
      effect: read
      questions:
      - What does the number of connected agent users look like over time?
      - Is there a histogram of connected users I can plot for a dashboard?
      instructions:
      - text: Get the connected user histogram for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Plot connected agent users over time for tenant {tenant} in region {region}.
        slots:
          tenant: header.Prisma-Tenant
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/connected_user_device_count_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart connected user devices over time
      effect: read
      questions:
      - How has the number of connected user devices changed over time?
      - Can I get a histogram of devices connected through the agent?
      instructions:
      - text: Chart connected user devices as a histogram for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show connected device counts over time for tenant {tenant} in region {region}.
        slots:
          tenant: header.Prisma-Tenant
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/current_connected_device_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count devices connected right now
      effect: read
      questions:
      - How many devices are connected through the agent at this moment?
      - What's the live connected device total for my tenant?
      instructions:
      - text: Tell me how many devices are currently connected in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the current connected device count for tenant {tenant} in region {region}.
        slots:
          tenant: header.Prisma-Tenant
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/current_connected_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count users connected right now
      effect: read
      questions:
      - How many agent users are connected at this moment?
      - What's the live connected user total for my tenant?
      instructions:
      - text: Tell me how many users are currently connected in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the current connected user count for tenant {tenant} in region {region}.
        slots:
          tenant: header.Prisma-Tenant
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/device_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List agent devices
      effect: read
      questions:
      - Which devices have the agent installed and connected?
      - Can I filter the agent device list on attributes other than ADEM score?
      instructions:
      - text: List agent devices in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show agent devices matching filter {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/risky_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count risky agent users
      effect: read
      questions:
      - How many of my agent users are flagged as risky?
      - Can I get the risky user count for a filtered group of users?
      instructions:
      - text: Count risky users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the number of risky users matching filter {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/session_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List agent sessions
      effect: read
      questions:
      - What agent sessions have users opened recently?
      - Can I see the list of agent connection sessions for a filtered set of users?
      instructions:
      - text: List agent sessions in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show agent sessions matching filter {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/unique_device_connections_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List unique device connections with user details
      effect: read
      questions:
      - Which unique devices have connected, and which user was on each?
      - Can I see each distinct device connection alongside its user?
      instructions:
      - text: List unique device connections with user details in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show distinct devices and their users matching filter {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agent/user_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List agent users
      effect: read
      questions:
      - Who are the users connecting through the agent?
      - How do I query agent users on screen rather than exporting them?
      instructions:
      - text: List agent users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Query agent users matching filter {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'