Amazon Q is a brand new generative AI-powered utility that helps customers get work carried out. Amazon Q can change into your tailor-made enterprise skilled 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, clear up issues, generate content material, acquire insights, and take motion by connecting to your organization’s info repositories, code, information, and enterprise methods. For extra info, see Introducing Amazon Q, a brand new generative AI-powered assistant (preview).
On this publish, we present you the best way to carry Amazon Q, your corporation skilled, to customers in Slack.
You’ll give you 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 hooked up information, and carry out duties.
You can too invite Amazon Q to take part in your group channels. In a channel, customers can ask it questions in a brand new message, or tag it in an present thread at any level, to supply further information factors, resolve a debate, or summarize the dialog and seize the following steps.
Amazon Q is amazingly highly effective. Try the next demo—seeing is believing!
Within the demo, our Amazon Q utility is populated with a set of AWS whitepapers. You’ll be able to populate your personal Amazon Q enterprise skilled utility with your personal firm’s paperwork and data base articles, so it is going to be in a position to reply your questions!
All the things you want is supplied as open supply in our GitHub repo.
On this publish, we stroll you thru the method to deploy Amazon Q in your AWS account and add it to your Slack workspace. Once you’re carried out, you’ll surprise the way you ever managed with out it!
The next are a few of the issues it may 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 consists of headings, lists, daring, italics, tables, and extra.
Monitor sentiment – It gives thumbs up and thumbs down buttons to trace person sentiment.
Present supply attribution – It gives 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 stated what, and when, so it may contribute in context and precisely summarize the thread when requested.
Course of hooked up information – It might course of as much as 5 hooked up 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 best way to deploy the undertaking to your personal AWS account and Slack workspace, and begin experimenting!
You want to have an AWS account and an AWS Id and Entry Administration (IAM) position and person with permissions to create and handle the mandatory assets and parts for this utility. In the event you don’t have an AWS account, see How do I create and activate a brand new Amazon Internet Providers account?
You additionally have to have an present, working Amazon Q enterprise skilled utility. In the event you haven’t set one up but, see Creating an Amazon Q utility.
Lastly, you want a Slack account and entry to create and publish apps to your Slack group. In the event 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 every little thing you want in your AWS account.
In the event you’re a developer and also you need to construct, deploy, or publish the answer from code, seek advice from 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 to your desired AWS Area to open the AWS CloudFormation console and create a brand new stack.
N. Virginia (us-east-1)
For Stack identify, enter a reputation to your app (for instance, AMAZON-Q-SLACK-GATEWAY).
For AmazonQAppId, enter your present Amazon Q utility 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 utility (us-east-1 or us-west-2).
For AmazonQUserId, enter an Amazon Q person ID e-mail handle (depart clean to make use of a Slack person e-mail because the person 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 preserve 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 Permit customers to ship Slash instructions and messages from the messages tab.
This can be a required step to allow your person 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 person 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 correct 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 with a view to confirm the signature of every request and publish on behalf of your Amazon Q bot.
On this instance, we’re not 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 problem (or, higher but, a pull request) within the GitHub repo if you need this characteristic 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 SlackSecretConsoleUrl to be redirected to the Secrets and techniques Supervisor console.
Select Retrieve secret worth.
Substitute the values of SlackSigningSecret and SlackBotUserOAuthToken utilizing the values within the Slack utility configuration beneath Fundamental Data and OAuth & Permissions.
Watch out you don’t unintentionally copy Consumer Secret as an alternative of Signing Secret.
Begin utilizing Amazon Q
Full the next steps to begin 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 group channels.
Within the app DM channel, enter Hey.
You’ve now deployed a strong new AI assistant into your sandbox Slack setting.
Play with it, attempt all of the options mentioned on this publish, and duplicate the stuff you noticed within the demo video. Most significantly, you possibly can ask about matters associated to the paperwork that you’ve ingested into your personal Amazon Q enterprise skilled utility. However don’t cease there. You could find further methods to make it helpful, and whenever 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 publish) and work with them to deploy it in your organization’s Slack workspaces. Your fellow staff will thanks!
Once 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.
This pattern Amazon Q slack utility mentioned on this publish is supplied as open supply—you need to use it as a place to begin to 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 recent releases, and verify again for the most recent updates. We’d additionally love to listen to your solutions for enhancements and options.
For extra info on Amazon Q, seek advice from What’s Amazon Q (For Enterprise Use)?
Concerning the Authors
Bob Strahan is a Principal Options Architect within the AWS Language AI Providers group.