AWS amazonq documentation change
Summary
Added 'ISV integration' section with API security controls
Security assessment
Documents security aspects of third-party integrations including maintained access controls and permission enforcement
Diff
diff --git a/amazonq/latest/qbusiness-ug/concepts-terms.md b/amazonq/latest/qbusiness-ug/concepts-terms.md index 0c507b70e..95173bf37 100644 --- a//amazonq/latest/qbusiness-ug/concepts-terms.md +++ b//amazonq/latest/qbusiness-ug/concepts-terms.md @@ -5 +5 @@ -Application environmentACLs (Access Control Lists)Amazon Q AppsCustom document enrichmentData sourceData source connectorDocumentDocument attributesField mappingsFiltering using document attributesFoundation modelGuardrailsHallucinationIAM Identity CenterIdentity Federation through IAMIdentity providerIndexIndex capacityLarge language modelPrincipal MappingPluginsQuick promptsRetrieverRetrieval Augmented GenerationRelevance tuningTagsUser storeWeb experience +Application environmentACLs (Access Control Lists)Amazon Q AppsAnalytics dashboardAudio and video extractionBrowser extensionsChat orchestrationCustom document enrichmentData accessorsData sourceData source connectorDocumentDocument attributesField mappingsFiltering using document attributesFoundation modelGuardrailsHallucinationHallucination mitigationIAM Identity CenterIdentity Federation through IAMIdentity providerIndexIndex capacityIntegrationsISV integrationLarge language modelPrincipal MappingPluginsQuick promptsResponse personalizationRetrieverRetrieval Augmented GenerationRelevance tuningSubscription tiersTagsVisual content extractionUser storeWeb experience @@ -18,0 +19,8 @@ This section describes the key concepts and terms related to Amazon Q Business. + * Analytics dashboard + + * Audio and video extraction + + * Browser extensions + + * Chat orchestration + @@ -20,0 +29,2 @@ This section describes the key concepts and terms related to Amazon Q Business. + * Data accessors + @@ -38,0 +49,2 @@ This section describes the key concepts and terms related to Amazon Q Business. + * Hallucination mitigation + @@ -48,0 +61,4 @@ This section describes the key concepts and terms related to Amazon Q Business. + * Integrations + + * ISV integration + @@ -56,0 +73,2 @@ This section describes the key concepts and terms related to Amazon Q Business. + * Response personalization + @@ -62,0 +81,2 @@ This section describes the key concepts and terms related to Amazon Q Business. + * Subscription tiers + @@ -64,0 +85,2 @@ This section describes the key concepts and terms related to Amazon Q Business. + * Visual content extraction + @@ -74 +96 @@ This section describes the key concepts and terms related to Amazon Q Business. -An Amazon Q Business application environment is the primary resource that you use to create a chat solution. To create the application environment, you can use either the Amazon Q Business console or [Amazon Q Business API](https://docs.aws.amazon.com/amazonq/latest/api-reference/Welcome.html) actions. +An Amazon Q Business application environment is the primary resource that you use to create a chat solution. To create the application environment, you can use either the Amazon Q Business console or [Amazon Q Business API](https://docs.aws.amazon.com/amazonq/latest/api-reference/Welcome.html) actions. Amazon Q Business offers four distinct methods for creating applications: the standard approach with [IAM Identity Center](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create- application.html) integration, an [IAM federation](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application-iam.html) option for AWS-centric environments, an [ anonymous application method](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-anonymous-application.html) for public-facing scenarios, and a specialized [QuickSight integration](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application- quicksight.html) for analytics-focused implementations. Each creation pathway provides different authentication mechanisms and integration capabilities, allowing organizations to select the most appropriate solution based on their security requirements and existing infrastructure. @@ -83,0 +106,16 @@ Amazon Q Business allows web experience users to create lightweight, purpose-bui +## Analytics dashboard + +The Amazon Q Business analytics dashboard provides comprehensive insights into how users interact with your application. It offers metrics and visualizations on conversation volumes, popular topics, user engagement patterns, and system performance. Administrators can use these analytics to identify trends, understand user needs, measure adoption rates, and make data-driven decisions to improve the application. The dashboard helps track the effectiveness of your Amazon Q Business implementation, identify areas for enhancement, and demonstrate the value it brings to your organization. For more information, see [Using the analytics dashboard](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/analytics-dashboard.html). + +## Audio and video extraction + +Amazon Q Business extracts semantic information from audio and video files, making multimedia content queryable. This allows users to query audio and video content using natural language and explore deeper with follow-up questions, enhancing information retrieval from multimedia sources. For more information, see [Extracting semantic meaning from audio and video content](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/extracting-meaning-from-images.html#Audio-video-extraction). + +## Browser extensions + +The Amazon Q Business browser extension enhances users' web browsing experience by bringing AI-powered assistance directly into their daily workflows. Available for Google Chrome, Microsoft Edge, and Mozilla Firefox browsers, the extension allows users to summarize web pages, ask questions about content, access company knowledge, and use other features available in the Amazon Q Business web experience. This integration is only available for Amazon Q Business Pro users and requires installation and authentication. For more information, see [Enhancing web browsing with Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/browser-extensions.html). + +## Chat orchestration + +Chat orchestration is a Amazon Q Business feature that automatically manages chat requests across configured plugins and data sources. When enabled, Amazon Q Business automatically routes chat requests to plugins, integrating enterprise data and relevant actions within a single chat response. This feature provides unified response integration combining RAG workflow with plugin actions, intelligent action detection for read-only vs. write actions, and smart plugin management with user-driven experience through clarification requests when needed. For more information, see [Chat orchestration settings](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/guardrails-global-controls.html#guardrails-global-orchestration). + @@ -87,0 +126,4 @@ Document enrichment is an Amazon Q Business feature that you can use to manipula +## Data accessors + +The Amazon Q Business data accessors feature allows you to securely share your enterprise data with verified independent software vendors (ISVs) using Amazon Q. This feature enables ISVs to retrieve relevant content from your Amazon Q index, enhancing their applications with your organization's knowledge. By granting controlled access to your data, you can leverage third-party tools while maintaining security and data access compliance. Data accessors include verified software providers such as Asana, Miro, Zoom, and PagerDuty. For more information, see [Share your enterprise data with data accessors](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/data-accessors.html). + @@ -123,0 +166,4 @@ A hallucination, in the machine learning context, is a confident response by an +## Hallucination mitigation + +Hallucination mitigation is a Amazon Q Business feature that checks chat responses for hallucinations and corrects inconsistencies in real-time during chat. If a hallucination is detected with high confidence, Amazon Q Business corrects the inconsistencies in its response and generates a new, edited message. This feature is only available for retrieval augmented generation (RAG) responses from data connected to the application and is not supported for chat orchestration, plugin workflows, or responses generated from tabular data or multimedia transcripts. For more information, see [Response settings](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/guardrails-global-controls.html#guardrails-global-response). + @@ -145,0 +192,8 @@ When you use an Amazon Q Business native index for your application environment, +## Integrations + +Amazon Q Business integrations enhance user productivity by bringing AI-powered assistance directly into daily workflows through third-party enterprise tools. These integrations include browser extensions for Google Chrome, Microsoft Edge, and Mozilla Firefox browsers, as well as applications for Slack, Microsoft Teams, Microsoft Outlook, and Microsoft Word. Each integration must be configured and deployed to bring Amazon Q Business capabilities directly within those enterprise tools, allowing users to access Amazon Q's knowledge without context switching during their work. For more information, see [Integrations](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/integrations.html). + +## ISV integration + +Amazon Q Business enables independent software vendors (ISVs) to leverage customer enterprise data through the Amazon Q index to enhance their applications with generative AI capabilities. ISVs can access this data through two methods: either by being added as a data accessor to an existing customer's Amazon Q index, or by creating a Amazon Q application on behalf of the customer. The `SearchRelevantContent` API operation allows ISVs to retrieve relevant content from the customer's data sources while maintaining security and access controls, ensuring users only see content they have permission to access. This integration enables software providers to build enhanced application experiences without having to directly connect to or index individual data sources. For more information, see [Amazon Q index for independent software vendors (ISVs)](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/isv.html). + @@ -161,0 +216,4 @@ The Amazon Q Business quick prompts feature helps with end user discoverability +## Response personalization + +Response personalization is a Amazon Q Business feature that customizes chat responses to end users based on metadata associated with them—specifically address and job-related information—in your SSO instance. This feature enhances the relevance of responses by tailoring them to the user's specific context within the organization. To use response personalization effectively, you must have already added the necessary user information in your SSO instance. For more information, see [Response settings](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/guardrails-global-controls.html#guardrails-global-response). + @@ -179 +237,5 @@ Retrieval Augmented Generation (RAG) is a natural language processing (NLP) tech -You can choose to use document attributes to boost and tune the relevance of chat responses for end users from specific content. For example, if you have a document attribute associated document creation or updation date, you use these attributes to boost chat responses from more recently created or updated documents. For more information, see [Relevance tuning](https://docs.aws.amazon.com/amazonq/latest/business-use-dg/metadata-boosting.html). +You can choose to use document attributes to boost and tune the relevance of chat responses for end users from specific content. For example, if you have a document attribute associated document creation or updating date, you use these attributes to boost chat responses from more recently created or updated documents. For more information, see [Relevance tuning](https://docs.aws.amazon.com/amazonq/latest/business-use-dg/metadata-boosting.html). + +## Subscription tiers + +Amazon Q Business offers multiple user subscription tiers and index types that can be combined to meet your organization's needs. User subscription tiers determine the features available to end users, with Pro tier users having access to advanced features like browser extensions. Index types include starter index and enterprise index, each with different capabilities and storage capacities. You can choose any combination of index types and user subscriptions for your Amazon Q Business application. For more information, see [Amazon Q Business subscription tiers and index types](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/tiers.html). @@ -184,0 +247,4 @@ Manage your Amazon Q Business applications and data sources by assigning tags or +## Visual content extraction + +When Amazon Q Business processes your input files from a data source, it uses advanced image understanding capabilities to extract semantic information and insights from images and other visuals. This feature makes visual information in your data sources queryable, allowing end users to find relevant information even when it's conveyed in embedded diagrams, charts, or technical illustrations. Visual content extraction provides additional context and nuance to the information in your data sources and builds a more complete knowledge base from your enterprise data. For more information, see [Extracting semantic meaning from embedded visual content](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/extracting-meaning-from-images.html). + @@ -191 +257 @@ User Store is an Amazon Q Business data source connector feature that streamline -An Amazon Q Business web experience is the chat interface that you create using your Amazon Q Business application environment. Then, your end users can chat with your organization’s Amazon Q Business web experience. You can configure and customize your Amazon Q Business web experience using either the Amazon Q Business console or the Amazon Q Business API. +An Amazon Q Business web experience is the chat interface that you create using your Amazon Q Business application environment. Then, your end users can chat with your organization’s Amazon Q Business web experience. You can configure and customize your Amazon Q Business web experience using either the Amazon Q Business console or the Amazon Q Business API. For more information, see [Customizing your web experience](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/customize-web-experience.html).