Skip to content
Nappai Documentation

Astra DB Chat Memory

This component acts as a secure storage space for your chat history within Nappai. It uses Astra DB to save your conversations, making them easily accessible and persistent. Think of it as a reliable record-keeper for all your interactions.

Relationship with Astra DB

This component directly interacts with your Astra DB database to save and retrieve chat messages. It needs your Astra DB credentials to connect and securely access your data.

Inputs

  • Collection Name: The name of the location (like a folder) in Astra DB where your chat messages will be saved. You’ll need to create this location beforehand in your Astra DB account.
  • Astra DB Application Token: This is a special code that allows Nappai to securely access your Astra DB account. Think of it as a password for your database. A default value is provided, but you might need to change it to your own token.
  • API Endpoint: This is the web address where Nappai connects to your Astra DB. A default value is provided, but you might need to change it to your own endpoint.
  • Namespace (Advanced): An optional extra layer of organization within Astra DB. You can leave this blank unless you have a specific need for it.
  • Session ID (Advanced): A unique identifier for a specific chat session. You can usually leave this blank unless you need to manage multiple conversations separately.

Outputs

This component doesn’t directly produce output variables you’ll see in the dashboard. Instead, it quietly saves and retrieves chat messages from Astra DB, making them available to other parts of Nappai. Other components will use this stored information.

Usage Example

Imagine you’re building a chatbot in Nappai. You’d use this component to store each message exchanged between the user and the bot. Later, you could use another component to retrieve this history to provide context for future interactions.

Templates

This component can be used in various Nappai workflows, including those involving chatbots and conversational AI. Specific template examples are not yet available.

  • Chat Memory: This component provides alternative ways to store chat history, potentially using different databases or methods.
  • Store Message: This component is used to send chat messages to the Astra DB Chat Memory component for storage.
  • Retrieval QA History: This component uses stored chat history to answer questions.
  • Runnable With Message History: This component executes actions using the stored chat history.
  • Tool Calling Agent: This component uses tools, potentially leveraging the chat history stored by this component.

Tips and Best Practices

  • Create your Astra DB collection first: Before using this component, make sure you’ve created the specified “Collection Name” in your Astra DB account.
  • Keep your Astra DB Application Token secure: This token grants access to your database. Do not share it with anyone.
  • Use meaningful Collection Names: Choose names that clearly identify the purpose of the stored chat data.

Security Considerations

  • Protect your Astra DB Application Token: This token is crucial for security. Treat it like a password and never expose it publicly.
  • Use strong passwords and regularly update them: Ensure your Astra DB account uses strong and regularly updated passwords. This protects your data from unauthorized access.