# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dialogflow ES API (v2) Conversation Datasets API
  version: 1.0.0
extends: openapi/google-dialogflow-conversationdatasets-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/conversationDatasets/{conversationDatasetsId}:importConversationData'].post
  update:
    x-apievangelist-phrasing:
      intent: Import transcripts into a regional conversation dataset
      effect: write
      questions:
      - How do I load conversation transcripts from Cloud Storage into a dataset in a specific region?
      - Can I add more conversation data to a regional dataset I already created?
      instructions:
      - text: Import conversation data from {input_config} into dataset {dataset}, project {project}, region {location}.
        slots:
          input_config: requestBody.inputConfig
          dataset: path.conversationDatasetsId
          project: path.projectsId
          location: path.locationsId
      - text: Load transcripts {input_config} into the regional conversation dataset {dataset} under {project}/{location}.
        slots:
          input_config: requestBody.inputConfig
          dataset: path.conversationDatasetsId
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/conversationDatasets'].get
  update:
    x-apievangelist-phrasing:
      intent: List conversation datasets in a region
      effect: read
      questions:
      - Which conversation datasets for model training do I have in a particular region?
      - Can I page through regional conversation datasets in my project?
      instructions:
      - text: List conversation datasets in project {project}, region {location}.
        slots:
          project: path.projectsId
          location: path.locationsId
      - text: Show {page_size} regional conversation datasets at a time for {project}/{location}.
        slots:
          page_size: query.pageSize
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/conversationDatasets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a conversation dataset in a region
      effect: write
      questions:
      - How do I create a conversation dataset to train Agent Assist models in a specific region?
      - Can I give a new regional conversation dataset a description and display name?
      instructions:
      - text: Create conversation dataset {display_name} in project {project}, region {location}.
        slots:
          display_name: requestBody.displayName
          project: path.projectsId
          location: path.locationsId
      - text: Set up a regional dataset {display_name} described as {description} in {project}/{location}.
        slots:
          display_name: requestBody.displayName
          description: requestBody.description
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/conversationDatasets/{conversationDatasetsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a regional conversation dataset
      effect: read
      questions:
      - How many conversations does one of my regional conversation datasets hold?
      - Can I check the details of a conversation dataset in a non-global location?
      instructions:
      - text: Get conversation dataset {dataset} in project {project}, region {location}.
        slots:
          dataset: path.conversationDatasetsId
          project: path.projectsId
          location: path.locationsId
      - text: Show the conversation count of regional dataset {dataset} under {project}/{location}.
        slots:
          dataset: path.conversationDatasetsId
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/conversationDatasets/{conversationDatasetsId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a regional conversation dataset
      effect: destructive
      questions:
      - How do I delete a conversation dataset I no longer need in a specific region?
      - Does removing a regional conversation dataset also delete its imported transcripts?
      instructions:
      - text: Delete conversation dataset {dataset} in project {project}, region {location}.
        slots:
          dataset: path.conversationDatasetsId
          project: path.projectsId
          location: path.locationsId
      - text: Remove the regional dataset {dataset} from {project}/{location}.
        slots:
          dataset: path.conversationDatasetsId
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/conversationDatasets/{conversationDatasetsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a project conversation dataset
      effect: read
      questions:
      - How do I view one conversation dataset at the global location of my project?
      - Can I see when a project-level conversation dataset was created?
      instructions:
      - text: Get global conversation dataset {dataset} in project {project}.
        slots:
          dataset: path.conversationDatasetsId
          project: path.projectsId
      - text: Show project {project}'s dataset {dataset} details.
        slots:
          project: path.projectsId
          dataset: path.conversationDatasetsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/conversationDatasets'].get
  update:
    x-apievangelist-phrasing:
      intent: List conversation datasets in a project
      effect: read
      questions:
      - What conversation datasets exist in my project without picking a region?
      - Can I list a project's global conversation datasets page by page?
      instructions:
      - text: List the global conversation datasets in project {project}.
        slots:
          project: path.projectsId
      - text: Show project {project}'s datasets, {page_size} per page.
        slots:
          project: path.projectsId
          page_size: query.pageSize
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/conversationDatasets/{conversationDatasetsId}:importConversationData'].post
  update:
    x-apievangelist-phrasing:
      intent: Import transcripts into a project conversation dataset
      effect: write
      questions:
      - How do I import conversation transcripts into a global conversation dataset?
      - Can I feed Cloud Storage transcript files into a project-level dataset?
      instructions:
      - text: Import conversation data from {input_config} into global dataset {dataset} of project {project}.
        slots:
          input_config: requestBody.inputConfig
          dataset: path.conversationDatasetsId
          project: path.projectsId
      - text: Load transcripts {input_config} into project {project}'s dataset {dataset}.
        slots:
          input_config: requestBody.inputConfig
          project: path.projectsId
          dataset: path.conversationDatasetsId
      method: generated
      generated: '2026-10-01'