Skip to main content

List Trainings

The list_trainings tool retrieves a paginated list of fine-tuning jobs with optional status, model, and dataset filters.


Tool Overview​

  • Tool Name: list_trainings
  • Underlying Endpoint: GET /finetuning/trainings/
  • SDK Methods: kg.finetuning.list_trainings (Python) / kg.finetuning.listTrainings (TypeScript)

Parameters​

ParameterTypeRequiredDescription
offsetIntegerNoPagination offset (default: 0).
limitIntegerNoMaximum number of training jobs to return (default: 20).
model_idStringNoOptional filter by base model ID.
dataset_idStringNoOptional filter by dataset ID.
statusStringNoOptional filter by job status (pending, running, successful, failed, stopped).

Example Usage​

Natural Language Prompt to Agent​

"List all currently running training jobs on Knowledgator."

Tool Call Arguments​

{
"name": "list_trainings",
"arguments": {
"status": "running",
"limit": 10
}
}

Tool Response​

{
"trainings": [
{
"id": "78d379da228a4985ba19100f53245b79",
"model_id": "comprehend-it",
"dataset_id": "6babd48a-2256-4466-b16b-9fd45ba59688",
"status": "running",
"created_at": "2024-02-15T09:00:00Z"
}
],
"total": 1,
"offset": 0,
"limit": 10
}