Astra DB

DataStax Astra DB is a serverless vector-capable database built on Cassandra and made conveniently available through an easy-to-use JSON API.

This notebook goes over how to use Astra DB to store chat message history.

Setting up

To run this notebook you need a running Astra DB. Get the connection secrets on your Astra dashboard:

• the API Endpoint looks like https://01234567-89ab-cdef-0123-456789abcdef-us-east1.apps.astra.datastax.com;
• the Token looks like AstraCS:6gBhNmsk135....

%pip install --upgrade --quiet  "astrapy>=0.7.1"

Set up the database connection parameters and secrets

import getpass

ASTRA_DB_API_ENDPOINT = input("ASTRA_DB_API_ENDPOINT = ")
ASTRA_DB_APPLICATION_TOKEN = getpass.getpass("ASTRA_DB_APPLICATION_TOKEN = ")

ASTRA_DB_API_ENDPOINT =  https://01234567-89ab-cdef-0123-456789abcdef-us-east1.apps.astra.datastax.com
ASTRA_DB_APPLICATION_TOKEN =  ········

Depending on whether local or cloud-based Astra DB, create the corresponding database connection “Session” object.

Example

from langchain_community.chat_message_histories import AstraDBChatMessageHistory

message_history = AstraDBChatMessageHistory(
    session_id="test-session",
    api_endpoint=ASTRA_DB_API_ENDPOINT,
    token=ASTRA_DB_APPLICATION_TOKEN,
)

message_history.add_user_message("hi!")

message_history.add_ai_message("whats up?")

API Reference:

• AstraDBChatMessageHistory

message_history.messages

[HumanMessage(content='hi!'), AIMessage(content='whats up?')]