Skip to content

Commit be6f0fb

Browse files
committed
docs: add Using the App section and assistant panel to READMEs
1 parent 092fefb commit be6f0fb

4 files changed

Lines changed: 34 additions & 13 deletions

File tree

README.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,12 @@ All implementations share the same Slack listener layer, the same five simulated
1818

1919
## What Casey Can Do
2020

21-
Casey gives your team instant IT support through three entry points:
21+
Casey gives your team instant IT support through four entry points:
2222

2323
* **App Home** — Choose from common issue categories. A modal collects details, then Casey starts a DM thread with a resolution.
2424
* **Direct Messages** — Describe any IT issue and Casey responds in-thread, maintaining context across follow-ups.
2525
* **Channel @mentions** — Mention `@Casey` in any channel to get help without leaving the conversation.
26+
* **Assistant Panel** — Users click _Add Agent_ in Slack, select Casey, and pick from suggested prompts or describe an issue.
2627

2728
Behind the scenes, Casey has access to five simulated tools: knowledge base search, support ticket creation, password reset, system status checks, and user permissions lookup.
2829

@@ -32,6 +33,17 @@ Behind the scenes, Casey has access to five simulated tools: knowledge base sear
3233

3334
Casey also works with the [Slack MCP Server](https://docs.slack.dev/agents-ai/model-context-protocol), giving it the ability to search messages and files, read channel history and threads, send messages, schedule messages, and create or update Slack canvases. When deployed with OAuth (HTTP mode), Casey automatically connects to the Slack MCP Server using the user's token, unlocking these capabilities on top of the built-in IT tools.
3435

36+
## Using the App
37+
38+
Once Casey is running, there are several ways to interact:
39+
40+
* **App Home** — Open Casey in Slack and click the _Home_ tab. Choose from common issue categories, describe your issue in the modal, and Casey starts a DM thread with a resolution.
41+
* **Direct Messages** — Open a DM with Casey. Pick a suggested prompt or describe your issue, and Casey will reply in a thread.
42+
* **Channel @mentions** — Invite Casey to a channel by typing `/invite @Casey`, then type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
43+
* **Assistant Panel** — Click _Add Agent_ in the top-right corner of Slack, select Casey, and choose a suggested prompt like _Reset Password_, _Request Access_, or _Network Issues_.
44+
45+
For full setup instructions, pick a framework above and follow the README in that directory.
46+
3547
## Local Development
3648

3749
This repo uses [`slack-bolt`](https://pypi.org/project/slack-bolt/) from PyPI.

claude-agent-sdk/README.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,12 @@ Built with [Bolt for Python](https://docs.slack.dev/tools/bolt-python/) and the
66

77
## App Overview
88

9-
Casey gives your team instant IT support through three entry points:
9+
Casey gives your team instant IT support through four entry points:
1010

1111
* **App Home** — Users open Casey's Home tab and choose from common issue categories (Password Reset, Access Request, Software Help, Network Issues, Something Else). A modal collects details, then Casey starts a DM thread with a resolution.
1212
* **Direct Messages** — Users message Casey directly to describe any IT issue. Casey responds in-thread, maintaining context across follow-ups.
1313
* **Channel @mentions** — Users mention `@Casey` in any channel to get help without leaving the conversation.
14+
* **Assistant Panel** — Users click _Add Agent_ in Slack, select Casey, and pick from suggested prompts or describe an issue.
1415

1516
Casey uses five simulated tools to assist users:
1617

@@ -241,13 +242,15 @@ python3 app_oauth.py
241242

242243
### Using the App
243244

244-
Once Casey is running, there are three ways to interact:
245+
Once Casey is running, there are several ways to interact:
245246

246247
**App Home** — Open Casey in Slack and click the _Home_ tab. You'll see five category buttons. Click one to open a modal, describe your issue, and submit. Casey will start a DM thread with you containing a diagnosis and next steps.
247248

248-
**Direct Messages** — Open a DM with Casey and describe your issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
249+
**Direct Messages** — Open a DM with Casey. You'll see suggested prompts like _Reset Password_, _Request Access_, and _Network Issues_ — pick one or describe your own issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
249250

250-
**Channel @mentions** — In any channel where Casey has been added, type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
251+
**Channel @mentions** — Invite Casey to a channel by typing `/invite @Casey` in the message box, then type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
252+
253+
**Assistant Panel** — Click _Add Agent_ in the top-right corner of Slack, select Casey from the list, then pick a suggested prompt or type a message.
251254

252255
Casey will add a :white_check_mark: reaction when it believes an issue has been resolved, and occasionally adds a contextual emoji reaction to keep things friendly.
253256

openai-agents-sdk/README.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,12 @@ Built with [Bolt for Python](https://docs.slack.dev/tools/bolt-python/) and [Ope
66

77
## App Overview
88

9-
Casey gives your team instant IT support through three entry points:
9+
Casey gives your team instant IT support through four entry points:
1010

1111
* **App Home** — Users open Casey's Home tab and choose from common issue categories (Password Reset, Access Request, Software Help, Network Issues, Something Else). A modal collects details, then Casey starts a DM thread with a resolution.
1212
* **Direct Messages** — Users message Casey directly to describe any IT issue. Casey responds in-thread, maintaining context across follow-ups.
1313
* **Channel @mentions** — Users mention `@Casey` in any channel to get help without leaving the conversation.
14+
* **Assistant Panel** — Users click _Add Agent_ in Slack, select Casey, and pick from suggested prompts or describe an issue.
1415

1516
Casey uses five simulated tools to assist users:
1617

@@ -241,13 +242,15 @@ python3 app_oauth.py
241242

242243
### Using the App
243244

244-
Once Casey is running, there are three ways to interact:
245+
Once Casey is running, there are several ways to interact:
245246

246247
**App Home** — Open Casey in Slack and click the _Home_ tab. You'll see five category buttons. Click one to open a modal, describe your issue, and submit. Casey will start a DM thread with you containing a diagnosis and next steps.
247248

248-
**Direct Messages** — Open a DM with Casey and describe your issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
249+
**Direct Messages** — Open a DM with Casey. You'll see suggested prompts like _Reset Password_, _Request Access_, and _Network Issues_ — pick one or describe your own issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
249250

250-
**Channel @mentions** — In any channel where Casey has been added, type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
251+
**Channel @mentions** — Invite Casey to a channel by typing `/invite @Casey` in the message box, then type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
252+
253+
**Assistant Panel** — Click _Add Agent_ in the top-right corner of Slack, select Casey from the list, then pick a suggested prompt or type a message.
251254

252255
Casey will add a :white_check_mark: reaction when it believes an issue has been resolved, and occasionally adds a contextual emoji reaction to keep things friendly.
253256

pydantic-ai/README.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,12 @@ Built with [Bolt for Python](https://docs.slack.dev/tools/bolt-python/) and [Pyd
66

77
## App Overview
88

9-
Casey gives your team instant IT support through three entry points:
9+
Casey gives your team instant IT support through four entry points:
1010

1111
* **App Home** — Users open Casey's Home tab and choose from common issue categories (Password Reset, Access Request, Software Help, Network Issues, Something Else). A modal collects details, then Casey starts a DM thread with a resolution.
1212
* **Direct Messages** — Users message Casey directly to describe any IT issue. Casey responds in-thread, maintaining context across follow-ups.
1313
* **Channel @mentions** — Users mention `@Casey` in any channel to get help without leaving the conversation.
14+
* **Assistant Panel** — Users click _Add Agent_ in Slack, select Casey, and pick from suggested prompts or describe an issue.
1415

1516
Casey uses five simulated tools to assist users:
1617

@@ -255,13 +256,15 @@ python3 app_oauth.py
255256

256257
### Using the App
257258

258-
Once Casey is running, there are three ways to interact:
259+
Once Casey is running, there are several ways to interact:
259260

260261
**App Home** — Open Casey in Slack and click the _Home_ tab. You'll see five category buttons. Click one to open a modal, describe your issue, and submit. Casey will start a DM thread with you containing a diagnosis and next steps.
261262

262-
**Direct Messages** — Open a DM with Casey and describe your issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
263+
**Direct Messages** — Open a DM with Casey. You'll see suggested prompts like _Reset Password_, _Request Access_, and _Network Issues_ — pick one or describe your own issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
263264

264-
**Channel @mentions** — In any channel where Casey has been added, type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
265+
**Channel @mentions** — Invite Casey to a channel by typing `/invite @Casey` in the message box, then type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
266+
267+
**Assistant Panel** — Click _Add Agent_ in the top-right corner of Slack, select Casey from the list, then pick a suggested prompt or type a message.
265268

266269
Casey will add a :white_check_mark: reaction when it believes an issue has been resolved, and occasionally adds a contextual emoji reaction to keep things friendly.
267270

0 commit comments

Comments
 (0)