Actions20
Overview
This node integrates with the Zep AI Memory Service to manage sessions, users, collections, documents, and memory data. Specifically, for the Session - Create operation, it allows you to create a new session by providing a unique session ID, optionally associating it with a user ID, and attaching additional metadata.
Common scenarios where this node is beneficial include:
- Creating and managing conversational sessions in AI chatbots or virtual assistants.
- Tracking user interactions over time by associating sessions with user IDs.
- Storing contextual metadata about sessions for analytics or personalized experiences.
For example, you might use this node to start a new chat session when a user initiates a conversation, passing along the session ID and user ID to keep track of the dialogue context.
Properties
| Name | Meaning |
|---|---|
| Session ID | The unique identifier for the session. |
| User ID | (Optional) The user ID to associate with the session. |
| Metadata | (Optional) Additional metadata as a JSON object to store extra information about session. |
Output
The node outputs JSON data representing the created session as returned by the Zep AI Memory Service API. This typically includes details such as the session ID, associated user ID, metadata, timestamps, and any other relevant session information.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Zep AI Memory Service.
- The node configuration must include the base URL of the Zep API and the API key.
- Network access to the Zep AI Memory Service endpoint is necessary.
Troubleshooting
- Invalid or missing session ID: The session ID is required; ensure it is provided and unique.
- Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Malformed metadata JSON: If metadata is provided, it must be valid JSON; otherwise, the request will fail.
- API connectivity issues: Check network connectivity and the correctness of the base URL.
If the node throws an error related to HTTP requests, inspect the error message for clues such as unauthorized access, bad request formatting, or server errors.
Links and References
- Zep AI Memory Service API Documentation (example link, replace with actual if available)
- n8n documentation on Creating Custom Nodes