Conversations
Conversations
Manage conversations used by agent tasks.
The conversation object groups agent tasks. Create a conversation first, then attach agent tasks by passing that conversationId when you create a session. Passing an unknown conversationId fails. The title is set from the first attached agent task that has a query.
Use List conversations to list all conversations, and Search conversations to filter by metadata.
The conversation object
| Attribute | Type | Description |
|---|---|---|
id | string | The unique identifier of the conversation. Prefixed with cnv_. |
createdAt | string | When the conversation was created. |
title | string | Conversation title. Null until the first attached agent task with a query sets it. |
metadata | object | Custom key-value metadata for the conversation. |