# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure SearchServiceClient Skillsets API
  version: 1.0.0
extends: openapi/microsoft-azure-skillsets-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: 5
- target: $.paths['/skillsets(\'{skillsetName}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a skillset from a search service
      effect: read
      questions:
      - How can I see the AI enrichment skills defined in one skillset?
      - What does a skillset definition in Azure AI Search contain?
      instructions:
      - text: Get skillset {skillsetName}.
        slots:
          skillsetName: path.skillsetName
      - text: Show the skills configured in skillset {skillsetName}.
        slots:
          skillsetName: path.skillsetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skillsets(\'{skillsetName}\')'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a skillset by name
      effect: write
      questions:
      - How do I update an existing skillset, or create it if it doesn't exist yet?
      - Can I make a skillset update conditional on its ETag?
      instructions:
      - text: Create or update skillset {skillsetName} with skills {skills}.
        slots:
          skillsetName: path.skillsetName
          skills: requestBody.skills
      - text: Update skillset {skillsetName} only if its ETag matches {etag}.
        slots:
          skillsetName: path.skillsetName
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skillsets(\'{skillsetName}\')'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a skillset
      effect: destructive
      questions:
      - Can I delete a skillset from my search service?
      - What removes an enrichment skillset I no longer use?
      instructions:
      - text: Delete skillset {skillsetName}.
        slots:
          skillsetName: path.skillsetName
      - text: Remove enrichment skillset {skillsetName} if its ETag is {etag}.
        slots:
          skillsetName: path.skillsetName
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skillsets'].get
  update:
    x-apievangelist-phrasing:
      intent: List skillsets in a search service
      effect: read
      questions:
      - Which skillsets exist in my Azure AI Search service?
      - Can I list skillsets but return only some properties such as the name?
      instructions:
      - text: List all skillsets in my search service.
      - text: List skillsets returning only fields {select}.
        slots:
          select: query.$select
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skillsets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new skillset
      effect: write
      questions:
      - How do I define a new skillset for an indexer's AI enrichment?
      - Can I attach a knowledge store or Cognitive Services key when adding a skillset?
      instructions:
      - text: Create new skillset {name} with skills {skills}.
        slots:
          name: requestBody.name
          skills: requestBody.skills
      - text: Add skillset {name} using knowledge store {knowledgeStore}.
        slots:
          name: requestBody.name
          knowledgeStore: requestBody.knowledgeStore
      method: generated
      generated: '2026-09-26'