You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
chore(slack): Add AI agent config instructions (#17354)
<!-- Use this checklist to make sure your PR is ready for merge. You may
delete any sections you don't need. -->
## DESCRIBE YOUR PR
Adds the changes from setting up the AI Agents in Slack feature. Also
adds some headings to break things up
## IS YOUR CHANGE URGENT?
Help us prioritize incoming PRs by letting us know when the change needs
to go live.
- [ ] Urgent deadline (GA date, etc.): <!-- ENTER DATE HERE -->
- [ ] Other deadline: <!-- ENTER DATE HERE -->
- [x] None: Not urgent, can wait up to 1 week+
| `assistant:write` | Enables accessing the app as a personal Slack Agent. |
73
80
| `app_mentions:read` | Receive `app_mention` events when the bot is mentioned (e.g. @Sentry) in a message. |
74
81
| `channels:read` | List and validate public channels when configuring alert-rule destinations, and resolve channel names to IDs. |
75
82
| `channels:history` | (Optional) Allows Sentry to read messages from public channels. Sentry uses this to gather context of individual threads for conversations with Seer Explorer. |
@@ -99,6 +106,8 @@ Add the following scopes to **User Scopes**:
99
106
your app’s OAuth tokens to a list of IP addresses and ranges you provide.
100
107
</Alert>
101
108
109
+
### Event Subscriptions
110
+
102
111
Navigate to **Event Subscriptions** and toggle “On”. Here you will enter another Request URL: `{YOUR_DOMAIN}/extensions/slack/event/`
103
112
104
113
You’ll see “Verified” when you’ve entered the correct URL.
@@ -117,7 +126,8 @@ If it fails to validate, first make sure your Sentry instance is running and Sla
117
126
118
127
Still on the **Event Subscription** page, go to **Subscribe to bot events** and add the following bot user events:
119
128
120
-
- `app_mention`(Not supported for self-hosted)
129
+
- `app_mention`(Not necessary for self-hosted, Seer is not available)
130
+
- `assistant_thread_started`(Not necessary for self-hosted, Seer is not available)
121
131
- `link_shared`
122
132
- `message.im`
123
133
@@ -129,12 +139,16 @@ Lastly, still on that page, go to **App Unfurl Domains**, click **Add Domain** t
129
139
130
140
At the bottom of the page, click **Save Changes**.
131
141
142
+
### App Home
143
+
132
144
Navigate to **App Home**, under **Features**. Here is where you can edit your bot's display name (this is the name that will be displayed when alerts are triggered).
133
145
134
146

135
147
136
148
If you plan on having Slack alerts sent to specific users (`@person`) in addition to channels, toggle on the **Messages Tab** under **Show Tabs** in the **App Home** page.
137
149
150
+
### Slash Commands
151
+
138
152
Navigate to **Slash Commands** under **Features**. Click **Create New Command** and enter the following values:
139
153
140
154
| Setting | Value |
@@ -151,3 +165,21 @@ Navigate to **Slash Commands** under **Features**. Click **Create New Command**
151
165
At the bottom of the page, click **Save**.
152
166
153
167
Now you can use Slack with Sentry! See our [documentation on installing and configuring the Slack integration for your projects](https://docs.sentry.io/product/integrations/notification-incidents/slack/) to take advantage of multi-channel Alert routing.
168
+
169
+
### Agents & AI Apps
170
+
171
+
<Alert title="Note (for self-hosted users)">
172
+
Seer is not currently available for self-hosted. You can skip this section of settings changes.
173
+
</Alert>
174
+
175
+
Navigate to **Agents & AI Apps** under **Features**.
176
+
177
+
Enable the Agent or Assistant toggle and add an overview for your users. For example:
178
+
179
+
```text
180
+
👋 Hey, I'm Seer — Sentry's AI debugging agent.
181
+
182
+
I live in your Sentry data and I'm very good at finding out why things are on fire.
183
+
```
184
+
185
+
Under **Suggested Prompts**, ensure _Dynamic_ is selected.
0 commit comments