Skip to content

OpenAIConversationsSession

Interface representing a persistent session store for conversation history.

new OpenAIConversationsSession(options?): OpenAIConversationsSession;
Parameter Type

options?

OpenAIConversationsSessionOptions

OpenAIConversationsSession

get sessionId(): string | undefined;

string | undefined

addItems(items): Promise<void>;

Append new items to the conversation history.

Parameter Type Description

items

AgentInputItem[]

Items to add to the session history.

Promise<void>

Session.addItems


clearSession(): Promise<void>;

Remove all items that belong to the session and reset its state.

Promise<void>

Session.clearSession


getItems(limit?): Promise<AgentInputItem[]>;

Retrieve items from the conversation history.

Parameter Type Description

limit?

number

The maximum number of items to return. When provided the most recent limit items should be returned in chronological order.

Promise<AgentInputItem[]>

Session.getItems


getSessionId(): Promise<string>;

Ensure and return the identifier for this session.

Promise<string>

Session.getSessionId


popItem(): Promise<
| AgentInputItem
| undefined>;

Remove and return the most recent item from the conversation history if it exists.

Promise< | AgentInputItem | undefined>

Session.popItem