Create Conversation

conversations.create() -> Conversation

post/v1/conversations/

Create a new conversation for an agent.

ParametersExpand Collapse

agent_id: str

The agent ID to create a conversation for

summary: Optional[str]

A summary of the conversation.

ReturnsExpand Collapse

class Conversation: …

Represents a conversation on an agent for concurrent messaging.

id: str

The unique identifier of the conversation.

agent_id: str

The ID of the agent this conversation belongs to.

created_at: Optional[datetime]

The timestamp when the object was created.

formatdate-time

created_by_id: Optional[str]

The id of the user that made this object.

in_context_message_ids: Optional[List[str]]

The IDs of in-context messages for the conversation.

last_updated_by_id: Optional[str]

The id of the user that made this object.

summary: Optional[str]

A summary of the conversation.

updated_at: Optional[datetime]

The timestamp when the object was last updated.

formatdate-time

Create Conversation

import os
from letta_client import Letta

client = Letta(
    api_key=os.environ.get("LETTA_API_KEY"),  # This is the default and can be omitted
)
conversation = client.conversations.create(
    agent_id="agent_id",
)
print(conversation.id)

{
  "id": "id",
  "agent_id": "agent_id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by_id": "created_by_id",
  "in_context_message_ids": [
    "string"
  ],
  "last_updated_by_id": "last_updated_by_id",
  "summary": "summary",
  "updated_at": "2019-12-27T18:11:19.117Z"
}

Returns Examples

{
  "id": "id",
  "agent_id": "agent_id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by_id": "created_by_id",
  "in_context_message_ids": [
    "string"
  ],
  "last_updated_by_id": "last_updated_by_id",
  "summary": "summary",
  "updated_at": "2019-12-27T18:11:19.117Z"
}