Suggest where a run's table could use a rule or a model
suggest_enrichmentsReads the run's columns, then a bounded sample of its text columns (up to max_rows rows, default 50, each value cut to its first few thousand characters; metered like query_run, the column read is not charged) and names, column by column, a deterministic derivation (cast text to its type, parse machine-coded text, map a code list to labels, a normalized key to join or dedupe on) or a model call (classify, extract, match) that would improve the table, each with model_status for the model it needs and the binding to use. It spends no model call and changes nothing. Example: {"run_id": "…"}. Returns {run_id, analyzer, sampled_rows, opportunities: [{column, task, method, why, next_step, stats, model_status?, binding?}], omitted, models, offer}. Treat each entry as a lead: confirm it against the rows before you offer it, deterministic ones first. Add a model source only when the person agrees or the brief asked for that judgement; a model_status other than available is offered as coming. The sampled rows are not returned. A timeout or a usage limit answers as query_run's would.
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": {
"run_id": "<run_id>"
},
"name": "suggest_enrichments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | Yes | ||
| max_rows | No | ||
| wait_seconds | No |