Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lyzr.ai/llms.txt

Use this file to discover all available pages before exploring further.

The get_messages() method retrieves the original conversation messages stored via add(). Unlike get() which returns extracted memory records, this returns the raw user/assistant message pairs.

​
Basic Usage

from lyzr import Cognis

cog = Cognis()

messages = cog.get_messages(
    owner_id="user_alice",
    session_id="sess_001",
)
for msg in messages.get("messages", []):
    print(f"[{msg['role']}] {msg['content']}")

​
Parameters

ParameterTypeDefaultDescription
owner_idstrNoneUser/tenant scope
session_idstrNoneSession scope
agent_idstrNoneAgent scope
limitintNoneMax messages to return
latestboolFalseReturn only the most recent messages
cross_sessionboolFalseInclude messages from all sessions

​
Use Cases

Conversation replay — Show a user their previous conversation: 
messages = cog.get_messages(
    owner_id="user_alice",
    session_id="sess_001",
    limit=50,
)
Latest context — Get the most recent messages for prompt injection: 
messages = cog.get_messages(
    owner_id="user_alice",
    session_id="sess_001",
    latest=True,
    limit=10,
)
Cross-session history — Pull messages from all sessions: 
messages = cog.get_messages(
    owner_id="user_alice",
    cross_session=True,
    limit=100,
)

​
Async

messages = await cog.aget_messages(owner_id="user_alice", session_id="sess_001")
get_messages() is hosted-only. In the open-source lyzr-cognis package, raw messages are stored in SQLite and accessible via get_context() as part of the short-term memory.