Conversation

Source: 10_conversation.py · 10-conversation.ts

agent.conversation() returns a Conversation object that tracks message history across turns. Each .send() (or .stream()) call sees prior context automatically, so you don’t manage the items array yourself.

Multi-turn

agent = Agent(name="note-assistant", instructions="...", tools=[save_note, list_notes])

conv = agent.conversation()

await conv.send("My name is Alice. Remember that.")
await conv.send("Save a note: buy groceries")
r = await conv.send("What's my name, and what notes have I saved?")

print(r.output)             # references Alice and the note
print(len(conv.get_items()))  # full message history

const agent = new Agent({ name: "note-assistant", instructions: "...", tools: [saveNote, listNotes] });

const conv = agent.conversation();

await conv.send("My name is Alice. Remember that.");
await conv.send("Save a note: buy groceries");
const r = await conv.send("What's my name, and what notes have I saved?");

console.log(r.output);
console.log(conv.getItems().length);

Streaming inside a conversation

conv.stream(input) works the same as agent.stream(input), but the conversation accumulates the streamed turn into its history once .result() resolves.

stream = conv.stream("Summarize everything we discussed.")
async for event in stream:
    if event.type == "text_delta":
        print(event.text, end="", flush=True)
result = await stream.result()

Resetting

conv.clear() empties the history and starts fresh. There is no built-in persistence, so serialize conv.get_items() / conv.getItems() yourself if you need to resume across processes.

Getting Started

Patterns

Legacy

Conversation

Multi-turn

Streaming inside a conversation

Resetting

​Multi-turn

​Streaming inside a conversation

​Resetting

Multi-turn

Streaming inside a conversation

Resetting