# 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 Azure AgFoodPlatform RP Service Data…
  version: 1.0.0
extends: openapi/microsoft-azure-data-connectors-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AgFoodPlatform/farmBeats/{dataManagerForAgricultureResourceName}/dataConnectors/{dataConnectorName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an agriculture data connector
      effect: read
      questions:
      - How do I view one data connector on my Data Manager for Agriculture resource?
      - What settings does a single agriculture data connector hold?
      instructions:
      - text: Show data connector {dataConnectorName} on Data Manager for Agriculture resource {dataManagerForAgricultureResourceName}.
        slots:
          dataConnectorName: path.dataConnectorName
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      - text: Get data connector {dataConnectorName} for {dataManagerForAgricultureResourceName}.
        slots:
          dataConnectorName: path.dataConnectorName
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AgFoodPlatform/farmBeats/{dataManagerForAgricultureResourceName}/dataConnectors/{dataConnectorName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an agriculture data connector
      effect: write
      questions:
      - How do I connect an external data provider to Data Manager for Agriculture?
      - Can I update the credentials on an existing agriculture data connector?
      instructions:
      - text: Create data connector {dataConnectorName} on Data Manager for Agriculture resource {dataManagerForAgricultureResourceName}.
        slots:
          dataConnectorName: path.dataConnectorName
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      - text: Update the credentials of data connector {dataConnectorName} on {dataManagerForAgricultureResourceName}.
        slots:
          dataConnectorName: path.dataConnectorName
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AgFoodPlatform/farmBeats/{dataManagerForAgricultureResourceName}/dataConnectors/{dataConnectorName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an agriculture data connector
      effect: destructive
      questions:
      - Can I remove a data connector from my Data Manager for Agriculture instance?
      - What happens to ingestion when I delete an agriculture data connector?
      instructions:
      - text: Delete data connector {dataConnectorName} from Data Manager for Agriculture resource {dataManagerForAgricultureResourceName}.
        slots:
          dataConnectorName: path.dataConnectorName
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      - text: Remove the {dataConnectorName} connector from {dataManagerForAgricultureResourceName}.
        slots:
          dataConnectorName: path.dataConnectorName
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AgFoodPlatform/farmBeats/{dataManagerForAgricultureResourceName}/dataConnectors'].get
  update:
    x-apievangelist-phrasing:
      intent: List data connectors on an agriculture instance
      effect: read
      questions:
      - Which data connectors are configured on my Data Manager for Agriculture instance?
      - Can I page through agriculture data connectors with a max page size?
      instructions:
      - text: List data connectors on Data Manager for Agriculture resource {dataManagerForAgricultureResourceName}.
        slots:
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      - text: Show {maxPageSize} data connectors per page for {dataManagerForAgricultureResourceName}.
        slots:
          maxPageSize: query.$maxPageSize
          dataManagerForAgricultureResourceName: path.dataManagerForAgricultureResourceName
      method: generated
      generated: '2026-10-01'