List all agricultural areas from the SIA AreaService.

Areas represent geographic boundaries (polygons) for fields and crop zones. Returns area ID, name, validity period, area type, blocked status, geojson boundary, and size.

Args:

• filter (string, optional): OData $filter expression, e.g. "name eq 'My Field Area'"

• top (number, optional): Maximum number of results (default: 100)

Returns: Array of Area objects with fields: ID, name, validFrom, validTo, isBlocked, areaType_ID, boundary_geojson, isAutomaticallyCalculated, areaSize

Create a new geographic area in the SIA AreaService.

Areas define the boundary polygon for a field or crop zone. Returns the created Area ID.

Args:

• name (string): Display name of the area

• validFrom (string): ISO datetime from which the area is valid, e.g. "2026-01-01T00:00:00.000Z"

• validTo (string, optional): ISO datetime until which the area is valid; omit for indefinite

• areaType_ID (string): UUID of the area type

• boundary_geojson (string): GeoJSON string defining the area polygon

• isAutomaticallyCalculated (boolean): Whether area size is auto-calculated from geometry

• areaSize (number, optional): Manual area size in hectares (used when isAutomaticallyCalculated=false)

• isBlocked (boolean, optional): Whether the area is blocked (default: false)

Returns: Created Area object with ID

Delete an area by its ID from the SIA AreaService.

WARNING: This is a destructive operation. Ensure the area is not referenced by active fields or crop zones before deleting.

Args:

• id (string): UUID of the area to delete

Returns: Confirmation message on success

List all farms from the SIA FarmAndFieldService.

Returns farm ID, name, description and metadata.

Args:

• filter (string, optional): OData $filter expression, e.g. "createdBy eq 'user@example.com'"

• top (number, optional): Max results (default: 100)

Returns: Array of Farm objects

List all fields from the SIA FarmAndFieldService.

Returns field ID, name, description, farm_ID, and area_ID.

Args:

• filter (string, optional): OData $filter expression, e.g. "farm_ID eq ''"

• top (number, optional): Max results (default: 100)

Returns: Array of Field objects

Create a new field in the SIA FarmAndFieldService.

A field belongs to a farm and is associated with a geographic area.

Args:

• name (string): Field display name

• farm_ID (string): UUID of the parent farm

• area_ID (string): UUID of the area (geographic boundary) — create with sia_create_area first

• description (string, optional): Additional notes about the field

Returns: Created Field object with ID

List characteristic values attached to fields (e.g. external plot IDs, custom attributes).

Optionally expands the configuration to include characteristic metadata.

Args:

• filter (string, optional): OData $filter, e.g. "field_ID eq ''"

• expand_configuration (boolean, optional): Include configuration metadata (default: true)

• top (number, optional): Max results (default: 100)

Returns: Array of FieldCharacteristicValue objects

Attach a characteristic value to a field (e.g. set an external plot ID or custom attribute).

Args:

• configuration_ID (string): UUID of the characteristic configuration (defines what attribute this is)

• field_ID (string): UUID of the target field

• textValue (string, optional): Text value for text-type characteristics

• numberValue (number, optional): Numeric value for number-type characteristics

Returns: Created FieldCharacteristicValue with ID

List crop zones from the SIA CropZoneService.

A crop zone represents a portion of a field planted with a specific crop variety in a season.

Args:

• filter (string, optional): OData $filter, e.g. "field_ID eq ''"

• top (number, optional): Max results (default: 100)

Returns: Array of CropZone objects with ID, name, isFallow, isClosed, field_ID, area_ID, crop_ID, variety_ID, season_ID

Create a new crop zone in the SIA CropZoneService.

A crop zone links a field, area, crop, variety, and season together.

Args:

• name (string): Display name

• field_ID (string): UUID of the parent field

• area_ID (string): UUID of the crop zone's area

• crop_ID (string): UUID of the crop type

• variety_ID (string): UUID of the crop variety

• season_ID (string): UUID of the agricultural season

• isFallow (boolean): Whether the zone is left fallow (default: false)

• isClosed (boolean): Whether the zone is closed (default: false)

• perennial_ID (string, optional): UUID of associated perennial

• cropPurpose_ID (string, optional): UUID of crop purpose

• productionType_ID (string, optional): UUID of production type

• description (string, optional): Free-text notes

Returns: Created CropZone object with ID

Delete a crop zone by ID from the SIA CropZoneService.

WARNING: Destructive operation. Ensure all KPIs and characteristics are removed first.

Args:

• id (string): UUID of the crop zone to delete

Returns: Confirmation message

Get KPI values for a specific crop zone.

Returns estimated production values and other KPIs linked to this crop zone.

Args:

• cropZone_ID (string): UUID of the crop zone

Returns: Array of KPI objects with kpiDefinition_ID, entityType, and estimatedValue

Add a KPI value to a crop zone (e.g. total production estimate, per-tree production).

Args:

• cropZone_ID (string): UUID of the crop zone to add the KPI to

• kpiDefinition_ID (string): UUID of the KPI definition (what metric this measures)

• entityType (string): Entity type, typically "CROP_ZONE"

• estimatedValue (number): The numeric KPI value

Returns: Created KPI object

List characteristic values attached to crop zones (e.g. tree counts, custom attributes).

Args:

• filter (string, optional): OData $filter, e.g. "cropZone_ID eq ''"

• top (number, optional): Max results (default: 100)

Returns: Array of CropZoneCharacteristicValue objects

Attach a characteristic value to a crop zone (e.g. number of trees, number of productive trees).

Args:

• configuration_ID (string): UUID of the characteristic configuration

• cropZone_ID (string): UUID of the target crop zone

• numberValue (number, optional): Numeric value

• textValue (string, optional): Text value

Returns: Created CropZoneCharacteristicValue with ID

List perennial plants from the SIA PerennialsService.

Perennials represent long-lived plants (e.g. fruit trees, coffee bushes) linked to fields.

Args:

• filter (string, optional): OData $filter, e.g. "field_ID eq ''"

• top (number, optional): Max results (default: 100)

Returns: Array of Perennial objects with ID, name, field_ID, area_ID, plantingDate, crop_ID, variety_ID

Create a perennial plant record in the SIA PerennialsService.

Args:

• name (string): Display name

• description (string, optional): Notes

• field_ID (string): UUID of the parent field

• area_ID (string): UUID of the area

• plantingDate (string): ISO date, e.g. "2026-01-02"

• crop_ID (string): UUID of the crop type

• variety_ID (string): UUID of the crop variety

Returns: Created Perennial object with ID

List agricultural seasons from the SIA SeasonService.

Seasons define time periods for crop planning. Use season IDs when creating crop zones.

Args:

• top (number, optional): Max results (default: 50)

Returns: Array of Season objects with ID, name, startDate, endDate

List crop varieties from the SIA CropAndVarietyService.

Use variety IDs when creating crop zones and perennials.

Args:

• filter (string, optional): OData $filter, e.g. "crop_ID eq ''"

• top (number, optional): Max results (default: 100)

Returns: Array of Variety objects with ID, name, crop_ID

List KPI definitions from the SIA KPIService.

KPI definitions describe what metrics can be tracked (e.g. total production, per-tree production). Use kpiDefinition_ID values when creating crop zone KPIs.

Returns: Array of KPIDefinition objects with ID, name, description, unit

List locations from the SIA LocationService (e.g. assembly points, storage facilities).

Args:

• filter (string, optional): OData $filter

• top (number, optional): Max results (default: 100)

Returns: Array of Location objects with ID, name, description, locationType_ID, geolocation_geojson

List location types from the SIA LocationService.

Use locationType_ID values when creating locations.

Returns: Array of LocationType objects with ID and name

Create a new location (e.g. assembly point) in the SIA LocationService.

Args:

• name (string): Display name

• description (string, optional): Notes

• locationType_ID (string): UUID of the location type

• geolocation_geojson (string): GeoJSON Point string, e.g. '{"type":"Point","coordinates":[lng, lat]}'

Returns: Created Location object with ID

Delete a location by ID from the SIA LocationService.

Args:

• id (string): UUID of the location to delete

List characteristic configurations from the SIA CharacteristicService.

Characteristic configurations define what custom attributes can be set on fields and crop zones. Use configuration_ID values when creating field or crop zone characteristic values.

Returns: Array of CharacteristicConfiguration objects with ID, name, dataType