Cassandra

Bundles 包含支援特定第三方整合的自訂Components，與 AgentBuilder 搭配使用。

此頁面描述 Cassandra bundle 中可用的Components，包括讀取和寫入 Apache Cassandra 叢集的Components，例如 OSS Cassandra 和 Astra DB 資料庫。

Cassandra 向量儲存

使用 Cassandra Components透過 CassandraVectorStore 實例讀取或寫入基於 Cassandra 的向量儲存。

關於向量儲存實例

Because AgentBuilder is based on LangChain, vector store components use an instance of LangChain vector store to drive the underlying read and write functions. These instances are provider-specific and configured according to the component's parameters, such as the connection string, index name, and schema.

In component code, this is often instantiated as vector_store, but some vector store components use a different name, such as the provider name.

Some LangChain classes don't expose all possible options as component parameters. Depending on the provider, these options might use default values or allow modification through environment variables, if they are supported in AgentBuilder. For information about specific options, see the LangChain API reference and vector store provider's documentation.

如果您使用向量儲存Components查詢您的向量資料庫，它會產生搜尋結果，您可以將其作為 Data 物件清單或表格 DataFrame 傳遞給FLOW中的下游Components。 如果支援兩種類型，您可以在視覺編輯器中向量儲存Components的輸出連接埠附近設定格式。

tip

如需在 Flow中使用向量資料庫的教學，請參閱建立向量 RAG 聊天機器人。

Cassandra 參數

您可以檢查向量儲存Components的參數，以了解它接受的輸入、支援的功能以及如何配置它。

某些參數在視覺編輯器中預設為隱藏。 您可以透過 Components的標頭選單 中的 Controls 修改所有參數。

某些參數是條件性的，只有在您設定其他參數或為其他參數選取特定選項後才可用。 條件參數在您設定所需的依賴項之前，可能不會在 Controls 窗格中顯示。

如需接受值和功能的資訊，請參閱 Cassandra 中的向量搜尋 或檢查Components程式碼。

Name	Type	Description
database_ref	String	輸入參數。資料庫的聯絡點或 Astra 資料庫 ID。
username	String	輸入參數。資料庫的使用者名稱。Astra DB 請留空。
token	SecretString	輸入參數。資料庫的使用者密碼或 Astra 應用程式權杖。
keyspace	String	輸入參數。包含 Table Name (table_name) 中指定向量儲存的金鑰空間名稱。
table_name	String	輸入參數。作為向量儲存的資料表或集合名稱。
ttl_seconds	Integer	輸入參數。新增文字的存活時間（如果叢集支援）。僅與寫入相關。
batch_size	Integer	輸入參數。在單一批次中處理的記錄數量。
setup_mode	String	輸入參數。設定 Cassandra 資料表的配置模式。
cluster_kwargs	Dict	輸入參數。Cassandra 叢集的額外關鍵字引數。
search_query	String	輸入參數。相似性搜尋的查詢字串。僅與讀取相關。
ingest_data	Data	輸入參數。要作為原始區塊和嵌入載入到向量儲存的資料。僅與寫入相關。
embedding	Embeddings	輸入參數。要使用的嵌入函數。
number_of_results	Integer	輸入參數。搜尋中要返回的結果數量。僅與讀取相關。
search_type	String	輸入參數。要執行的搜尋類型。僅與讀取相關。
search_score_threshold	Float	輸入參數。搜尋結果的最小相似性分數。僅與讀取相關。
search_filter	Dict	輸入參數。除了向量搜尋之外要套用的可選中繼資料搜尋篩選器字典。僅與讀取相關。
body_search	String	輸入參數。文件文字搜尋詞彙。僅與讀取相關。
enable_body_search	Boolean	輸入參數。啟用本文搜尋的旗標。僅與讀取相關。

Cassandra Chat Memory

Cassandra Chat Memory Components使用基於 Apache Cassandra 的資料庫檢索和儲存聊天訊息。

聊天記憶體作為 Memory 資料類型在記憶體儲存Components之間傳遞。 具體來說，此Components建立 CassandraChatMessageHistory 的實例，這是一個使用 Cassandra 資料庫進行儲存的 LangChain 聊天訊息歷史記錄類別。

如需在 Flow中使用外部聊天記憶體的詳細資訊，請參閱 Message History Components。

Cassandra Chat Memory 參數

某些參數在視覺編輯器中預設為隱藏。 您可以透過 Components的標頭選單 中的 Controls 修改所有參數。

Name	Type	Description
database_ref	MessageText	輸入參數。Cassandra 資料庫的聯絡點或 Astra DB 資料庫 ID。必要。
username	MessageText	輸入參數。Cassandra 的使用者名稱。Astra DB 請留空。
token	SecretString	輸入參數。Cassandra 的密碼或 Astra DB 的權杖。必要。
keyspace	MessageText	輸入參數。Cassandra 中的金鑰空間或 Astra DB 中的命名空間。必要。
table_name	MessageText	輸入參數。儲存訊息的資料表或集合名稱。必要。
session_id	MessageText	輸入參數。聊天工作階段的唯一識別碼。可選。
cluster_kwargs	Dictionary	輸入參數。Cassandra 叢集配置的額外關鍵字引數。可選。

Cassandra Graph

Cassandra Graph Components使用 CassandraGraphVectorStore（LangChain 圖形向量儲存的實例），用於在相容的基於 Cassandra 的叢集中進行圖形遍歷和基於圖形的文件檢索。 它也支援寫入向量儲存。

如果您使用向量儲存Components查詢您的向量資料庫，它會產生搜尋結果，您可以將其作為 Data 物件清單或表格 DataFrame 傳遞給FLOW中的下游Components。 如果支援兩種類型，您可以在視覺編輯器中向量儲存Components的輸出連接埠附近設定格式。

Cassandra Graph 參數

某些參數在視覺編輯器中預設為隱藏。 您可以透過 Components的標頭選單 中的 Controls 修改所有參數。

Name	Display Name	Info
database_ref	Contact Points / Astra Database ID	輸入參數。資料庫的聯絡點或 Astra 資料庫 ID。必要。
username	Username	輸入參數。資料庫的使用者名稱。Astra DB 請留空。
token	Password / Astra DB Token	輸入參數。資料庫的使用者密碼或 Astra 應用程式權杖。必要。
keyspace	Keyspace	輸入參數。包含 Table Name (table_name) 中指定向量儲存的金鑰空間名稱。必要。
table_name	Table Name	輸入參數。作為向量儲存的資料表或集合名稱。必要。
setup_mode	Setup Mode	輸入參數。設定 Cassandra 資料表的配置模式。選項為 Sync（預設）或 Off。
cluster_kwargs	Cluster arguments	輸入參數。Cassandra 叢集的額外關鍵字引數的可選字典。
search_query	Search Query	輸入參數。相似性搜尋的查詢字串。僅與讀取相關。
ingest_data	Ingest Data	輸入參數。要作為原始區塊和嵌入載入到向量儲存的資料。僅與寫入相關。
embedding	Embedding	輸入參數。要使用的嵌入模型。
number_of_results	Number of Results	輸入參數。相似性搜尋中要返回的結果數量。僅與讀取相關。預設：4。
search_type	Search Type	輸入參數。要使用的搜尋類型。選項為 Traversal（預設）、MMR Traversal、Similarity、Similarity with score threshold 或 MMR (Max Marginal Relevance)。
depth	Depth of traversal	輸入參數。要遍歷的邊緣的最大深度。僅當 Search Type (search_type) 為 Traversal 或 MMR Traversal 時相關。預設：1。
search_score_threshold	Search Score Threshold	輸入參數。搜尋結果的最小相似性分數閾值。僅與使用 Similarity with score threshold 搜尋類型的讀取相關。
search_filter	Search Metadata Filter	輸入參數。除了圖形遍歷和相似性搜尋之外要套用的可選中繼資料搜尋篩選器字典。

另請參閱

• DataStax bundle