# 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) Answer Records API
  version: 1.0.0
extends: openapi/google-dialogflow-answerrecords-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: 4
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/answerRecords'].get
  update:
    x-apievangelist-phrasing:
      intent: List Agent Assist answer records in a region
      effect: read
      questions:
      - Which Agent Assist suggestions were shown to my agents in a particular region?
      - Can I filter regional answer records, for example by conversation?
      instructions:
      - text: List answer records in project {project}, location {location}.
        slots:
          project: path.projectsId
          location: path.locationsId
      - text: Show regional answer records in {location} matching filter {filter}.
        slots:
          location: path.locationsId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/locations/{locationsId}/answerRecords/{answerRecordsId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Record feedback on a regional answer record
      effect: write
      questions:
      - How do I tell Dialogflow whether a suggestion shown to an agent in a specific region was useful?
      - Can I mark a regional Agent Assist answer as clicked or correct?
      instructions:
      - text: Update answer record {answer_record} in project {project}, location {location} with feedback {feedback}.
        slots:
          answer_record: path.answerRecordsId
          project: path.projectsId
          location: path.locationsId
          feedback: requestBody.answerFeedback
      - text: Submit feedback {feedback} on the {location} answer record {answer_record}.
        slots:
          feedback: requestBody.answerFeedback
          location: path.locationsId
          answer_record: path.answerRecordsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/answerRecords'].get
  update:
    x-apievangelist-phrasing:
      intent: List Agent Assist answer records for a project
      effect: read
      questions:
      - What answer records has Agent Assist logged at the project level?
      - Can I page through global answer records with a filter?
      instructions:
      - text: List global answer records in project {project}.
        slots:
          project: path.projectsId
      - text: Show project {project}'s answer records that match {filter}, {page_size} at a time.
        slots:
          project: path.projectsId
          filter: query.filter
          page_size: query.pageSize
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/projects/{projectsId}/answerRecords/{answerRecordsId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Record feedback on a project answer record
      effect: write
      questions:
      - Can I attach agent feedback to a project-level answer record?
      - Is it possible to say a global Agent Assist suggestion was wrong?
      instructions:
      - text: Update global answer record {answer_record} in project {project} with feedback {feedback}.
        slots:
          answer_record: path.answerRecordsId
          project: path.projectsId
          feedback: requestBody.answerFeedback
      - text: Mark project {project}'s answer record {answer_record} with feedback {feedback}.
        slots:
          project: path.projectsId
          answer_record: path.answerRecordsId
          feedback: requestBody.answerFeedback
      method: generated
      generated: '2026-10-01'