Users

​

Overview

Users in Julep represent the entities interacting with your AI agents. These can be real people or other systems that require automated responses from an agent. Managing users effectively allows for personalized and contextual interactions, ensuring that each user’s preferences and history are maintained across sessions.

​

Components

Users are comprised of several key components that facilitate their interaction with agents and sessions:

• Name: The identifier for the user.
• About: Additional information describing the user.
• Metadata: Customizable key-value pairs that store user-specific data, preferences, and other relevant information.

​

Users configuration options

When creating a user, the following attributes can be specified:

​

Creating a User

You can create a user using Julep’s SDKs in Python or JavaScript. Below are examples demonstrating how to create a user.

from julep import Julep

client = Julep(api_key="your_api_key")

user = client.users.create(
    name="John Doe",
    project="university-assistant",
    about="A 21-year-old man who is a student at MIT.",
    metadata={
        "email": "john.doe@example.com",
        "preferences": {
            "language": "en",
            "timezone": "UTC"
        }
    }
)

print(f"Created user: {user.id}")

​

Managing Users

Once users are created, you can perform various operations such as retrieving, updating, and deleting user profiles.

​

Retrieving Users

Retrieve user information individually or as a list.

# Get a user by ID
user = client.users.get(user_id="user_id_here")
print(user)

# List all users
users = client.users.list()
for user in users:
    print(user)

​

Updating Users

Update user details or specific fields within the user profile.

# Update user metadata
updated_user = client.users.update(
    user_id="user_id_here",
    metadata={
        "preferences": {
            "language": "es",
            "notifications_enabled": True
        }
    }
)

print(f"Updated user: {updated_user.id}")

​

Deleting Users

Remove users from your system when they are no longer needed.

# Delete a single user
client.users.delete(user_id="user_id_here")

​

Relationship to Other Concepts

​

Projects

Users belong to exactly one project, which helps organize related resources together. When creating a user, you can specify which project it belongs to using the project parameter. If not specified, the user will be assigned to the “default” project.

Example:

# Create a user in a specific project
user = client.users.create(
    name="Marketing User",
    project="marketing-campaign"
)

For more information about projects, see Projects.

​

Sessions

Users interact with agents through sessions, which maintain the context and history of conversations. Each session is associated with a single user and an agent, ensuring that interactions are personalized and relevant.

Example:

client = Julep(api_key="YOUR_API_KEY")
user = client.users.create(name="Alice", about="An avid reader.")
agent = client.agents.create(name="BookBot", about="Helps find and recommend books.")
session = client.sessions.create(agent=agent.id, user=user.id)

​

Agents

While users represent the entities interacting with your system, agents are the AI-powered entities that respond to user interactions. Agents can have access to user data to provide personalized and context-aware responses.

Example:

agent = client.agents.create(
    name="SupportBot",
    about="Assists customers with their inquiries.",
    model="gpt-4"
)

user = client.users.create(name="Bob", about="A customer with recent purchases.")
session = client.sessions.create(agent=agent.id, user=user.id)

​

Best Practices

​

Next Steps

• Sessions - Learn how to manage sessions and maintain conversation context.
• Agents - Learn how to manage agents and create personalized interactions.
• Tasks - Learn how to manage tasks and create automated workflows.