本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 什么才是 AWS AppFabric 为了提高工作效率？
| |
| --- |
| “ AWS AppFabric 提高生产力” 功能处于预览阶段，可能会发生变化。 |
**注意**
由 Amazon Bedrock 提供支持： AWS 实现自动滥用[检测](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html)。由于 AWS AppFabric 工作效率建立在 Amazon Bedrock 之上，因此用户继承了 Amazon Bedrock 中实施的控制措施，以强制执行安全、安保和负责任地使用人工智能。
AWS AppFabric for productive（预览版）通过从多个应用程序中生成基于上下文的见解和操作，帮助重新构想第三方应用程序中最终用户的工作效率。应用程序开发人员认识到，从其他应用程序访问用户数据对于创建更高效的应用程序体验很重要，但他们不想构建和管理与每个应用程序的集成。 AppFabric 为了提高工作效率，应用程序开发人员可以访问生成式人工智能，这些生成式人工智能 APIs 可以生成跨应用程序的数据见解和操作，因此他们可以通过新的或现有的生成式人工智能助手提供更丰富的最终用户体验。 AppFabric 为了提高工作效率，可以集成来自多个应用程序的数据，开发人员无需构建或维护 point-to-point集成。 AppFabric 为了提高工作效率，应用程序开发人员可以直接嵌入到其应用程序的用户界面中，为最终用户保持一致的体验，同时显示来自其他应用程序的相关上下文。
AppFabric 为了提高工作效率，可以连接来自常用应用程序（例如AsanaAtlassian 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)
+ [AppFabric 提高工作效率 APIs （预览）](productivity-apis.md)
+ [中的数据处理 AppFabric](productivity-data-processing.md)
## 优势
AppFabric 为了提高工作效率，应用程序开发人员可以访问生成跨应用程序数据见解和操作的信息，这样他们就可以通过新的或现有的生成式 AI 助手提供更丰富的最终用户体验。 APIs
+ **跨应用程序用户数据的单一来源**： AppFabric 为了提高工作效率，可以集成来自多个应用程序的数据，开发人员无需构建或维护 point-to-point集成。通过自动将不同的数据类型标准化为任何应用程序都能理解的格式，从而处理 SaaS 应用程序数据以供其他应用程序使用，这样让应用程序开发人员能够整合更多数据，从而真正提高最终用户的工作效率。
+ **完全控制用户体验**：开发人员将工作效率直接嵌入 AppFabric 到其应用程序的用户界面中，保持对用户体验的完全控制，同时向最终用户提供个性化的见解和操作建议，并提供来自整个应用程序的上下文。这使得 AppFabric 最终用户首选的 SaaS 应用程序可以提高工作效率，也可以在他们想要完成任务的应用程序中进行访问。最终用户花在应用程序之间切换的时间更少，并且可以保持在工作流程中。
+ **加快上市时间**：在单个 API 调用中，应用开发者无需微调模型、编写自定义提示或跨多个应用程序构建集成，即可获得对用户生成的数据的用户级见解。 AppFabric 将这种复杂性抽象出来，使应用程序开发者能够更快地构建、嵌入或丰富生成式 AI 功能。这使应用程序开发人员能够将资源集中在最重要的任务上。
+ A@@ **rtifactic 引用以建立用户信任**：作为产出的一部分， AppFabric 为了提高工作效率，将显示相关的工件或源文件，这些工件或源文件用于生成见解，从而建立最终用户对LLM输出的信任。
+ **简化的用户权限**：用于生成见解的用户构件基于用户有权访问的内容。 AppFabric 为了提高工作效率，使用 ISV 的权限和访问控制作为事实来源。
## 使用案例
应用程序开发人员可以利用提高 AppFabric 工作效率来重新构想其应用程序内部的生产力。 AppFabric for productivity 提供了两个 APIs 侧重于以下用例的内容，以帮助最终用户提高工作效率：
+ 优先安排您的一天
+ 可操作的见解 API 通过显示来自其应用程序（包括电子邮件、日历、消息、任务等）的及时见解，帮助用户更好地管理自己的一天。此外，用户还可以通过其首选应用程序执行跨应用程序操作，例如创建电子邮件、安排会议和创建操作项目。例如，在一夜之间进行客户上报的员工不仅可以看到一夜之间对话的摘要，还可以看到安排与客户的客户经理召开会议的建议操作。操作预先填充了必填字段（如任务名称和所有者，或电子邮件发件人/收件人），可以在执行操作之前编辑预先填充的内容。
+ 为即将召开的会议做准备
+ 会议准备 API 通过总结会议目的并显示相关的跨应用程序构件（如电子邮件、消息等），帮助用户为会议做好最充分的准备。用户现在可以快速为会议做准备，不用浪费时间在应用程序之间切换来查找内容。
## 访问 AppFabric 以提高工作效率
AppFabric for productive 目前已作为预览版推出，并在美国东部（弗吉尼亚北部）推出 AWS 区域。有关的更多信息 AWS 区域，请参阅中的[AWS AppFabric 终端节点和配额*AWS 一般参考*](https://docs.aws.amazon.com/general/latest/gr/appfabric.html)。
在每个区域，您可以通过以下任何一种方式 AppFabric 进行访问以提高工作效率：
+ 作为应用程序开发人员
+ [AppFabric 面向应用程序开发人员的生产力入门（预览版）](getting-started-appdeveloper-productivity.md)
+ 作为最终用户
+ [开始使用 AppFabric 提高最终用户的工作效率（预览版）](getting-started-users-productivity.md)
# AppFabric 面向应用程序开发人员的生产力入门（预览版）
| |
| --- |
| “ AWS AppFabric 提高生产力” 功能处于预览阶段，可能会发生变化。 |
本节帮助应用程序开发者将提高 AWS AppFabric 工作效率（预览）集成到他们的应用程序中。 AWS AppFabric 提高生产力使开发人员能够通过跨多个应用程序的电子邮件、日历事件、任务、消息等生成人工智能驱动的见解和操作，从而为用户打造更丰富的应用程序体验。有关支持的应用程序的列表，请参阅[AWS AppFabric 支持的应用程序](https://aws.amazon.com/appfabric/supported-applications/)。
AppFabric 提高工作效率为应用程序开发者提供了在安全可控的环境中进行构建和实验的权限。当你第一次开始使用提高 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)
+ [进行故障排除 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 以获取生产力见解之前，您需要创建一个 AppFabric AppClient. 本质上 AppClient 是您提高工作效率 AppFabric 的门户，它充当安全的 OAuth 应用程序客户端，可实现应用程序与之间的安全通信 AppFabric。当你创建时 AppClient，你会得到一个 AppClient ID，这是一个唯一的标识符，对于确保它 AppFabric 知道它正在与你的应用程序和你的应用程序一起使用至关重要 AWS 账户。
AppFabric 提高工作效率为应用程序开发者提供了在安全可控的环境中进行构建和实验的权限。当你第一次开始使用提高 AppFabric 工作效率时，你需要创建一个 AppClient并注册一个测试用户。此方法旨在帮助您了解和测试应用程序与之间的身份验证和通信流 AppFabric。在对单个用户进行测试后，您可以先将申请提交给 AppFabric 进行验证，然后再将访问权限扩展到其他用户（请参阅[步骤 5。 AppFabric 请求验证您的申请](#request_verification)）。 AppFabric 将在实现广泛采用之前验证应用程序信息，以帮助保护应用程序开发人员、最终用户及其数据，从而为以负责任的方式扩大用户采用率铺平道路。
要创建 AppClient，请使用 AWS AppFabric `CreateAppClient` API 操作。如果您需要更新 AppClient 后面的内容，则可以使用 `UpdateAppClient` API 操作仅更改 redirectURL。如果您需要更改与您的关联的任何其他参数（ AppClient 例如 AppName 或描述），则必须删除 AppClient 并创建一个新参数。有关更多信息，请参阅 [CreateAppClient](API_CreateAppClient.md)。
你可以使用 `CreateAppClient` API 使用多种编程语言（包括 Python、Node.js、Java、C\$1、Go 和 Rust）向 AWS 服务注册应用程序。有关更多信息，请参阅《*IAM 用户指南*》中的[请求签名示例](https://docs.aws.amazon.com/IAM/latest/UserGuide/signature-v4-examples.html)。您需要使用账户签名版本 4 凭证才能执行此 API 操作。有关签名版本 4 的更多信息，请参阅 I *AM 用户指南*中的[签署 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 个 redirectUrl。例如 `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`-包含编号的亚马逊资源名称 (ARN)。 AppClient 例如， AppClient ID 是`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`。
+ `verificationStatus`- AppClient 验证状态。
+ `pending_verification`-的验证 AppClient仍在进行中 AppFabric。在 AppClient 验证之前，只有一个用户（在中指定`starterUserEmails`）可以使用 AppClient。用户将在 AppFabric 用户门户中看到一条通知（如中所述）[步骤 3：将 AppFabric 用户门户 URL 添加到您的应用程序](#end_user_portal)，表示该应用程序未通过验证。
+ `verified`-验证过程已成功完成 AppFabric ，现 AppClient 已完全验证。
+ `rejected`-的验证过程 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 的更多信息，请参阅 I *AM 用户指南*中的[签署 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 将用户数据存储在 AWS 账户 所有者中 AppFabric。有关如何 AppFabric 使用您的数据的信息，请参阅[中的数据处理 AppFabric](productivity-data-processing.md)。
您可以使用 APIs 以下 AI 驱动的工具在应用程序中生成和显示用户级见解和操作：
+ `ListActionableInsights` — 有关更多信息，请参阅下面的[可操作的见解](#productivity-actionable-insights)部分。
+ `ListMeetingInsights` — 有关更多信息，请参阅本指南后面的[会议准备](#productivity-meeting-insights)部分。
### 可操作的见解 (`ListActionableInsights`)
`ListActionableInsights` API 可帮助用户根据其应用程序（包括电子邮件、日历、消息、任务等）中的活动显示可操作的见解，帮助用户更好地管理自己的一天。返回的见解还将显示指向用于生成见解的构件的嵌入式链接，从而帮助用户快速查看生成见解时使用了哪些数据。此外，API 可能会根据见解返回建议的操作，并允许用户从您的应用程序执行跨应用程序操作。具体而言，API 与 Asana、Google Workspace、Microsoft 365 和 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 或的反馈评分（1 到 5，其中评分越高越好）的方法 ActionId。
**请求字段**
+ `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 请求验证您的申请
到目前为止，您已经更新了应用程序界面以嵌入 AppFabric 跨应用程序的见解和操作，并收到了针对单个用户的见解。在您对测试感到满意并希望将 AppFabric丰富的体验扩展到其他用户之后，可以将您的申请提交给以 AppFabric 供审核和验证。 AppFabric 将在实现广泛采用之前验证应用程序信息，以帮助保护应用程序开发人员、最终用户及其数据，从而为以负责任的方式扩大用户采用率铺平道路。
**启动验证流程**
通过发送电子邮件至 [appfabric-appverification@amazon.com](mailto:appfabric-appverification@amazon.com) 并请求验证您的应用程序，来开始验证流程。
在您的电子邮件中包括以下详细信息：
+ 你的 AWS 账户 身份证
+ 您正在寻求验证的应用程序的名称
+ 你的 AppClient 身份证
+ 您的联系信息
此外，请提供以下信息（如果可用），以帮助我们评估优先级和影响：
+ 您计划授予访问权限的估计用户数
+ 您的目标发布日期
**注意**
如果您有 AWS 账户 经理或 AWS 合作伙伴开发经理，请将其复制到您的电子邮件中。包括这些联系人可以帮助加快验证过程。
**验证标准**
在启动验证过程之前，您必须满足以下标准：
+ 为了提高工作效率， AWS 账户 必须使用有效 AppFabric 的
此外，您至少满足下列条件之一：
+ 您的组织是至少 AWS Partner Network 具有 “AWS 精选” 级别的 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
| |
| --- |
| 提高 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 身份证。
**响应字段**
+ `appName`-将在用户门户的同意页面上向用户显示的应用程序的 AppFabric 名称。
+ `customerManagedKeyIdentifier`（可选）- 用于加密数据的客户托管密钥（由 KMS 生成）的 ARN。如果未指定，则将使用 AWS AppFabric 托管密钥。
+ `description` - 应用程序的描述。
+ `redirectUrls` - 授权后要将最终用户重定向到的 URI。您最多可以添加 5 个 redirectUrl。例如 `https://localhost:8080`。
+ `starterUserEmails` - 在应用程序通过验证之前允许访问以接收见解的用户电子邮件地址。只允许使用一个电子邮件地址。例如 `anyuser@example.com`。
+ `verificationStatus`- AppClient 验证状态。
+ `pending_verification`-的验证 AppClient仍在进行中 AppFabric。在 AppClient 验证之前，只有一个用户（在中指定`starterUserEmails`）可以使用 AppClient。
+ `verified`-验证过程已成功完成 AppFabric ，现 AppClient 已完全验证。
+ `rejected`-的验证过程 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`-包含编号的亚马逊资源名称 (ARN)。 AppClient 例如， AppClient ID 是`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`。
+ `verificationStatus`- AppClient 验证状态。
+ `pending_verification`-的验证 AppClient仍在进行中 AppFabric。在 AppClient 验证之前，只有一个用户（在中指定`starterUserEmails`）可以使用 AppClient。
+ `verified`-验证过程已成功完成 AppFabric ，现 AppClient 已完全验证。
+ `rejected`-的验证过程 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如果您需要更改任何其他参数，例如 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`（必填）- 已更新的 redirectUrl 列表。您最多可以添加 5 个 redirectUrl。
**响应字段**
+ `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`-的验证过程 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，您必须至少拥有 `"appfabric:DeleteAppClient"` IAM 策略权限。有关更多信息，请参阅 [允许访问删除 AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-delete-appclient)。
**请求字段**
+ `appClientId`- AppClient 身份证。
**响应字段**
+ 没有响应字段。
```
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 获取的代币可以在到期时刷新。这可以使用 grant\$1type 为 `refresh_token` 的 [令牌](API_Token.md) API 来完成。当 grant\$1type 为 `refresh_token` 时，要使用的 `authorization_code` 将作为令牌 API 响应的一部分返回。默认到期时间为 12 小时。要调用刷新 API，您必须具有 `"appfabric:Token"` IAM 策略权限。有关更多信息，请参阅[令牌](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` - 从初始 /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}"
}
```
# 进行故障排除 AppClients AppFabric 以提高工作效率
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
本节介绍常见错误和故障排除， AppFabric 以提高工作效率。
## 未验证的应用程序
AppFabric 用于提高工作效率来丰富其应用程序体验的应用程序开发者在向最终用户推出其功能之前将经过验证流程。所有应用程序都以未验证状态启动，只有在验证过程完成后才会更改为已验证。这意味着`starterUserEmails`您在创建时使用的 AppClient 将看到此消息。
![\[Warning message for an unverified application in AWS AppFabric, requesting data access.\]](http://docs.aws.amazon.com/zh_cn/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如果尚未创建，请创建，或者使用现有的，`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 正确。它必须与您在创建或更新时 URLs指定的重定向相匹配 AppClient。要查看允许的重定向列表 URLs，请使用 [GetAppClient](manage-appclients.md#get_appclient_details)API 操作。
## `Token` 错误
### TokenException
您可能会收到以下异常，原因如下。
```
TokenException
HTTP Status Code: 400
```
**原因 1：指定了无效的电子邮件时**
```
Message: Invalid Email used
```
确保您使用的电子邮件地址与您创建时为该`starterUserEmails`属性列出的电子邮件地址相匹配 AppClient。如果电子邮件不匹配，请更改为匹配的电子邮件地址，然后重试。要查看使用的电子邮件，请使用 [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 提高最终用户的工作效率（预览版）
| |
| --- |
| “ AWS AppFabric 提高生产力” 功能处于预览阶段，可能会发生变化。 |
本部分适用于想要提高工作效率（预览）以 AWS AppFabric 改善任务管理和工作流程效率的 SaaS 应用程序的最终用户。按照以下步骤连接您的应用程序并授权 AppFabric 显示跨应用程序见解，并帮助您通过首选应用程序完成操作（例如发送电子邮件或安排会议）。您可以连接 Asana、Atlassian Jira Suite、Google Workspace、Microsoft 365、Miro、Slack、Smartsheet 等应用程序。在您授权 AppFabric 访问内容后， AppFabric可以直接在您的首选应用程序中提供跨应用程序的见解和操作，从而帮助您提高工作效率并保持当前的工作流程。
AppFabric 为了提高工作效率，使用由 Amazon Bedrock 提供支持的生成式人工智能。 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)
+ [管理 IT 和安全管理员 AppFabric 对提高工作效率（预览）功能的访问权限](productivity-end-users-managing-access.md)
+ [对最终用户错误进行故障排除，提高 AppFabric 工作效率](productivity-end-users-errors.md)
## 先决条件
开始之前，请确保您具备以下内容：
+ 登录凭证 AppFabric：要开始使用 AppFabric 以提高工作效率，您需要以下提供商之一的联合登录凭证（用户名和密码）：Asana、Google WorkspaceMicrosoft 365、或Slack。登录以 AppFabric 帮助我们在您为提高工作效率而启用的每个应用程序中将您识别 AppFabric 为用户。登录后，您可以连接您的应用程序以开始生成见解。
+ 连接您的应用程序的凭证：仅基于您授权的应用程序生成跨应用程序见解和操作。您要授权的每个应用程序都需要登录凭证（用户名和密码）。支持的应用程序包括 Asana、Atlassian Jira Suite、Google Workspace、Microsoft 365、Miro、Slack 和 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_cn/appfabric/latest/adminguide/images/fabric-01.png)
1. 使用以下提供商之一提供的凭证登录：Asana、Google Workspace、Microsoft 365 或 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_cn/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_cn/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_cn/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_cn/appfabric/latest/adminguide/images/fabric-05.png)
## 步骤 3：连接您的应用程序以生成见解和操作
完成同意页面后，您将进入**连接应用程序**页面，您可以在其中连接、断开连接或重新连接各个应用程序，这些应用程序最终用于生成跨应用程序见解和操作。大多数情况下，在您登录并提供同意后，您将继续使用此页面来管理已连接的应用程序。
要连接应用程序，请选择您使用的任意应用程序旁边的**连接**按钮。
![\[List of applications to connect, including Smartsheet, Slack, and Google Workspace, all showing as not connected.\]](http://docs.aws.amazon.com/zh_cn/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_cn/appfabric/latest/adminguide/images/fabric-07.png)
成功连接应用程序后，该应用程序的状态将从“未连接”更改为“已连接”。提醒：您需要为每个要用于生成见解和操作的应用程序完成此授权步骤。
连接应用程序后，它不会永远连接。您需要定期重新连接应用程序。我们这样做是为了确保我们仍然可以获得您的许可来生成见解。
可能的应用程序状态包括：
+ Connec AppFabric ted-已获得授权，正在使用您来自此应用程序的数据生成见解。
+ 未连接- AppFabric 未使用此应用程序中的数据生成见解。您可以连接以开始生成见解。
+ 授权失败。请重新连接。- 特定应用程序可能存在授权失败。如果看到此错误，请尝试使用**连接**按钮重新连接您的应用程序。
![\[Application connection status interface showing connected and unconnected apps.\]](http://docs.aws.amazon.com/zh_cn/appfabric/latest/adminguide/images/fabric-08.png)
设置已完成，您可以返回到您的应用程序。开始查看应用程序内部的见解可能至少需要几个小时。
根据需要，您可以导航回此页面以管理已连接的应用程序。如果您选择**断开**应用程序连接， AppFabric 将停止使用该应用程序中的数据或收集新数据来生成新的见解。如果您选择在 7 天内不重新连接应用程序，则断开连接的应用程序中的数据在该时间段后将自动删除。
## 步骤 4：开始查看见解并在您的应用程序中执行跨应用程序操作
将应用程序与连接后 AppFabric，您将可以访问宝贵的见解，并能够直接从首选应用程序中执行跨应用程序操作。注意：并非每个应用程序都保证此功能，并且完全取决于应用程序开发者选择启用哪种 AppFabric 生产力功能。
**跨应用程序见解**
AppFabric 提高生产力提供了两种类型的见解：
+ 切实可行的见解： AppFabric 分析来自互联应用程序中的电子邮件、日历事件、任务和消息的信息，并生成可能对您重要的关键见解，以确定优先顺序。此外， AppFabric 可能会生成建议的操作（例如发送电子邮件、安排会议和创建任务），您可以在停留在首选应用程序中时编辑和执行这些操作。例如，您可能会收到一条见解，说有客户上报需要处理，并建议您采取下一步行动安排与客户的会议。
+ 会议准备见解：此功能可帮助您为即将举行的会议做好最充分的准备。 AppFabric 将分析您即将举行的会议，并生成有关会议目的的简要摘要。此外，它还会显示已连接的应用程序中的相关构件（例如，电子邮件、消息和任务），这将有助于您高效地为会议做准备，而无需在应用程序之间切换来查找内容。
**跨应用程序操作**
对于某些见解，还 AppFabric 可能生成建议的操作，例如发送电子邮件、安排会议或创建任务。生成操作时， AppFabric 可能会根据所连接应用程序的内容和上下文预先填充某些字段。例如， AppFabric 可能会根据见解生成建议的电子邮件回复或任务名称。当你点击建议的操作时，你将被带到一个 AppFabric 拥有的用户界面，在执行操作之前，你可以在其中编辑预先填充的内容。 AppFabric 由于生成式人工智能和底层的大型语言模型 (LLM) 可能会不时产生幻觉，因此在没有用户审查和输入的情况下不会执行操作。
**注意**
您有责任验证和确认 AppFabric LLM 的输出。 AppFabric 不保证其 LLM 输出的准确性或质量。有关更多信息，请参阅 [AWS 负责任 AI 策略](https://aws.amazon.com/machine-learning/responsible-ai/policy/)。
### 创建电子邮件（Google Workspace、Microsoft 365）
AppFabric 允许您在首选应用程序中编辑和发送电子邮件。我们支持基本的电子邮件字段，包括 “发件人”、“收件人”、“抄送/密送”、“电子邮件主题行” 和 “电子邮件正文”。 AppFabric 可能会在这些字段中生成内容，以帮助您缩短完成任务的时间。编辑完电子邮件后，选择**发送**以发送电子邮件。
发送电子邮件需要下列字段：
+ 至少需要一封收件人电子邮件（收件人、抄送和密件抄送），并且必须是有效的电子邮件地址。
+ 主题行和消息字段。
![\[Email form with From, To, CC, BCC, Subject line, and Message fields for sending.\]](http://docs.aws.amazon.com/zh_cn/appfabric/latest/adminguide/images/fabric-12.png)
发送电子邮件后，您将看到电子邮件已发送的确认信息。此外，您还会在指定的应用程序中看到用于查看电子邮件的链接。您可以使用此链接快速导航到应用程序，并确认电子邮件已发送。
![\[Email sent confirmation with recipient details and message preview.\]](http://docs.aws.amazon.com/zh_cn/appfabric/latest/adminguide/images/fabric-13.png)
### 创建日历事件（Google Workspace、Microsoft 365）
AppFabric 允许您在首选应用程序中编辑和创建日历事件。我们支持基本的日历活动字段，包括活动标题、地点、 Start/End 时间和日期、受邀者列表和活动详情。 AppFabric 可能会在这些字段中生成内容，以帮助您缩短完成任务的时间。编辑完日历事件后，选择**创建**以创建事件。
要创建日历事件，必须填写以下字段：
+ “标题”、“开始”、“结束”和“描述”字段。
+ 开始时间和日期不得早于结束时间和日期。
+ “邀请”字段是可选的，但需要有效的电子邮件地址（如果提供）。
![\[Calendar event creation form with title, time, location, invitees, and description fields.\]](http://docs.aws.amazon.com/zh_cn/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_cn/appfabric/latest/adminguide/images/fabric-15.png)
### 创建任务 (Asana)
AppFabric 允许您在首选应用程序Asana中编辑和创建任务。我们支持基本任务字段，例如任务名称、任务所有者、截止日期和任务描述。 AppFabric 可能会在这些字段中生成内容，以帮助您缩短创建任务的时间。编辑完任务后，选择**创建**以创建任务。按照 LLM 的建议，在相应 Asana 的工作区或项目或任务中创建任务。
创建 Asana 任务时必须填写以下字段：
+ “标题”和“描述”字段。
+ 如果修改，则受让人必须是有效的电子邮件地址。
![\[Create Task form with fields for title, assignee, due date, and description for a finance meeting task.\]](http://docs.aws.amazon.com/zh_cn/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_cn/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_cn/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_cn/appfabric/latest/adminguide/images/fabric-19.png)
# 管理 IT 和安全管理员 AppFabric 对提高工作效率（预览）功能的访问权限
| |
| --- |
| “ AWS AppFabric 提高生产力” 功能处于预览阶段，可能会发生变化。 |
所有集成 AppFabric 了提高生产力（预览）功能的 SaaS 应用程序用户均可公开访问生产力用户门户。 AppFabric 如果您是一名 IT 管理员，想要管理组织内对这些生成式人工智能功能的访问权限，请考虑以下选项：
+ 限制身份提供者 (IdP) 登录：您可以通过身份提供者阻止登录访问权限，以控制用户对生成式人工智能功能的访问。
+ OAuth 对特定应用程序禁用：通过禁用来实现下游限制 OAuth。此操作可防止用户将需要 OAuth 身份验证的应用程序连接到公司的工作区。
# 对最终用户错误进行故障排除，提高 AppFabric 工作效率
| |
| --- |
| “ 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_cn/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_cn/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_cn/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_cn/appfabric/latest/adminguide/images/fabric-21.png)
# AppFabric 提高工作效率 APIs （预览）
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
本节提供 AWS AppFabric生产力功能的 API 操作、数据类型和常见错误。
**注意**
有关所有其他信息 AppFabric APIs，请参阅 [AWS AppFabric API 参考](https://docs.aws.amazon.com/appfabric/latest/api/)。
**Topics**
+ [提高工作效率 AppFabric 的 API 操作（预览版）](productivity-actions.md)
+ [提高工作效率的 API 数据类型（预览版） AppFabric](productivity-data-types.md)
+ [提高工作效率的 AppFabric 常见 API 错误（预览版）](productivity-common-errors.md)
# 提高工作效率 AppFabric 的 API 操作（预览版）
| |
| --- |
| 提高 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)
# 授权
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
授权. AppClient
**Topics**
+ [请求正文](#API_Authorize_request)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **app\$1client\$1id** | AppClient 要授权的 ID。 |
| **redirect\$1uri** | 授权后要将最终用户重定向到的 URI。 |
| **state** | 用于维护请求和回调之间状态的唯一值。 |
# CreateAppClient
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
创建一个 AppClient.
**Topics**
+ [请求正文](#API_CreateAppClient_request)
+ [响应元素](#API_CreateAppClient_response)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **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}` 必需：否 |
| **customerManagedKey标识符** | 由 客户自主管理型密钥 生成的 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}` 必需：否 |
| **描述** | 应用的描述。 类型：字符串 是否必需：是 |
| **iconUrl** | 的图标或徽标的网址 AppClient。 类型：字符串 必需：否 |
| **redirectUrls** | 授权后要将最终用户重定向到的 URI。您最多可以添加 5 个 redirectUrl。例如 `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 格式返回的以下数据。
| 参数 | 说明 |
| --- | --- |
| **appClientSummary** | 包含的摘要 AppClient。 类型：[AppClientSummary](API_AppClientSummary.md) 对象 |
# DeleteAppClient
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
删除应用程序客户端。
**Topics**
+ [请求正文](#API_DeleteAppClient_request)
+ [响应元素](#API_DeleteAppClient_response)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **appClientIdentifier** | 用于请求的亚马逊资源名称 (ARN) 或通用唯一标识符 (UUID)。 AppClient 长度限制：最小长度为 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
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
返回有关的信息 AppClient。
**Topics**
+ [请求正文](#API_GetAppClient_request)
+ [响应元素](#API_GetAppClient_response)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **appClientIdentifier** | 用于请求的亚马逊资源名称 (ARN) 或通用唯一标识符 (UUID)。 AppClient 长度限制：最小长度为 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 格式返回以下数据。
| 参数 | 说明 |
| --- | --- |
| **appClient** | 包含有关的信息 AppClient。 类型：[AppClient](API_AppClient.md) 对象 |
# ListActionableInsights
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
列出最重要的可操作电子邮件、任务和其他更新。
**Topics**
+ [请求正文](#API_ListActionableInsights_request)
+ [响应元素](#API_ListActionableInsights_response)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **nextToken** | 如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。 |
## 响应元素
如果此操作成功，则该服务将会发送回 HTTP 201 响应。
服务以 JSON 格式返回的以下数据。
| 参数 | 说明 |
| --- | --- |
| **ActionableInsightsList** | 列出可操作的见解，包括标题、描述、操作和创建的时间戳。有关更多信息，请参阅 [ActionableInsights](API_ActionableInsights.md)。 |
| **nextToken** | 如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。 类型：字符串 |
# ListAppClients
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
返回所有列表 AppClients。
**Topics**
+ [请求正文](#API_ListAppClients_request)
+ [响应元素](#API_ListAppClients_response)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **maxResults** | 每个调用返回的最大结果数。您可以使用 `nextToken` 获取更多的结果页面。 这只是一个上限。每次调用返回的实际结果数可能少于指定的最大值。 有效范围：最小值为 1。最大值为 100。 |
| **nextToken** | 如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。 |
## 响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
| 参数 | 说明 |
| --- | --- |
| **appClientList** | 包含 AppClient 结果列表。 类型：[AppClientSummary](API_AppClientSummary.md) 对象数组 |
| **nextToken** | 如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。 类型：字符串 |
# ListMeetingInsights
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
列出最重要的可操作的日历事件。
**Topics**
+ [请求正文](#API_ListMeetingInsights_request)
+ [响应元素](#API_ListMeetingInsights_response)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **nextToken** | 如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。 |
## 响应元素
如果此操作成功，则该服务将会发送回 HTTP 201 响应。
服务以 JSON 格式返回的以下数据。
| 参数 | 说明 |
| --- | --- |
| **MeetingInsightList** | 列出可操作的会议见解。有关更多信息，请参阅 [MeetingInsights](API_MeetingInsights.md)。 |
| **nextToken** | 如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。 类型：字符串 |
# PutFeedback
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
允许用户针对给定的见解或操作提交反馈。
**Topics**
+ [请求正文](#API_PutFeedback_request)
+ [响应元素](#API_PutFeedback_response)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **id** | 要提交反馈的对象的 ID。这可以是 InsightId 或 ActionId。 |
| **feedbackFor** | 要提交反馈的见解类型。 可能的值：`ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION` |
| **feedbackRating** | 反馈评分从 `1` 到 `5`。评分越高越好。 |
## 响应元素
如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 201 响应。
# 令牌
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
包含 AppClients 允许将授权码交换为访问令牌的信息。
**Topics**
+ [请求正文](#API_Token_request)
+ [响应元素](#API_Token_response)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **代码** | 从授权端点接收的授权码。 类型：字符串 长度限制：最小长度为 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 格式返回以下数据。
| 参数 | 说明 |
| --- | --- |
| **appfabric\$1user\$1id** | 令牌的用户 ID。只有使用 `authorization_code` 授予类型的请求才会返回此值。 类型：字符串 |
| **expires\$1in** | 令牌过期前的秒数。 类型：长整型 |
| **refresh\$1token** | 用于后续请求的刷新令牌。 类型：字符串 长度限制：最小长度为 1。最大长度为 2048。 |
| **token** | 访问令牌。 类型：字符串 长度限制：最小长度为 1。最大长度为 2048。 |
| **token\$1type** | 令牌类型。 类型：字符串 |
# UpdateAppClient
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
更新一个 AppClient.
**Topics**
+ [请求正文](#API_UpdateAppClient_request)
+ [响应元素](#API_UpdateAppClient_response)
## 请求正文
请求接受采用 JSON 格式的以下数据。
| 参数 | 说明 |
| --- | --- |
| **appClientIdentifier** | 用于请求的亚马逊资源名称 (ARN) 或通用唯一标识符 (UUID)。 AppClient 长度限制：最小长度为 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 个 redirectUrl。例如 `https://localhost:8080`。 类型：字符串数组 数组成员：最少 1 个物品。最多 5 项。 长度限制：最小长度为 1。最大长度为 2048。 模式：`(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` |
## 响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
| 参数 | 说明 |
| --- | --- |
| **appClient** | 包含有关的信息 AppClient。 类型：[AppClient](API_AppClient.md) 对象 |
# 提高工作效率的 API 数据类型（预览版） AppFabric
| |
| --- |
| 提高 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
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
根据用户应用程序产品组合中的电子邮件、日历邀请、消息和任务，包含用户的重要且合适的操作摘要。用户可以看到来自各个应用程序的主动见解，以帮助他们最好地调整一天的方向。这些见解为用户为什么应关心见解摘要以及生成见解的各个应用程序和构件的引用（例如嵌入式链接）提供了理由。
| 参数 | 说明 |
| --- | --- |
| **insightId** | 生成的见解的唯一 ID。 |
| **insightContent** | 这将返回见解摘要以及用于生成见解的构件的嵌入式链接。 这将是一个包含嵌入式链接（`` 标签）的 HTML 内容。 |
| **insightTitle** | 生成的见解的标题。 |
| **createdAt** | 当生成见解时。 |
| **actions** | 为生成的见解建议的操作列表。 操作对象包含下列参数： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/appfabric/latest/adminguide/API_ActionableInsights.html) |
# AppClient
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
包含有关的信息 AppClient。
**Topics**
| 参数 | 说明 |
| --- | --- |
| **appName** | 应用程序的名称。 类型：字符串 是否必需：是 |
| **arn** | AppClient 的 Amazon 资源名称（ARN）。 类型：字符串 长度限制：最小长度为 1。最大长度为 1011。 模式：`arn:.+` 是否必需：是 |
| **描述** | 应用程序的描述。 类型：字符串 是否必需：是 |
| **iconUrl** | 的图标或徽标的网址 AppClient。 类型：字符串 必需：否 |
| **redirectUrls** | 允许的重 URLs 定向 AppClient。 类型：字符串数组 数组成员：最少 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** | 为 客户自主管理型密钥 生成的亚马逊资源名称 (ARN) AWS Key Management Service 。 AppClient 类型：字符串 长度限制：最小长度为 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
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
包含有关的信息 AppClient。
**Topics**
| 参数 | 说明 |
| --- | --- |
| **arn** | AppClient 的 Amazon 资源名称（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
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
包含前 3 个会议的摘要，以及会议目的、相关的跨应用程序构件以及来自任务、电子邮件、消息和日历事件的活动。
| 参数 | 说明 |
| --- | --- |
| **insightId** | 生成的见解的唯一 ID。 |
| **insightContent** | 见解的描述，以字符串格式突出显示详细信息。例如，为什么这种见解很重要。 |
| **insightTitle** | 生成的见解的标题。 |
| **createdAt** | 当生成见解时。 |
| **calendarEvent** | 用户应关注的重要日历事件或会议。 日历事件对象： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **resources** | 包含与生成的见解相关的其他资源的列表。 资源对象： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **nextToken** | 用于获取下一组见解的分页令牌。这是一个可选字段，如果返回 null，则表示没有更多的见解可供加载。 |
# VerificationDetails
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
包含 AppClient 验证的状态和原因。
**Topics**
| 参数 | 说明 |
| --- | --- |
| **verificationStatus** | AppClient 验证状态。 类型：字符串 有效值：`pending_verification \| verified \| rejected` 是否必需：是 |
| **statusReason** | AppClient 验证状态原因。 类型：字符串 长度限制：最小长度为 1。最大长度为 1024。 必需：否 |
# 提高工作效率的 AppFabric 常见 API 错误（预览版）
| |
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 |
本节列出了 AWS AppFabric 生产力功能的 API 操作中常见的错误。
有关所有其他 AppFabric 常见的 API 错误，请参阅[进行故障排除 AppClients AppFabric 以提高工作效率](ahead-app-dev-errors.md)《[AWS AppFabric API *参考》中的AWS AppFabric API* 常见错误](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html)。
| 异常名称 | 说明 |
| --- | --- |
| **TokenException** | 令牌请求无效。 HTTP 状态代码：400 |
# 中的数据处理 AppFabric
| |
| --- |
| “ AWS AppFabric 提高生产力” 功能处于预览阶段，可能会发生变化。 |
AppFabric 采取措施将用户内容单独存储在由 AppFabric和单独管理的 Amazon S3 存储桶中；这有助于确保我们生成用户特定的见解。我们使用合理的保障措施来保护您的内容，包括静态加密和动态加密。我们已将系统配置为在客户内容接收后 30 天内自动删除。 AppFabric 不会使用用户不再有权访问的数据工件生成见解。例如，当用户断开数据源（应用程序）的连接时， AppFabric 停止从该应用程序收集数据，并且不使用断开连接的应用程序中的任何延迟工件来生成见解。 AppFabric的系统配置为在 30 天内删除此类数据。
AppFabric 不使用用户内容来训练或改进用于生成见解的底层大型语言模型。有关生成人工智能功能 AppFabric的更多信息，请参阅 A [mazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/)。
## 静态加密
AWS AppFabric 支持静态加密，这是一种服务器端加密功能，当用户相关的所有数据保存到磁盘时，可以 AppFabric透明地对其进行加密，并在您访问数据时对其进行解密。
## 传输中加密
AppFabric 使用 TLS 1.2 保护传输中的所有内容，并使用 AWS 签名版本 4 签署 AWS 服务的 API 请求。