Knowledge bases (KBases)
A KBase is a container for your content. When you add content to a KBase it is
chunked, embedded and indexed for retrieval, and a knowledge graph describing the concepts it
contains is built alongside it. These tools let an agent create, remove and enumerate KBases.
The identifier returned by these tools is the indexId used by nearly every other
tool on this server.
CreateKBase
destructiveCreates a new, empty knowledge base owned by the calling account.
Parameters
| Name | Type | Description |
|---|---|---|
kbaseName | string | The display name for the new knowledge base. |
Returns
The Id of the newly created knowledge base. Keep it — it is the indexId that other tools expect.
DeleteKBase
destructivePermanently deletes a knowledge base, together with its indexed content and knowledge graph. You can only delete knowledge bases that you own; deleting anything else fails with KBase not found.
Parameters
| Name | Type | Description |
|---|---|---|
kbaseId | string | The Id of the KBase to delete. |
Returns
true when the knowledge base was deleted.
ListKBases
read-onlyLists every knowledge base belonging to the calling account. This is normally the first tool an agent calls.
Parameters
None.
Returns
A list of records, each containing:
| Field | Type | Description |
|---|---|---|
Id | string | The Id of the knowledge base. |
Name | string | The name of the knowledge base. |
Description | string | The description of the knowledge base, if one has been set. |
ListOpenKBases
read-onlyLists the publicly shared ("open") knowledge bases published on this server, whoever owns them. Use it to discover shared reference material that you can search or chat with, even though you cannot modify it.
Parameters
None.
Returns
A list of records with the same Id, Name and Description fields as ListKBases.