Deploy a Microsoft Groups gateway for Amazon Q, your enterprise knowledgeable

Amazon Q is a brand new generative AI-powered utility that helps customers get work finished. Amazon Q can grow to be your tailor-made enterprise knowledgeable and allow you to uncover content material, brainstorm concepts, or create summaries utilizing your organization’s information 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, information, 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 convey Amazon Q, your enterprise knowledgeable, to customers in Microsoft Groups. (In the event you use Slack, consult with Deploy a Slack gateway for Amazon Q, your enterprise knowledgeable.)

You’ll have the opportunity converse with Amazon Q enterprise knowledgeable utilizing Groups direct messages (DMs) to ask questions and get solutions based mostly on firm information, get assist creating new content material equivalent to e-mail drafts, summarize hooked up recordsdata, and carry out duties.

You can even invite Amazon Q enterprise knowledgeable to take part in your Groups channels. In a channel, customers can ask Amazon Q enterprise knowledgeable questions in a brand new message, or tag it in an current thread at any level, to supply further information factors, resolve a debate, or summarize the dialog and seize the subsequent steps.

Resolution overview

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

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

All the things 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 knowledgeable in your AWS account and add it to Microsoft Groups. While you’re finished, you’ll marvel the way you ever managed with out it!

The next are a number of the issues it may well 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 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 knowledgeable.
• Perceive dialog context – It tracks the dialog and responds based mostly 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 may well contribute in context and precisely summarize the thread when requested.
• Course of hooked up recordsdata – It could actually 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 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!

Conditions

You want to have an AWS account and an AWS Id and Entry Administration (IAM) function and person with permissions to create and handle the required 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 Net Companies account?

You additionally must have an current, working Amazon Q enterprise knowledgeable utility. In the event you haven’t set one up but, see Creating an Amazon Q utility.

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

In the event you’re a developer and also you wish to construct, deploy, or publish the answer from code, consult with 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 title, enter a reputation to your app (for instance, AMAZON-Q-TEAMS-GATEWAY).
4. For AmazonQAppId, enter your current Amazon Q enterprise knowledgeable utility ID (for instance, 80xxxxx9-7xx3-4xx0-bxx4-5baxxxxx2af5). You possibly can copy it from the Amazon Q enterprise knowledgeable console.
5. For AmazonQRegion, select the Area the place you created your Amazon Q enterprise knowledgeable utility (us-east-1 or us-west-2).
6. For AmazonQUserId, enter an Amazon Q enterprise knowledgeable person ID e-mail tackle (go away 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’ll be able to 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 together with your Microsoft account.
2. Select New registration.
   1. For Identify, present the title to your app. You possibly can preserve issues easy through the use of 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 Crew.ReadBasic.All.
   7. Choose Information.Learn.All.
   8. Select Add permissions. This permission permits the app to learn information in your group’s listing in regards to the signed-in person.
   9. Use the choices menu (three dots) on the appropriate 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 worth, equivalent to description of my consumer secret.
   3. Select a worth 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 Homeowners 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’ll be able to create and add a customized icon to your new Amazon Q enterprise knowledgeable bot. For instance, we created the next utilizing Amazon Bedrock picture playground.
   

3. Enter your most well-liked 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 with a view to confirm the signature of every request and submit on behalf of your Amazon Q enterprise knowledgeable bot.

On this instance, we aren’t enabling Groups token rotation. You possibly can 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’d like 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. Change 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 brief and full descriptions (you need to use the bot title for all of them if you’d like, simply don’t go away 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. Below Branding, you’ll be able to 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. Below App options, select Bot.
   1. Choose Enter a bot ID, and enter the MicrosoftAppId worth from the sooner steps.
   2. Below What can your bot do?, choose Add and obtain recordsdata.
   3. Below Choose the scopes wherein individuals can use this command, choose Private, Crew, and Group chat.
   4. Select Save.
5. Select Publish.
6. Select Obtain the app package deal to obtain a .zip file to your laptop.
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 knowledgeable app, and select Add.

Now you’ll be able to check your bot in Microsoft Groups!

Begin utilizing Amazon Q enterprise knowledgeable

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

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

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

Play with it, attempt all of the options mentioned on this submit, and duplicate the stuff you noticed within the demo video. Most significantly, you’ll be able to ask about subjects associated to the paperwork that you’ve got ingested into your personal Amazon Q enterprise knowledgeable utility. However don’t cease there. You will discover further 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, discuss to your Groups admins (present them this submit) and work with them to deploy it in your organization’s Groups organizations. Your fellow staff will thanks!

Clear up

While you’re completed experimenting with this resolution, 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 knowledgeable Groups utility mentioned on this submit is supplied as open supply—you need to 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 latest releases, and test 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 knowledgeable, consult with the Amazon Q (For Enterprise Use) Developer Information.

---

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 based mostly 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 deal with making digital wallets safe by means of multi-party computation. He acquired 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.