AGENT - Nomadic

Specialized motion and behavior detection powered by curated agent pipelines:

Agent examples

# General agent (edge-case detection)
client.analyze(
    "abc123",
    analysis_type=AnalysisType.GENERAL_AGENT,
)

# Lane change specialist
client.analyze(
    "abc123",
    analysis_type=AnalysisType.LANE_CHANGE,
)

# Batch agent run
client.analyze(
    ["abc123", "def456"],
    analysis_type=AnalysisType.LANE_CHANGE
)

# Batch agent run using a folder
client.analyze(
    folder="san_francisco_midday",
    analysis_type=AnalysisType.LANE_CHANGE
)

AnalysisType.GENERAL_AGENT: zero-shot edge-case hunting (General Edge Case)
AnalysisType.LANE_CHANGE: lane-change manoeuvre detection
AnalysisType.TURN: left/right turn behaviour
AnalysisType.RELATIVE_MOTION: relative motion between vehicles
AnalysisType.DRIVING_VIOLATIONS: speeding, stop, red-light, and related violations

Required Parameters:

Parameter	Type	Description
`ids` or `folder`	`str \| Sequence[str]`	Video ID(s) or folder name (use one, not both)
`analysis_type`	`AnalysisType`	One of `AnalysisType.GENERAL_AGENT`, `AnalysisType.LANE_CHANGE`, `AnalysisType.TURN`, `AnalysisType.RELATIVE_MOTION`, `AnalysisType.DRIVING_VIOLATIONS`

Optional Parameters:

Parameter	Type	Default	Description
`model_id`	`str`	`"Nomadic-VL-XLarge"`	AI model to use
`timeout`	`int`	`2400`	Analysis timeout in seconds
`wait_for_completion`	`bool`	`True`	Wait for analysis to complete
`concept_ids`	`List[str]`	`None`	Concept IDs for specialized detection
`return_subset`	`bool`	`False`	Return subset of results

Returns: Dict with video_id, analysis_id, mode, status, and events.

SDK

Documentation Index