accept_cycle_review
ChatGPTApply the exact reviewed crop-cycle proposal after a new affirmative farmer message. Requires the confirmation receipt, source revision and stable idempotency key. Reject stale proposals; this can overwrite cycle dates.
acknowledge_alert
ChatGPTMark the specified private farm alert acknowledged, or dismissed with a reason, when requested by the farmer. Changes alert status; neither resolves the underlying field risk.
archive_cycle
ChatGPTArchive the reviewed crop cycle and cancel outstanding linked tasks only after prepare_cycle_archive and a new affirmative farmer message. Requires the confirmation receipt. Completed history is preserved; this is a destructive state transition.
assess_crop_suitability
ChatGPTScreen or rank the bounded FAO EcoCrop catalog against a saved field's climate and soil evidence. This is an ecological match, not a market, supply or agronomic guarantee. Return factor evidence, missing context and limits without changing farm records.
commit_cycle_plan
ChatGPTCommit only the exact reviewed crop plan after prepare_cycle_plan_commit and a new affirmative farmer message. Requires its payload-bound confirmation receipt. May replace cycle state and linked work as described by the preview; preserves server authorization and stale-draft checks.
complete_task
ChatGPTMark the specified farm task complete and record the approved completion details. May also record the supplied linked intervention. Changes task state; do not invent amounts or completion facts.
confirm_soil_test
ChatGPTChange the specified soil sample to confirmed only after the farmer explicitly validates the exact saved laboratory values. Does not turn modeled estimates or categorical test-kit readings into quantitative laboratory truth.
create_cycle
ChatGPTCreate a crop cycle from the specified saved field, crop and dates when the farmer requests and approves it. This is an additive farm write. Do not replace an existing active season through this tool.
create_task
ChatGPTCreate the requested farm task for a saved field or cycle, with supplied priority and due date. This adds a private task; it does not notify an external recipient.
discard_workspace_draft
ChatGPTDiscard the specified saved draft after the farmer approves removal. This changes stored draft state and does not remove the active crop cycle.
export_farm_data
ChatGPTExport the connected account's existing farm records as a snapshot. Does not change farm records, upload them elsewhere, or grant access to another account.
generate_farm_report
ChatGPTGenerate and store a private PDF farm report only when requested. Return the authorized download URL and relevant report metadata. This creates a stored artifact and uses the account's existing entitlement; it does not send the report to another person.
get_cycle_review
ChatGPTRead the saved crop-cycle proposal and evidence revision owned by the connected account. Does not apply or reject the proposal.
get_farm_briefing
ChatGPTUse for a requested current farm briefing. Return evidence, risks, recommended next steps, missing context and dated unresolved saved alerts for the saved field or whole farm. Saved alerts are records awaiting review, not fresh measurements; check current field signals before treating an old warning as current. Saves a connection watermark and may persist an initial modeled soil estimate, clearly distinguished from laboratory truth. Does not authorize applying fertilizer.
get_farm_report
ChatGPTRead the season-to-date farm record for a saved field, including cycles, soil, tasks, observations, interventions and alerts. Returns existing records without saving a report or changing farm data.
get_fertilizer_plan
ChatGPTRead the withheld fertilizer-plan status and evidence gaps for a saved field and crop. Product choices, fertilizer and lime rates, totals and application timing remain withheld pending independent local agronomic validation, even with confirmed laboratory evidence or a cited source. Do not reconstruct an application prescription.
get_field_ndvi
ChatGPTRead field-scale satellite greenness statistics for the saved field and bounded date window. Explain cloud masking, observation dates and missing data. Does not treat a missing or poor-quality pass as proof of crop health.
get_onboarding_status
ChatGPTUse to list the connected account's saved fields and setup progress. Return required and missing farm context without creating records or requesting precise user location. Field setup is completed in ZarSage.
get_spray_window
ChatGPTRead weather-based spraying windows for a saved field. Explain the weather criteria and uncertainties; this does not replace product labels or legal restrictions and does not record or perform a treatment. Relay crop_protection.response_policy: weather never authorizes a product, rate, scope or tank mix.
get_water_balance
ChatGPTCalculate a bounded field water-balance estimate from saved crop and weather context. Distinguish modeled demand from measured soil moisture and disclose missing irrigation records. Does not apply irrigation.
get_weather
ChatGPTRead the seven-day forecast for a saved field, including temperature, rain probability, wind and reference evapotranspiration. Return freshness and missing-provider context. Does not modify farm records.
get_weather_history
ChatGPTRead bounded historical reanalysis for a saved field as daily data or monthly summaries. Distinguish modeled history from observations and archived forecasts. Does not modify farm records.
get_workspace_draft
ChatGPTRead one crop-cycle draft owned by the connected account, including its current version and saved payload. Does not commit the draft or change the active season.
list_alerts
ChatGPTRead the connected account's saved farm alerts and evidence, optionally including acknowledged alerts. Does not acknowledge alerts or run a new risk scan.
list_observations
ChatGPTRead saved field observations within the supported filters and limits. Do not treat absent observations as proof of healthy crops. Changes no records.
list_task_outcomes
ChatGPTRead recorded outcomes for completed farm tasks accessible to the connected account. Does not change task status or recorded interventions.
list_tasks
ChatGPTRead the connected account's open farm tasks, optionally filtered by saved field, with cursor pagination and a bounded page size. Return saved work without creating or completing tasks.
prepare_cycle_archive
ChatGPTPreview the exact saved crop cycle and linked-task impact of archiving. Return the confirmation receipt. Present the preview and wait for explicit approval before archive_cycle.
prepare_cycle_plan_commit
ChatGPTValidate and freeze the exact crop-cycle draft, version, field, dates and tasks for final confirmation. Return the payload-bound confirmation receipt and exact impact. Present the review and wait for a new affirmative farmer message before commit_cycle_plan.
prepare_cycle_review
ChatGPTPrepare and persist a confirmation checkpoint for the exact saved crop-cycle proposal. Present its proposed changes and wait for a new affirmative farmer message before accept_cycle_review. Does not apply changes to the farm record.
record_intervention
ChatGPTAdd the farmer-confirmed farm intervention, such as irrigation or treatment, with supplied amounts, dates and safety details. Creates a historical record; it does not operate equipment or purchase inputs. Record the reported scope, target, MoA, PHI and REI; this historical write does not authorize new application advice.
record_observation
ChatGPTRecord the farmer's requested field observation with supplied severity, affected area and notes. Creates a private record. When verifies_alert_id and verification are supplied, also records ground-check evidence and changes the linked alert: confirms acknowledges it, and disputes dismisses it. Preview that status change and obtain explicit farmer approval before applying the verdict. Uncertainty remains explicit and no treatment is performed.
record_soil_test
ChatGPTSave the farmer-provided quantitative soil laboratory results for a saved field as an unconfirmed sample. Present exactly what was saved. This creates a record; confirmation and fertilizer eligibility are separate checks.
reject_cycle_review
ChatGPTReject the saved crop-cycle proposal identified by its source revision and stable idempotency key when the farmer requests it. Changes proposal status without applying its farm changes.
render_field_chart
ChatGPTRender a chart image from the saved field's supported evidence series. Return the image with units, dates and provenance. Does not save a farm record or return embedded custom UI.
render_field_satellite_image
ChatGPTRender a field-clipped satellite image for the saved field and supported imagery options. Return the actual image with acquisition date and provenance. Does not modify farm records or return embedded custom UI.
resolve_field
ChatGPTResolve a farmer-supplied field name to a saved field accessible to the connected account. Return candidates or an ambiguity error instead of choosing an unrelated field. Does not create records.
review_crop_cycle
ChatGPTGenerate and save a private proposal for date changes to an existing crop cycle. Starts a stateful review workflow; does not apply the proposed dates. Returns a saved proposal for separate review and confirmation.
save_workspace_draft
ChatGPTSave or update a private crop-cycle draft for review. Updates require the draft's base version and can overwrite that draft's contents. Does not commit a cycle or replace the active season.
scan_alerts
ChatGPTRun an on-demand bounded risk scan of the connected farm when requested. Persists deduplicated alerts for weather, water, crop-stage, satellite and task risks; can update alert state. Crop-stage and satellite monitors detect changes from a saved baseline, and a water deficit alerts once per dry spell, so zero findings does not rule out standing risks. Check current field signals before describing conditions as normal. Returns the scan outcome without starting a recurring schedule.
show_cycle_planner
ChatGPTRead the account's saved fields, current crop-cycle drafts, and supported task categories for a requested crop plan. Planning and committing are separate actions; this tool changes no farm records.
show_field_dashboard
ChatGPTUse to review one saved field's boundary, crop, soil, work, weather and best-effort satellite evidence. Require a named field when several exist. Building the briefing can persist an initial modeled soil estimate; missing evidence remains explicit.
update_intervention
ChatGPTUpdate the specified farm intervention with farmer-approved corrections and the farmer's reason. Changes historical treatment details; the replaced values are kept in a correction history. Do not infer missing application amounts or safety intervals.