Profile Management
Methods for searching, retrieving, and deleting user profiles, plus profile changelog.
Profile Management
search_profiles
Search for user profiles using semantic queries.
response = client.search_profiles(
user_id="user_123",
query="laptop preferences",
threshold=0.7,
top_k=5
)Prop
Type
get_profiles
Retrieve user profiles.
response = client.get_profiles(
user_id="user_123",
top_k=10
)Prop
Type
get_all_profiles
Get profiles across all users (admin operation).
response = client.get_all_profiles(limit=100)Prop
Type
Returns: GetUserProfilesResponse with profiles from all users
Example:
# Get profiles from all users
all_profiles = client.get_all_profiles(limit=50)
# Group by user
from collections import defaultdict
by_user = defaultdict(list)
for profile in all_profiles.user_profiles:
by_user[profile.user_id].append(profile)
for user_id, profiles in by_user.items():
print(f"User {user_id}: {len(profiles)} profiles")
for p in profiles[:3]: # Show first 3
print(f" - {p.content[:50]}...")add_user_profile
Add user profiles directly to storage, bypassing the inference pipeline. Useful for seeding known facts (testing, migration, manual injection). The server populates the embedding automatically.
response = client.add_user_profile(
user_profiles=[
{"user_id": "user_123", "content": "Prefers concise responses"},
]
)Prop
Type
delete_profile
Delete user profiles by ID or search query.
response = client.delete_profile(
user_id,
profile_id="",
search_query="",
wait_for_response=False
)Prop
Type
get_profile_change_log
Retrieve the history of profile changes.
logs = client.get_profile_change_log()Bulk Delete Operations
delete_profiles_by_ids
Delete multiple profiles by their IDs.
response = client.delete_profiles_by_ids(profile_ids=["prof_1", "prof_2"])Prop
Type
Returns: BulkDeleteResponse with success, deleted_count, and message
delete_all_profiles
Delete all profiles.
response = client.delete_all_profiles()Returns: BulkDeleteResponse with success, deleted_count, and message