Index Operations

Learn how to add memories to different indexes, perform basic operations, and organize your memory structure using common patterns and naming conventions.

Adding to Different Indexes

Python SDK
JavaScript SDK

from gravixlayer import GravixLayer

client = GravixLayer()
memory = client.memory

# Add to different indexes
memory.add("User works as a software engineer", user_id="alice")  # Default index
memory.add("User prefers dark mode", user_id="alice", index_name="user_preferences")
memory.add("User uses Python daily", user_id="alice", index_name="work_info")

# Search in specific index
work_results = memory.search("programming", user_id="alice", index_name="work_info")
print(f"Work memories: {len(work_results['results'])}")

# List available indexes
indexes = memory.list_available_indexes()
print(f"Available indexes: {indexes}")

import { GravixLayer } from 'gravixlayer';

const client = new GravixLayer();
const memory = client.memory;

// Add to different indexes
await memory.add("User works as a software engineer", "alice");  // Default index
await memory.add("User prefers dark mode", "alice", { indexName: "user_preferences" });
await memory.add("User uses Python daily", "alice", { indexName: "work_info" });

// Search in specific index
const workResults = await memory.search("programming", "alice", { indexName: "work_info" });
console.log(`Work memories: ${workResults.results.length}`);

// List available indexes
const indexes = await memory.listAvailableIndexes();
console.log(`Available indexes: ${indexes}`);

Searching Specific Indexes

Target your searches to specific indexes for better performance and more relevant results:

Python SDK
JavaScript SDK

# Search only in work-related memories
work_results = memory.search("programming skills", user_id="alice", index_name="work_info")
print(f"Work-related memories: {len(work_results['results'])}")

# Search only in preferences
pref_results = memory.search("settings", user_id="alice", index_name="user_preferences")
print(f"Preference memories: {len(pref_results['results'])}")

# Search in default index (comprehensive)
all_results = memory.search("user information", user_id="alice")
print(f"All memories: {len(all_results['results'])}")

// Search only in work-related memories
const workResults = await memory.search("programming skills", "alice", { indexName: "work_info" });
console.log(`Work-related memories: ${workResults.results.length}`);

// Search only in preferences
const prefResults = await memory.search("settings", "alice", { indexName: "user_preferences" });
console.log(`Preference memories: ${prefResults.results.length}`);

// Search in default index (comprehensive)
const allResults = await memory.search("user information", "alice");
console.log(`All memories: ${allResults.results.length}`);

Managing Index Lists

Python SDK
JavaScript SDK

# List all available indexes
indexes = memory.list_available_indexes()
print(f"Available indexes: {indexes}")

# Get memories from specific index
work_memories = memory.get_all(user_id="alice", index_name="work_info")
print(f"Work memories count: {len(work_memories['results'])}")

# Get current configuration
config = memory.get_current_configuration()
print(f"Current index: {config.get('index_name', 'gravixlayer_memories')}")

// List all available indexes
const indexes = await memory.listAvailableIndexes();
console.log(`Available indexes: ${indexes}`);

// Get memories from specific index
const workMemories = await memory.getAll("alice", { indexName: "work_info" });
console.log(`Work memories count: ${workMemories.results.length}`);

// Get current configuration
const config = await memory.getCurrentConfiguration();
console.log(`Current index: ${config.indexName || 'gravixlayer_memories'}`);

Common Index Patterns

Index Name	Purpose	Example Memories
`user_preferences`	Settings, UI preferences	”Dark mode”, “Language: Spanish”, “Notifications off”
`work_info`	Job, skills, projects	”Software engineer”, “Uses Python”, “Works remotely”
`conversation_history`	Chat logs, interactions	”Asked about weather”, “Discussed movies”
`personal_info`	Basic user data	”Lives in NYC”, “Age 25”, “Married”
`food_preferences`	Dietary info, likes/dislikes	”Vegetarian”, “Allergic to nuts”, “Loves Italian food”
`health_info`	Medical, fitness data	”Exercises daily”, “Takes vitamin D”, “Allergic to peanuts”

Use Case Examples

E-commerce Application

customer_preferences    # Shopping preferences, brands
purchase_history       # Past orders, favorite products  
support_interactions   # Customer service conversations

Content Platform

content_preferences    # Genres, topics of interest
viewing_history       # Watched/read content
social_interactions   # Comments, likes, shares

Productivity App

work_projects         # Current and past projects
meeting_notes         # Meeting summaries and action items
personal_tasks        # Personal reminders and goals

Index Naming Conventions

Good Naming Practices:

Use descriptive, clear names: user_preferences not prefs
Use underscores for separation: conversation_history not conversationhistory
Be consistent with pluralization: user_preferences, work_projects
Include context when needed: customer_support_tickets not just tickets

Avoid:

Generic names: data, info, stuff
Abbreviations: usr_prefs, conv_hist
Special characters: user-preferences, work@info
Very long names: user_application_specific_preferences_and_settings

Organizing by User Context

Python SDK
JavaScript SDK

from gravixlayer import GravixLayer

client = GravixLayer()
memory = client.memory

# Organize by user role
memory.add("Admin access granted", user_id="alice", index_name="admin_permissions")
memory.add("Can edit user profiles", user_id="alice", index_name="admin_permissions")

# Organize by application context
memory.add("Prefers email notifications", user_id="alice", index_name="notification_settings")
memory.add("Dark theme enabled", user_id="alice", index_name="ui_preferences")

# Organize by data sensitivity
memory.add("Lives in San Francisco", user_id="alice", index_name="personal_info")
memory.add("Works at TechCorp", user_id="alice", index_name="professional_info")

import { GravixLayer } from 'gravixlayer';

const client = new GravixLayer();
const memory = client.memory;

// Organize by user role
await memory.add("Admin access granted", "alice", { indexName: "admin_permissions" });
await memory.add("Can edit user profiles", "alice", { indexName: "admin_permissions" });

// Organize by application context
await memory.add("Prefers email notifications", "alice", { indexName: "notification_settings" });
await memory.add("Dark theme enabled", "alice", { indexName: "ui_preferences" });

// Organize by data sensitivity
await memory.add("Lives in San Francisco", "alice", { indexName: "personal_info" });
await memory.add("Works at TechCorp", "alice", { indexName: "professional_info" });

Introduction

AI Inference

Files

Vectors

Memory

AgentBox

Integrations

Policies

Index Operations

Adding to Different Indexes

Searching Specific Indexes

Managing Index Lists

Use Case Examples

E-commerce Application

Content Platform

Productivity App

Index Naming Conventions

Organizing by User Context

Introduction

AI Inference

Files

Vectors

Memory

AgentBox

Integrations

Policies

​Adding to Different Indexes

​Searching Specific Indexes

​Managing Index Lists

​

​Use Case Examples

​E-commerce Application

​Content Platform

​Productivity App

​Index Naming Conventions

​Organizing by User Context

Adding to Different Indexes

Searching Specific Indexes

Managing Index Lists

Use Case Examples

E-commerce Application

Content Platform

Productivity App

Index Naming Conventions

Organizing by User Context