Skip to content
DocsGitHub

agent-conversation

List and view agent conversations

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:

Terminal window
# List recent agent conversations
sentry agent-conversation list
# Explicit organization (all projects)
sentry agent-conversation list my-org/
# One project
sentry agent-conversation list my-org/my-project
# Find a project across organizations
sentry agent-conversation list my-project
# Show more, last 24 hours
sentry agent-conversation list --limit 50 --period 24h
# Sort by highest error count
sentry agent-conversation list --sort -conversation.errors
# Sort by lowest total cost
sentry agent-conversation list --sort conversation.totalCost
# Find conversations with errors
sentry agent-conversation list -q "conversation.errors:>0"
# Find conversations for an agent
sentry agent-conversation list -q "gen_ai.agent.name:my-agent"
# Find conversations with more than two tool calls
sentry agent-conversation list -q "conversation.toolCalls:>2"
# Find conversations that used a tool
sentry agent-conversation list -q "gen_ai.tool.name:search_issues"
# Paginate through project results
sentry agent-conversation list my-org/my-project -c next

sentry 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:

Terminal window
# View full transcript (organization auto-detected)
sentry agent-conversation view conv-123
# Explicit organization
sentry agent-conversation view my-org/conv-123
# JSON output
sentry agent-conversation view my-org/conv-123 --json

All commands support --json for machine-readable output and --fields to select specific JSON fields.