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
| Parameter | Type | Required | Description |
|---|---|---|---|
offset | Integer | No | Pagination offset (default: 0). |
limit | Integer | No | Maximum number of training jobs to return (default: 20). |
model_id | String | No | Optional filter by base model ID. |
dataset_id | String | No | Optional filter by dataset ID. |
status | String | No | Optional 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
}