# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Aiapplyd AI Persona API
  version: 1.0.0
extends: openapi/aiapplyd-ai-persona-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['/ai-persona'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my voice and tone settings
      effect: read
      questions:
      - What voice and tone is the AI using when it writes for me?
      - Which persona preset do I have selected right now?
      instructions:
      - text: Show my AI persona settings.
      - text: Tell me my current voice and tone configuration.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ai-persona'].put
  update:
    x-apievangelist-phrasing:
      intent: Set my voice, tone and auto-apply rules
      effect: write
      questions:
      - How do I change the tone the AI uses in my cover letters?
      - Can I cap how many jobs the AI applies to per day or require a minimum match score?
      - Is there a setting to stop the AI from embellishing my experience?
      instructions:
      - text: Set my persona preset to {presetId}.
        slots:
          presetId: requestBody.presetId
      - text: Use preset {presetId} with a daily limit of {dailyLimit} and minimum match score {minMatchScore}.
        slots:
          presetId: requestBody.presetId
          dailyLimit: requestBody.dailyLimit
          minMatchScore: requestBody.minMatchScore
      - text: Update preset {presetId} with tone instructions {toneInstructions}.
        slots:
          presetId: requestBody.presetId
          toneInstructions: requestBody.toneInstructions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ai-persona/scoring-weights'].patch
  update:
    x-apievangelist-phrasing:
      intent: Adjust my match scoring weights
      effect: write
      questions:
      - Can I make salary count more than location when jobs are scored for me?
      - What range are match scoring weights allowed to take?
      instructions:
      - text: Set my match scoring weights to {weights}.
        slots:
          weights: requestBody.weights
      - text: Update the per-dimension scoring multipliers to {weights}.
        slots:
          weights: requestBody.weights
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ai-persona/suggest-tone'].post
  update:
    x-apievangelist-phrasing:
      intent: Recommend a voice preset from my resume
      effect: read
      questions:
      - Which voice and tone preset fits my resume best?
      - Can AI read my resume and recommend a persona preset with a reason?
      instructions:
      - text: Recommend a voice and tone preset based on my resume.
      - text: Suggest which persona preset suits my latest resume.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ai-persona/suggest-narrative'].post
  update:
    x-apievangelist-phrasing:
      intent: Draft a background narrative from my resume
      effect: read
      questions:
      - Can AI write a short background story about me from my resume?
      - How long is the suggested starter narrative?
      instructions:
      - text: Draft a background narrative from my resume.
      - text: Write me a short starter bio based on my latest resume.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ai-persona/derive-custom-tone'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a custom voice from my own writing
      effect: write
      questions:
      - Can the AI learn my personal writing voice from my resume and cover letter?
      - Is a derived custom tone saved to my persona automatically?
      instructions:
      - text: Derive a custom voice and tone from my resume, cover letter and story.
      - text: Create and save a custom persona tone based on my own documents.
      method: generated
      generated: '2026-09-26'