Amazon Q is a brand new generative AI-powered software that helps customers get work finished. Amazon Q can turn into your tailor-made enterprise skilled and allow you to uncover content material, brainstorm concepts, or create summaries utilizing your organization’s knowledge 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, knowledge, and enterprise methods. For extra data, see Introducing Amazon Q, a brand new generative AI-powered assistant (preview).
On this submit, we present you the way to convey Amazon Q, your corporation skilled, to customers in Slack. (When you use Microsoft Groups, confer with Deploy a Microsoft Groups gateway for Amazon Q, your corporation skilled.)
You’ll find a way converse with Amazon Q utilizing Slack direct messages (DMs) to ask questions and get solutions primarily based on firm knowledge, get assist creating new content material equivalent to electronic mail drafts, summarize connected recordsdata, and carry out duties.
You can even invite Amazon Q to take part in your staff 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 knowledge factors, resolve a debate, or summarize the dialog and seize the subsequent steps.
Resolution overview
Amazon Q is amazingly highly effective. Try the next demo—seeing is believing!
Within the demo, our Amazon Q software is populated with a set of AWS whitepapers. You possibly can populate your personal Amazon Q enterprise skilled software with your personal firm’s paperwork and data base articles, so it will likely be in a position to reply your questions!
The whole lot you want is offered 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. Whenever 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 consists of headings, lists, daring, italics, tables, and extra.
Monitor sentiment – It supplies thumbs up and thumbs down buttons to trace person 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 stated what, and when, so it might probably contribute in context and precisely summarize the thread when requested.
Course of connected recordsdata – It will probably course of as much as 5 connected recordsdata for doc query answering, summaries, and extra.
Begin new conversations – You possibly can reset and begin new conversations in DM channels by utilizing /new_conversation.
Within the following sections, we present the way to deploy the challenge to your personal AWS account and Slack workspace, and begin experimenting!
Conditions
You could have an AWS account and an AWS Identification and Entry Administration (IAM) position and person with permissions to create and handle the mandatory assets and elements for this software. When you don’t have an AWS account, see How do I create and activate a brand new Amazon Net Companies account?
You additionally have to have an present, working Amazon Q enterprise skilled software. When 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. When 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 offered pre-built AWS CloudFormation templates that deploy all the things you want in your AWS account.
When 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 to 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 title, enter a reputation to your app (for instance, AMAZON-Q-SLACK-GATEWAY).
For AmazonQAppId, enter your present Amazon Q software ID (for instance, 80xxxxx9-7xx3-4xx0-bxx4-5baxxxxx2af5). You possibly can 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 person ID electronic mail deal with (go away clean to make use of a Slack person electronic mail because the person ID).
For ContextDaysToLive, enter the size of time to maintain dialog metadata cached in Amazon DynamoDB (you may go away this because the default).
When your CloudFormation stack standing is CREATE_COMPLETE, select the Outputs tab, and hold it open—you’ll want it in later steps.
Create your app
Now you may 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.
This can be a required step to allow your person to ship messages to your app.
Add your app in your workspace
Now you may 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 title, Settings & administration, and Handle apps.
Select your newly created app.
In the proper 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 the intention 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 possibly can 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 in order for you 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.
Select Edit.
Substitute the values of SlackSigningSecret and SlackBotUserOAuthToken utilizing the values within the Slack software configuration beneath Primary Info and OAuth & Permissions.
Watch out you don’t by chance copy Consumer Secret as a substitute of Signing Secret.
Begin utilizing Amazon Q
Full the next steps to begin utilizing Amazon Q in Slack:
Open your Slack workspace.
Underneath Apps, Handle, add your new Amazon Q app.
Optionally, add your Amazon Q app to staff channels.
Within the app DM channel, enter Hey.
You might have now deployed a robust new AI assistant into your sandbox Slack setting.
Play with it, strive all of the options mentioned on this submit, and replica the belongings you noticed within the demo video. Most significantly, you may ask about matters associated to the paperwork that you’ve ingested into your personal Amazon Q enterprise skilled software. However don’t cease there. You’ll find further methods to make it helpful, and once you do, tell us by posting a remark.
As soon as you’re satisfied how helpful it’s, speak to your Slack admins (and present them this submit) and work with them to deploy it in your organization’s Slack workspaces. Your fellow workers will thanks!
Clear up
Whenever you’re completed experimenting with this resolution, 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 just deployed. This deletes the assets that you just created by deploying the answer.
Conclusions
This pattern Amazon Q slack software mentioned on this submit is offered as open supply—you should use it as a place to begin to your personal resolution, 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 recommendations for enhancements and options.
For extra data on Amazon Q, confer with What’s Amazon Q (For Enterprise Use)?
In regards to the Authors
Gary Benattar is a Senior Software program Improvement Supervisor in AWS HR. Gary began at Amazon in 2012 as an intern, specializing in constructing scalable, real-time outlier detection methods. 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 concentrate on making digital wallets safe via multi-party computation. He obtained his MSc in Software program Engineering from Sorbonne College in Paris.
Bob Strahan is a Principal Options Architect within the AWS Language AI Companies staff.