# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Google Dialogflow Locations API
  version: 1.0.0
extends: openapi/google-dialogflow-locations-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['/v3/projects/{projectsId}/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List regions available to Dialogflow CX
      effect: read
      questions:
      - Which regions can I host a Dialogflow CX agent in for my project?
      - Can I filter the list of CX v3 locations?
      instructions:
      - text: List the CX v3 locations available to project {project}.
        slots:
          project: path.projectsId
      - text: Show v3 regions for project {project} matching filter {filter}.
        slots:
          project: path.projectsId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Dialogflow CX location
      effect: read
      questions:
      - What details can I get about one Dialogflow CX region like us-central1?
      - What metadata does the v3 API return for a single location?
      instructions:
      - text: Get CX v3 location {location} for project {project}.
        slots:
          location: path.locationsId
          project: path.projectsId
      - text: Describe v3 region {location} in project {project}.
        slots:
          location: path.locationsId
          project: path.projectsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Dialogflow ES location
      effect: read
      questions:
      - Can I look up one Dialogflow ES region for my project?
      - What does the v2 API report about a single location?
      instructions:
      - text: Get ES v2 location {location} for project {project}.
        slots:
          location: path.locationsId
          project: path.projectsId
      - text: Fetch v2 region details for {location} in project {project}.
        slots:
          location: path.locationsId
          project: path.projectsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/agent'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the ES agent in a region
      effect: read
      questions:
      - How do I fetch the Dialogflow ES agent that lives in a specific region of my project?
      - Can I check a regional ES agent's default language and match mode?
      instructions:
      - text: Get the ES agent in project {project}, region {location}.
        slots:
          project: path.projectsId
          location: path.locationsId
      - text: Show the regional agent settings for {project}/{location}.
        slots:
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/agent'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update the ES agent in a region
      effect: write
      questions:
      - How do I create or update a Dialogflow ES agent in a specific region?
      - Can I change a regional ES agent's classification threshold or supported languages?
      instructions:
      - text: Set the ES agent in project {project}, region {location} to name {display_name} with default language {language}.
        slots:
          project: path.projectsId
          location: path.locationsId
          display_name: requestBody.displayName
          language: requestBody.defaultLanguageCode
      - text: Update the regional agent in {project}/{location} to classification threshold {threshold}.
        slots:
          project: path.projectsId
          location: path.locationsId
          threshold: requestBody.classificationThreshold
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/agent'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the ES agent in a region
      effect: destructive
      questions:
      - Can I delete the Dialogflow ES agent in one region of my project?
      - Is deleting a regional ES agent permanent?
      instructions:
      - text: Delete the ES agent in project {project}, region {location}.
        slots:
          project: path.projectsId
          location: path.locationsId
      - text: Remove the regional agent from {project}/{location}.
        slots:
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/encryptionSpec'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the encryption settings for a region
      effect: read
      questions:
      - Which customer-managed encryption key does Dialogflow use in a given region?
      - Is CMEK configured for my project's Dialogflow data in a particular location?
      instructions:
      - text: Get the encryption spec for project {project}, region {location}.
        slots:
          project: path.projectsId
          location: path.locationsId
      - text: Show the CMEK key settings for {project}/{location}.
        slots:
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List regions available to Dialogflow ES
      effect: read
      questions:
      - Which regions does Dialogflow ES support for my project?
      - Can I page through the v2 locations list?
      instructions:
      - text: List the ES v2 locations available to project {project}.
        slots:
          project: path.projectsId
      - text: Show v2 regions for project {project}, {page_size} per page.
        slots:
          project: path.projectsId
          page_size: query.pageSize
      method: generated
      generated: '2026-10-01'