AI tools

Parcel area grouped by household, zone or crop: number of households, parcels, total area (ha) and parcels without a boundary. Sorted by area, largest first.

Scope: gis:read

{
  "group_by": "zone"
}

The farm's crop type catalogue: code, name and category. Use the crop type ID to filter parcels, seasons and yields.

Scope: gis:read

Farmer households / members of the sourcing area: name, zone, group and member type. Filter by zone, group or type.

Scope: gis:read

One parcel: name, code, area, zone, owner, current crop and status.

Scope: gis:read

{
  "id": "0190a3c2-5b1e-7c3d-8e4f-000000000001"
}

The farm's parcels: code, area (ha), zone, owner, current crop and status. Filter by zone, crop or status.

Scope: gis:read

{
  "page": 1,
  "page_size": 50
}

Search parcels, seasons, farmers and zones by keyword; groups outside the key's scopes come back empty.

Scope: gis:read

{
  "q": "A-12"
}

Seasons with the same crop and season name across parcels in one year (e.g. Rice · Winter-Spring): parcel count, total area, earliest/latest planting date.

Scope: gis:read

{
  "year": 2026
}

Seasons for one parcel (cultivation history) or for a year: crop, season name, planting date, expected harvest date and status. Provide a parcel or a year.

Scope: gis:read

{
  "year": 2026
}

Number of parcels and total area (ha) of one zone.

Scope: gis:read

Certificates (VietGAP, GlobalGAP, organic…) about to expire or already expired, sorted by expiry date.

Scope: harvest:read

{
  "within_days": 60
}

Parcels, ponds and pens currently under a pesticide pre-harvest interval or veterinary withdrawal period: earliest safe date and the blocking application.

Scope: harvest:read

Declared harvest records: parcel, crop, declared yield (kg), status (draft · confirmed · verified · collected · void), harvest date and traceability lot.

Scope: harvest:read

{
  "status": "confirmed"
}

Search harvest records, QR labels and certificates by keyword (record code, label code, certificate name).

Scope: harvest:read

{
  "q": "VietGAP"
}

Harvested yield (confirmed records only) grouped by household, zone, crop or parcel within a harvest date range. Sorted by total kg, largest first.

Scope: harvest:read

{
  "from": "2026-10-01",
  "group_by": "crop",
  "to": "2026-10-31"
}

One traceability lot: cultivation log, certificates and photos — what a buyer sees when scanning the QR label.

Scope: harvest:read

Published traceability lots of the farm: parcel, zone, product, certification, harvest date, farmer and number of stages.

Scope: harvest:read

Whether a parcel is still within a pesticide pre-harvest interval, the earliest safe harvest date and the application holding it.

Scope: harvest:read

Sensor threshold alerts: device, metric, value, threshold, severity and handling status.

Scope: iot:read

{
  "status": "triggered"
}

Latest commands sent to one controller: command type, status, sent time and whether the device acknowledged it.

Scope: iot:read

The farm's IoT devices: name, type, online or offline, last report time. Filter by status, parcel or zone.

Scope: iot:read

{
  "status": "offline"
}

Search devices by name or code.

Scope: iot:read

{
  "q": "NK2"
}

Irrigation outputs of one controller: type (pump, zone valve, fertigation), index and the user-given name (e.g. 'Block A').

Scope: iot:read

Sensor reading history for a device or zone within a time range, newest first.

Scope: iot:read

{
  "from": "2026-10-27",
  "to": "2026-10-28"
}

The latest value of each sensor (temperature, humidity, EC, pH…) for the whole farm or one zone.

Scope: iot:read

Upcoming scheduled irrigation runs: controller, start time, duration (seconds), valves, skipped or already run.

Scope: iot:read

{
  "days": 2
}

The farm's automation rules: name, status, trigger type and last run.

Scope: office:read

Columns of one table: name, data type and options — needed to read row values correctly.

Scope: office:read

The farm's custom books (logs, inventory, costs…): name, description and number of tables.

Scope: office:read

Read rows of a book table, paginated; values keyed by column ID.

Scope: office:read

Tables inside one farm book.

Scope: office:read

Available farm reports: code, name, group and the number of data blocks you can see.

Scope: reports:read

Run a report by code over a date range: KPIs, time series, breakdowns and tables. Without dates the last 30 days are used.

Scope: reports:read

{
  "code": "SX-01",
  "from": "2026-10-01",
  "grain": "week",
  "to": "2026-10-28"
}