list_dataset_items
List dataset items with pagination and optional filtering by source trace or observation ID. Retrieve input, expected output, and metadata for each item.
Instructions
List items in a dataset with pagination and optional filtering.
Returns dataset items with their input, expected output, and metadata.
Args:
ctx: Context object containing lifespan context with Langfuse client
dataset_name: The name of the dataset to list items from
source_trace_id: Optional filter by source trace ID
source_observation_id: Optional filter by source observation ID
page: Page number for pagination (starts at 1)
limit: Maximum items per page (max 100)
output_mode: How to format the response data
Returns:
A dictionary containing:
- data: List of dataset item objects
- metadata: Pagination info (page, limit, total, dataset_name)Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_name | Yes | The name of the dataset to list items from | |
| source_trace_id | No | Filter by source trace ID | |
| source_observation_id | No | Filter by source observation ID | |
| page | No | Page number for pagination (starts at 1) | |
| limit | No | Items per page (max 100) | |
| output_mode | No | Output format: 'compact' truncates, 'full_json_string' returns full data, 'full_json_file' writes to file | compact |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |