Voice Capture

Voice capture is the fastest way to log observations, notes, and tasks while you're working in the field. Speak naturally, and Headlands' AI will interpret your words, extract key information, and suggest actions.

How Voice Capture Works

1. Record - Tap the microphone button and speak your observation
2. Transcribe - Your audio is transcribed using OpenAI's Whisper model
3. Interpret - AI analyzes the transcription to extract structured data
4. Review - You approve, edit, or discard the interpretation
5. Store - Approved captures become part of your knowledge base

Recording a Capture

Starting a Recording

Click or tap the orange floating action button (FAB) in the bottom-right corner of the screen. The button will pulse to indicate recording is active.

Speak clearly and naturally. Include relevant context like:

• Location: "In the north field..." or "At bin number 3..."
• Subject: "The corn is..." or "Tractor 42 needs..."
• Observations: "Seeing some leaf curl..." or "Oil pressure seems low..."
• Actions needed: "Should schedule spraying..." or "Need to order parts..."

Stopping a Recording

Tap the microphone button again to stop. Your recording will be sent for processing (or queued if offline).

Recording Tips

• Speak in complete thoughts - The AI understands context better with full sentences
• Mention names - Field names, equipment IDs, and animal tags help with automatic linking
• Be specific - "Aphids on about 20% of plants" is better than "some bugs"
• Include severity - "Minor issue" vs "needs immediate attention"

AI Interpretation

After transcription, Headlands' AI extracts structured data from your capture:

Extracted Data Types

Data Type	Example
Fields	Links to fields mentioned by name
Equipment	Links to equipment by ID or description
Cattle	Links to animals by tag number
Issues	Pest pressure, equipment problems, health concerns
Tasks	Suggested follow-up actions
Dates	Referenced dates and deadlines
Measurements	Quantities, percentages, conditions

Review Process

After processing, you'll see a capture card with:

1. Original transcription - What you said
2. AI interpretation - Extracted entities and suggested actions
3. Confidence indicators - How certain the AI is about each extraction

You can:

• Approve - Accept the interpretation as-is
• Edit - Correct any misinterpretations
• Discard - Delete the capture entirely

Offline Support

Voice capture works fully offline thanks to Progressive Web App (PWA) technology.

How Offline Works

1. Recordings are stored in local browser storage
2. A sync indicator shows pending captures
3. When connectivity returns, captures automatically upload
4. Processing happens server-side after upload

Offline Limits

• Up to 50 pending captures can be stored locally
• Individual recordings up to 5 minutes
• Total local storage depends on device (typically 50-100MB)

Sync Status

The sync indicator in the navigation bar shows:

• Green dot - All synced, online
• Orange dot - Pending sync, items waiting
• Gray dot - Offline, captures stored locally

Capture Categories

Captures are automatically categorized based on content:

Category	Description
Field Observation	Crop conditions, growth stages, issues
Equipment Log	Maintenance, repairs, status updates
Cattle Record	Health checks, treatments, movements
Weather Note	Conditions, forecasts, impacts
Task	Work that needs to be done
General	Uncategorized observations

Integration with Knowledge Base

Captures automatically link to your knowledge base entities:

Field Linking

When you mention a field name, the capture links to that field's record. This enables:

• Field-specific history views
• Trend analysis over time
• Automatic inclusion in field reports

Equipment Linking

Mention equipment by name or ID to link captures to equipment records:

• "Tractor 42" → Links to equipment #42
• "The combine" → May prompt for clarification if multiple combines exist

Cattle Linking

Reference animals by tag number for automatic linking:

• "Tag 1234" → Links to animal record
• "The heifer in pen 3" → May link to pen assignment

Batch Capture

For bulk observations, use batch capture mode:

1. Enable batch mode in capture settings
2. Record multiple observations in sequence
3. Review all at once in a batch review screen
4. Approve or edit each interpretation individually

Batch mode is useful for:

• Pasture walks with multiple observations
• Equipment inspections
• Cattle health checks

Best Practices

For Field Observations

"Checked the Johnson north 40 today, May 15th. Corn is at V6 stage, about 18 inches tall. Seeing some minor aphid pressure on the east edges, maybe 10% of plants affected. Should consider scouting again in a week. No action needed yet."

For Equipment Logs

"Tractor 42 is showing low hydraulic pressure, around 1800 PSI instead of the normal 2200. Also noticed some oil seeping near the loader cylinder. Need to schedule maintenance, probably a seal replacement."

For Cattle Records

"Treated heifer tag 4521 for pinkeye today. Gave her LA-200, 10cc IM. Eye was about 50% cloudy. Will need a follow-up check in 3 days. She's in the north pasture near the windmill."

Keyboard Shortcuts

On desktop, you can use keyboard shortcuts:

Shortcut	Action
Space	Start/stop recording
Enter	Approve interpretation
E	Edit interpretation
Esc	Discard capture

Troubleshooting

"Microphone not found"

• Check browser permissions for microphone access
• Ensure your device has a working microphone
• Try a different browser if issues persist

"Transcription failed"

• Check your internet connection
• The recording may be too quiet - try speaking louder
• Very long pauses may cause timeout issues

"AI interpretation seems wrong"

• Edit the interpretation to correct it
• More specific language helps AI accuracy
• The system learns from your corrections over time