API Evangelist conversational phrasing for Cortex Analyst API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cortex Analyst API
  version: 1.0.0
extends: openapi/snowflake-cortex-analyst-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-02'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/api/v2/cortex/analyst/feedback'].post
  update:
    x-apievangelist-phrasing:
      intent: Rate a Cortex Analyst response
      effect: write
      questions:
      - How do I tell Cortex Analyst an answer was wrong?
      - Can I attach a written comment when giving thumbs up or down on an Analyst reply?
      instructions:
      - text: 'Mark Cortex Analyst request {request_id} as helpful: {positive}.'
        slots:
          request_id: requestBody.request_id
          positive: requestBody.positive
      - text: Send feedback {positive} on request {request_id} with the note {feedback_message}.
        slots:
          positive: requestBody.positive
          request_id: requestBody.request_id
          feedback_message: requestBody.feedback_message
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/cortex/analyst/message'].post
  update:
    x-apievangelist-phrasing:
      intent: Ask Cortex Analyst a data question
      effect: read
      questions:
      - Can I ask a plain-English question about my data and get SQL back?
      - How does Cortex Analyst turn a business question into an answer over a semantic model?
      instructions:
      - text: Ask Cortex Analyst what our revenue was last quarter.
      - text: Send this data question to Cortex Analyst using our semantic model.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/cortex/analyst/verified-query-suggestions'].post
  update:
    x-apievangelist-phrasing:
      intent: Suggest verified queries for a semantic model
      effect: read
      questions:
      - Can Cortex Analyst propose verified queries to add to my semantic model?
      - How many verified query suggestions can I page through at a time?
      instructions:
      - text: Generate verified query suggestions for {semantic_model} using warehouse {warehouse}.
        slots:
          semantic_model: requestBody.semantic_model
          warehouse: requestBody.warehouse
      - text: Suggest up to {limit} verified queries for the model, running on warehouse {warehouse}.
        slots:
          limit: requestBody.limit
          warehouse: requestBody.warehouse
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/cortex/analyst/fast-generation'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate or improve a semantic model quickly
      effect: read
      questions:
      - Can I get real-time suggestions to improve a semantic model?
      - Is there a fast way to draft a semantic model from source material?
      instructions:
      - text: Rapidly generate a semantic model from {json_proto}.
        slots:
          json_proto: requestBody.json_proto
      - text: Run fast generation to stream real-time improvement suggestions for my semantic model.
      method: generated
      generated: '2026-10-02'
- target: $.paths['/api/v2/cortex/analyst/pre-selection'].post
  update:
    x-apievangelist-phrasing:
      intent: Pick relevant tables for semantic model generation
      effect: read
      questions:
      - Which tables should go into a new semantic model given my source data?
      - Can Cortex Analyst pre-select tables from a Tableau data source?
      instructions:
      - text: Pre-select relevant tables from {tds_source} using warehouse {warehouse}.
        slots:
          tds_source: requestBody.tds_source
          warehouse: requestBody.warehouse
      - text: Find the tables worth modelling from {tds_source} and SQL {sql_source} on warehouse {warehouse}.
        slots:
          tds_source: requestBody.tds_source
          sql_source: requestBody.sql_source
          warehouse: requestBody.warehouse
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/cortex/analyst/filters-and-metrics-suggestions'].post
  update:
    x-apievangelist-phrasing:
      intent: Suggest filters, facts and metrics for a model
      effect: read
      questions:
      - What metrics and filters could I add to my semantic view?
      - Can I page separately through suggested facts, filters and metrics?
      instructions:
      - text: Suggest filters, facts and metrics for semantic model {semantic_model}.
        slots:
          semantic_model: requestBody.semantic_model
      - text: Give me up to {metrics_limit} metric suggestions for tables {tables}.
        slots:
          metrics_limit: requestBody.metrics_limit
          tables: requestBody.tables
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/cortex/analyst/agentic-optimizations'].post
  update:
    x-apievangelist-phrasing:
      intent: List agentic optimization runs for a model
      effect: read
      questions:
      - Which agentic optimization runs have been done on my semantic model?
      - Can I see the optimization history for a base model?
      instructions:
      - text: List all agentic optimization runs for semantic model {semantic_model}.
        slots:
          semantic_model: requestBody.semantic_model
      - text: Show every optimization run started on base model {semantic_model}.
        slots:
          semantic_model: requestBody.semantic_model
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/cortex/analyst/agentic-optimization'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an agentic optimization run's status
      effect: read
      questions:
      - Is my agentic optimization run finished yet?
      - What state is a specific semantic model optimization run in?
      instructions:
      - text: Get the status of agentic optimization {optimization_name}.
        slots:
          optimization_name: query.optimization_name
      - text: Check whether optimization run {optimization_name} has completed.
        slots:
          optimization_name: query.optimization_name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/cortex/analyst/token'].get
  update:
    x-apievangelist-phrasing:
      intent: Exchange a Cortex Analyst OAuth token
      effect: read
      questions:
      - How is a Cortex Analyst OAuth token exchanged for a scoped token?
      - What does the internal Cortex Analyst token endpoint return?
      instructions:
      - text: Exchange my Cortex Analyst OAuth token for a scoped token.
      - text: Get a scoped Cortex Analyst token for this session.
      method: generated
      generated: '2026-10-01'