Amazon Q is a brand new AI-powered technology utility that helps customers get their work accomplished. Amazon Q might be your tailored enterprise skilled, permitting you to securely and securely uncover content material, brainstorm concepts, or construct summaries utilizing your organization’s profile. You should utilize Amazon Q to hook up with your organization’s data repositories, code, information, and enterprise methods to have conversations, clear up issues, generate content material, acquire insights, and take motion. For extra data, see Introducing Amazon Q, a brand new AI-generated assistant (preview).
On this article, we’ll present you easy methods to convey what you are promoting consultants, Amazon Q, to your customers in Slack.
You can use Slack direct messages (DM) to have conversations with Amazon Q, ask questions and get solutions based mostly on firm profiles, get assist creating new content material (resembling e mail drafts), assemble hooked up information, and carry out duties.
You too can invite Amazon Q to your staff channel. In a channel, customers can ask a query in a brand new message or tag it in an current thread at any time to supply extra information factors, resolve debates, or summarize the dialog and seize subsequent steps.
Resolution overview
Amazon Q is extremely highly effective. Try the demonstration beneath – seeing it’s believing!
Within the demo, our Amazon Q utility is populated with a set of AWS white papers. You may populate your personal Amazon Q Enterprise Professional app with your personal firm’s paperwork and information base articles so it is going to be capable of reply your questions!
Every thing you want is offered as open supply in our GitHub repository.
On this article, we’ll stroll you thru the method of deploying Amazon Q in your AWS account and including it to your Slack workspace. Whenever you’re accomplished, you will marvel the way you ever bought by with out it!
Listed here are a few of the issues it may possibly do:
- Reply to message – In DM, it responds to all messages. In a channel, it solely responds to @mentions and in dialog threads.
- Render solutions containing markdown – This contains headings, lists, daring, italics, tables, and many others.
- monitor feelings – It offers “thumbs up” and “thumbs down” buttons to trace person sentiment.
- Present supply attribution – It offers references and hyperlinks to sources utilized by Amazon Q.
- Perceive the context of the dialog – It tracks conversations and responds contextually.
- Be careful for a number of customers – When it’s tagged in a thread, it is aware of who mentioned what when, so it may possibly contribute in context and precisely summarize the thread when requested.
- Course of hooked up information – It may well deal with as much as 5 extra information for doc Q&A, summaries, and many others.
- Begin a brand new dialog – You should utilize the DM channel to reset and begin a brand new dialog
/new_conversation
.
Within the following sections, we’ll present you easy methods to deploy the mission to your personal AWS account and Slack workspace, and begin experimenting!
conditions
You want an AWS account and an AWS Identification and Entry Administration (IAM) position and person with permissions to create and handle the assets and elements required by the appliance. If you do not have an AWS account, see How do I create and begin a brand new Amazon Internet Providers account?
You additionally have to have an current Amazon Q Enterprise Professional utility out there. If you have not set it up but, see Creating an Amazon Q Software.
Lastly, you will want a Slack account and entry to create and publish the app to your Slack group. If you do not have one, see if your organization can arrange a Slack sandbox group so that you can experiment with, or go to slack.com to arrange a free Slack account and workspace.
Deploy resolution assets
We offer pre-built AWS CloudFormation templates to deploy every little thing you want in your AWS account.
If you’re a developer and need to construct, deploy, or publish your resolution by code, see the developer readme.
Full the next steps to start out the CloudFormation stack:
- Log in to the AWS Administration Console.
- Select one of many following choices Begin stacking Button on your desired AWS area to open the AWS CloudFormation console and create a brand new stack.
space | Begin stacking |
---|---|
Northern Virginia (us-east-1 ) |
|
Oregon(us-west-2 ) |
- for stack identifyenter a reputation on your utility (for instance,
AMAZON-Q-SLACK-GATEWAY
). - for AmazonQAppIdenter your current Amazon Q utility ID (for instance,
80xxxxx9-7xx3-4xx0-bxx4-5baxxxxx2af5
). You may copy it from the Amazon Q console. - for Amazon Q spacechoose the Area by which you created your Amazon Q utility (us-east-1 or us-west-2).
- for AmazonQ person IDenter your Amazon Q person ID e mail tackle (go away clean to make use of your Slack person e mail because the person ID).
- for Context survival daysenter the size of time to cache session metadata in Amazon DynamoDB (you’ll be able to go away this because the default).
When your CloudFormation stack standing is Create_Doneselect output tab and go away it open – you will want it within the subsequent steps.
Create your utility
Now you’ll be able to construct apps in Slack. Full the next steps:
- Construct a Slack app at https://api.slack.com/apps based mostly on the generated manifest – copy and paste from the stack output:
SlackAppManifest
. - select Software House Web page Within the navigation pane and scroll right down to the part Present tab.
- allow Messages tab.
- select Permits customers to ship Slash instructions and messages from the Messages tab.
It is a required step to allow your customers to ship messages to your utility.
Add your utility to your workspace
Now you can add purposes to your workspace. That is required to generate the bot person OAuth token worth required within the subsequent step.
- go OAuth and permissions (in https://api.slack.com) and choose Set up into workspace Generate OAuth token.
- In Slack, go to your workspace.
- Select your workspace identify, Setup and administrationand Handle purposes.
- Choose your newly created utility.
- In the precise pane, choose Open in utility listing.
- select Open in Slack.
Arrange Slack keys in AWS Secrets and techniques Supervisor
Let’s configure your Slack key to confirm the signature of every request and publish on behalf of your Amazon Q bot.
On this instance, we didn’t allow Slack token rotation. You may allow it for manufacturing purposes by implementing rotation by AWS Secrets and techniques Supervisor. If you need this function added to a future launch, please create a difficulty (or higher but, a pull request) within the GitHub repository.
Full the next steps to arrange keys in Secrets and techniques Supervisor:
- On the AWS CloudFormation console, navigate to your stack output tab and choose hyperlink
SlackSecretConsoleUrl
Redirect to the Secrets and techniques Supervisor console. - select Retrieve secret worth.
- select edit.
- alternative worth
SlackSigningSecret
andSlackBotUserOAuthToken
Use the values from the Slack utility configuration beneath Fundamental data and OAuth and permissions.
Watch out to not by accident copy consumer secrets and techniques exchange Signature Ideas.
Get began with Amazon Q
Full the next steps to start out utilizing Amazon Q with Slack:
- Open your Slack workspace.
- beneath utility, handleadd your new Amazon Q utility.
- (Non-obligatory) Add your Amazon Q utility to the staff channel.
- Within the app DM channel, enter
Hi there
.
You may have now deployed your highly effective new AI assistant to your sandbox Slack setting.
Give it a attempt, check out all of the options mentioned on this article, and duplicate what you see within the demo video. Better of all, you’ll be able to ask about matters associated to the information you’ve got pulled into your personal Amazon Q Enterprise Professional app. However do not cease there. You’ll find different methods to make it helpful, and whenever you do, please tell us by leaving a remark.
When you’re satisfied how helpful it’s, discuss to your Slack admin (and present them this text) and work with them to deploy it into your organization’s Slack workspace. Your colleagues will thanks!
clear up
When you have got completed experimenting with this resolution, delete your app in Slack (https://api.slack.com/apps) by opening the AWS CloudFormation console and deleting AMAZON-Q-SLACK-GATEWAY
The stack you deployed. This can delete the assets you created by deploying the answer.
in conclusion
The pattern Amazon Q slack utility mentioned on this article is offered as open supply – you should utilize it as a place to begin on your personal resolution and assist us enhance it by contributing fixes and options through GitHub pull requests.Discover the code, select watch Get notified of latest releases within the GitHub repository, and examine again for the newest updates. We might additionally love to listen to your ideas for enhancements and options.
For extra details about Amazon Q, see What’s Amazon Q (Enterprise Use)?
In regards to the writer
Gary Benatar Is a Senior Software program Improvement Supervisor at AWS HR. Gary began working as an intern at Amazon in 2012, specializing in constructing scalable, on-the-fly outlier detection methods. He has labored in Seattle and Luxembourg and now lives in Tel Aviv, Israel, the place he works constructing software program to revolutionize the way forward for HR. He co-founded Zengo, a startup centered on securing digital wallets by multi-party computation. He holds a grasp’s diploma in software program engineering from the Sorbonne College in Paris.
Bob Strahan is the lead options architect on the AWS Language AI service staff.