add_feature_value_record
Add multi-field feature values to domain objects in Deriva, enabling batch insertion for complex features like diagnosis with confidence scores.
Instructions
Add feature values with multiple fields to one or more domain objects.
For features with multiple columns (e.g., a diagnosis with confidence score),
use this tool to provide values for each field. Accepts a list of entries
for batch insertion. Use lookup_feature first to see available fields.
Feature columns are dynamically generated based on the feature definition:
term_columns: Accept vocabulary term names (strings)asset_columns: Accept asset RIDs (strings)value_columns: Accept direct values (strings, numbers)
Args:
table_name: Table the target records belong to (e.g., "Image").
feature_name: Name of the feature (e.g., "Diagnosis").
entries: List of dicts, each with:
- target_rid (str, required): RID of the target record.
- Plus any feature column names mapped to their values.
Use lookup_feature to see available columns and types.
execution_rid: Execution RID for provenance (uses active if not provided).
Returns: JSON with status, feature_name, count, execution_rid, rids.
Example: # First check the feature structure: lookup_feature("Image", "Diagnosis") # -> {"term_columns": {"Diagnosis_Type": {...}}, "value_columns": {"confidence": {...}}}
# Then add values (single or batch):
add_feature_value_record("Image", "Diagnosis", [
{"target_rid": "1-ABC", "Diagnosis_Type": "Normal", "confidence": 0.95},
{"target_rid": "1-DEF", "Diagnosis_Type": "Abnormal", "confidence": 0.87},
])
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entries | Yes | ||
| table_name | Yes | ||
| feature_name | Yes | ||
| execution_rid | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |