AWS quick documentation change
Summary
Reorganized integration console documentation with new categories (Knowledge/Connectors), updated Google Drive examples, added action connector setup, and restructured existing integration management.
Security assessment
Changes focus on UI reorganization and workflow updates without addressing vulnerabilities. OAuth mentions are part of standard setup, not security fixes. No CVE references or vulnerability patches are present.
Diff
diff --git a/quick/latest/userguide/integration-console-setup-process.md b/quick/latest/userguide/integration-console-setup-process.md index 1ee9223ac..5428aa0af 100644 --- a//quick/latest/userguide/integration-console-setup-process.md +++ b//quick/latest/userguide/integration-console-setup-process.md @@ -11 +11 @@ Choose integration optionsView setup process examplesIntegration management opti -The Integrations console provides a streamlined interface for creating and managing integrations. When you access the Integrations tab, you see all available applications in a unified grid. The console setup process adapts based on the integration you select, your user tier, and existing integrations. +The console organizes integrations into separate categories based on their purpose. Use **Knowledge** to connect data sources for Q&A and insights. Use **Connectors** to set up action connectors that perform operations in external applications. The setup process adapts based on the integration you select, your subscription, and existing integrations. @@ -15 +15 @@ The Integrations console provides a streamlined interface for creating and manag -When you select an integration from the main grid, the console branches based on several factors: +When you set up an integration, the console guides you based on several factors: @@ -17 +17 @@ When you select an integration from the main grid, the console branches based on - * **Integration capabilities** \- Each application supports different combinations of actions and knowledge base creation. For example, Google Drive supports data ingestion not actions. OneDrive supports both data ingestion and actions. + * **Integration capabilities** – Each application supports different combinations of actions and knowledge base creation. For example, Google Drive supports both actions and knowledge base creation. Web Crawler supports knowledge base creation only. @@ -21 +21 @@ When you select an integration from the main grid, the console branches based on - * **Existing integrations** \- The console first shows existing integrations before offering to create new ones. + * **Existing integrations** – When you choose a connector that already exists, the console shows your existing connectors before offering to create new ones. @@ -28 +28 @@ When you select an integration from the main grid, the console branches based on -The following examples show how different integrations guide you through different console setup processes: +The following examples show how different integrations guide you through different console setup processes. @@ -30 +30 @@ The following examples show how different integrations guide you through differe -### Google Drive - Bring data for Q&A +### Google Drive – Set up a knowledge base @@ -32 +32 @@ The following examples show how different integrations guide you through differe -Google Drive supports data access integrations and knowledge base creation. +Google Drive supports knowledge base creation through user-managed or admin-managed authentication. @@ -34 +34 @@ Google Drive supports data access integrations and knowledge base creation. - 1. In the console, choose **Integrations**. + 1. In the console, choose **Knowledge**. @@ -36 +36 @@ Google Drive supports data access integrations and knowledge base creation. - 2. From the integration grid, choose **Google Drive** , and select the add icon. + 2. Find **Google Drive** and choose the **Add** (+) icon. @@ -38 +38 @@ Google Drive supports data access integrations and knowledge base creation. - 3. The OAuth popup appears. Complete the OAuth process and grant it all the necessary permissions. Choose **Continue**. + 3. Choose your authentication method and complete the sign-in flow. @@ -40 +40 @@ Google Drive supports data access integrations and knowledge base creation. - 4. You are taken to the Create knowledge base page. Select the files you want to assign to your knowledge base, and choose Select. + 4. Enter a name and description for your knowledge base. @@ -42 +42 @@ Google Drive supports data access integrations and knowledge base creation. - 5. Enter a name and description. Choose **Create**. + 5. Select the files and folders you want to index, then choose **Create**. @@ -47 +47 @@ Google Drive supports data access integrations and knowledge base creation. -### OneDrive - Perform actions and bring data for Q&A +### Google Drive – Set up an action connector @@ -49 +49 @@ Google Drive supports data access integrations and knowledge base creation. -OneDrive supports the capabilities to both perform actions and bring data for Q&A. The console provides options for both capabilities during setup. +Google Drive also supports action connectors for performing file operations directly from . @@ -51 +51 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& - 1. In the console, choose **Integrations**. + 1. In the console, choose **Connectors**. @@ -53 +53 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& - 2. From the integration grid, choose **OneDrive**. + 2. Choose the **Create for your team** tab. @@ -55 +55 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& - 3. In the Create Integration dialog, select your integration type: + 3. Find and choose **Google Drive**. @@ -57 +57 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& - * **Perform actions in OneDrive** \- Enables actions like creating, updating, or managing OneDrive files. + 4. Enter a **Name** for your connector. Optionally, choose **\+ Add Description** to add a description. @@ -59 +59 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& - * **Bring data from OneDrive** \- Enables you to ask questions about and get insights from your OneDrive content. + 5. Choose your **Connection type** and **OAuth Configuration** , then complete the authentication setup. @@ -61 +61 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& - * **Both** \- Combines task and data ingestion capabilities. + 6. Review the available actions and choose **Publish**. @@ -63 +62,0 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& - 4. Enter integration details and configure Microsoft 365 authentication. @@ -65 +63,0 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& - 5. If you selected "Bring data from OneDrive", select the files you want to add to your knowledge base using the file picker interface. @@ -67 +64,0 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& - 6. Choose **Create** to complete the setup. @@ -68,0 +66 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& +### Available connectors tab @@ -69,0 +68 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& +The **Available** tab on the Connectors page shows connectors that use managed OAuth and are ready to use without additional configuration. Users can connect directly by choosing **Connect** on the connector card. @@ -70,0 +70 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& + 1. In the console, choose **Connectors**. @@ -72 +72 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& -### Working with existing integrations + 2. On the **Available** tab, find the connector you want to use. @@ -74 +74 @@ OneDrive supports the capabilities to both perform actions and bring data for Q& -When you select an integration type that you've used before, the console first displays your existing integrations. + 3. Choose **Connect**. @@ -76 +76 @@ When you select an integration type that you've used before, the console first d - 1. In the console, choose **Integrations**. + 4. Complete the sign-in flow for the application. @@ -78 +77,0 @@ When you select an integration type that you've used before, the console first d - 2. Choose an integration type you've used before (for example, **OneDrive**). @@ -80 +78,0 @@ When you select an integration type that you've used before, the console first d - 3. The console displays a table of existing integrations with columns for: @@ -82 +79,0 @@ When you select an integration type that you've used before, the console first d - * **Name** \- Integration name @@ -84 +81 @@ When you select an integration type that you've used before, the console first d - * **Status** \- The status of the integration (ex. Available, Completed with issues) +### Working with existing connectors @@ -86 +83 @@ When you select an integration type that you've used before, the console first d - * **Visibiliy** \- The visilibity level of the integration (ex. Personal, Shared) +When you choose a connector on the **Create for your team** tab that already exists, the console displays your existing connectors before offering to create a new one. @@ -88 +85 @@ When you select an integration type that you've used before, the console first d - * **Owner** \- The integration creator + 1. In the console, choose **Connectors**. @@ -90 +87 @@ When you select an integration type that you've used before, the console first d - * **Last Modified** \- Most recent update + 2. Choose the **Create for your team** tab. @@ -92 +89 @@ When you select an integration type that you've used before, the console first d - * **Actions** \- A dropdown menu to perform actions on existing integrations + 3. Choose a connector that you've configured before. @@ -94 +91 @@ When you select an integration type that you've used before, the console first d - 4. Choose an existing integration to view details, or choose add **+** to set up an additional connection. + 4. A dialog appears showing your existing connectors. To use an existing connector, choose it. To create a new one, choose **No, create new**. @@ -103 +100 @@ After creating integrations, you can manage them through several console options - * **Edit integration** \- Modify integration settings, authentication details, and configuration options + * **Edit integration** – Modify integration settings, authentication details, and configuration options. @@ -105 +102 @@ After creating integrations, you can manage them through several console options - * **Delete integration** \- Remove integrations with confirmation dialogs to prevent accidental deletion + * **Delete integration** – Remove integrations with confirmation dialogs to prevent accidental deletion. @@ -107 +104 @@ After creating integrations, you can manage them through several console options - * **Knowledge base management** \- Separate flows for creating, editing, and deleting knowledge bases associated with your integrations + * **Knowledge base management** – Separate flows for creating, editing, and deleting knowledge bases associated with your integrations.