# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon Lex Model Building V2 Testsets API
  version: 1.0.0
extends: openapi/amazon-lex-testsets-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['/testsets'].post
  update:
    x-apievangelist-phrasing:
      intent: List my bot test sets
      effect: read
      questions:
      - Which test sets have I created for testing my Lex bots?
      - Can I sort my list of bot test sets?
      instructions:
      - text: List all of my bot test sets.
      - text: Show my test sets sorted by {sortBy}.
        slots:
          sortBy: requestBody.sortBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/testsets/{testSetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a test set's details
      effect: read
      questions:
      - What's in a particular test set and what's its status?
      - How many records and turns does one test set contain?
      instructions:
      - text: Describe test set {testSetId}.
        slots:
          testSetId: path.testSetId
      - text: Show the metadata for test set {testSetId}.
        slots:
          testSetId: path.testSetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/testsets/{testSetId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or redescribe a test set
      effect: write
      questions:
      - How do I rename a test set I already have?
      - Can I change the description of an existing test set?
      instructions:
      - text: Rename test set {testSetId} to {testSetName}.
        slots:
          testSetId: path.testSetId
          testSetName: requestBody.testSetName
      - text: 'Update test set {testSetId}: name {testSetName}, description {description}.'
        slots:
          testSetId: path.testSetId
          testSetName: requestBody.testSetName
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/testsets/{testSetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a test set
      effect: destructive
      questions:
      - How do I delete a test set I no longer need?
      - Can I remove an old bot test set permanently?
      instructions:
      - text: Delete test set {testSetId}.
        slots:
          testSetId: path.testSetId
      - text: Permanently remove the test set {testSetId}.
        slots:
          testSetId: path.testSetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/testsets/{testSetId}/records'].post
  update:
    x-apievangelist-phrasing:
      intent: List the records in a test set
      effect: read
      questions:
      - What conversations and turns are stored inside a test set?
      - Can I page through the individual records of one test set?
      instructions:
      - text: List the records in test set {testSetId}.
        slots:
          testSetId: path.testSetId
      - text: Show the first {maxResults} conversation records from test set {testSetId}.
        slots:
          maxResults: requestBody.maxResults
          testSetId: path.testSetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/testsets/{testSetId}/testexecutions'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a test set against a bot
      effect: write
      questions:
      - How do I run a test set against my bot alias to check its accuracy?
      - Can a test run use text or audio input, and streaming or non-streaming mode?
      instructions:
      - text: Run test set {testSetId} against target {target} in {apiMode} mode.
        slots:
          testSetId: path.testSetId
          target: requestBody.target
          apiMode: requestBody.apiMode
      - text: Start a {testExecutionModality} test execution of test set {testSetId} on {target} using {apiMode} API mode.
        slots:
          testExecutionModality: requestBody.testExecutionModality
          testSetId: path.testSetId
          target: requestBody.target
          apiMode: requestBody.apiMode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/testsets/{testSetId}/testsetdiscrepancy'].post
  update:
    x-apievangelist-phrasing:
      intent: Compare a test set against a bot
      effect: write
      questions:
      - How do I find which intents and slots in a test set don't exist in my bot?
      - Can I generate a report of mismatches between a test set and a bot?
      instructions:
      - text: Create a discrepancy report comparing test set {testSetId} with bot target {target}.
        slots:
          testSetId: path.testSetId
          target: requestBody.target
      - text: Check test set {testSetId} against {target} and report the differences.
        slots:
          testSetId: path.testSetId
          target: requestBody.target
      method: generated
      generated: '2026-09-26'