|
| 1 | +--- |
| 2 | +name: sentry-cli-ai-conversations |
| 3 | +version: 0.35.0-dev.0 |
| 4 | +description: List and view AI conversations |
| 5 | +requires: |
| 6 | + bins: ["sentry"] |
| 7 | + auth: true |
| 8 | +--- |
| 9 | + |
| 10 | +# Ai-conversations Commands |
| 11 | + |
| 12 | +List and view AI conversations |
| 13 | + |
| 14 | +### `sentry ai-conversations list <org>` |
| 15 | + |
| 16 | +List recent AI conversations |
| 17 | + |
| 18 | +**Flags:** |
| 19 | +- `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` |
| 20 | +- `-q, --query <value> - Search query` |
| 21 | +- `-t, --period <value> - Time range: "7d", "2026-04-01..2026-05-01", ">=2026-04-01" - (default: "7d")` |
| 22 | +- `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` |
| 23 | +- `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` |
| 24 | + |
| 25 | +**JSON Fields** (use `--json --fields` to select specific fields): |
| 26 | + |
| 27 | +| Field | Type | Description | |
| 28 | +|-------|------|-------------| |
| 29 | +| `conversationId` | string | | |
| 30 | +| `flow` | array | | |
| 31 | +| `errors` | number | | |
| 32 | +| `llmCalls` | number | | |
| 33 | +| `toolCalls` | number | | |
| 34 | +| `totalTokens` | number | | |
| 35 | +| `totalCost` | number | | |
| 36 | +| `startTimestamp` | number | | |
| 37 | +| `endTimestamp` | number | | |
| 38 | +| `traceCount` | number | | |
| 39 | +| `traceIds` | array | | |
| 40 | +| `firstInput` | string \| null | | |
| 41 | +| `lastOutput` | string \| null | | |
| 42 | +| `user` | object \| null | | |
| 43 | +| `toolNames` | array | | |
| 44 | +| `toolErrors` | number | | |
| 45 | + |
| 46 | +**Examples:** |
| 47 | + |
| 48 | +```bash |
| 49 | +# List last 10 AI conversations |
| 50 | +sentry ai-conversations list |
| 51 | + |
| 52 | +# Explicit organization |
| 53 | +sentry ai-conversations list my-org |
| 54 | + |
| 55 | +# Show more, last 24 hours |
| 56 | +sentry ai-conversations list --limit 50 --period 24h |
| 57 | + |
| 58 | +# Filter conversations |
| 59 | +sentry ai-conversations list -q "has:errors" |
| 60 | + |
| 61 | +# Paginate through results |
| 62 | +sentry ai-conversations list my-org -c next |
| 63 | +``` |
| 64 | + |
| 65 | +### `sentry ai-conversations view <org> <conversation-id>` |
| 66 | + |
| 67 | +View an AI conversation transcript |
| 68 | + |
| 69 | +**Flags:** |
| 70 | +- `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` |
| 71 | + |
| 72 | +**Examples:** |
| 73 | + |
| 74 | +```bash |
| 75 | +# View full transcript |
| 76 | +sentry ai-conversations view my-org conv-123 |
| 77 | + |
| 78 | +# JSON output |
| 79 | +sentry ai-conversations view my-org conv-123 --json |
| 80 | +``` |
| 81 | + |
| 82 | +All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags. |
0 commit comments