Skip to main content
Version: v1.7.0

Select a Collection

Overview​

The Select a Collection ingestion method allows you to import all documents from another collection into your current collection. This method is useful for combining collections or creating new collections based on existing ones.

Select Existing Collection

When to use​

  • Collection merging: When you want to combine multiple collections
  • Collection copying: When you want to create a copy of an existing collection
  • Template collections: When using a collection as a template for new ones
  • Bulk document reuse: When you want all documents from another collection
  • Collection organization: When reorganizing your document structure

Configuration parameters​

Collection selection​

OptionDefaultDescriptionUse case
Search collections- (text input)Search for collections by name or descriptionFind specific Collections
Filter by ownerAll owners (dropdown)Filter collections by ownerFind collections owned by specific users
Document count filterAll sizes (dropdown)Filter by number of documents in collectionFocus on collections of specific sizes
Date range filterAll dates (date picker)Filter by collection creation/modification dateFind collections from specific time periods

Import options​

The following option applies only to collection imports:

OptionDefaultDescriptionUse case
Preserve Document StatusDisabled (toggle off)Retains agent_only status from source documents instead of applying the selected ingest mode.Maintain agent_only distinction when importing mixed-status collections.
tip

The Preserve Document Status toggle only preserves agent_only status. Documents with other statuses (such as failed or canceled) use the selected ingest mode.

Python SDK example​

You can import a collection with preserve_document_status using the h2oGPTe Python client library:

job = client.import_collection_into_collection(
collection_id="<target_collection_id>",
src_collection_id="<source_collection_id>",
preserve_document_status=True,
)
info

For document processing options, see the Shared Document Processing Options section in the main documentation.


Feedback