List dataset runs
listDatasetRunsRetrieve evaluation runs for a dataset with pagination support. Specify the dataset name to list its rounds, controlling page and limit.
Instructions
List runs (evaluation rounds) for a dataset.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default 1) | |
| limit | No | Items per page (default 50, max 100) | |
| datasetName | Yes |
Implementation Reference
- src/tools.ts:241-253 (registration)Registration of the 'listDatasetRuns' tool via server.registerTool() with name, metadata, inputSchema, and handler.
server.registerTool( "listDatasetRuns", { title: "List dataset runs", description: "List runs (evaluation rounds) for a dataset.", inputSchema: { ...paginationShape, datasetName: z.string().min(1), }, }, async ({ datasetName, ...rest }) => asJson(await client.get(`/api/public/datasets/${enc(datasetName)}/runs`, rest)), ); - src/tools.ts:251-253 (handler)Handler function that calls the Langfuse API: GET /api/public/datasets/{datasetName}/runs with pagination params.
async ({ datasetName, ...rest }) => asJson(await client.get(`/api/public/datasets/${enc(datasetName)}/runs`, rest)), ); - src/tools.ts:246-249 (schema)Input schema requiring datasetName (string) and paginationShape (page, limit).
inputSchema: { ...paginationShape, datasetName: z.string().min(1), }, - src/tools.ts:409-420 (registration)Tool name listed in the TOOL_NAMES const array for enumeration purposes.
"listDatasetRuns", "getDatasetRun", "getMetrics", "getDailyMetrics", "listModels", "getModel", "listProjects", "listComments", "getComment", "getMedia", "getHealth", ] as const; - src/schemas.ts:3-12 (helper)paginationShape helper schema imported by listDatasetRuns input schema, defining page and limit fields.
export const paginationShape = { page: z.number().int().positive().optional().describe("Page number (default 1)"), limit: z .number() .int() .min(1) .max(100) .optional() .describe("Items per page (default 50, max 100)"), };