# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma AIRS Red Teaming Management Adapters API
  version: 1.0.0
extends: openapi/palo-alto-networks-adapters-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: 7
- target: $.paths['/v1/adapters'].get
  update:
    x-apievangelist-phrasing:
      intent: List red teaming target adapters
      effect: read
      questions:
      - Which red teaming adapters are set up for my AI targets?
      - Can I list only draft adapters, or search adapters by name?
      - How many targets reference each adapter?
      instructions:
      - text: List all red teaming adapters.
      - text: Show adapters with status {status}.
        slots:
          status: query.status
      - text: Search adapters named {name} and include their target counts.
        slots:
          name: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/adapters'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a red teaming adapter
      effect: write
      questions:
      - How do I create an adapter script that connects red teaming to my AI endpoint?
      - Can I save an adapter as a draft without running validation?
      instructions:
      - text: Create adapter {name} from script {script} tested with prompt {prompt}.
        slots:
          name: requestBody.name
          script: requestBody.script_b64
          prompt: requestBody.prompt
      - text: Save adapter {name} as a draft with script {script} and prompt {prompt}, validate {validate}.
        slots:
          name: requestBody.name
          script: requestBody.script_b64
          prompt: requestBody.prompt
          validate: query.validate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/adapters/config'].get
  update:
    x-apievangelist-phrasing:
      intent: Get adapter configuration defaults
      effect: read
      questions:
      - What default settings apply to new red teaming adapters?
      - Where do I find adapter config defaults before writing a script?
      instructions:
      - text: Show the adapter configuration defaults.
      - text: Get the default config used for new adapters.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/adapters/{adapter_uuid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a red teaming adapter
      effect: read
      questions:
      - How do I view the details of one adapter by its UUID?
      - What script and variables does a given adapter use?
      instructions:
      - text: Get adapter {adapter_uuid}.
        slots:
          adapter_uuid: path.adapter_uuid
      - text: Show the script and variables of adapter {adapter_uuid}.
        slots:
          adapter_uuid: path.adapter_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/adapters/{adapter_uuid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a red teaming adapter
      effect: write
      questions:
      - How do I change the script of an existing adapter?
      - Can I edit an adapter and keep it as a draft instead of validating it?
      instructions:
      - text: Replace the script of adapter {adapter_uuid} with {script}, named {name}, tested with {prompt}.
        slots:
          adapter_uuid: path.adapter_uuid
          script: requestBody.script_b64
          name: requestBody.name
          prompt: requestBody.prompt
      - text: Point adapter {adapter_uuid} at network broker channel {channel}.
        slots:
          adapter_uuid: path.adapter_uuid
          channel: requestBody.network_broker_channel_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/adapters/{adapter_uuid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a red teaming adapter
      effect: destructive
      questions:
      - How do I remove an adapter I no longer need?
      - Is deleting a red teaming adapter permanent?
      instructions:
      - text: Delete adapter {adapter_uuid}.
        slots:
          adapter_uuid: path.adapter_uuid
      - text: Remove the red teaming adapter {adapter_uuid}.
        slots:
          adapter_uuid: path.adapter_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/adapters/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate an adapter script end to end
      effect: read
      questions:
      - Can I test an adapter script against my target before saving it?
      - How do I check that an adapter works through a network broker channel?
      instructions:
      - text: Validate script {script} over channel {channel} with prompt {prompt}.
        slots:
          script: requestBody.script_b64
          channel: requestBody.network_broker_channel_uuid
          prompt: requestBody.prompt
      - text: Dry-run the adapter script for existing adapter {adapter_uuid} with prompt {prompt}.
        slots:
          adapter_uuid: requestBody.adapter_uuid
          prompt: requestBody.prompt
      method: generated
      generated: '2026-09-26'