Zep AI icon

Zep AI

AI Tool for interacting with Zep memory and knowledge graph. Provides operations to store/retrieve conversation memory, search knowledge graphs, and manage user context.

Actions9

Overview

The "Add Data to Graph" operation of the Zep AI node allows users to add structured or unstructured data into a knowledge graph. This is useful for enriching a knowledge base with new information that can later be searched, analyzed, or linked with other data points. Typical scenarios include:

  • Adding textual notes or JSON-formatted data related to a user or a specific graph.
  • Feeding messages or conversational data into the knowledge graph for context-aware AI applications.
  • Incrementally building a knowledge graph by adding relevant facts and entities.

For example, a customer support system could use this operation to add chat transcripts or user feedback into a knowledge graph, enabling better search and retrieval of past interactions.

Properties

Name Meaning
User ID The unique identifier of the user associated with the data being added.
Graph ID The ID of the knowledge graph to which the data will be added. Optional; if not provided, the user's default graph is used.
Data The actual content to add to the knowledge graph. Can be text, JSON, or message format.
Data Type Specifies the format of the data being added. Options: Text, JSON, Message.

Output

The output JSON object includes:

  • success: Boolean indicating if the data was successfully added.
  • dataAdded: The original data string that was added.
  • dataType: The type of data added (text, json, or message).
  • response: The full response from the API call, typically containing details about the stored data or confirmation.

This node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating requests to the Zep AI service.
  • The node makes HTTP requests to the Zep API endpoint at https://api.getzep.com/api/v2/graph.
  • Proper network connectivity to the Zep API is necessary.

Troubleshooting

  • Error: "Either Graph ID or User ID must be provided"
    This error occurs if neither a Graph ID nor a User ID is specified. To fix it, provide at least one of these identifiers so the node knows where to add the data.

  • Invalid JSON in Data
    If you select "JSON" as the Data Type, ensure the data string is valid JSON. Malformed JSON will cause the API request to fail.

  • Authentication Errors
    Ensure the API key credential is correctly configured and has the necessary permissions.

  • Network Issues
    Verify that your environment can reach https://api.getzep.com. Firewall or proxy restrictions may block access.

Links and References

Discussion