Amazon Q is a brand new generative AI-powered utility that helps customers get work accomplished. Amazon Q can grow to be 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 need to use Amazon Q to have conversations, clear up issues, generate content material, achieve insights, and take motion by connecting to your organization’s info repositories, code, knowledge, and enterprise methods. For extra info, see Introducing Amazon Q, a brand new generative AI-powered assistant (preview).

On this submit, we present you how one can deliver Amazon Q, your small business skilled, to customers in Microsoft Groups. (When you use Slack, seek advice from Deploy a Slack gateway for Amazon Q, your small business skilled.)

You’ll find a way converse with Amazon Q enterprise skilled utilizing Groups direct messages (DMs) to ask questions and get solutions primarily based on firm knowledge, get assist creating new content material equivalent to e-mail drafts, summarize connected information, and carry out duties.

You may as well invite Amazon Q enterprise skilled to take part in your Groups channels. In a channel, customers can ask Amazon Q enterprise skilled questions in a brand new message, or tag it in an present thread at any level, to supply extra knowledge factors, resolve a debate, or summarize the dialog and seize the following steps.

Resolution overview

Amazon Q enterprise skilled is amazingly highly effective. Try the next demo—seeing is believing!

Within the demo, our Amazon Q enterprise skilled utility is populated with some Wikipedia pages. You may populate your Amazon Q enterprise skilled utility with your personal firm’s paperwork and information base articles, so it will likely be capable of reply your particular questions!

The whole lot you want is supplied as open supply in our GitHub repo.

On this submit, we stroll you thru the method to deploy Amazon Q enterprise skilled in your AWS account and add it to Microsoft Groups. If you’re accomplished, you’ll marvel the way you ever managed with out it!

The next are a number 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.
• Observe 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 enterprise skilled.
• 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 connected information – It might course of as much as 5 connected information for doc query answering, summaries, and extra.
• Begin new conversations – You may reset and begin new conversations in DM chats through the use of /new_conversation.

Within the following sections, we present how one can deploy the venture to your personal AWS account and Groups account, and begin experimenting!

Stipulations

It’s good to have an AWS account and an AWS Identification and Entry Administration (IAM) function and consumer with permissions to create and handle the required assets and elements for this utility. When 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 present, working Amazon Q enterprise skilled utility. When you haven’t set one up but, see Creating an Amazon Q utility.

Lastly, you want a Microsoft account and a Microsoft Groups subscription to create and publish the app utilizing the steps outlined on this submit. When you don’t have these, see if your organization can create sandboxes so that you can experiment, or create a brand new account and trial subscription as wanted to finish the steps.

Deploy the answer assets

We’ve supplied pre-built AWS CloudFormation templates that deploy the whole lot you want in your AWS account.

When you’re a developer and also you wish to construct, deploy, or publish the answer from code, seek advice from the Developer README.

Full the next steps to launch the CloudFormation stack:

1. Log in to the AWS Administration Console.
2. 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)

3. For Stack identify, enter a reputation to your app (for instance, AMAZON-Q-TEAMS-GATEWAY).
4. For AmazonQAppId, enter your present Amazon Q enterprise skilled utility ID (for instance, 80xxxxx9-7xx3-4xx0-bxx4-5baxxxxx2af5). You may copy it from the Amazon Q enterprise skilled console.
5. For AmazonQRegion, select the Area the place you created your Amazon Q enterprise skilled utility (us-east-1 or us-west-2).
6. For AmazonQUserId, enter an Amazon Q enterprise skilled consumer ID e-mail tackle (go away clean to make use of a Groups consumer e-mail because the consumer ID).
7. 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 preserve it open—you’ll want it in later steps.

Register a brand new app within the Microsoft Azure portal

Full the next steps to register a brand new app within the Microsoft Azure portal:

1. Go to the Azure Portal and log in along with your Microsoft account.
2. Select New registration.
   1. For Title, present the identify to your app. You may preserve issues easy through the use of the stack identify you used for the CloudFormation stack.
   2. For Who can use this utility or entry this API?, select Accounts on this organizational listing solely (AWS solely – Single tenant).
   3. Select Register.
   4. Notice down the Software (consumer) ID worth and the Listing (tenant) ID from the Overview web page. You’ll want them later when requested for MicrosoftAppId and MicrosoftAppTenantId.
3. Select Choose API permissions within the navigation pane.
   1. Select Add a permission.
   2. Select Microsoft Graph.
   3. Select Software permissions.
   4. Choose Consumer.Learn.All.
   5. Choose ChannelMessage.Learn.All.
   6. Choose Staff.ReadBasic.All.
   7. Choose Recordsdata.Learn.All.
   8. Select Add permissions. This permission permits the app to learn knowledge in your group’s listing concerning the signed-in consumer.
   9. Use the choices menu (three dots) on the suitable to decide on Take away permission.
   10. Take away the unique Consumer.Learn – Delegated permission.
   11. Select Grant admin consent for Default Listing.
4. Select Certificates & secrets and techniques within the navigation pane.
   1. Select New consumer secret.
   2. For Description, present a price, equivalent to description of my consumer secret.
   3. Select a price for Expires. Notice that in manufacturing, you’ll must manually rotate your secret earlier than it expires.
   4. Select Add.
   5. Notice down the worth to your new secret. You’ll want it later when requested for MicrosoftAppPassword.
5. Optionally, select House owners so as to add any extra house owners for the appliance.

Register your new app within the Microsoft Bot Framework

Full the next steps to register your app within the Microsoft Bot Framework:

1. Go to the Microsoft Bot Framework and log in along with your Microsoft account.
2. Optionally, you may create and add a customized icon to your new Amazon Q enterprise skilled bot. For instance, we created the next utilizing Amazon Bedrock picture playground.
   

3. Enter your most popular show identify, bot deal with, and outline.
4. For Messaging endpoint, copy and paste the worth of TeamsEventHandlerApiEndpoint out of your stack Outputs tab.
5. Don’t choose Allow Streaming Endpoint.
6. For App kind, select Single Tenant.
7. For Paste your app ID beneath to proceed, enter the MicrosoftAppId worth you famous earlier.
8. For App Tenant ID, enter the MicrosoftAppTenantId worth you famous earlier.
9. Depart the opposite values as they’re, comply with the phrases, and select Register.
10. On the Channels web page, below Add a featured channel, select Microsoft Groups.
11. Select Microsoft Groups Business (most typical), then select Save.
12. Conform to the Phrases of Service and select Agree.

Configure your secrets and techniques in AWS

Let’s configure your Groups secrets and techniques with the intention to confirm the signature of every request and submit on behalf of your Amazon Q enterprise skilled bot.

On this instance, we’re not enabling Groups token rotation. You may 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 need this characteristic added to a future model.

Full the next steps to configure a secret in Secrets and techniques Supervisor:

1. On the AWS CloudFormation console, navigate to your stack Outputs tab and select the hyperlink for TeamsSecretConsoleUrl to be redirected to the Secrets and techniques Supervisor console.
2. Select Retrieve secret worth.
3. Select Edit.
4. Substitute the values of MicrosoftAppId, MicrosoftAppPassword, and MicrosoftAppTenantId with the values you famous within the earlier steps.

Deploy your app into Microsoft Groups

Full the next steps to deploy the app to Groups:

1. Go to the Developer Portal for Groups and log in along with your Microsoft Groups consumer account.
2. Select Apps within the navigation pane, then select New app.
   1. For Title, enter your bot identify.
   2. Enter a reputation for Full identify and each brief and full descriptions (you need to use the bot identify for all of them if you need, simply don’t go away them empty).
   3. Enter values for Developer info and App URLs. For testing, you may make up values, and URLs like https://www.anycompany.com/. Use actual ones for manufacturing.
   4. For Software (consumer) ID*, enter the worth of MicrosoftAppId from earlier.
   5. Select Save.
3. Underneath Branding, you may add AI-generated icons, or totally different icons, or none in any respect, it’s as much as you. The next are some examples:
   1. Shade icon 192×192
   2. Define icon 32×32
4. Underneath App options, select Bot.
   1. Choose Enter a bot ID, and enter the MicrosoftAppId worth from the sooner steps.
   2. Underneath What can your bot do?, choose Add and obtain information.
   3. Underneath Choose the scopes through which folks can use this command, choose Private, Staff, and Group chat.
   4. Select Save.
5. Select Publish.
6. Select Obtain the app package deal to obtain a .zip file to your pc.
7. Select Preview in Groups to launch Microsoft Groups (work or faculty) app.
   1. Within the navigation pane, select Apps, then Handle your apps, then Add an app.
   2. Select Add an app to your orgs app catalog, and choose the .zip file you downloaded. This provides the app to Groups.
   3. Choose the cardboard to your new app, select Add, and watch for it to finish (10–20 seconds).

Add your bot to a number of groups

Full the next step so as to add your bot to a workforce:

1. Within the Groups app, choose your workforce and select Handle workforce.
2. On the Apps tab, select the brand new Amazon Q enterprise skilled app, and select Add.

Now you may take a look at your bot in Microsoft Groups!

Begin utilizing Amazon Q enterprise skilled

Full the next steps to start out utilizing Amazon Q enterprise skilled in Groups:

1. Open your Groups consumer.
2. Underneath Apps, add your new Amazon Q enterprise skilled app to a chat.
3. Optionally, add your Amazon Q enterprise skilled app to a number of Groups channels.
4. Within the app DM chat, enter Whats up.

You may have now deployed a strong new AI assistant into your sandbox Groups setting.

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 may ask about matters associated to the paperwork that you’ve got ingested into your personal Amazon Q enterprise skilled utility. However don’t cease there. You will discover extra methods to make it helpful, and once you do, tell us by posting a remark.

As soon as you might be satisfied how helpful it’s, speak to your Groups admins (present them this submit) and work with them to deploy it in your organization’s Groups organizations. Your fellow workers will thanks!

Clear up

If you’re completed experimenting with this answer, delete your app in Microsoft Groups, Bot Framework, and Azure portal. Then clear up your AWS assets by opening the AWS CloudFormation console and deleting the AMAZON-Q-TEAMS-GATEWAY stack that you just deployed. This deletes the assets that you just created by deploying the answer.

Conclusions

The pattern Amazon Q enterprise skilled Groups utility mentioned on this submit 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 newest updates. We’d additionally love to listen to your options for enhancements and options.

For extra info on Amazon Q enterprise skilled, seek advice from the Amazon Q (For Enterprise Use) Developer Information.

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 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 give attention to making digital wallets safe by way of 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 workforce.