本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 生產力的 is AWS AppFabric 是什麼？
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
**注意**
採用 Amazon Bedrock 技術： AWS 實作自動濫用[偵測](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html)。Because AWS AppFabric 的生產力建立在 Amazon Bedrock 上，使用者會繼承在 Amazon Bedrock 中實作的控制項，以強制執行 AI 的安全、安全性和負責任的使用。
AWS AppFabric for productivity （預覽） 透過從多個應用程式產生具有內容的洞察和動作，協助重新構想第三方應用程式中的最終使用者生產力。應用程式開發人員認識到，從其他應用程式存取使用者資料對於建立更具生產力的應用程式體驗至關重要，但他們不想建立和管理與每個應用程式的整合。透過 AppFabric 提高生產力，應用程式開發人員可以存取生成式 AI 支援的 APIs，以產生跨應用程式資料洞見和動作，以便他們可以透過新的或現有的生成式 AI 助理提供更豐富的最終使用者體驗。AppFabric for productivity 整合來自多個應用程式的資料，無需開發人員建置或維護point-to-point整合。應用程式開發人員可以直接將 AppFabric 的生產力嵌入其應用程式的 UI，為最終使用者維持一致的體驗，同時從其他應用程式浮現相關內容。
用於生產力的 AppFabric 會從常用的應用程式連接資料，例如 Asana、Atlassian Jira Suite、Google Workspace、Microsoft 365、Miro、Slack、 Smartsheet等。AppFabric 提高生產力可讓應用程式開發人員更輕鬆地建置更個人化的應用程式體驗，以改善使用者採用率、滿意度和忠誠度。同時，最終使用者可以從其應用程式間存取所需的洞見，而不會中斷其工作流程。
**Topics**
+ [優勢](#benefits)
+ [使用案例](#use-cases)
+ [存取 AppFabric 以提高生產力](#acessing-appfabric)
+ [開始使用 AppFabric 為應用程式開發人員提高生產力 （預覽）](getting-started-appdeveloper-productivity.md)
+ [開始使用 AppFabric 為最終使用者提高生產力 （預覽）](getting-started-users-productivity.md)
+ [生產力 APIs的 AppFabric （預覽）](productivity-apis.md)
+ [AppFabric 中的資料處理](productivity-data-processing.md)
## 優勢
透過 AppFabric 提高生產力，應用程式開發人員可以存取可產生跨應用程式資料洞見和動作APIs，以便透過新的或現有的生成式 AI 助理提供更豐富的最終使用者體驗。
+ **跨應用程式使用者資料的單一來源**：用於生產力的 AppFabric 整合了來自多個應用程式的資料，無需開發人員建置或維護point-to-point整合。處理 SaaS 應用程式資料以供其他應用程式使用，方法是將不同的資料類型自動標準化為任何應用程式可理解的格式，讓應用程式開發人員能夠整合更多資料，實際改善最終使用者的生產力。
+ **完全控制使用者體驗**：開發人員將 AppFabric 直接嵌入其應用程式的 UI 以提高生產力，保留使用者體驗的完全控制，同時為具有跨應用程式內容的最終使用者提供個人化的洞見和建議的動作。這可讓 AppFabric 在最終使用者的偏好 SaaS 應用程式中提高生產力，並可在他們偏好完成任務的應用程式中存取。最終使用者花較少的時間在應用程式之間切換，並且可以繼續工作。
+ **加速上市時間**：在單一 API 呼叫中，應用程式開發人員可以接收使用者資料的使用者層級洞見，而不必微調模型、撰寫自訂提示，或跨多個應用程式建置整合。AppFabric 可消除這種複雜性，讓應用程式開發人員更快地建置、嵌入或豐富生成式 AI 功能。這可讓應用程式開發人員專注於最重要的任務上的資源。
+ **建置使用者信任的成品參考**：作為輸出的一部分，用於生產力的 AppFabric 將呈現相關成品或來源檔案，用於產生洞見，以在 LLM 輸出中建置最終使用者信任。
+ **簡化的使用者許可**：用於產生洞見的使用者成品取決於使用者可存取的內容。AppFabric for productivity 使用 ISV 的許可和存取控制作為事實來源。
## 使用案例
應用程式開發人員可以使用 AppFabric 提高生產力，以重新構想其應用程式內的生產力。AppFabric for productivity 提供兩個著重於下列使用案例APIs，以協助最終使用者提高生產力：
+ 排定一天的優先順序
+ 可採取行動的洞見 API 可讓使用者從應用程式中及時獲得洞見，包括電子郵件、行事曆、訊息、任務等，以最佳方式管理他們的一天。此外，使用者可以執行跨應用程式動作，例如從他們偏好的應用程式建立電子郵件、排程會議和建立動作項目。例如，客戶呈報隔夜的員工不僅會看到隔夜對話的摘要，也會看到與客戶客戶經理安排會議的建議動作。動作會預先填入必要欄位 （例如任務名稱和擁有者，或電子郵件寄件者/收件人），能夠在執行動作之前編輯預先填入的內容。
+ 為即將舉行的會議做好準備
+ 會議準備 API 可摘要會議目的和出現相關的跨應用程式成品，例如電子郵件、訊息等，協助使用者為會議做好最佳準備。使用者現在可以快速準備會議，而且不會浪費在應用程式之間切換的時間來尋找內容。
## 存取 AppFabric 以提高生產力
AppFabric 生產力目前以預覽形式啟動，並在美國東部 （維吉尼亞北部） 提供 AWS 區域。如需 的詳細資訊 AWS 區域，請參閱《》中的 [AWS AppFabric 端點和配額](https://docs.aws.amazon.com/general/latest/gr/appfabric.html)*AWS 一般參考*。
在每個區域中，您可以透過下列任何方式存取 AppFabric 以提高生產力：
+ 身為應用程式開發人員
+ [開始使用 AppFabric 為應用程式開發人員提高生產力 （預覽）](getting-started-appdeveloper-productivity.md)
+ 身為最終使用者
+ [開始使用 AppFabric 為最終使用者提高生產力 （預覽）](getting-started-users-productivity.md)
# 開始使用 AppFabric 為應用程式開發人員提高生產力 （預覽）
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
本節協助應用程式開發人員將 AWS AppFabric 的生產力 （預覽版） 整合到應用程式中。 AWS AppFabric 的生產力可讓開發人員在多個應用程式中從電子郵件、行事曆事件、任務、訊息等產生 AI 支援的洞見和動作，為使用者建立更豐富的應用程式體驗。如需支援的應用程式清單，請參閱 [AWS AppFabric 支援的應用程式](https://aws.amazon.com/appfabric/supported-applications/)。
AppFabric for productivity 可讓應用程式開發人員在安全且受控的環境中進行建置和實驗。當您第一次開始使用 AppFabric 提高生產力時，您可以建立 AppClient 並註冊單一測試使用者。此方法旨在協助您了解和測試應用程式和 AppFabric 之間的身分驗證和通訊流程。使用單一使用者測試之後，您可以將應用程式提交至 AppFabric 進行驗證，然後再將存取權擴展至其他使用者 （請參閱 [步驟 5. 請求 AppFabric 驗證您的應用程式](#request_verification))。AppFabric 將在啟用廣泛採用之前驗證應用程式資訊，以協助保護應用程式開發人員、最終使用者及其資料，以負責任的方式擴展使用者採用。
**Topics**
+ [先決條件](#getting-started-prerequisites)
+ [步驟 1. 建立 AppFabric 以提高生產力 AppClient](#create_appclient)
+ [步驟 2. 驗證和授權您的應用程式](#authorize_data_access)
+ [步驟 3。將 AppFabric 使用者入口網站 URL 新增至您的應用程式](#end_user_portal)
+ [步驟 4. 使用 AppFabric 呈現跨應用程式洞見和動作](#surface_insights_actions)
+ [步驟 5. 請求 AppFabric 驗證您的應用程式](#request_verification)
+ [管理 AppFabric 以提高生產力 AppClients](manage-appclients.md)
+ [故障診斷 AppFabric 中的 AppClients 以提高生產力 AppFabric](ahead-app-dev-errors.md)
## 先決條件
開始使用之前，您需要建立 AWS 帳戶。如需詳細資訊，請參閱[註冊 AWS 帳戶](prerequisites.md#sign-up-for-aws)。您也需要建立至少一個可存取下列 `"appfabric:CreateAppClient"` IAM 政策的使用者，以允許使用者向 AppFabric 註冊您的應用程式。如需授予 AppFabric 生產力功能許可的詳細資訊，請參閱 [適用於生產力的 AppFabric IAM 政策範例](security_iam_id-based-policy-examples.md#appfabric-for-productivity-policy-examples)。雖然擁有管理使用者是有益的，但初始設定並非強制性的。如需詳細資訊，請參閱[建立具有管理存取權的使用者](prerequisites.md#create-an-admin)。
提高生產力的 AppFabric 僅適用於預覽期間的美國東部 （維吉尼亞北部）。開始以下步驟之前，請確定您位於此區域。
## 步驟 1. 建立 AppFabric 以提高生產力 AppClient
您需要建立 AppFabric AppClient，才能開始在應用程式中浮現 AppFabric 以取得生產力洞察。AppClient 基本上是 AppFabric 生產力的閘道，可做為安全 OAuth 應用程式用戶端運作，在您的應用程式和 AppFabric 之間進行安全通訊。當您建立 AppClient 時，您會收到 AppClient ID，這是確保 AppFabric 知道它正在與您的應用程式和您的 搭配使用的關鍵唯一識別符 AWS 帳戶。
AppFabric for productivity 可讓應用程式開發人員在安全且受控的環境中進行建置和實驗。當您第一次開始使用 AppFabric 提高生產力時，您可以建立 AppClient 並註冊單一測試使用者。此方法旨在協助您了解和測試應用程式和 AppFabric 之間的身分驗證和通訊流程。使用單一使用者測試之後，您可以將應用程式提交至 AppFabric 進行驗證，然後再將存取權擴展至其他使用者 （請參閱 [步驟 5. 請求 AppFabric 驗證您的應用程式](#request_verification))。AppFabric 將在啟用廣泛採用之前驗證應用程式資訊，以協助保護應用程式開發人員、最終使用者及其資料，以負責任的方式擴展使用者採用。
若要建立 AppClient，請使用 AWS AppFabric `CreateAppClient` API 操作。如果您需要在 之後更新 AppClient，您可以使用 `UpdateAppClient` API 操作僅變更 redirectUrls。如果您需要變更與 AppClient 相關聯的任何其他參數，例如 appName 或描述，您必須刪除 AppClient 並建立新的參數。如需詳細資訊，請參閱[CreateAppClient](API_CreateAppClient.md)。
您可以使用多種程式設計語言，包括 Python、Node.js、Java、C\$1、Go 和 Rust，使用 `CreateAppClient` API 向 AWS 服務註冊您的應用程式。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[請求簽章範例](https://docs.aws.amazon.com/IAM/latest/UserGuide/signature-v4-examples.html)。您需要使用帳戶簽章第 4 版登入資料來執行此 API 操作。如需簽章第 4 版的詳細資訊，請參閱《*IAM 使用者指南*》中的[簽署 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。
**請求欄位**
+ `appName` - AppFabric 使用者入口網站的同意頁面上將向使用者顯示的應用程式名稱。同意頁面會要求最終使用者在應用程式中顯示 AppFabric 洞見的許可。如需同意頁面的詳細資訊，請參閱 [步驟 2. 同意應用程式顯示洞見](getting-started-users-productivity.md#provide-consent)。
+ `description` - 應用程式的說明。
+ `redirectUrls` - 在授權後將最終使用者重新導向至 的 URI。您最多可以新增 5 個 redirectUrls。例如 `https://localhost:8080`。
+ `starterUserEmails` - 允許存取的使用者電子郵件地址，以接收洞見，直到驗證應用程式為止。僅允許一個電子郵件地址。例如 `anyuser@example.com`
+ `customerManagedKeyIdentifier` （選用） - 用於加密資料之客戶受管金鑰 （由 KMS 產生） 的 ARN。如果未指定，則會使用 AWS AppFabric 受管金鑰。如需 AWS 擁有的金鑰 和客戶受管金鑰的詳細資訊，請參閱《 *AWS Key Management Service 開發人員指南*》中的[客戶金鑰和 AWS 金鑰](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt)。
**回應欄位**
+ `appClientArn` - 包含 AppClient ID 的 Amazon Resource Name (ARN)。例如，AppClient ID 為 `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`。
+ `verificationStatus` - AppClient 驗證狀態。
+ `pending_verification` - AppFabric 驗證 AppClient 仍在進行中。 AppFabric 在驗證 AppClient 之前，只有一個使用者 （在 中指定`starterUserEmails`) 可以使用 AppClient。使用者會在 AppFabric 使用者入口網站中看到通知，在 中介紹[步驟 3。將 AppFabric 使用者入口網站 URL 新增至您的應用程式](#end_user_portal)，指出應用程式未驗證。
+ `verified` - AppFabric 已成功完成驗證程序，現在已完全驗證 AppClient。
+ `rejected` - AppFabric 已拒絕 AppClient 的驗證程序。 AppFabric 在重新啟動和成功完成驗證程序之前，其他使用者無法使用 AppClient。
```
curl --request POST \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: " \
--header "X-Amz-Security-Token: " \
--header "X-Amz-Date: 20230922T172215Z" \
--header "Authorization: AWS4-HMAC-SHA256 ..." \
--url https://appfabric..amazonaws.com/appclients/ \
--data '{
"appName": "Test App",
"description": "This is a test app",
"redirectUrls": ["https://localhost:8080"],
"starterUserEmails": ["anyuser@example.com"],
"customerManagedKeyIdentifier": "arn:aws:kms:::key/"
}'
```
如果動作成功，則服務傳回 HTTP 200 回應。
```
{
"appClientConfigSummary": {
"appClientArn": "arn:aws:appfabric:::appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"verificationStatus": "pending_verification"
}
}
```
## 步驟 2. 驗證和授權您的應用程式
建立 OAuth 2.0 授權流程，讓您的應用程式安全地整合 AppFabric 洞見。首先，您需要建立授權碼，以驗證您的應用程式身分。如需詳細資訊，請參閱[授權](API_Authorize.md)。然後，您將交換此授權碼做為存取字符，授予應用程式在應用程式中擷取和顯示 AppFabric 洞見的許可。如需詳細資訊，請參閱[權杖](API_Token.md)。
如需授予應用程式授權許可的詳細資訊，請參閱 [允許存取以授權應用程式](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-token)。
1. 若要建立授權碼，請使用 AWS AppFabric `oauth2/authorize` API 操作。
**請求欄位**
+ `app_client_id` （必要） - 在步驟 1 中 AWS 帳戶 建立之 的 AppClient ID。 [建立 AppClient](#create_appclient)。例如 `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`。
+ `redirect_uri` （必要） - 您在[步驟 1 中使用的授權後，將最終使用者重新導向至 的 URI。建立 AppClient](#create_appclient)。例如 `https://localhost:8080`。
+ `state` （必要） - 用來維護請求與回呼之間狀態的唯一值。例如 `a8904edc-890c-1005-1996-29a757272a44`。
```
GET https://productivity.appfabric..amazonaws.com/oauth2/authorize?app_client_id=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\
redirect_uri=https://localhost:8080&state=a8904edc-890c-1005-1996-29a757272a44
```
1. 身分驗證之後，系統會將您重新導向至指定的 URI，並將授權碼傳回為查詢參數。例如，其中 `code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`。
```
https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44
```
1. 使用 AppFabric `oauth2/token` API 操作交換此授權碼以取得存取權杖。
此字符用於 API 請求，最初對 有效，`starterUserEmails`直到 AppClient 驗證為止。驗證 AppClient 後，此字符可用於任何使用者。您需要使用帳戶簽章第 4 版登入資料來執行此 API 操作。如需簽章第 4 版的詳細資訊，請參閱《*IAM 使用者指南*》中的[簽署 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。
**請求欄位**
+ `code` （必要） - 您在最後一個步驟中驗證後收到的授權碼。例如 `mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`。
+ `app_client_id` （必要） - 在步驟 1 中 AWS 帳戶 建立之 的 AppClient ID。 [建立 AppClient](#create_appclient)。例如 `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`。
+ `grant_type` （必要） - 值必須為 `authorization_code`。
+ `redirect_uri` （必要） - 您在[步驟 1 中使用的授權後，將使用者重新導向至 的 URI。建立 AppClient](#create_appclient)。這必須是用來建立授權碼的相同重新導向 URI。例如 `https://localhost:8080`。
**回應欄位**
+ `expires_in` - 字符過期前多久。預設過期時間為 12 小時。
+ `refresh_token` - 從初始 /token 請求收到的重新整理字符。
+ `token` - 從初始 /token 請求收到的字符。
+ `token_type` - 值為 `Bearer`。
+ `appfabric_user_id` - AppFabric 使用者 ID。這只會針對使用 `authorization_code`授予類型的請求傳回。
```
curl --location \
"https://appfabric..amazonaws.com/oauth2/token" \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: " \
--header "X-Amz-Security-Token: " \
--header "X-Amz-Date: 20230922T172215Z" \
--header "Authorization: AWS4-HMAC-SHA256 ..." \
--data "{
\"code\": \"mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc",
\"app_client_id\": \"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\",
\"grant_type\": \"authorization_code\",
\"redirect_uri\": \"https://localhost:8080\"
}"
```
如果動作成功，則服務傳回 HTTP 200 回應。
```
{
"expires_in": 43200,
"refresh_token": "apkaeibaerjr2example",
"token": "apkaeibaerjr2example",
"token_type": "Bearer",
"appfabric_user_id" : ""
}
```
## 步驟 3。將 AppFabric 使用者入口網站 URL 新增至您的應用程式
最終使用者需要授權 AppFabric 從用於產生洞見的應用程式存取資料。AppFabric 透過為最終使用者建立專用使用者入口網站 （快顯畫面） 以授權其應用程式，消除應用程式開發人員擁有此程序的複雜性。當使用者準備好啟用 AppFabric 以提高生產力時，他們將被帶到使用者入口網站，這讓他們能夠連接和管理用於產生洞見和跨應用程式動作的應用程式。登入時，使用者可以將應用程式連線至 AppFabric 以提高生產力，然後返回您的應用程式來探索洞見和動作。若要將應用程式與 AppFabric 整合以提高生產力，您需要將特定的 AppFabric URL 新增至應用程式。此步驟對於讓使用者直接從應用程式存取 AppFabric 使用者入口網站至關重要。
1. 導覽至您應用程式的設定，並找到新增重新導向 URLs區段。
1. 找到適當的區域後，請將下列 AppFabric URL 做為重新導向 URL 新增至您的應用程式：
```
https://userportal.appfabric..amazonaws.com/eup_login
```
新增 URL 後，您的應用程式將設定為將使用者導向 AppFabric 使用者入口網站。在這裡，使用者可以登入和管理其用於產生 AppFabric 的應用程式，以取得生產力洞察。
## 步驟 4. 使用 AppFabric 呈現跨應用程式洞見和動作
使用者連線其應用程式後，您可以利用使用者的洞見，藉由協助減少應用程式和內容切換來提高生產力。AppFabric 只會根據使用者有權存取的內容，為使用者產生洞見。AppFabric 會將使用者資料存放在 AppFabric AWS 帳戶 擁有的 中。如需 AppFabric 如何使用您的資料的詳細資訊，請參閱 [AppFabric 中的資料處理](productivity-data-processing.md)。
您可以使用下列 AI 支援的 APIs在應用程式中產生和呈現使用者層級的洞見和動作：
+ `ListActionableInsights` — 如需詳細資訊，請參閱以下[可採取行動的洞察](#productivity-actionable-insights)一節。
+ `ListMeetingInsights` — 如需詳細資訊，請參閱本指南稍後[的會議準備](#productivity-meeting-insights)一節。
### 可行的洞見 (`ListActionableInsights`)
`ListActionableInsights` API 可協助使用者根據其應用程式的活動，包括電子郵件、行事曆、訊息、任務等，以最佳方式管理其日出的可行洞見。傳回的洞見也會顯示用於產生洞見的成品的內嵌連結，協助使用者快速檢視用於產生洞見的資料。此外，API 可能會根據洞見傳回建議的動作，並允許使用者從您的應用程式內執行跨應用程式動作。具體而言，API 會與 Asana、Microsoft 365、 Google Workspace和 等平台整合Smartsheet，讓使用者能夠傳送電子郵件、建立行事曆事件和建立任務。大型語言模型 (LLMs) 可能會在建議的動作 （例如電子郵件內文或任務名稱） 中預先填入詳細資訊，使用者可以在執行之前自訂這些動作，進而簡化決策並提高生產力。與最終使用者授權應用程式的體驗類似，AppFabric 使用相同的專用入口網站，讓使用者檢視、編輯和執行跨應用程式動作。對於執行動作，AppFabric 需要 ISVs 將使用者重新導向至 AppFabric 使用者入口網站，他們可以在此查看動作詳細資訊並執行它們。AppFabric 產生的每個動作都有唯一的 URL。此 URL 可用於 `ListActionableInsights` API 回應的回應。
以下是支援的跨應用程式動作和其中應用程式的摘要：
+ 傳送電子郵件 (Google Workspace、Microsoft 365)
+ 建立行事曆事件 (Google Workspace、Microsoft 365)
+ 建立任務 (Asana、Smartsheet)
**請求欄位**
+ `nextToken` （選用） - 擷取下一組洞見的分頁字符。
+ `includeActionExecutionStatus` - 接受動作執行狀態清單的篩選條件。動作會根據傳入的狀態值進行篩選。可能的值：`NOT_EXECUTED` \$1 `EXECUTED`
**請求標頭**
+ 授權標頭需要與 `Bearer Token `值一起傳入。
**回應欄位**
+ `insightId` - 產生洞見的唯一 ID。
+ `insightContent` - 這會將洞見和內嵌連結的摘要傳回用於產生洞見的成品。注意：這是包含內嵌連結 ( 標籤） 的 HTML 內容。
+ `insightTitle` - 產生的洞見標題。
+ `createdAt` - 產生洞見的時間。
+ `actions` - 針對產生的洞見建議的動作清單。動作物件：
+ `actionId` - 所產生動作的唯一 ID。
+ `actionIconUrl` - 建議在其中執行動作之應用程式的圖示 URL。
+ `actionTitle` - 所產生動作的標題。
+ `actionUrl` - 最終使用者在 AppFabric 使用者入口網站中檢視和執行動作的唯一 URL。注意：若要執行動作，ISV 應用程式會使用此 URL 將使用者重新導向至 AppFabric 使用者入口網站 （彈出畫面）。
+ `actionExecutionStatus` - 指出動作狀態的列舉。可能的值為： `EXECUTED` \$1 `NOT_EXECUTED`
+ `nextToken` （選用） - 擷取下一組洞見的分頁字符。這是一個選用欄位，如果傳回 null，表示沒有更多需要載入的洞見。
如需詳細資訊，請參閱[ActionableInsights](API_ActionableInsights.md)。
```
curl -v --location \
"https://productivity.appfabric..amazonaws.com"\
"/actionableInsights" \
--header "Authorization: Bearer "
```
如果動作成功，則服務傳回 HTTP 200 回應。
```
200 OK
{
"insights": [
{
"insightId": "7tff3412-33b4-479a-8812-30EXAMPLE1111",
"insightContent": "You received an email from James
regarding providing feedback
for upcoming performance reviews.",
"insightTitle": "New feedback request",
"createdAt": 2022-10-08T00:46:31.378493Z,
"actions": [
{
"actionId": "5b4f3412-33b4-479a-8812-3EXAMPLE2222",
"actionIconUrl": "https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg",
"actionTitle": "Send feedback request email",
"actionUrl": "https://userportal.appfabric.us-east-1.amazonaws.com/action/action_id_1"
"actionExecutionStatus": "NOT_EXECUTED"
}
]
},
{
"insightId": "2dff3412-33b4-479a-8812-30bEXAMPLE3333",
"insightContent":"Steve sent you an email asking for details on project. Consider replying to the email.",
"insightTitle": "New team launch discussion",
"createdAt": 2022-10-08T00:46:31.378493Z,
"actions": [
{
"actionId": "74251e31-5962-49d2-9ca3-1EXAMPLE1111",
"actionIconUrl": "https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg",
"actionTitle": "Reply to team launch email",
"actionUrl": "https://userportal.appfabric.us-east-1.amazonaws.com/action/action_id_2"
"actionExecutionStatus": "NOT_EXECUTED"
}
]
}
],
"nextToken": null
}
```
### 會議準備 (`ListMeetingInsights`)
`ListMeetingInsights` API 可摘要會議目的和出現相關的跨應用程式成品，例如電子郵件、訊息等，協助使用者為即將舉行的會議做好最佳準備。使用者現在可以快速準備會議，而且不會浪費時間在應用程式之間切換來尋找內容。
**請求欄位**
+ `nextToken` （選用） - 擷取下一組洞見的分頁字符。
**請求標頭**
+ 授權標頭需要與 `Bearer Token`值一起傳入。
**回應欄位**
+ `insightId` - 產生洞見的唯一 ID。
+ `insightContent` - 以字串格式強調詳細資訊的洞見描述。如同 ，為什麼此洞見很重要。
+ `insightTitle` - 產生的洞見標題。
+ `createdAt` - 產生洞見的時間。
+ `calendarEvent` - 使用者應關注的重要行事曆事件或會議。行事曆事件物件：
+ `startTime` - 事件的開始時間。
+ `endTime` - 事件的結束時間。
+ `eventUrl` - ISV 應用程式上行事曆事件的 URL。
+ `resources` - 包含與 相關其他資源的清單會產生洞見。資源物件：
+ `appName` - 資源所屬的應用程式名稱。
+ `resourceTitle` - 資源標題。
+ `resourceType` - 資源的類型。可能的值為： `EMAIL` \$1 `EVENT` \$1 `MESSAGE` \$1 `TASK`
+ `resourceUrl` - 應用程式中的資源 URL。
+ `appIconUrl` - 資源所屬之應用程式的影像 URL。
+ `nextToken` （選用） - 擷取下一組洞見的分頁字符。這是一個選用欄位，如果傳回 null，表示沒有更多需要載入的洞見。
如需詳細資訊，請參閱[MeetingInsights](API_MeetingInsights.md)。
```
curl --location \
"https://productivity.appfabric..amazonaws.com"\
"/meetingContexts" \
--header "Authorization: Bearer "
```
如果動作成功，則服務傳回 HTTP 201 回應。
```
200 OK
{
"insights": [
{
"insightId": "74251e31-5962-49d2-9ca3-15EXAMPLE4444"
"insightContent": "Project demo meeting coming up soon. Prepare accordingly",
"insightTitle": "Demo meeting next week",
"createdAt": 2022-10-08T00:46:31.378493Z,
"calendarEvent": {
"startTime": {
"timeInUTC": 2023-10-08T10:00:00.000000Z,
"timeZone": "UTC"
},
"endTime": {
"timeInUTC": 2023-10-08T11:00:00.000000Z,
"timeZone": "UTC"
},
"eventUrl": "http://someapp.com/events/1234",
}
"resources": [
{
"appName": "SOME_EMAIL_APP",
"resourceTitle": "Email for project demo",
"resourceType": "EMAIL",
"resourceUrl": "http://someapp.com/emails/1234",
"appIconUrl":"https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg"
}
]
},
{
"insightId": "98751e31-5962-49d2-9ca3-15EXAMPLE5555"
"insightContent": "Important code complete task is now due. Consider updating the status.",
"insightTitle": "Code complete task is due",
"createdAt": 2022-10-08T00:46:31.378493Z,
"calendarEvent":{
"startTime": {
"timeInUTC": 2023-10-08T10:00:00.000000Z,
"timeZone": "UTC"
},
"endTime": {
"timeInUTC": 2023-10-08T11:00:00.000000Z,
"timeZone": "UTC"
},
"eventUrl": "http://someapp.com/events/1234",
},
"resources": [
{
"appName": "SOME_TASK_APPLICATION",
"resourceTitle": "Code Complete task is due",
"resourceType": "TASK",
"resourceUrl": "http://someapp.com/task/1234",
"appIconUrl": "https://d3gdwnnn63ow7w.cloudfront.net/eup/123.svg"
}
]
}
],
"nextToken": null
}
```
### 為您的洞見或動作提供意見回饋
使用 AppFabric `PutFeedback` API 操作，為產生的洞見和動作提供意見回饋。您可以在應用程式中嵌入此功能，以提供提交特定 InsightId 或 ActionId 意見回饋評分 (1 到 5，評分越高） 的方法。
**請求欄位**
+ `id` - 要提交意見回饋之物件的識別符。這可以是 InsightId 或 ActionId。
+ `feedbackFor` - 要提交意見回饋的資源類型。可能的值：`ACTIONABLE_INSIGHT` \$1 `MEETING_INSIGHT` \$1 `ACTION`
+ `feedbackRating` - 從 `1`到 的意見回饋評分`5`。評分越高越好。
**回應欄位**
+ 沒有回應欄位。
如需詳細資訊，請參閱[PutFeedback](API_PutFeedback.md)。
```
curl --request POST \
--url "https://productivity.appfabric..amazonaws.com"\
"/feedback" \
--header "Authorization: Bearer " \
--header "Content-Type: application/json" \
--data '{
"id": "1234-5678-9012",
"feedbackFor": "ACTIONABLE_INSIGHT"
"feedbackRating": 3
}'
```
如果動作成功，則服務會傳回具有空 HTTP 內文的 HTTP 201 回應。
## 步驟 5. 請求 AppFabric 驗證您的應用程式
此時，您已更新應用程式 UI 以嵌入 AppFabric 跨應用程式洞見和動作，並收到單一使用者的洞見。當您對測試感到滿意，並想要將 AppFabric 豐富的體驗擴展到其他使用者之後，您可以將應用程式提交至 AppFabric 進行審核和驗證。AppFabric 將在啟用廣泛採用之前驗證應用程式資訊，以協助保護應用程式開發人員、最終使用者及其資料，以負責任的方式擴展使用者採用。
**啟動驗證程序**
傳送電子郵件至 [appfabric-appverification@amazon.com](mailto:appfabric-appverification@amazon.com) 並要求驗證您的應用程式，以開始驗證程序。
在您的電子郵件中包含下列詳細資訊：
+ 您的 AWS 帳戶 ID
+ 您要驗證的應用程式名稱
+ 您的 AppClient ID
+ 您的聯絡資訊
此外，如果可用，請提供以下資訊，以協助我們評估優先順序和影響：
+ 您計劃授予存取權的預估使用者數量
+ 您的目標啟動日期
**注意**
如果您有 AWS 帳戶 經理或 AWS 合作夥伴開發經理，請在您的電子郵件中複製他們。包含這些聯絡人有助於加速驗證程序。
**驗證條件**
啟動驗證程序之前，您必須符合下列條件：
+ 您必須使用有效的 AWS 帳戶 ，才能使用 AppFabric 提高生產力
此外，您至少符合下列其中一項條件：
+ 您的組織是 上的 AWS 合作夥伴，至少 AWS Partner Network 具有「AWS 選取」層。如需詳細資訊，請參閱 [AWS 合作夥伴服務方案](https://aws.amazon.com/partners/services-tiers/)。
+ 您的組織在過去三年內應該已在 AppFabric 服務上花費至少 10，000 美元。
+ 您的應用程式應列在 上 AWS Marketplace。如需詳細資訊，請參閱 [AWS Marketplace](https://aws.amazon.com/marketplace)。
**等待驗證狀態更新**
檢閱您的應用程式後，我們會透過電子郵件回應，您的 AppClient 狀態將從 變更為 `pending_verification` `verified`。如果您的應用程式遭到拒絕，您將需要重新啟動驗證程序。
# 管理 AppFabric 以提高生產力 AppClients
| |
| --- |
| 生產力的 The AWS AppFabric 功能為預覽版，可能會有所變更。 |
您可以管理 AppFabric 以提高生產力 AppClients，以確保身分驗證和授權程序的順暢操作和維護。
## 取得 AppClient 的詳細資訊
使用 AppFabric `GetAppClient` API 操作來檢視 AppClient 的詳細資訊，包括檢查 AppClient 狀態。如需詳細資訊，請參閱[GetAppClient](API_GetAppClient.md)。
若要取得 AppClient 的詳細資訊，您至少必須擁有 `"appfabric:GetAppClient"` IAM 政策許可。如需詳細資訊，請參閱[允許存取以取得 AppClients 的詳細資訊](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-get-appclient)。
**請求欄位**
+ `appClientId` - AppClient ID。
**回應欄位**
+ `appName` - AppFabric 使用者入口網站的同意頁面上將向使用者顯示的應用程式名稱。
+ `customerManagedKeyIdentifier` （選用） - 用於加密資料之客戶受管金鑰 （由 KMS 產生） 的 ARN。如果未指定，則會使用 AWS AppFabric 受管金鑰。
+ `description` - 應用程式的描述。
+ `redirectUrls` - 授權後將最終使用者重新導向至 的 URI。您最多可以新增 5 個 redirectUrls。例如 `https://localhost:8080`。
+ `starterUserEmails` - 允許存取的使用者電子郵件地址，以接收洞見，直到驗證應用程式為止。僅允許一個電子郵件地址。例如 `anyuser@example.com`。
+ `verificationStatus` - AppClient 驗證狀態。
+ `pending_verification` - AppClient 的驗證仍在 AppFabric 進行。驗證 AppClient 之前，只有一個使用者 （在 中指定`starterUserEmails`) 可以使用 AppClient。
+ `verified` - AppFabric 已成功完成驗證程序，現在已完整驗證 AppClient。
+ `rejected` - AppFabric 已拒絕 AppClient 的驗證程序。 AppFabric 在驗證程序重新啟動並成功完成之前，其他使用者無法使用 AppClient。
```
curl --request GET \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: " \
--header "X-Amz-Security-Token: " \
--header "X-Amz-Date: 20230922T172215Z" \
--header "Authorization: AWS4-HMAC-SHA256 ..." \
--url https://appfabric..amazonaws.com/appclients/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
如果動作成功，則服務傳回 HTTP 200 回應。
```
200 OK
{
"appClient": {
"appName": "Test App",
"arn": "arn:aws:appfabric::111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"customerManagedKeyArn": "arn:aws:kms::111122223333:key/",
"description": "This is a test app",
"redirectUrls": [
"https://localhost:8080"
],
"starterUserEmails": [
"anyuser@example.com"
],
"verificationDetails": {
"verificationStatus": "pending_verification"
}
}
}
```
## 列出 AppClients
使用 AppFabric `ListAppClients` API 操作來檢視 AppClients 的清單。AppFabric 每個 僅允許一個 AppClient AWS 帳戶。這可能會在未來變更。如需詳細資訊，請參閱[ListAppClients](API_ListAppClients.md)。
若要列出 AppClients，您至少必須擁有 `"appfabric:ListAppClients"` IAM 政策許可。如需詳細資訊，請參閱[允許存取列出 AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-list-appclient)。
**請求欄位**
+ 沒有必要欄位。
**回應欄位**
+ `appClientARN` - 包含 AppClient ID 的 Amazon Resource Name (ARN)。例如，AppClient ID 為 `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`。
+ `verificationStatus` - AppClient 驗證狀態。
+ `pending_verification` - AppClient 的驗證仍在 AppFabric 進行。驗證 AppClient 之前，只有一個使用者 （在 中指定`starterUserEmails`) 可以使用 AppClient。
+ `verified` - AppFabric 已成功完成驗證程序，現在已完整驗證 AppClient。
+ `rejected` - AppFabric 已拒絕 AppClient 的驗證程序。 AppFabric 在驗證程序重新啟動並成功完成之前，其他使用者無法使用 AppClient。
```
curl --request GET \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: " \
--header "X-Amz-Security-Token: " \
--header "X-Amz-Date: 20230922T172215Z" \
--header "Authorization: AWS4-HMAC-SHA256 ..." \
--url https://appfabric..amazonaws.com/appclients
```
如果動作成功，則服務傳回 HTTP 200 回應。
```
200 OK
{
"appClientList": [
{
"appClientArn": "arn:aws:appfabric::111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"verificationStatus": "pending_verification"
}
]
}
```
## 更新 AppClient
使用 AppFabric `UpdateAppClient` API 操作來更新映射至 AppClient 的 redirectUrls。如果您需要變更任何其他參數，例如 AppName、starterUserEmails 或其他參數，您必須刪除 AppClient 並建立新的參數。如需詳細資訊，請參閱[UpdateAppClient](API_UpdateAppClient.md)。
若要更新 AppClient，您至少必須擁有 `"appfabric:UpdateAppClient"` IAM 政策許可。如需詳細資訊，請參閱[允許存取以更新 AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient)。
**請求欄位**
+ `appClientId` （必要） - 您要更新 redirectUrls 的 AppClient ID。
+ `redirectUrls` （必要） - redirectUrls 的更新清單。您最多可以新增 5 個 redirectUrls。
**回應欄位**
+ `appName` - AppFabric 使用者入口網站的同意頁面上將向使用者顯示的應用程式名稱。
+ `customerManagedKeyIdentifier` （選用） - 用於加密資料之客戶受管金鑰 （由 KMS 產生） 的 ARN。如果未指定，則會使用 AWS AppFabric 受管金鑰。
+ `description` - 應用程式的描述。
+ `redirectUrls` - 授權後將最終使用者重新導向至 的 URI。例如 `https://localhost:8080`。
+ `starterUserEmails` - 允許存取的使用者電子郵件地址，以接收洞見，直到驗證應用程式為止。僅允許一個電子郵件地址。例如 `anyuser@example.com`。
+ `verificationStatus` - AppClient 驗證狀態。
+ `pending_verification` - AppClient 的驗證仍在 AppFabric 進行。驗證 AppClient 之前，只有一個使用者 （在 中指定`starterUserEmails`) 可以使用 AppClient。
+ `verified` - AppFabric 已成功完成驗證程序，現在已完整驗證 AppClient。
+ `rejected` - AppFabric 已拒絕 AppClient 的驗證程序。 AppFabric 在驗證程序重新啟動並成功完成之前，其他使用者無法使用 AppClient。
```
curl --request PATCH \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: " \
--header "X-Amz-Security-Token: " \
--header "X-Amz-Date: 20230922T172215Z" \
--header "Authorization: AWS4-HMAC-SHA256 ..." \
--url https://appfabric..amazonaws.com/appclients/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--data '{
"redirectUrls": ["https://localhost:8081"]
}'
```
如果動作成功，則服務傳回 HTTP 200 回應。
```
200 OK
{
"appClient": {
"appName": "Test App",
"arn": "arn:aws:appfabric::111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"customerManagedKeyArn": "arn:aws:kms::111122223333:key/",
"description": "This is a test app",
"redirectUrls": [
"https://localhost:8081"
],
"starterUserEmails": [
"anyuser@example.com"
],
"verificationDetails": {
"verificationStatus": "pending_verification"
}
}
}
```
## 刪除 AppClient
使用 AppFabric `DeleteAppClient` API 操作刪除您不再需要的任何 AppClients。如需詳細資訊，請參閱[DeleteAppClient](API_DeleteAppClient.md)。
若要刪除 AppClient，您至少必須擁有 IAM `"appfabric:DeleteAppClient"` 政策許可。如需詳細資訊，請參閱[允許存取以刪除 AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-delete-appclient)。
**請求欄位**
+ `appClientId` - AppClient ID。
**回應欄位**
+ 沒有回應欄位。
```
curl --request DELETE \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: " \
--header "X-Amz-Security-Token: " \
--header "X-Amz-Date: 20230922T172215Z" \
--header "Authorization: AWS4-HMAC-SHA256 ..." \
--url https://appfabric..amazonaws.com/appclients/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。
## 重新整理最終使用者的字符
AppClient 為最終使用者取得的權杖可以在到期時重新整理。您可以使用 [權杖](API_Token.md) API 搭配 grant\$1type 來完成此操作`refresh_token`。當 grant\$1type 為 時，將傳回`refresh_token`要使用的 做為字符 API 回應的一部分`authorization_code`。預設過期時間為 12 小時。若要呼叫重新整理 API，您必須擁有 IAM `"appfabric:Token"` 政策許可。如需詳細資訊，請參閱[權杖](API_Token.md)及[允許存取以更新 AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient)。
**請求欄位**
+ `refresh_token` （必要） - 從初始`/token`請求收到的重新整理字符。
+ `app_client_id` （必要） - 為 建立的 AppClient 資源 ID AWS 帳戶。
+ `grant_type` （必要） - 這必須是 `refresh_token`。
**回應欄位**
+ `expires_in` - 字符過期前多久。預設過期時間為 12 小時。
+ `refresh_token` - 從初始 / 權杖請求收到的重新整理權杖。
+ `token` - 從初始 / 權杖請求收到的權杖。
+ `token_type` - 值為 `Bearer`。
+ `appfabric_user_id` - AppFabric 使用者 ID。這只會針對使用 `authorization_code`授予類型的請求傳回。
```
curl --location \
"https://appfabric..amazonaws.com/oauth2/token" \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: " \
--header "X-Amz-Security-Token: " \
--header "X-Amz-Date: 20230922T172215Z" \
--header "Authorization: AWS4-HMAC-SHA256 ..." \
--data "{
\"refresh_token\": \"",
\"app_client_id\": \"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\",
\"grant_type\": \"refresh_token\"
}"
```
如果動作成功，則服務傳回 HTTP 200 回應。
```
200 OK
{
"expires_in": 43200,
"token": "apkaeibaerjr2example",
"token_type": "Bearer",
"appfabric_user_id" : "${UserID}"
}
```
# 故障診斷 AppFabric 中的 AppClients 以提高生產力 AppFabric
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
本節說明 AppFabric 生產力的常見錯誤和疑難排解。
## 未驗證的應用程式
使用 AppFabric 提高生產力的應用程式開發人員，在向最終使用者啟動其功能之前，會先經過驗證程序。所有應用程式都開始為未驗證，只有在驗證程序完成時才會變更為已驗證。這表示`starterUserEmails`您在建立 AppClient 時使用的 會看到此訊息。
![\[Warning message for an unverified application in AWS AppFabric, requesting data access.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-24.png)
## `CreateAppClient` 錯誤
### ServiceQuotaExceededException
如果您在建立 AppClient 時收到下列例外狀況，表示您已超過每個 可建立的 AppClients 數量 AWS 帳戶。限制為 1。HTTP 狀態碼：402
```
ServiceQuotaExceededException / SERVICE_QUOTA_EXCEEDED
You have exceeded the number of AppClients that can be created per AWS Account. The limit is 1.
HTTP Status Code: 402
```
## `GetAppClient` 錯誤
### ResourceNotFoundException
如果您在取得 AppClient 的詳細資訊時收到下列例外狀況，請確定您已輸入正確的 AppClient 識別符。此錯誤表示找不到指定的 AppClient。
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## `DeleteAppClient` 錯誤
### ConflictException
如果您在刪除 AppClient 時收到下列例外狀況，表示另一個刪除請求正在進行中。請等到它完成，然後再試一次。HTTP 狀態碼：409
```
ConflictException
Another delete request is in progress. Wait until it completes then try again.
HTTP Status Code: 409
```
### ResourceNotFoundException
如果您在刪除 AppClient 時收到下列例外狀況，請確定您已輸入正確的 AppClient 識別符。此錯誤表示找不到指定的 AppClient。
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## `UpdateAppClient` 錯誤
### ResourceNotFoundException
如果您在更新 AppClient 時收到下列例外狀況，請確定您已輸入正確的 AppClient 識別符。此錯誤表示找不到指定的 AppClient。
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## `Authorize` 錯誤
### ValidationException
如果任何 API 參數不符合 API 規格中定義的限制條件，您可能會收到下列例外狀況。
```
ValidationException
HTTP Status Code: 400
```
**原因 1：未指定 AppClient ID 時**
請求參數中`app_client_id`缺少 。如果尚未建立 AppClient，請建立 AppClient，或使用您現有的 AppClient`app_client_id`，然後再試一次。若要尋找 AppClient ID，請使用 [ListAppClient](manage-appclients.md#list_appclients) API 操作。
**原因 2：當 AppFabric 無法存取客戶受管金鑰時**
```
Message: AppFabric couldn't access the customer managed key configured for AppClient.
```
AppFabric 目前無法存取客戶受管金鑰，可能是因為其許可最近有所變更。驗證指定的金鑰是否存在，並確保 AppFabric 獲得適當的存取許可。
**原因 3：指定的重新導向 URL 無效**
```
Message: Redirect url invalid
```
確保請求中的重新導向 URL 正確。它必須符合您在建立或更新 AppClient 時指定的其中一個重新導向 URLs。若要檢視允許的重新導向 URLs 清單，請使用 [GetAppClient](manage-appclients.md#get_appclient_details) API 操作。
## `Token` 錯誤
### TokenException
您可能會因為幾個原因而收到下列例外狀況。
```
TokenException
HTTP Status Code: 400
```
**原因 1：指定無效電子郵件時**
```
Message: Invalid Email used
```
確保您使用的電子郵件地址與您建立 AppClient 時為 `starterUserEmails` 屬性列出的電子郵件地址相符。如果電子郵件不相符，請變更為相符的電子郵件地址，然後再試一次。若要檢視使用的電子郵件，請使用 [GetAppClient](manage-appclients.md#get_appclient_details) API 操作。
**原因 2：未指定字符時，Grant\$1type 為 refresh\$1token。**
```
Message: refresh_token must be non-null for Refresh Token Grant-type
```
請求中指定的重新整理字符為 null 或空白。在[字符](getting-started-appdeveloper-productivity.md#authorize_data_access) API 呼叫回應中指定`refresh_token`收到的作用中 。
### ThrottlingException
如果 API 的呼叫速率超過允許的配額，您可能會收到下列例外狀況。
```
ThrottlingException
HTTP Status Code: 429
```
## `ListActionableInsights`、 `ListMeetingInsights`和 `PutFeedback`錯誤
### ValidationException
如果任何 API 參數不符合 API 規格上定義的限制條件，您可能會收到下列例外狀況。
```
ValidationException
HTTP Status Code: 400
```
### ThrottlingException
如果 API 的呼叫速率超過允許的配額，您可能會收到下列例外狀況。
```
ThrottlingException
HTTP Status Code: 429
```
# 開始使用 AppFabric 為最終使用者提高生產力 （預覽）
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
本節適用於希望 enable AWS AppFabric 提高生產力 （預覽） 以改善其任務管理和工作流程效率的 SaaS 應用程式最終使用者。請依照下列步驟來連接您的應用程式，並授權 AppFabric 呈現跨應用程式洞見，並協助您從偏好的應用程式完成動作 （例如傳送電子郵件或安排會議）。您可以連接應用程式，例如 Asana、Atlassian Jira Suite、Google Workspace、Microsoft 365、Miro、Slack、 Smartsheet等。在您授權 AppFabric 存取您的內容後，AppFabric 會在您偏好的應用程式中直接提供跨應用程式洞見和動作，協助您更有效率地工作，並保持在目前的工作流程中。
AppFabric 的生產力使用採用 Amazon Bedrock 技術的生成式 AI。AppFabric 只會在收到明確許可後產生洞見和動作。您授權每個個別應用程式保持完全控制使用的內容。AppFabric 不會使用您的資料來訓練或改善用於產生洞見的基礎大型語言模型。如需詳細資訊，請參閱 [Amazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/)。
**Topics**
+ [先決條件](#getting-started-prerequisites)
+ [步驟 1. 登入 AppFabric](#sign-in-appfabric)
+ [步驟 2. 同意應用程式顯示洞見](#provide-consent)
+ [步驟 3。連接您的應用程式以產生洞見和動作](#connect-apps)
+ [步驟 4. 開始在您的應用程式中查看洞見並執行跨應用程式動作](#insights_in_app)
+ [管理對 AppFabric 的存取，以提高 IT 和安全管理員的生產力 （預覽） 功能](productivity-end-users-managing-access.md)
+ [針對 AppFabric 中的最終使用者錯誤進行故障診斷，以提高生產力](productivity-end-users-errors.md)
## 先決條件
開始之前，請確定您有下列項目：
+ 登入 AppFabric 的登入資料：若要開始使用 AppFabric 提高生產力，您需要下列其中一個供應商的聯合登入登入資料 （使用者名稱和密碼）：Asana、Microsoft 365、 Google Workspace或 Slack。登入 AppFabric 可協助我們將您識別為啟用 AppFabric 以提高生產力的每個應用程式的使用者。登入後，您可以連接應用程式以開始產生洞見。
+ 連接應用程式的登入資料：跨應用程式洞見和動作只會根據您授權的應用程式產生。對於您要授權的每個應用程式，您將需要登入憑證 （使用者名稱和密碼）。支援的應用程式包括 Asana、Atlassian Jira Suite、Google Workspace、Microsoft 365、Slack、 Miro和 Smartsheet。
## 步驟 1. 登入 AppFabric
將應用程式連線至 AppFabric，以直接在偏好的應用程式中提供您的內容和洞見。
1. 每個應用程式都會以不同的方式使用 AppFabric 來提高生產力，讓您擁有更豐富的應用程式體驗。因此，每個應用程式都會有不同的進入點，以到達以下 AppFabric 提高生產力首頁。首頁會設定程序的相關內容，以啟用 AppFabric，並先提示您登入。您想要在 中啟用 AppFabric 的每個應用程式都會到達此畫面。
![\[Sign-in prompt for AWS AppFabric, highlighting AI-powered productivity features.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-01.png)
1. 使用其中一個供應商的登入資料登入：Asana、Microsoft 365、 Google Workspace或 Slack。為了獲得最佳體驗，建議您為啟用 AppFabric 的每個應用程式使用相同的供應商登入。例如，如果您在 App1 中選擇 Google Workspace 登入資料，我們建議您在 App2 Google Workspace 中選擇，以及每隔當您需要重新登入時選擇一次。如果您使用不同的供應商登入，則需要重新啟動連線應用程式的程序。
![\[AWS AppFabric sign-in page with options for Slack, Microsoft, Google, and Asana.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-02.png)
1. 如果出現提示，請輸入您的登入憑證，並接受來自此供應商的登入 AppFabric。
![\[Slack sign-in page with options for Google, Apple, or email authentication.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-03.png)
![\[Sign-in interface for AWS AppFabric with Slack, showing account selection and connection details.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-04.png)
## 步驟 2. 同意應用程式顯示洞見
登入後，AppFabric 會顯示同意頁面，詢問您是否允許 AppFabric 在啟用 AppFabric 以提高生產力的應用程式內顯示跨應用程式洞見和動作。例如，您是否允許 AppFabric 接收您的Google Workspace電子郵件和行事曆事件，並將其顯示在 中Asana。您只需要在每個啟用 AppFabric 的應用程式完成此同意步驟一次。
![\[Dialog box requesting permission to display insights and artifacts within an application.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-05.png)
## 步驟 3。連接您的應用程式以產生洞見和動作
完成同意頁面後，系統會將您導向 **Connect 應用程式**頁面，您可以在其中連接、中斷連線或重新連線最終用來產生跨應用程式洞見和動作的個別應用程式。在大多數情況下，在您登入並提供同意後，您將繼續使用此頁面來管理您的連線應用程式。
若要連接應用程式，請選擇您使用的任何應用程式旁的**連線**按鈕。
![\[List of applications to connect, including Smartsheet, Slack, and Google Workspace, all showing as not connected.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-06.png)
您需要提供應用程式的登入憑證，並允許 AppFabric 存取您的資料以產生洞見和完成動作。
![\[Dialog box requesting permission for AWS AppFabric to access Slack workspace data.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-07.png)
成功連接應用程式後，該應用程式的狀態將從「未連線」變更為「已連線」。提醒：您需要為要用於產生洞見和動作的每個應用程式完成此授權步驟。
連接應用程式後，應用程式不會永遠連接。您需要定期重新連接應用程式。我們這樣做是為了確保我們仍然擁有產生洞見的許可。
可能的應用程式狀態為：
+ 已連線 - AppFabric 已獲授權，且正在使用來自此應用程式的資料產生洞見。
+ 未連線 - AppFabric 不會使用此應用程式中的資料產生洞見。您可以連線 以開始產生洞見。
+ 授權失敗。請重新連線。- 特定應用程式可能發生授權失敗。如果您看到此錯誤，請嘗試使用 **Connect** 按鈕重新連接應用程式。
![\[Application connection status interface showing connected and unconnected apps.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-08.png)
設定已完成，您可以返回您的應用程式。可能需要至少幾個小時才能開始在您的應用程式中看到洞見。
您可以視需要導覽回此頁面，以管理連線的應用程式。如果您選擇**中斷**連接應用程式，AppFabric 將停止使用該應用程式的資料，或收集新資料以產生新的洞見。如果您選擇在該時間不重新連線應用程式，則會在 7 天內自動刪除中斷連線應用程式的資料。
## 步驟 4. 開始在您的應用程式中查看洞見並執行跨應用程式動作
將應用程式與 AppFabric 連線後，您將能夠存取寶貴的洞見，並能夠直接從您偏好的應用程式執行跨應用程式動作。注意：每個應用程式不保證此功能，並且完全取決於應用程式開發人員選擇啟用哪些 AppFabric 的生產力功能。
**跨應用程式洞見**
AppFabric for productivity 提供兩種類型的洞見：
+ 可行的洞見：AppFabric 會分析連線應用程式中電子郵件、行事曆事件、任務和訊息中的資訊，並產生重要洞見，以便您排定優先順序。此外，AppFabric 可能會產生建議的動作 （例如傳送電子郵件、排程會議和建立任務），您可以在保留在偏好的應用程式中時編輯和執行這些動作。例如，您可能會收到洞見，指出需要處理客戶呈報，並建議下一個動作來安排與客戶的會議。
+ 會議準備洞察：此功能可協助您為即將舉行的會議做好最佳準備。AppFabric 將分析您即將舉行的會議，並產生有關會議目的的簡潔摘要。此外，它會顯示連線應用程式的相關成品 （例如電子郵件、訊息和任務），這有助於您有效地準備會議，而無需在應用程式之間切換以尋找內容。
**跨應用程式動作**
對於某些洞見，AppFabric 也可能會產生建議的動作，例如傳送電子郵件、安排會議或建立任務。產生動作時，AppFabric 可能會根據連線應用程式的內容和內容預先填入特定欄位。例如，AppFabric 可能會根據洞見產生建議的電子郵件回應或任務名稱。當您按一下建議的動作時，系統會將您導向 AppFabric 擁有的使用者介面，您可以在其中編輯預先填入的內容，然後再執行動作。AppFabric 不會在沒有使用者檢閱和先輸入的情況下執行動作，因為生成式 AI 和基礎大型語言模型 (LLM) 可能會不時出現幻覺。
**注意**
您有責任驗證和確認 AppFabric LLM 輸出。AppFabric 不保證其 LLM 輸出的準確性或品質。如需詳細資訊，請參閱[AWS 負責任的 AI 政策](https://aws.amazon.com/machine-learning/responsible-ai/policy/)。
### 建立電子郵件 (Google Workspace、Microsoft 365)
AppFabric 可讓您從偏好的應用程式內編輯和傳送電子郵件。我們支援基本電子郵件欄位，包括寄件者、收件人、副本/副本、電子郵件主旨行和電子郵件內文訊息。AppFabric 可能會在這些欄位中產生內容，以協助您縮短完成任務的時間。完成編輯電子郵件後，請選擇**傳送**以傳送電子郵件。
傳送電子郵件時需要下列欄位：
+ 至少需要其中一個收件人電子郵件 （收件人、CC 和 BCC)，而且必須是有效的電子郵件地址。
+ 主旨行和訊息欄位。
![\[Email form with From, To, CC, BCC, Subject line, and Message fields for sending.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-12.png)
傳送電子郵件後，您會看到電子郵件已傳送的確認。此外，您會在指定的應用程式中看到檢視電子郵件的連結。您可以使用此連結快速導覽至應用程式，並確認電子郵件已傳送。
![\[Email sent confirmation with recipient details and message preview.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-13.png)
### 建立行事曆事件 (Google Workspace、Microsoft 365)
AppFabric 可讓您從偏好的應用程式內編輯和建立行事曆事件。我們支援基本行事曆事件欄位，包括事件標題、位置、開始/結束時間和日期、受邀者清單和事件詳細資訊。AppFabric 可能會在這些欄位中產生內容，以協助您縮短完成任務的時間。編輯行事曆事件完成後，請選擇**建立**以建立事件。
建立行事曆事件時需要下列欄位：
+ 標題、開始、結束和描述欄位。
+ 開始時間和日期不得早於結束時間和日期。
+ 邀請欄位是選用的，但如果提供，則需要有效的電子郵件地址。
![\[Calendar event creation form with title, time, location, invitees, and description fields.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-14.png)
傳送行事曆事件後，您會看到事件已建立的確認。此外，您會在指定的應用程式中看到檢視事件的連結。您可以使用此連結快速導覽至應用程式，並確認事件已建立。
![\[Calendar event creation confirmation with event details and option to view in Google Calendar.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-15.png)
### 建立任務 (Asana)
AppFabric 可讓您Asana在偏好的應用程式中，在 中編輯和建立任務。我們支援基本任務欄位，例如任務名稱、任務擁有者、到期日和任務描述。AppFabric 可能會在這些欄位中產生內容，以協助您縮短建立任務的時間。完成編輯任務後，請選擇**建立**以建立任務。任務是在適用的Asana工作區或專案或任務中建立，如 LLM 所建議。
建立Asana任務需要下列欄位：
+ 標題和描述欄位。
+ 如果修改，被指派者必須是有效的電子郵件地址。
![\[Create Task form with fields for title, assignee, due date, and description for a finance meeting task.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-16.png)
建立任務後，您會看到任務已在 中建立的確認Asana。此外，您會看到在 中檢視任務的連結Asana。您可以使用此連結快速導覽至應用程式，以驗證任務是否已建立，或將其移至適當的Asana工作區或專案或任務。
![\[Task creation confirmation with details and a link to view in Asana.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-17.png)
### 建立任務 (Smartsheet)
AppFabric 可讓您Smartsheet在偏好的應用程式中，在 中編輯和建立任務。我們支援基本任務欄位，例如任務名稱、任務擁有者、到期日和任務描述。AppFabric 可能會在這些欄位中產生內容，以協助您縮短建立任務的時間。完成編輯任務後，請選擇**建立**以建立任務。對於Smartsheet任務，AppFabric 將建立新的私有Smartsheet工作表，並填入任何建立的任務。這是為了協助以結構化方式將 AppFabric 產生的動作集中在單一位置。
建立Smartsheet任務需要下列欄位：
+ 標題和描述欄位。
+ 如果提供，被指派者必須是有效的電子郵件地址。
![\[Create Task form with fields for title, assignees, due date, and description for an AWS AppFabric Action.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-18.png)
建立任務後，您會看到任務已在 中建立的確認Smartsheet。此外，您會看到在 中檢視任務的連結Smartsheet。您可以使用此連結快速導覽至應用程式，以在建立的Smartsheet工作表中檢視任務。所有未來的Smartsheet任務都會填入此工作表中。如果工作表已刪除，AppFabric 將建立新的工作表。
![\[AWS AppFabric Action interface showing a successfully created task with details.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-19.png)
# 管理對 AppFabric 的存取，以提高 IT 和安全管理員的生產力 （預覽） 功能
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
AppFabric for productivity 使用者入口網站可供已與 AppFabric 整合以實現生產力 （預覽） 功能的 SaaS 應用程式所有使用者公開存取。如果您是想要管理組織內這些生成式 AI 功能的存取權的 IT 管理員，請考慮以下選項：
+ 限制身分提供者 (IdP) 登入：您可以透過身分提供者封鎖登入存取，以控制使用者對生成式 AI 功能的存取。
+ 停用特定應用程式的 OAuth：停用 OAuth 來實作下游限制。此動作可防止使用者將需要 OAuth 身分驗證的應用程式連線至公司的工作區。
# 針對 AppFabric 中的最終使用者錯誤進行故障診斷，以提高生產力
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
本節說明 AppFabric 生產力的常見錯誤和疑難排解。
## 未驗證的應用程式
使用 AppFabric 提高生產力的應用程式，在向最終使用者啟動其功能之前，將會經過驗證程序。如果您在嘗試登入 AppFabric 時遇到「未驗證」橫幅，這表示應用程式尚未經過 AppFabric 驗證程序，以確認應用程式開發人員的身分和應用程式註冊資訊的準確性。所有應用程式都開始為未驗證，只有在驗證程序完成時才會變更為已驗證。
使用未經驗證的應用程式時請小心。如果您不確定應用程式開發人員，您可以等到應用程式達到已驗證狀態後再繼續。
![\[Warning message for an unverified application in AWS AppFabric, advising caution before authorization.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-20.png)
## 發生錯誤。請再試一次，或向您的管理員確認 (`InternalServerException`)
當 AppFabric 使用者入口網站因為未知錯誤、例外狀況或失敗而無法列出應用程式或中斷連接應用程式時，您可能會收到此訊息。請稍後再試。
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-23.png)
## 由於請求調節，因此請求遭到拒絕。請稍後再試 (`ThrottlingException`)
當 AppFabric 使用者入口網站因限流問題而無法列出應用程式或中斷連接應用程式時，您可能會收到此訊息。請稍後再試。
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-22.png)
## 您無權使用 AppFabric。請再次登入 AppFabric (`AccessDeniedException`)
當 AppFabric 使用者入口網站因為存取遭拒的例外狀況而無法列出應用程式或中斷連接應用程式時，您可能會收到此訊息。再次登入 AppFabric。
![\[Connect applications interface showing connected and unconnected apps with action buttons.\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/images/fabric-21.png)
# 生產力 APIs的 AppFabric （預覽）
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
本節提供 API 操作、資料類型和常見錯誤，適用於 the AWS AppFabric 生產力功能。
**注意**
如需所有其他 AppFabric APIs請參閱 [AWS AppFabric API 參考](https://docs.aws.amazon.com/appfabric/latest/api/)。
**Topics**
+ [提高生產力的 AppFabric API 動作 （預覽）](productivity-actions.md)
+ [提高生產力的 AppFabric API 資料類型 （預覽）](productivity-data-types.md)
+ [提高生產力的 AppFabric 常見 API 錯誤 （預覽）](productivity-common-errors.md)
# 提高生產力的 AppFabric API 動作 （預覽）
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
AppFabric 的生產力功能支援下列動作。
如需所有其他 AppFabric API 動作，請參閱 [AWS AppFabric API 動作](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html)。
**Topics**
+ [授權](API_Authorize.md)
+ [CreateAppClient](API_CreateAppClient.md)
+ [DeleteAppClient](API_DeleteAppClient.md)
+ [GetAppClient](API_GetAppClient.md)
+ [ListActionableInsights](API_ListActionableInsights.md)
+ [ListAppClients](API_ListAppClients.md)
+ [ListMeetingInsights](API_ListMeetingInsights.md)
+ [PutFeedback](API_PutFeedback.md)
+ [權杖](API_Token.md)
+ [UpdateAppClient](API_UpdateAppClient.md)
# 授權
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
授權 AppClient。
**Topics**
+ [請求內文](#API_Authorize_request)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **app\$1client\$1id** | 要授權的 AppClient ID。 |
| **redirect\$1uri** | 授權後將最終使用者重新導向至 的 URI。 |
| **state** | 用來維護請求與回呼之間狀態的唯一值。 |
# CreateAppClient
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
建立 AppClient。
**Topics**
+ [請求內文](#API_CreateAppClient_request)
+ [回應元素](#API_CreateAppClient_response)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **appName** | 應用程式的名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 255。 必要：是 |
| **clientToken** | 指定您提供的唯一、區分大小寫的識別符，以確保請求的冪等性。這可讓您安全地重試請求，而不會意外再次執行相同的操作。將相同的值傳遞給稍後的 操作呼叫，也需要您為所有其他參數傳遞相同的值。我們建議您使用 [UUID 類型的值](https://wikipedia.org/wiki/Universally_unique_identifier)。 如果您未提供此值，則 會為您 AWS 產生隨機值。 如果您使用相同的 重試操作`ClientToken`，但使用不同的參數，則重試會失敗並顯示`IdempotentParameterMismatch`錯誤。 類型：字串 模式：`[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必要：否 |
| **customerManagedKeyIdentifier** | 由 客戶受管金鑰 產生的 ARN AWS Key Management Service。金鑰用於加密資料。 如果未指定金鑰，則會 AWS 受管金鑰 使用 。要指派給資源之標籤或標籤的鍵值對映射。 如需 AWS 擁有的金鑰 和客戶受管金鑰的詳細資訊，請參閱《 *AWS Key Management Service 開發人員指南*》中的[客戶金鑰和 AWS 金鑰](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt)。 類型：字串 長度限制：長度下限為 1。長度上限為 1011。 模式：`arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必要：否 |
| **description** | 應用程式的說明。 類型：字串 必要：是 |
| **iconUrl** | AppClient 圖示或標誌的 URL。 類型：字串 必要：否 |
| **redirectUrls** | 授權後將最終使用者重新導向至 的 URI。您最多可以新增 5 個 redirectUrls。例如 `https://localhost:8080`。 類型：字串陣列 陣列成員：項目數下限為 1。項目數上限為 5。 長度限制：長度下限為 1。長度上限為 2048。 模式：`(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` 必要：是 |
| **starterUserEmails** | 允許存取以接收洞見的使用者的入門電子郵件地址，直到 AppClient 驗證為止。 類型：字串陣列 陣列成員：固定項目數為 1。 長度限制：長度下限為 0。長度上限為 320。 模式：`[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` 必要：是 |
| **tags** | 要指派給資源之標籤或標籤的鍵值對映射。 類型：標籤物件陣列 陣列成員：項目數下限為 0。項目數上限為 50。 必要：否 |
## 回應元素
如果動作成功，則服務傳回 HTTP 201 回應。
服務會傳回下列 JSON 格式的資料。
| 參數 | Description |
| --- | --- |
| **appClientSummary** | 包含 AppClient 的摘要。 類型：[AppClientSummary](API_AppClientSummary.md) 物件 |
# DeleteAppClient
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
刪除應用程式用戶端。
**Topics**
+ [請求內文](#API_DeleteAppClient_request)
+ [回應元素](#API_DeleteAppClient_response)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **appClientIdentifier** | 要用於請求之 AppClient 的 Amazon Resource Name (ARN) 或 Universal Unique Identifier (UUID)。 長度限制：長度下限為 1。長度上限為 1011。 模式：`arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必要：是 |
## 回應元素
如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。
# GetAppClient
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
傳回 AppClient 的相關資訊。
**Topics**
+ [請求內文](#API_GetAppClient_request)
+ [回應元素](#API_GetAppClient_response)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **appClientIdentifier** | 要用於請求之 AppClient 的 Amazon Resource Name (ARN) 或 Universal Unique Identifier (UUID)。 長度限制：長度下限為 1。長度上限為 1011。 模式：`arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必要：是 |
## 回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
| 參數 | Description |
| --- | --- |
| **appClient** | 包含 AppClient 的相關資訊。 類型：[AppClient](API_AppClient.md) 物件 |
# ListActionableInsights
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
列出最重要的可行電子郵件訊息、任務和其他更新。
**Topics**
+ [請求內文](#API_ListActionableInsights_request)
+ [回應元素](#API_ListActionableInsights_response)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **nextToken** | 如果傳回 `nextToken` ，則有更多結果可用。的值`nextToken`是每個頁面的唯一分頁字符。使用傳回的字符再次進行呼叫，以擷取下一頁。讓所有其他引數保持不變。每個分頁字符會在 24 小時後過期。使用過期的分頁字符將傳回 *HTTP 400 InvalidToken 錯誤*。 |
## 回應元素
如果動作成功，則服務傳回 HTTP 201 回應。
服務會傳回下列 JSON 格式的資料。
| 參數 | Description |
| --- | --- |
| **ActionableInsightsList** | 列出可行的洞見，包括標題、描述、動作和建立的時間戳記。如需詳細資訊，請參閱[ActionableInsights](API_ActionableInsights.md)。 |
| **nextToken** | 如果傳回 `nextToken` ，則有更多結果可用。的值`nextToken`是每個頁面的唯一分頁字符。使用傳回的字符再次進行呼叫，以擷取下一頁。讓所有其他引數保持不變。每個分頁字符會在 24 小時後過期。使用過期的分頁字符將傳回 *HTTP 400 InvalidToken 錯誤*。 類型：字串 |
# ListAppClients
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
傳回所有 AppClients 的清單。
**Topics**
+ [請求內文](#API_ListAppClients_request)
+ [回應元素](#API_ListAppClients_response)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **maxResults** | 每次呼叫傳回的結果數目上限。您可以使用 `nextToken` 取得進一步的結果頁面。 這只是上限。每次呼叫傳回的實際結果數量可能少於指定的最大值。 有效範圍：最小值為 1。最大值為 100。 |
| **nextToken** | 如果傳回 `nextToken` ，則有更多結果可用。的值`nextToken`是每個頁面的唯一分頁字符。使用傳回的字符再次進行呼叫，以擷取下一頁。讓所有其他引數保持不變。每個分頁字符會在 24 小時後過期。使用過期的分頁字符將傳回 *HTTP 400 InvalidToken 錯誤*。 |
## 回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
| 參數 | Description |
| --- | --- |
| **appClientList** | 包含 AppClient 結果的清單。 類型：[AppClientSummary](API_AppClientSummary.md) 物件的陣列 |
| **nextToken** | 如果傳回 `nextToken` ，則有更多結果可用。的值`nextToken`是每個頁面的唯一分頁字符。使用傳回的字符再次進行呼叫，以擷取下一頁。讓所有其他引數保持不變。每個分頁字符會在 24 小時後過期。使用過期的分頁字符將傳回 *HTTP 400 InvalidToken 錯誤*。 類型：字串 |
# ListMeetingInsights
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
列出最重要的可行行事曆事件。
**Topics**
+ [請求內文](#API_ListMeetingInsights_request)
+ [回應元素](#API_ListMeetingInsights_response)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **nextToken** | 如果傳回 `nextToken` ，則有更多結果可用。的值`nextToken`是每個頁面的唯一分頁字符。使用傳回的字符再次進行呼叫，以擷取下一頁。讓所有其他引數保持不變。每個分頁字符會在 24 小時後過期。使用過期的分頁字符將傳回 *HTTP 400 InvalidToken 錯誤*。 |
## 回應元素
如果動作成功，則服務傳回 HTTP 201 回應。
服務會傳回下列 JSON 格式的資料。
| 參數 | Description |
| --- | --- |
| **MeetingInsightList** | 列出可行的會議洞見。如需詳細資訊，請參閱[MeetingInsights](API_MeetingInsights.md)。 |
| **nextToken** | 如果傳回 `nextToken` ，則有更多結果可用。的值`nextToken`是每個頁面的唯一分頁字符。使用傳回的字符再次進行呼叫，以擷取下一頁。讓所有其他引數保持不變。每個分頁字符會在 24 小時後過期。使用過期的分頁字符將傳回 *HTTP 400 InvalidToken 錯誤*。 類型：字串 |
# PutFeedback
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
允許使用者提交特定洞見或動作的意見回饋。
**Topics**
+ [請求內文](#API_PutFeedback_request)
+ [回應元素](#API_PutFeedback_response)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **id** | 正在提交意見回饋的物件 ID。這可以是 InsightId 或 ActionId。 |
| **feedbackFor** | 正在提交意見回饋的洞見類型。 可能的值： `ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION` |
| **feedbackRating** | 從 `1`到 的意見回饋評分`5`。評分越高越好。 |
## 回應元素
如果動作成功，則服務會傳回具有空 HTTP 內文的 HTTP 201 回應。
# 權杖
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
包含的資訊可讓 AppClients 交換存取字符的授權碼。
**Topics**
+ [請求內文](#API_Token_request)
+ [回應元素](#API_Token_response)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **code** | 從授權端點收到的授權碼。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 必要：否 |
| **grant\$1type** | 字符的授予類型。必須為 `authorization_code` 或 `refresh_token`。 類型：字串 必要：是 |
| **app\$1client\$1id** | AppClient 的 ID。 類型：字串 模式：`[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必要：是 |
| **redirect\$1uri** | 傳遞至授權端點的重新導向 URI。 類型：字串 必要：否 |
| **refresh\$1token** | 從初始權杖請求收到的重新整理權杖。 類型：字串 長度限制：長度下限為 1。長度上限為 4096。 必要：否 |
## 回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
| 參數 | Description |
| --- | --- |
| **appfabric\$1user\$1id** | 字符的使用者 ID。這只會針對使用 `authorization_code`授予類型的請求傳回。 類型：字串 |
| **expires\$1in** | 直到字符過期的秒數。 類型：Long |
| **refresh\$1token** | 用於後續請求的重新整理字符。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 |
| **t**oken | 存取字符。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 |
| **token\$1type** | 字符類型。 類型：字串 |
# UpdateAppClient
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
更新 AppClient。
**Topics**
+ [請求內文](#API_UpdateAppClient_request)
+ [回應元素](#API_UpdateAppClient_response)
## 請求內文
請求接受採用 JSON 格式的下列資料。
| 參數 | Description |
| --- | --- |
| **appClientIdentifier** | 要用於請求之 AppClient 的 Amazon Resource Name (ARN) 或 Universal Unique Identifier (UUID)。 長度限制：長度下限為 1。長度上限為 1011。 模式：`arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必要：是 |
| **redirectUrls** | 授權後要將最終使用者重新導向至 的 URI。您最多可以新增 5 個 redirectUrls。例如 `https://localhost:8080`。 類型：字串陣列 陣列成員：項目數下限為 1。項目數上限為 5。 長度限制：長度下限為 1。長度上限為 2048。 模式：`(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` |
## 回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
| 參數 | Description |
| --- | --- |
| **appClient** | 包含 AppClient 的相關資訊。 類型：[AppClient](API_AppClient.md) 物件 |
# 提高生產力的 AppFabric API 資料類型 （預覽）
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
AppFabric API 包含各種動作使用的多種資料類型。本節詳細說明適用於生產力功能的 AppFabric 資料類型。
如需所有其他 AppFabric API 資料類型，請參閱 [AWS AppFabric API 資料類型](https://docs.aws.amazon.com/appfabric/latest/api/API_Types.html)。
**重要**
不保證資料類型結構中每個元素的順序。應用程式不該認定採取某一特定順序。
**Topics**
+ [ActionableInsights](API_ActionableInsights.md)
+ [AppClient](API_AppClient.md)
+ [AppClientSummary](API_AppClientSummary.md)
+ [MeetingInsights](API_MeetingInsights.md)
+ [VerificationDetails](API_VerificationDetails.md)
# ActionableInsights
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
包含根據使用者應用程式產品組合中的電子郵件、行事曆邀請、訊息和任務，為使用者提供重要和適當動作的摘要。使用者可以跨應用程式查看主動洞見，以協助他們以最佳方式安排一天的方向。這些洞見提供理由，說明使用者為何應該關心洞見摘要以及產生洞見的個別應用程式和成品的參考，例如內嵌連結。
| 參數 | Description |
| --- | --- |
| **insightId** | 所產生洞見的唯一 ID。 |
| **insightContent** | 這會將洞見和內嵌連結的摘要傳回用於產生洞見的成品。 這是包含內嵌連結 (`` 標籤） 的 HTML 內容。 |
| **insightTitle** | 產生的洞見標題。 |
| **createdAt** | 產生洞見的時間。 |
| **動作** | 為產生的洞見建議的動作清單。 動作物件包含下列參數： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/API_ActionableInsights.html) |
# AppClient
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
包含 AppClient 的相關資訊。
**Topics**
| 參數 | Description |
| --- | --- |
| **appName** | 應用程式名稱。 類型：字串 必要：是 |
| **arn** | AppClient 的 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度下限為 1。長度上限為 1011。 模式：`arn:.+` 必要：是 |
| **description** | 應用程式的說明。 類型：字串 必要：是 |
| **iconUrl** | AppClient 圖示或標誌的 URL。 類型：字串 必要：否 |
| **redirectUrls** | AppClient 允許的重新導向 URLs。 類型：字串陣列 陣列成員：項目數下限為 1。項目數上限為 5。 長度限制：長度下限為 1。長度上限為 2048。 模式：`(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` 必要：是 |
| **starterUserEmails** | 允許存取以接收洞見的使用者的入門電子郵件地址，直到 AppClient 驗證為止。 類型：字串陣列 陣列成員：固定項目數為 1。 長度限制：長度下限為 0。長度上限為 320。 模式：`[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` 必要：是 |
| **verificationDetails** | 包含 AppClient 驗證的狀態和原因。 類型：[VerificationDetails](API_VerificationDetails.md) 物件 必要：是 |
| **customerManagedKeyArn** | AWS Key Management Service 為 AppClient 產生的 客戶受管金鑰 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度下限為 1。長度上限為 1011。 模式：`arn:.+` 必要：否 |
| **appClientId** | AppClient 的 ID。表示用於應用程式用戶端的 o-auth 流程。 類型：字串 模式：`[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必要：否 |
# AppClientSummary
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
包含 AppClient 的相關資訊。
**Topics**
| 參數 | Description |
| --- | --- |
| **arn** | AppClient 的 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度下限為 1。長度上限為 1011。 模式：`arn:.+` 必要：是 |
| **verificationStatus** | AppClient 驗證狀態。 類型：字串 有效值:`pending_verification \| verified \| rejected` 必要：是 |
| **appClientId** | AppClient 的 ID。表示用於應用程式用戶端的 o-auth 流程。 類型：字串 模式：`[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必要：否 |
# MeetingInsights
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
包含前 3 個會議的摘要，以及會議目的、相關的跨應用程式成品，以及任務、電子郵件、訊息和行事曆事件的活動。
| 參數 | Description |
| --- | --- |
| **insightId** | 所產生洞見的唯一 ID。 |
| **insightContent** | 洞見的描述會以字串格式反白顯示詳細資訊。如 所示，為什麼此洞見很重要。 |
| **insightTitle** | 產生的洞見標題。 |
| **createdAt** | 產生洞見的時間。 |
| **calendarEvent** | 使用者應關注的重要行事曆事件或會議。 行事曆事件物件： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **resources** | 包含與 相關其他資源的清單會產生洞見。 資源物件： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **nextToken** | 擷取下一組洞見的分頁字符。這是一個選用欄位，如果傳回 null，表示沒有更多需要載入的洞見。 |
# VerificationDetails
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
包含 AppClient 驗證的狀態和原因。
**Topics**
| 參數 | Description |
| --- | --- |
| **verificationStatus** | AppClient 驗證狀態。 類型：字串 有效值:`pending_verification \| verified \| rejected` 必要：是 |
| **statusReason** | AppClient 驗證狀態原因。 類型：字串 長度限制：長度下限為 1。長度上限為 1024。 必要：否 |
# 提高生產力的 AppFabric 常見 API 錯誤 （預覽）
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
本節列出 API 動作對於 the AWS AppFabric 生產力功能的常見錯誤。
如需所有其他 AppFabric 常見 API 錯誤，請參閱《AppFabric API 參考》中的 [故障診斷 AppFabric 中的 AppClients 以提高生產力 AppFabric](ahead-app-dev-errors.md)和 AppFabric API 常見錯誤。 [AWS AppFabric ](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html) *AWS AppFabric *
| 例外狀況名稱 | Description |
| --- | --- |
| **TokenException** | 字符請求無效。 HTTP 狀態碼：400 |
# AppFabric 中的資料處理
| |
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 |
AppFabric 會採取步驟，將使用者內容個別存放在由 AppFabric 管理的 Amazon S3 儲存貯體中，並個別存放；這有助於確保我們產生使用者特定的洞見。我們使用合理的保護措施來保護您的內容，其中可能包括靜態加密和傳輸中加密。我們已將系統設定為在擷取後 30 天內自動刪除客戶內容。AppFabric 不會使用使用者無法再存取的資料成品產生洞見。例如，當使用者中斷連線資料來源 （應用程式） 時，AppFabric 會停止從該應用程式收集資料，而且不會從中斷連線的應用程式使用任何停留成品來產生洞見。AppFabric 的系統設定為在 30 天內刪除此類資料。
AppFabric 不會使用使用者內容來訓練或改善用於產生洞見的基礎大型語言模型。如需 AppFabric 生成式 AI 功能的詳細資訊，請參閱 [Amazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/)。
## 靜態加密
AWS AppFabric 支援靜態加密，這是一種伺服器端加密功能，其中 AppFabric 會在使用者保留到磁碟時透明地加密與使用者相關的所有資料，並在您存取資料時解密這些資料。
## 傳輸中加密
AppFabric 使用 TLS 1.2 保護傳輸中的所有內容，並使用 AWS Signature 第 4 版簽署 AWS 服務的 API 請求。