Amazon Q is a brand new generative AI-powered software that helps customers get work finished. Amazon Q can turn out to be your tailor-made enterprise professional and allow you to uncover content material, brainstorm concepts, or create summaries utilizing your organization’s information safely and securely. You should use Amazon Q to have conversations, remedy issues, generate content material, acquire insights, and take motion by connecting to your organization’s data repositories, code, information, and enterprise programs. For extra data, see Introducing Amazon Q, a brand new generative AI-powered assistant (preview).
On this submit, we present you the way to carry Amazon Q, your corporation professional, to customers in Slack.
You’ll have the option converse with Amazon Q utilizing Slack direct messages (DMs) to ask questions and get solutions primarily based on firm information, get assist creating new content material corresponding to e-mail drafts, summarize connected information, and carry out duties.
You too can invite Amazon Q to take part in your crew channels. In a channel, customers can ask it questions in a brand new message, or tag it in an current thread at any level, to supply extra information factors, resolve a debate, or summarize the dialog and seize the subsequent steps.
Answer overview
Amazon Q is amazingly highly effective. Take a look at the next demo—seeing is believing!
Within the demo, our Amazon Q software is populated with a set of AWS whitepapers. You’ll be able to populate your individual Amazon Q enterprise professional software with your individual firm’s paperwork and data base articles, so it is going to be capable of reply your questions!
Every thing you want is supplied as open supply in our GitHub repo.
On this submit, we stroll you thru the method to deploy Amazon Q in your AWS account and add it to your Slack workspace. While you’re finished, you’ll surprise the way you ever managed with out it!
The next are among the issues it might probably do:
- Reply to messages – In DMs, it responds to all messages. In channels, it responds solely to @mentions and responds in a dialog thread.
- Render solutions containing markdown – This contains headings, lists, daring, italics, tables, and extra.
- Monitor sentiment – It supplies thumbs up and thumbs down buttons to trace consumer sentiment.
- Present supply attribution – It supplies references and hyperlinks to sources utilized by Amazon Q.
- Perceive dialog context – It tracks the dialog and responds primarily based on the context.
- Keep conscious of a number of customers – When it’s tagged in a thread, it is aware of who mentioned what, and when, so it might probably contribute in context and precisely summarize the thread when requested.
- Course of connected information – It could course of as much as 5 connected information for doc query answering, summaries, and extra.
- Begin new conversations – You’ll be able to reset and begin new conversations in DM channels by utilizing
/new_conversation.
Within the following sections, we present the way to deploy the mission to your individual AWS account and Slack workspace, and begin experimenting!
Conditions
It’s worthwhile to have an AWS account and an AWS Identification and Entry Administration (IAM) function and consumer with permissions to create and handle the mandatory assets and elements for this software. In case you don’t have an AWS account, see How do I create and activate a brand new Amazon Net Companies account?
You additionally must have an current, working Amazon Q enterprise professional software. In case you haven’t set one up but, see Creating an Amazon Q software.
Lastly, you want a Slack account and entry to create and publish apps to your Slack group. In case you don’t have one, see if your organization can create a Slack sandbox group so that you can experiment, or go to slack.com to create a free Slack account and workspace.
Deploy the answer assets
We’ve supplied pre-built AWS CloudFormation templates that deploy the whole lot you want in your AWS account.
In case you’re a developer and also you wish to construct, deploy, or publish the answer from code, confer with the Developer README.
Full the next steps to launch the CloudFormation stack:
- Log in to the AWS Administration Console.
- Select one of many following Launch Stack buttons in your desired AWS Area to open the AWS CloudFormation console and create a brand new stack.
| Area | Launch Stack |
|---|---|
N. Virginia (us-east-1) |  |
Oregon (us-west-2) | |
- For Stack identify, enter a reputation in your app (for instance,
AMAZON-Q-SLACK-GATEWAY). - For AmazonQAppId, enter your current Amazon Q software ID (for instance,
80xxxxx9-7xx3-4xx0-bxx4-5baxxxxx2af5). You’ll be able to copy it from the Amazon Q console. - For AmazonQRegion, select the Area the place you created your Amazon Q software (us-east-1 or us-west-2).
- For AmazonQUserId, enter an Amazon Q consumer ID e-mail handle (depart clean to make use of a Slack consumer e-mail because the consumer ID).
- For ContextDaysToLive, enter the size of time to maintain dialog metadata cached in Amazon DynamoDB (you possibly can depart this because the default).
When your CloudFormation stack standing is CREATE_COMPLETE, select the Outputs tab, and maintain it open—you’ll want it in later steps.
Create your app
Now you possibly can create your app in Slack. Full the next steps:
- Create a Slack app in https://api.slack.com/apps from the generated manifest—copy and paste from the stack output:
SlackAppManifest. - Select App Dwelling within the navigation pane and scroll all the way down to the part Present Tabs.
- Allow Messages Tab.
- Choose Enable customers to ship Slash instructions and messages from the messages tab.
It is a required step to allow your consumer to ship messages to your app.
Add your app in your workspace
Now you possibly can add your app in your workspace. That is required to generate the bot consumer OAuth token worth that’s wanted within the subsequent step.
- Go to OAuth & Permissions (in https://api.slack.com) and select Set up to Workspace to generate the OAuth token.
- In Slack, go to your workspace.
- Select your workspace identify, Settings & administration, and Handle apps.
- Select your newly created app.
- In the appropriate pane, select Open in App Listing.
- Select Open in Slack.
Configure Slack secrets and techniques in AWS Secrets and techniques Supervisor
Let’s configure your Slack secrets and techniques in an effort to confirm the signature of every request and submit on behalf of your Amazon Q bot.
On this instance, we aren’t enabling Slack token rotation. You’ll be able to allow it for a manufacturing app by implementing rotation through AWS Secrets and techniques Supervisor. Create a difficulty (or, higher but, a pull request) within the GitHub repo if you would like this function added to a future model.
Full the next steps to configure a secret in Secrets and techniques Supervisor:
- On the AWS CloudFormation console, navigate to your stack Outputs tab and select the hyperlink for
SlackSecretConsoleUrlto be redirected to the Secrets and techniques Supervisor console. - Select Retrieve secret worth.
- Select Edit.
- Exchange the values of
SlackSigningSecretandSlackBotUserOAuthTokenutilizing the values within the Slack software configuration underneath Primary Data and OAuth & Permissions.
Watch out you don’t unintentionally copy Shopper Secret as a substitute of Signing Secret.
Begin utilizing Amazon Q
Full the next steps to start out utilizing Amazon Q in Slack:
- Open your Slack workspace.
- Beneath Apps, Handle, add your new Amazon Q app.
- Optionally, add your Amazon Q app to crew channels.
- Within the app DM channel, enter
Hiya.
You may have now deployed a robust new AI assistant into your sandbox Slack surroundings.
Play with it, attempt all of the options mentioned on this submit, and replica the belongings you noticed within the demo video. Most significantly, you possibly can ask about subjects associated to the paperwork that you’ve ingested into your individual Amazon Q enterprise professional software. However don’t cease there. Yow will discover extra methods to make it helpful, and while you do, tell us by posting a remark.
As soon as you might be satisfied how helpful it’s, discuss to your Slack admins (and present them this submit) and work with them to deploy it in your organization’s Slack workspaces. Your fellow staff will thanks!
Clear up
While you’re completed experimenting with this answer, delete your app in Slack (https://api.slack.com/apps) and clear up your AWS assets by opening the AWS CloudFormation console and deleting the AMAZON-Q-SLACK-GATEWAY stack that you simply deployed. This deletes the assets that you simply created by deploying the answer.
Conclusions
This pattern Amazon Q slack software mentioned on this submit is supplied as open supply—you should utilize it as a place to begin in your personal answer, and assist us make it higher by contributing again fixes and options through GitHub pull requests. Discover the code, select Watch within the GitHub repo to be notified of latest releases, and test again for the most recent updates. We’d additionally love to listen to your options for enhancements and options.
For extra data on Amazon Q, confer with What’s Amazon Q (For Enterprise Use)?
Concerning the Authors
Gary Benattar is a Senior Software program Growth Supervisor in AWS HR. Gary began at Amazon in 2012 as an intern, specializing in constructing scalable, real-time outlier detection programs. He labored in Seattle and Luxembourg and is now primarily based in Tel Aviv, Israel, the place he dedicates his time to constructing software program to revolutionize the way forward for Human Assets. He co-founded a startup, Zengo, with a give attention to making digital wallets safe by means of multi-party computation. He acquired his MSc in Software program Engineering from Sorbonne College in Paris.
Bob Strahan is a Principal Options Architect within the AWS Language AI Companies crew.
