Commands
agent-conversation
List and view agent conversations
Commands
Section titled “Commands”sentry agent-conversation list [<org/project>]
Section titled “sentry agent-conversation list [<org/project>]”List recent agent conversations
Arguments:
| Argument | Description |
|---|---|
[<org/project>] |
<org>/ (all projects), <org>/<project>, or <project> (search) |
Options:
| Option | Description |
|---|---|
-n, --limit <limit> |
Number of conversations (1-1000) (default: "25") |
-q, --query <query> |
Any matching span selects its conversation; totals include all spans in selected projects and time range |
-s, --sort <sort> |
One conversation field; prefix - for descending (default: -conversation.age; ID breaks ties) |
-t, --period <period> |
Time range: "7d", "2024-01-01..2024-02-01", ">=2024-01-01" (default: "7d") |
-f, --fresh |
Bypass cache, re-detect projects, and fetch fresh data |
-c, --cursor <cursor> |
Navigate pages: "next", "prev", "first" (or raw cursor string) |
Examples:
# List recent agent conversationssentry agent-conversation list
# Explicit organization (all projects)sentry agent-conversation list my-org/
# One projectsentry agent-conversation list my-org/my-project
# Find a project across organizationssentry agent-conversation list my-project
# Show more, last 24 hourssentry agent-conversation list --limit 50 --period 24h
# Sort by highest error countsentry agent-conversation list --sort -conversation.errors
# Sort by lowest total costsentry agent-conversation list --sort conversation.totalCost
# Find conversations with errorssentry agent-conversation list -q "conversation.errors:>0"
# Find conversations for an agentsentry agent-conversation list -q "gen_ai.agent.name:my-agent"
# Find conversations with more than two tool callssentry agent-conversation list -q "conversation.toolCalls:>2"
# Find conversations that used a toolsentry agent-conversation list -q "gen_ai.tool.name:search_issues"
# Paginate through project resultssentry agent-conversation list my-org/my-project -c nextsentry agent-conversation view [<org>/]<conversation-id>
Section titled “sentry agent-conversation view [<org>/]<conversation-id>”View an agent conversation transcript
Arguments:
| Argument | Description |
|---|---|
[<org>/]<conversation-id> |
Organization slug (optional) and conversation ID |
Options:
| Option | Description |
|---|---|
-f, --fresh |
Bypass cache, re-detect projects, and fetch fresh data |
Examples:
# View full transcript (organization auto-detected)sentry agent-conversation view conv-123
# Explicit organizationsentry agent-conversation view my-org/conv-123
# JSON outputsentry agent-conversation view my-org/conv-123 --jsonAll commands support --json for machine-readable output and --fields to select specific JSON fields.