Deploy a Microsoft Groups gateway for Amazon Q, your small business skilled

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 knowledge safely and securely. You should utilize Amazon Q to have conversations, resolve issues, generate content material, achieve insights, and take motion by connecting to your organization’s info repositories, code, knowledge, and enterprise programs. For extra info, see Introducing Amazon Q, a new generative AI-powered assistant (preview).

On this publish, we present you the way to convey Amazon Q, your business expert, to customers in Microsoft Groups. (Should you use Slack, confer with Deploy a Slack gateway for Amazon Q, your business expert.)

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 resembling e-mail drafts, summarize hooked up recordsdata, and carry out duties.

You too can 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 further knowledge factors, resolve a debate, or summarize the dialog and seize the following steps.

Resolution overview

Amazon Q enterprise skilled is amazingly highly effective. Take a look at the next demo—seeing is believing!

Within the demo, our Amazon Q enterprise skilled utility is populated with some Wikipedia pages. You possibly can populate your Amazon Q enterprise skilled utility with your individual firm’s paperwork and data base articles, so will probably be in a position to reply your particular questions!

Every part you want is supplied as open supply in our GitHub repo.

On this publish, 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 carried out, you’ll marvel the way you ever managed with out it!

The next are among the issues it could possibly 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.
• Observe sentiment – 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 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 mentioned what, and when, so it could possibly contribute in context and precisely summarize the thread when requested.
• Course of hooked up recordsdata – It may course of as much as 5 hooked up recordsdata for doc query answering, summaries, and extra.
• Begin new conversations – You possibly can reset and begin new conversations in DM chats by utilizing /new_conversation.

Within the following sections, we present the way to deploy the challenge to your individual AWS account and Groups account, and begin experimenting!

Conditions

It is advisable to have an AWS account and an AWS Identity and Access Management (IAM) position and person with permissions to create and handle the mandatory assets and parts for this utility. Should you don’t have an AWS account, see How do I create and activate a new Amazon Web Services account?

You additionally must have an present, working Amazon Q enterprise skilled utility. Should you haven’t set one up but, see Creating an Amazon Q application.

Lastly, you want a Microsoft account and a Microsoft Teams subscription to create and publish the app utilizing the steps outlined on this publish. Should 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 every thing you want in your AWS account.

Should 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:

1. Log in to the AWS Management 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 title, 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 possibly can 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 person ID e-mail tackle (depart clean to make use of a Groups person e-mail because the person ID).
7. 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.

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 together with your Microsoft account.
2. Select New registration.
   1. For Identify, present the title to your app. You possibly can maintain issues easy by utilizing the stack title 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 Information.Learn.All.
   8. Select Add permissions. This permission permits the app to learn knowledge in your group’s listing concerning the signed-in person.
   9. Use the choices menu (three dots) on the proper 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, resembling 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 further homeowners 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 together with your Microsoft account.
2. Optionally, you possibly can create and add a customized icon to your new Amazon Q enterprise skilled bot. For instance, we created the next utilizing Amazon Bedrock image playground.
   

3. Enter your most popular show title, 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 sort, select Single Tenant.
7. For Paste your app ID under to proceed, enter the MicrosoftAppId worth you famous earlier.
8. For App Tenant ID, enter the MicrosoftAppTenantId worth you famous earlier.
9. Go away the opposite values as they’re, conform to the phrases, and select Register.
10. On the Channels web page, beneath Add a featured channel, select Microsoft Groups.
11. Select Microsoft Groups Business (most typical), then select Save.
12. Comply with the Phrases of Service and select Agree.

Configure your secrets and techniques in AWS

Let’s configure your Groups secrets and techniques in an effort to confirm the signature of every request and publish on behalf of your Amazon Q enterprise skilled bot.

On this instance, we aren’t enabling Groups token rotation. You possibly can allow it for a manufacturing app by implementing rotation by way of AWS Secrets Manager. 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:

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 Teams and log in together with your Microsoft Groups person account.
2. Select Apps within the navigation pane, then select New app.
   1. For Identify, enter your bot title.
   2. Enter a reputation for Full title and each quick and full descriptions (you need to use the bot title for all of them if you would like, simply don’t depart them empty).
   3. Enter values for Developer info and App URLs. For testing, you can also 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. Beneath Branding, you possibly can 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. Color icon 192×192
   2. Outline icon 32×32
4. Beneath App options, select Bot.
   1. Choose Enter a bot ID, and enter the MicrosoftAppId worth from the sooner steps.
   2. Beneath What can your bot do?, choose Add and obtain recordsdata.
   3. Beneath Choose the scopes wherein individuals can use this command, choose Private, Staff, and Group chat.
   4. Select Save.
5. Select Publish.
6. Select Obtain the app bundle to obtain a .zip file to your pc.
7. Select Preview in Groups to launch Microsoft Groups (work or college) 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 look ahead to 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 possibly can take a look at your bot in Microsoft Groups!

Begin utilizing Amazon Q enterprise skilled

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

1. Open your Groups consumer.
2. Beneath 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 Hi there.

You could have now deployed a robust new AI assistant into your sandbox Groups setting.

Play with it, strive all of the options mentioned on this publish, 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 got ingested into your individual Amazon Q enterprise skilled utility. However don’t cease there. You could find further methods to make it helpful, and while you do, tell us by posting a remark.

As soon as you’re satisfied how helpful it’s, speak to your Groups admins (present them this publish) and work with them to deploy it in your organization’s Groups organizations. Your fellow staff 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 simply deployed. This deletes the assets that you simply created by deploying the answer.

Conclusions

The pattern Amazon Q enterprise skilled Groups 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 by way of GitHub pull requests. Discover the code, select Watch within the GitHub repo to be notified of latest 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 enterprise skilled, confer with the Amazon Q (For Business Use) Developer Guide.

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 Sources. 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 Providers workforce.