list_conversations
Read-only
Retrieve paginated conversation history from agents with metadata. Filter by agent ID or date range. Ideal for reviewing previous interactions and analyzing conversation patterns.
Instructions
Lists agent conversations. Returns: conversation list with metadata. Use when: asked about conversation history.
Args:
agent_id (str, optional): Filter conversations by specific agent ID
cursor (str, optional): Pagination cursor for retrieving next page of results
call_start_before_unix (int, optional): Filter conversations that started before this Unix timestamp
call_start_after_unix (int, optional): Filter conversations that started after this Unix timestamp
page_size (int, optional): Number of conversations to return per page (1-100, defaults to 30)
max_length (int, optional): Maximum character length of the response text (defaults to 10000)Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | No | ||
| cursor | No | ||
| call_start_before_unix | No | ||
| call_start_after_unix | No | ||
| page_size | No | ||
| max_length | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| text | Yes | ||
| annotations | No | ||
| _meta | No |