Class: Conversation

TypeScript SDK reference

weave / Conversation

A Conversation groups Turns under a single gen_ai.conversation.id. It is not itself an OTel span — children stamp the conversation id onto theirs.

Table of contents

Accessors

• agentName
• attributes
• conversationId
• model
• sessionId

Methods

• end
• startTurn
• create

Accessors

agentName

• get agentName(): string

Returns

string

Defined in

src/genai/conversation.ts:94

---

attributes

• get attributes(): Attributes

Returns

Attributes

Defined in

src/genai/conversation.ts:106

---

conversationId

• get conversationId(): string

Returns

string

Defined in

src/genai/conversation.ts:102

---

model

• get model(): string

Returns

string

Defined in

src/genai/conversation.ts:98

---

sessionId

Deprecated. Use Conversation.conversationId instead.

• get sessionId(): string

Returns

string

Defined in

src/genai/conversation.ts:111

Methods

end

▸ end(opts?): void

Parameters

Name	Type
opts?	SpanEndOptions

Returns

void

Defined in

src/genai/conversation.ts:168

---

startTurn

▸ startTurn(opts?): Turn

Start a new Turn under this Conversation. The turn inherits the conversation’s conversationId; agentName, agentId, agentDescription, agentVersion and model fall back to the conversation’s values when not provided on opts.

Parameters

Name	Type
opts	TurnInit

Returns

Turn

Example

const turn = conversation.startTurn();

Example

const turn = conversation.startTurn({
  model: 'gpt-4o',
  agentName: 'research-bot',
  agentId: 'research-bot-prod',
  agentDescription: 'Looks up facts on Wikipedia.',
  agentVersion: '1.4.2',
  userMessage: 'What is the weather in Tokyo?',
  systemInstructions: ['You are a helpful weather bot.'],
  startTime: new Date('2026-05-29T10:00:00.000Z'),
});

Defined in

src/genai/conversation.ts:156

---

create

▸ create(opts?): Conversation

Parameters

Name	Type
opts	ConversationInit

Returns

Conversation

Defined in

src/genai/conversation.ts:115