Skip to content

agentcore_cli.utils.session_utils

agentcore_cli.utils.session_utils

Session utilities for AgentCore CLI.

generate_session_id(prefix=None)

Generate a unique session ID for agent runtime invocations.

Parameters:

Name Type Description Default
prefix str | None

Optional prefix to add to the session ID.

 None

Returns:

Name Type Description
str str

A string of at least 33 characters as required by AgentCore.
Source code in agentcore_cli/utils/session_utils.py
Python
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
def generate_session_id(prefix: str | None = None) -> str:
    """Generate a unique session ID for agent runtime invocations.

    Args:
        prefix: Optional prefix to add to the session ID.

    Returns:
        str: A string of at least 33 characters as required by AgentCore.
    """
    # Prefix with timestamp for sortability
    timestamp = int(datetime.now().timestamp())

    # Use UUID4 for uniqueness (36 chars)
    unique_id = str(uuid.uuid4())

    # Add custom prefix if provided
    if prefix:
        # Combine for a session ID that's guaranteed to be > 33 chars
        return f"{prefix}-{timestamp}-{unique_id}"

    # Combine for a session ID that's guaranteed to be > 33 chars
    return f"{timestamp}-{unique_id}"