Skip to content

Commit 56e0d53

Browse files
authored
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+
1 parent 86f173d commit 56e0d53

File tree

1 file changed

+38
-6
lines changed

1 file changed

+38
-6
lines changed

develop-docs/integrations/slack/index.mdx

Lines changed: 38 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -34,42 +34,49 @@ After you update the `config.yml`, `sentry.conf.py`, or `devlocal.py` you need t
3434
<Link to="/self-hosted/#configuration">configuration section</Link> for more information.
3535
</Alert>
3636

37+
## App Settings
38+
39+
### Interactivity & Shortcuts
40+
3741
Now that you’ve created your app and updated your Sentry config, you can navigate to **Interactivity & Shortcuts** under **Features**.
3842

3943
Toggle on **Interactivity & Shortcuts**.
4044

4145
Now you’ll be able to enter your **Request URL** (this is the location of your self-hosted Sentry) and **Options Load URL**:
4246

43-
```
47+
```text
4448
Request URL: {YOUR_DOMAIN}/extensions/slack/action/
4549
Options Load URL: {YOUR_DOMAIN}/extensions/slack/options-load/
4650
```
4751

52+
### OAuth & Permissions
53+
4854
Navigate to **OAuth & Permissions** to configure the Redirect URLs.
4955

5056
![OAuth](./oauth.png)
5157

5258
Click **Add a new Redirect URL**, enter the URL, and click **Add**. Set the URL to:
5359

54-
```
60+
```text
5561
{YOUR_DOMAIN}/extensions/slack/setup/
5662
```
5763

5864
Click **Save URLs**.
5965

60-
## Scopes
66+
#### Scopes
6167

6268
On the same page under **Scopes** you'll need to add **Bot Scopes** and **User Scopes**.
6369

6470
Add the following scopes to **Bot Scopes**:
6571

6672
<Alert title="Note (for self-hosted users)">
67-
`channels:history`, `groups:history`, and `app_mentions:read` are used to trigger Seer which is
68-
not currently available for self-hosted, meaning they're not required permissions to add.
73+
`app_mentions:read`, `assistant:write`, `channels:history` and `groups:history` are used for Seer
74+
Features which are not currently available for self-hosted. You can freely omit them.
6975
</Alert>
7076

7177
| Scope | Reason |
7278
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
79+
| `assistant:write` | Enables accessing the app as a personal Slack Agent. |
7380
| `app_mentions:read` | Receive `app_mention` events when the bot is mentioned (e.g. @Sentry) in a message. |
7481
| `channels:read` | List and validate public channels when configuring alert-rule destinations, and resolve channel names to IDs. |
7582
| `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**:
99106
your app’s OAuth tokens to a list of IP addresses and ranges you provide.
100107
</Alert>
101108

109+
### Event Subscriptions
110+
102111
Navigate to **Event Subscriptions** and toggle “On”. Here you will enter another Request URL: `{YOUR_DOMAIN}/extensions/slack/event/`
103112

104113
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
117126

118127
Still on the **Event Subscription** page, go to **Subscribe to bot events** and add the following bot user events:
119128

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)
121131
- `link_shared`
122132
- `message.im`
123133

@@ -129,12 +139,16 @@ Lastly, still on that page, go to **App Unfurl Domains**, click **Add Domain** t
129139

130140
At the bottom of the page, click **Save Changes**.
131141

142+
### App Home
143+
132144
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).
133145

134146
![Bot](./bot.png)
135147

136148
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.
137149

150+
### Slash Commands
151+
138152
Navigate to **Slash Commands** under **Features**. Click **Create New Command** and enter the following values:
139153

140154
| Setting | Value |
@@ -151,3 +165,21 @@ Navigate to **Slash Commands** under **Features**. Click **Create New Command**
151165
At the bottom of the page, click **Save**.
152166

153167
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

Comments
 (0)