Skip to navigation
Solutions

Enterprise context graphs

Unify business data and documents into shared context for agents

An agent can fail a task when the required business context is split across documents and operational systems. An enterprise Context Graph combines related data into shared context that authorized agents and applications can retrieve.

Use this solution for projects, products, policies, operations, cases, and other business domains that are not owned by one application user.

Choose the graph scope

Create one Context Graph for each subject and access boundary. Store the uuid that graph.create returns, and use it as the graph_uuid in later calls. Do not put unrelated subjects or data with different access requirements in one graph.

Examples include:

  • One graph for a project or customer account.
  • One graph for a product and its support knowledge.
  • One graph for an operational domain, such as incident response.
  • Separate graphs for business units that have different access policies.

Implementation path

1

Create and describe the Context Graph

Create a graph with a name and a description. Store the graph UUID in your application. The description helps an agent or application select the correct graph.

2

Ingest business data and documents

Add text, JSON, messages, or document chunks with graph.episode.add. Use zep-ingest for a backfill or a recurring bulk import.

3

Shape the graph for the domain

Use custom entity and edge types when the application must retrieve domain-specific objects and relationships.

4

Give the agent retrieval tools

Wrap the graph search methods, node lists, and neighbor lists as tools. The application pins the graph_uuid and the access filters. The agent plans its retrieval and calls the tools. See Build an Agent with Zep and Build Tools for an Agent. To ground a conversational turn in one low-latency call, use graph.get_context.

5

Apply governance

Use policy-based access control to limit graph access. Use source episodes for provenance and API Logs for supported request-audit workflows.

The Give Your Agent Domain Knowledge guide contains a complete SDK example for graph creation, ingestion, and search.

Application responsibilities

Zep returns context from the graphs that the caller can access. Your application must select the correct graph scope, treat retrieved data according to its trust level, and authorize any external action separately.