Learn how to create and manage Collections within your Vector Databases in Kosmoy Studio.
The Collections section within the Data Catalog allows you to define and manage specific subsets of data within your registered Vector Databases. Collections are essential for organizing your vector data and making it accessible to other Kosmoy Studio components, such as Data Channels and Vector Pipelines.
Prerequisites:
Before creating a Collection, you must have a Vector Database registered in the Data Catalog. Refer to the Databases section for details.
Navigate to Collections: From the Kosmoy Studio home page, click on the “Data Management” menu in the left-hand navigation bar, then select “Data Catalog”, and then click on “Collections”.
Add a New Collection: Click the ”+ ADD” button located in the upper right corner of the Collections section.
Select Vector Database: From the dropdown menu, select the pre-configured Vector Database in which you want to create the collection.
Define Distance Strategy: Choose the appropriate distance strategy for your collection. The available options are:
Note: The choice of distance strategy depends on the nature of your data and the specific requirements of your application. You should have configured it when creating your Vector Database.
Configure Collection Connection Parameters: Enter the required connection parameters for your specific Vector Database type. These parameters may vary depending on the database provider.
Click “Next”: Proceed to the next step.
Name and Describe the Collection: Give your collection a unique name and an optional description.
Click “Review”: Review the collection configuration.
Click “Create”: Create the collection.
The Collections section displays each created collection as a card. Each card shows:
You cannot edit or delete a collection if it is currently referenced by other entities within Kosmoy Studio. This includes being used in:
Before attempting to edit or delete a collection, ensure it is not actively used in any of these areas.
You can update the name and description of a registered collection, provided it is not currently referenced by any other component.
Note: You cannot modify the core configuration of a collection (database, distance strategy, connection parameters) after it has been created.
You can remove a registered collection if it’s no longer needed. However, you cannot delete a collection that is currently referenced by any other component.
If you attempt to delete a collection that is currently in use, a modal will appear, preventing the deletion and explaining that the collection is in use.
Warning: Deleting a collection is a permanent action and cannot be undone. Ensure that the collection is not being referenced by any other component before proceeding.
Collections are primarily used in two ways within Kosmoy Studio:
This section provides a detailed guide to creating and managing Collections within Kosmoy Studio’s Data Catalog.