explain_segment
Drill into a specific data segment defined by condition variables to discover key factors driving a target outcome.
Instructions
Find drivers of a target outcome within a specific segment (CLARA method). Call this ONCE — like find_drivers, it returns a complete multi-level nested JSON in a single response. Do NOT call it multiple times to refine results.
Use this for local/conditional analysis: "within 1st class passengers, what drives survival?" The condition_variables define which variables describe the segment — araxai will find what values of those variables define the strongest sub-segments, then find drivers within them.
Use find_drivers first for the global picture; use explain_segment only when you need to drill into a specific slice of the data.
Args: dataset_name: Name of a dataset loaded with load_dataset target: Column name of the outcome variable target_class: The specific outcome value to explain condition_variables: Columns that define the segment to focus on (e.g. ["Journey_Type"]) attributes: Optional subset of columns to use as candidate drivers. Exclude columns that are direct encodings of the target, same as for find_drivers. min_base: Minimum records a rule must cover
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dataset_name": "<dataset_name>",
"target": "<target>",
"target_class": "<target_class>",
"condition_variables": "<condition_variables>"
},
"name": "explain_segment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_name | Yes | ||
| target | Yes | ||
| target_class | Yes | ||
| condition_variables | Yes | ||
| attributes | No | ||
| min_base | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |