# 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 Agentless Users API
  version: 1.0.0
extends: openapi/palo-alto-networks-agentless-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: 6
- target: $.paths['/insights/v3.0/resource/query/agentless/risky_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count risky users
      effect: read
      questions:
      - How many risky users do we have right now?
      - Can I filter the risky user count by time range or site?
      instructions:
      - text: Count risky users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the number of risky users matching filter {filter}.
        slots:
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agentless/active_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count active agentless users
      effect: read
      questions:
      - How many users are active without an agent installed?
      - What is the active user count for agentless users in my region?
      instructions:
      - text: Count active agentless users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Give me the active agentless user total for filter {filter}.
        slots:
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agentless/active_user_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List active internal users (agentless)
      effect: read
      questions:
      - Who are the internal users active on the network without an agent?
      - Can I get the actual list of agentless internal users, not just a count?
      instructions:
      - text: List active internal users seen agentlessly in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show agentless internal users matching {filter}.
        slots:
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agentless/session_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List agentless user sessions
      effect: read
      questions:
      - What sessions have internal users had without the agent running?
      - Can I see individual agentless user sessions for a time window?
      instructions:
      - text: List agentless internal user sessions in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show agentless sessions that match filter {filter}.
        slots:
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agentless/user_count_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart agentless users over time
      effect: read
      questions:
      - How has the number of agentless internal users changed over time?
      - Can I get a histogram of internal users for a dashboard?
      instructions:
      - text: Build a histogram of agentless internal users for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Plot agentless user counts over time using filter {filter}.
        slots:
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/agentless/users'].post
  update:
    x-apievangelist-phrasing:
      intent: Get agentless user data
      effect: read
      questions:
      - Where can I pull general agentless user data from Prisma Access Insights?
      - What user details are available for users without an agent?
      instructions:
      - text: Get agentless user data for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Retrieve agentless user records with filter {filter} for tenant {tenant}.
        slots:
          filter: requestBody.filter
          tenant: header.Prisma-Tenant
      method: generated
      generated: '2026-09-26'