Skip to main content

List Datasets

The list_datasets tool retrieves a paginated list of datasets available on your Knowledgator platform account with optional filtering.


Tool Overview​

  • Tool Name: list_datasets
  • Underlying Endpoint: GET /datasets/
  • SDK Methods: kg.datasets.list (Python) / kg.datasets.list (TypeScript)

Parameters​

ParameterTypeRequiredDescription
offsetIntegerNoPagination offset (default: 0).
limitIntegerNoMaximum number of datasets to return (default: 20).
nameStringNoOptional case-insensitive name filter.
dataset_typeStringNoOptional service type filter (ner, text-classification, relation-extraction).

Example Usage​

Natural Language Prompt to Agent​

"List all available NER datasets on my Knowledgator account."

Tool Call Arguments​

{
"name": "list_datasets",
"arguments": {
"dataset_type": "ner",
"limit": 10
}
}

Tool Response​

{
"datasets": [
{
"id": "ds-8924b1a4-92ef",
"name": "ecommerce_reviews_ner",
"type": "ner",
"format": "jsonl",
"status": "ready",
"file_count": 1,
"total_size": 204800,
"created_at": "2024-02-10T14:20:00Z"
}
],
"total": 1,
"offset": 0,
"limit": 10
}