翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS AppFabric for productivity とは
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
**注記**
Amazon Bedrock を利用: 自動不正[検出](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) AWS を実装します。 AWS AppFabric for productivity は Amazon Bedrock 上に構築されているため、ユーザーは Amazon Bedrock に実装されているコントロールを継承して、AI の安全性、セキュリティ、責任ある使用を強化します。
AWS AppFabric for productivity (プレビュー) は、複数のアプリケーションからコンテキストを使用してインサイトとアクションを生成することで、サードパーティーアプリケーションのエンドユーザーの生産性を再考するのに役立ちます。アプリケーションデベロッパーは、他のアプリケーションのユーザーデータにアクセスすることがアプリケーションの生産性を高めるうえで重要であることを認識していますが、各アプリケーションとの統合を構築して管理することは望んでいません。AppFabric for productivity を使用すると、アプリケーションデベロッパーは、クロスアプリケーションのデータインサイトやアクションを生成する、生成 AI を活用した API を使って、新規または既存の生成 AI アシスタントを通じてより充実したエンドユーザーエクスペリエンスを実現できます。AppFabric for productivity によって複数のアプリケーションのデータが統合されるため、デベロッパーは 2 地点間統合を構築または管理する必要がなくなります。アプリケーションデベロッパーは、AppFabric for productivity を自社のアプリケーションの UI に直接埋め込むことができ、エンドユーザーに一貫したエクスペリエンスを提供すると同時に、他のアプリケーションの関連するコンテキストを表示することができます。
AppFabric for productivity は、Asana、Atlassian Jira Suite、Google Workspace、Microsoft 365、Miro、Slack、Smartsheet など、一般によく利用されているアプリケーションのデータを接続します。AppFabric for productivity を使用すれば、アプリデベロッパーは、ユーザーの採用率、満足度、ロイヤルティを高めるよりパーソナライズされたアプリケーション体験を、これまでよりも簡単に構築できるようになります。一方でエンドユーザーは、さまざまなアプリケーションを横断して、必要とするインサイトに作業の流れを止めることなくアクセスできるようになります。
**Topics**
+ [利点](#benefits)
+ [ユースケース](#use-cases)
+ [AppFabric for productivity へのアクセス](#acessing-appfabric)
+ [アプリケーション開発者向けの AppFabric for productivity (プレビュー) の使用を開始する](getting-started-appdeveloper-productivity.md)
+ [エンドユーザー向けの AppFabric for productivity (プレビュー) の使用を開始する](getting-started-users-productivity.md)
+ [AppFabric for productivity APIsプレビュー)](productivity-apis.md)
+ [AppFabric でのデータ処理](productivity-data-processing.md)
## 利点
AppFabric for productivity を使用すると、アプリケーションデベロッパーは、クロスアプリケーションのデータインサイトやアクションを生成する API を使って、新規または既存の生成 AI アシスタントを通じてより充実したエンドユーザーエクスペリエンスを実現できます。
+ **クロスアプリケーションのユーザーデータの単一ソース**: AppFabric for productivity によって複数のアプリケーションのデータが統合されるため、デベロッパーは 2 地点間統合を構築または管理する必要がなくなります。SaaS アプリケーションのデータは、異質なデータタイプを、どのアプリケーションにも理解可能な形式に自動的に正規化することで、他のアプリケーションで使用できるように処理されます。これにより、アプリケーションのデベロッパーはより多くのデータを組み込んでエンドユーザーの生産性を高めることができます。
+ **ユーザーエクスペリエンスを完全にコントロール**: デベロッパーは、AppFabric for productivity を自社のアプリケーションの UI に直接埋め込むことで、ユーザーエクスペリエンスを完全にコントロールしながら、アプリケーション全体のコンテキストに基づいてパーソナライズされたインサイトや推奨されるアクションをエンドユーザーに提供することができます。エンドユーザーは、好みの SaaS アプリケーションや、タスク実行のために選択したアプリケーションから、AppFabric for productivity を利用できます。それにより、アプリケーションを切り替える手間を省いて時間を節約し、作業の流れを常に把握することが可能になります。
+ **市場化にかかる時間を短縮**: アプリケーションデベロッパーは、生成されたユーザーデータに関するユーザーレベルのインサイトを 1 度の API コールで取得できます。モデルを微調整したり、カスタムプロンプトを作成したり、複数のアプリケーションを横断して統合を構築したりする必要がありません。AppFabric はこうした複雑さを取り除き、アプリケーションデベロッパーによる生成 AI 機能のよりスピーディな構築、組み込み、強化を可能にします。それによりアプリケーションデベロッパーは、最も重要なタスクにリソースを集中させることが可能になります。
+ **アーティファクトのリファレンスによりユーザーの信頼を構築**: AppFabric for productivity は、アウトプットの一部として、インサイトの生成に使用した関連するアーティファクトまたはソースファイルを表示し、LLM アウトプットに対するエンドユーザーの信頼を構築します。
+ **ユーザー権限をシンプル化**: インサイトの生成に使用したユーザーアーティファクトは、ユーザーがアクセスできるものに基づきます。AppFabric for productivity は、ISVの許可とアクセス制御を信頼できるソースとして使用します。
## ユースケース
アプリケーションデベロッパーは、AppFabric for productivity を使用することでアプリケーションの生産性を刷新できます。AppFabric for productivity には、エンドユーザーの生産性向上に役立つ、以下のユースケースに焦点を絞った 2 つの API が用意されています。
+ 1 日の作業の優先付け
+ 実行可能なインサイト API は、アプリケーション (E メール、カレンダー、メッセージ、タスクなど) を横断してタイムリーにインサイトを表示することで、1 日の業務を効率よく管理することを可能にする API です。さらにユーザーは、メール作成、会議のスケジュール設定、アクションアイテムの作成といったアプリケーションを横断したアクションを、自分が選んだアプリケーションから実行することができます。例えば、夜間にカスタマーエスカレーションを受けた従業員は、夜間の会話の要旨を確認できるだけでなく、推奨されるアクションを確認して、その顧客のアカウントマネージャーとのミーティングを設定することもできます。アクションの必須フィールド (タスク名、所有者、メールの送信者/受信者など) は自動入力され、入力された内容はアクションの実行前に編集することが可能です。
+ 次回のミーティングの準備
+ 会議準備の API は、会議の内容を要約したり、E メールやメッセージその他のアプリケーションを横断して関連性の高いアーティファクトを表示したりすることで、会議に向けた準備に役立つ API です。ユーザーはすぐに会議に向けた準備ができ、コンテンツを見つけるためにアプリケーション間を切り替える手間が省けます。
## AppFabric for productivity へのアクセス
AppFabric for Productivity は、現在プレビュー版でリリースされており、米国東部 (バージニア北部) AWS リージョンで利用できます。詳細については AWS リージョン、『』の[AWS AppFabric エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/appfabric.html)」を参照してください*AWS 全般のリファレンス*。
各リージョンでは、次のいずれかの方法で AppFabric for productivity にアクセスできます。
+ アプリケーションデベロッパーとして
+ [アプリケーション開発者向けの AppFabric for productivity (プレビュー) の使用を開始する](getting-started-appdeveloper-productivity.md)
+ エンドユーザーとして
+ [エンドユーザー向けの AppFabric for productivity (プレビュー) の使用を開始する](getting-started-users-productivity.md)
# アプリケーション開発者向けの AppFabric for productivity (プレビュー) の使用を開始する
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
このセクションでは、アプリデベロッパーが AWS AppFabric for productivity (プレビュー) をアプリケーションに統合するのに役立ちます。 AWS AppFabric for productivity を使用すると、デベロッパーは、複数のアプリケーション間で E メール、カレンダーイベント、タスク、メッセージなどから AI を活用したインサイトやアクションを生成することで、ユーザーにとってよりリッチなアプリケーションエクスペリエンスを構築できます。サポートされているアプリケーションのリストは、「[AWS AppFabric Supported Applications](https://aws.amazon.com/appfabric/supported-applications/)」を参照してください。
AppFabric for Productivity は、アプリケーションデベロッパーに、安全で統制のとれた環境で構築や実験へのアクセスを提供します。AppFabric for productivity の使用を開始するときは、まず AppClient を作成し、テストユーザーを 1 人登録します。この方法は、ユーザーが、アプリケーションと AppFabric 間の認証およびコミュニケーションの流れを理解しテストすることができるようにすることを目的としています。1 人のユーザーでテストしたら、アプリケーションを AppFabric に送信して検証を行い、その後、アクセスを他のユーザーに広げます (「[ステップ 5. AppFabric にアプリケーションの検証をリクエストする](#request_verification)」を参照)。アプリケーションデベロッパーとエンドユーザーを保護し彼らのデータを保護するため、AppFabric では、アプリケーションの情報を検証してから採用範囲を拡大できるようにしています。そうすることで、責任ある方法でユーザーによる利用を広げるための準備をします。
**Topics**
+ [前提条件](#getting-started-prerequisites)
+ [ステップ 1. AppFabric for productivity の AppClient を作成する](#create_appclient)
+ [ステップ 2. アプリケーションを認証し認可する](#authorize_data_access)
+ [ステップ 3. AppFabric ユーザーポータル URL をアプリケーションに追加する](#end_user_portal)
+ [ステップ 4. AppFabric を使用してクロスアプリケーションのインサイトとアクションを表示する](#surface_insights_actions)
+ [ステップ 5. AppFabric にアプリケーションの検証をリクエストする](#request_verification)
+ [AppFabric for productivity AppClients の管理](manage-appclients.md)
+ [AppFabric for productivity の AppClients AppClients のトラブルシューティング](ahead-app-dev-errors.md)
## 前提条件
開始する前に、 を作成する必要があります AWS アカウント。詳細については、「[にサインアップする AWS アカウント](prerequisites.md#sign-up-for-aws)」を参照してください。また、以下の `"appfabric:CreateAppClient"` IAM ポリシーにアクセスできるユーザーを 1 人以上作成する必要があります。これにより、ユーザーはアプリケーションを AppFabric に登録することができます。AppFabric for productivity の機能へのアクセス権限を付与する方法の詳細については、「[AppFabric for productivity IAM ポリシーの例](security_iam_id-based-policy-examples.md#appfabric-for-productivity-policy-examples)」を参照してください。管理ユーザーを作成しておくことは何かと便利ですが、初期設定ではその作成は必須ではありません。詳細については、「[管理アクセスを持つユーザーを作成する](prerequisites.md#create-an-admin)」を参照してください。
AppFabric for productivity は、プレビュー中は米国東部 (バージニア北部) のみで利用できます。以下のステップを開始する前に、ご自身の現在地がこの地域であることを確認します。
## ステップ 1. AppFabric for productivity の AppClient を作成する
AppFabric for productivity インサイトをアプリケーション内で表示できるようにするには、先に AppFabric の AppClient を作成しておく必要があります。AppClient とは、AppFabric for productivity のゲートウェイであり、アプリケーションと AppFabric 間の安全なコミュニケーションを可能にする、セキュアな OAuth アプリケーションクライアントとして機能します。AppClient を作成すると AppClient ID が付与されます。これは、AppFabric が、アプリケーションおよびユーザーの AWS アカウントと連携していることを認識できるようにするための、不可欠な一意の識別子です。
AppFabric for Productivity は、アプリケーションデベロッパーに、安全で統制のとれた環境で構築や実験へのアクセスを提供します。AppFabric for productivity の使用を開始するときは、まず AppClient を作成し、テストユーザーを 1 人登録します。この方法は、ユーザーが、アプリケーションと AppFabric 間の認証およびコミュニケーションの流れを理解しテストすることができるようにすることを目的としています。1 人のユーザーでテストしたら、アプリケーションを AppFabric に送信して検証を行い、その後、アクセスを他のユーザーに広げます (「[ステップ 5. AppFabric にアプリケーションの検証をリクエストする](#request_verification)」を参照)。アプリケーションデベロッパーとエンドユーザーを保護し彼らのデータを保護するため、AppFabric では、アプリケーションの情報を検証してから採用範囲を拡大できるようにしています。そうすることで、責任ある方法でユーザーによる利用を広げるための準備をします。
AppClient を作成するには、 AWS AppFabric `CreateAppClient` API オペレーションを使用します。AppClient を後で更新する必要がある場合は、`UpdateAppClient` API オペレーションを使用すれば redirectUrls を変更するだけで済みます。appName や説明などお使いの AppClient に関連付けられているその他のパラメータを変更する必要がある場合は、その AppClient を削除し、新たに作成する必要があります。詳細については、「[CreateAppClient](API_CreateAppClient.md)」を参照してください。
API を使用して、Python、Node.js、Java、C\$1、Go、Rust などの複数のプログラミング言語`CreateAppClient`を使用して、 AWS サービスにアプリケーションを登録できます。詳細については、「IAM ユーザーガイド」の「[リクエスト署名の例](https://docs.aws.amazon.com/IAM/latest/UserGuide/signature-v4-examples.html)」を参照してください。この API オペレーションを実行するには、アカウント署名バージョン 4 の認証情報を使用する必要があります。署名バージョン 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 です。redirectUrls は 5 個まで追加できます。例えば、`https://localhost:8080`。
+ `starterUserEmails` - アプリケーションが検証されるまでの間、インサイトを受け取るためのアクセスが許可されるユーザーの E メールアドレスです。使用できるアドレスは 1 つのみです。例: `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 リソースネーム (ARN) です。例えば、AppClient ID は `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111` です。
+ `verificationStatus` - AppClient の検証ステータスです。
+ `pending_verification` - AppClient の検証が、AppFabric でまだ進行中です。AppClient の検証が終わるまでは、この AppClient を使用できるのは (`starterUserEmails` で指定された) 1 人のユーザーのみとなります。このユーザーは、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 のインサイトを安全に統合できるようにします。まず認可コードを作成します。このコードがアプリケーションの ID を検証します。詳細については、「[承認](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. AppClient の作成 で作成した 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 リクエストに使用され、AppClient の検証が完了するまでは `starterUserEmails` に対して有効です。AppClient の検証が完了した後は、このトークンはどのユーザーにでも使用できます。この API オペレーションを実行するには、アカウント署名バージョン 4 の認証情報を使用する必要があります。署名バージョン 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. AppClient の作成 で作成した 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 for productivity を有効にする準備が整うとユーザーはこのユーザーポータルに誘導されます。ユーザーはそこで、インサイトやクロスアプリケーションアクションの生成に使用されるアプリケーションを、接続したり管理したりできます。ログインすると、ユーザーはアプリケーションを AppFabric for productivity に接続できるようになり、自分のアプリケーションでインサイトやアクションを確認できます。アプリケーションを AppFabric for productivity と連携させるには、特定の AppFabric URL をアプリケーションに追加する必要があります。これは、ユーザーがアプリケーションから AppFabric ユーザーポータルに直接アクセスできるようにするために欠かせないステップです。
1. アプリケーションの設定に進み、リダイレクト URL を追加するセクションを探します。
1. 該当するセクションが見つかったら、以下の AppFabric URL をリダイレクト URL としてアプリケーションに追加します。
```
https://userportal.appfabric..amazonaws.com/eup_login
```
URL を追加すると、ユーザーを AppFabric ユーザーポータルに誘導するようにアプリケーションで設定されます。ここで、ユーザーはログインし、AppFabric for productivity のインサイトの生成に使用されるアプリケーションを接続して管理することができます。
## ステップ 4. AppFabric を使用してクロスアプリケーションのインサイトとアクションを表示する
ユーザーがアプリケーションを接続すると、ユーザーのインサイトを活用でき、アプリケーションとコンテキストを切り替える手間が省けて生産性を高めることができます。AppFabric は、ユーザーが持つアクセス権限に基づいてインサイトを生成します。AppFabric は、AppFabric AWS アカウント が所有する にユーザーデータを保存します。AppFabric によるデータの使用方法についての詳細は、「[AppFabric でのデータ処理](productivity-data-processing.md)」を参照してください。
ユーザーレベルのインサイトとアクションをアプリケーション内で生成して表示するときは、AI を活用した以下の API を使用できます。
+ `ListActionableInsights` — 詳細については、以下の「[実行可能なインサイト](#productivity-actionable-insights)」のセクションを参照してください。
+ `ListMeetingInsights` — 詳細については、本ガイドで後述する「[会議の準備](#productivity-meeting-insights)」のセクションを参照してください。
### 実行可能なインサイト (`ListActionableInsights`)
`ListActionableInsights` は、アプリケーション (E メール、カレンダー、メッセージ、タスクなど) を横断するアクティビティに基づいて実行可能なインサイトを表示する、日々の業務を効率よく管理するのに役立つ API です。表示されるインサイトには、インサイトの生成に使用されたアーティファクトへの埋め込みリンクも含まれているため、ユーザーはインサイトの生成に使用されたデータをすばやく確認できます。さらにこの API は、インサイトに基づく推奨されるアクションを返すことができるため、ユーザーは自分のアプリケーションからクロスアプリケーションアクションを実行することができます。具体的には、この API は Asana、Google Workspace、Microsoft 365、Smartsheet などのプラットフォームと連携し、ユーザーがメール送信、カレンダーイベントの作成、タスクの作成などを行うことを可能にします。大規模言語モデル (LLM) では、推奨されるアクション (メール本文やタスク名など) に自動的に詳細を追加できます。ユーザーはこれを実行前にカスタマイズできるため、意思決定を簡略化し、生産性を高めることができます。エンドユーザーがアプリケーションを承認する場合と同様に、AppFabric では、ユーザーは同じ専用ポータルを使用してクロスアプリケーションアクションを表示、編集、実行できます。アクションを実行する場合、AppFabric は、ユーザーを AppFabric ユーザーポータルにリダイレクトして、アクションの詳細を確認してからこれを実行できるようにすることを ISV に要求しています。AppFabric で生成されるアクションのすべてに、固有の URL があります。この URL は `ListActionableInsights` API レスポンスのレスポンスで使用できます。
以下は、サポートされているクロスアプリケーションアクションと、どのアプリケーションでサポートされているかをまとめたものです。
+ E メールの送信 (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` は、会議の内容を要約したり、E メールやメッセージその他のアプリケーションを横断して関連性の高いアーティファクトを表示したりすることで、今後の会議に向けて準備するのに役立つ 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 のクロスアプリケーションのインサイトとアクションを埋め込むように更新し、1 人のユーザーに関するインサイトを取得しました。テストに満足し、AppFabric によって機能強化したエクスペリエンスを他のユーザーにも広げたい場合は、アプリケーションを AppFabric に送信し、レビューと検証を受けます。アプリケーションデベロッパーとエンドユーザーを保護し彼らのデータを保護するため、AppFabric では、アプリケーションの情報を検証してから採用範囲を拡大できるようにしています。そうすることで、責任ある方法でユーザーによる利用を広げるための準備をします。
**検証プロセスの開始**
[appfabric-appverification@amazon.com](mailto:appfabric-appverification@amazon.com) にメールを送信し、アプリケーションの検証をリクエストして、検証プロセスを開始します。
E メールの本文には次の情報を含めます。
+ AWS アカウント ID
+ 検証を依頼するアプリケーションの名称
+ 自分の AppClient ID
+ 自分の連絡先情報
また、可能であれば、以下の情報も含めると、優先順位や影響を評価する際に役立ちます。
+ アクセスを許可するユーザー数 (推計)
+ リリース日
**注記**
AWS アカウント マネージャーまたは AWS パートナー開発マネージャーがいる場合は、E メールでコピーしてください。追加しておくと、検証プロセスをスピーディに進めることができます。
**検証基準**
検証プロセスを開始する前に、次の基準を満たしている必要があります。
+ AppFabric for productivity AWS アカウント を使用するには、有効な を使用する必要があります
また、以下の基準のうち 1 つ以上を満たしている必要があります。
+ 組織は、少なくとも「 Select AWS 」階層 AWS Partner Network を持つ の AWS パートナーです。詳細については、「[AWS サービスパートナーティア](https://aws.amazon.com/partners/services-tiers/)」を参照してください。
+ 所属する組織が、過去 3 年間で AppFabric サービスに 10,000 ドル以上を費やしていること。
+ アプリケーションが AWS Marketplaceに掲載されていること。詳細については、「[AWS Marketplace](https://aws.amazon.com/marketplace)」を参照してください。
**検証ステータスの更新の待機**
アプリケーションの審査が完了すると、メールで返信があり、AppClient のステータスが `pending_verification` から `verified` に変わります。アプリケーションが却下された場合は、検証プロセスを改めて行う必要があります。
# AppFabric for productivity AppClients の管理
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppFabric for productivity の AppClients を管理することで、認証および認可のプロセスのスムーズなオペレーションと管理を実現できます。
## AppClient の詳細を取得する
AppClient ステータスの確認など AppClient に関する詳細を表示するときは、AppFabric `GetAppClient` API オペレーションを使用します。詳細については、「[GetAppClient](API_GetAppClient.md)」を参照してください。
AppClient の詳細を取得するには、少なくとも IAM ポリシーの許可が必要です。`"appfabric:GetAppClient"`詳細については、「[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 です。redirectUrls は 5 個まで追加できます。例えば、`https://localhost:8080`。
+ `starterUserEmails` - アプリケーションが検証されるまでの間、インサイトを受け取るためのアクセスが許可されるユーザーの E メールアドレスです。使用できるアドレスは 1 つのみです。例えば、`anyuser@example.com`。
+ `verificationStatus` - AppClient の検証ステータスです。
+ `pending_verification` - AppClient の検証が、AppFabric でまだ進行中です。AppClient の検証が終わるまでは、この AppClient を使用できるのは (`starterUserEmails` で指定された) 1 人のユーザーのみとなります。
+ `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 の一覧表示
AppClients のリストを表示するときは、AppFabric `ListAppClients` API オペレーションを使用します。AppFabric では、1 つの AppClient につき 1 つのみが許可されます AWS アカウント。この制限は将来変更される可能性があります。詳細については、「[ListAppClients](API_ListAppClients.md)」を参照してください。
AppClient をリスト化するには、少なくとも `"appfabric:ListAppClients"` IAM ポリシーの許可が必要です。詳細については、「[AppClients を一覧表示するためのアクセスを許可する](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-list-appclient)」を参照してください。
**リクエストフィールド**
+ 必須フィールドはありません。
**レスポンスフィールド**
+ `appClientARN` - AppClient ID を含む Amazon リソースネーム (ARN) です。例えば、AppClient ID は `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111` です。
+ `verificationStatus` - AppClient の検証ステータスです。
+ `pending_verification` - AppClient の検証が、AppFabric でまだ進行中です。AppClient の検証が終わるまでは、この AppClient を使用できるのは (`starterUserEmails` で指定された) 1 人のユーザーのみとなります。
+ `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 を更新する
AppClient に対応付けられた redirectUrls を更新するときは、AppFabric `UpdateAppClient` API オペレーションを使用します。AppName、starterUserEmailsなど、その他のパラメータを変更する必要がある場合は、AppClient を削除して新しい 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 のリストです。redirectUrls は 5 個まで追加できます。
**レスポンスフィールド**
+ `appName` - AppFabric ユーザーポータルの同意ページでユーザーに表示されるアプリケーションの名前です。
+ `customerManagedKeyIdentifier` (オプション) - データの暗号化に使用されるカスタマーマネージドキー (KMS が生成) の ARN です。指定しない場合、 AWS AppFabric マネージドキーが使用されます。
+ `description` - アプリケーションの説明です。
+ `redirectUrls` - 承認後にエンドユーザーがリダイレクトされる URI です。例えば、`https://localhost:8080`。
+ `starterUserEmails` - アプリケーションが検証されるまでの間、インサイトを受け取るためのアクセスが許可されるユーザーの E メールアドレスです。使用できるアドレスは 1 つのみです。例えば、`anyuser@example.com`。
+ `verificationStatus` - AppClient の検証ステータスです。
+ `pending_verification` - AppClient の検証が、AppFabric でまだ進行中です。AppClient の検証が終わるまでは、この AppClient を使用できるのは (`starterUserEmails` で指定された) 1 人のユーザーのみとなります。
+ `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 を削除する
不要になった AppClients を削除するときは、AppFabric `DeleteAppClient` API オペレーションを使用します。詳細については、「[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 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 が `authorization_code` である場合は、使用すべき `refresh_token` は、トークン 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` (必須) - AWS アカウント用に作成された AppClient リソースの ID です。
+ `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}"
}
```
# AppFabric for productivity の AppClients AppClients のトラブルシューティング
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
このセクションでは、AppFabric for productivity のよくあるエラーとトラブルシューティングについて説明します。
## 未検証のアプリケーション
AppFabric for productivity を使用してエクスペリエンスを強化するアプリケーションデベロッパーは、エンドユーザーに機能を公開する前に検証プロセスを経る必要があります。アプリケーションはすべて、未検証の状態からスタートし、検証プロセスが完了した場合のみ、検証済みの状態になります。つまり、AppClient の作成時に使用した `starterUserEmails` にはこのメッセージが表示されます。
![\[Warning message for an unverified application in AWS AppFabric, requesting data access.\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/images/fabric-24.png)
## `CreateAppClient` エラー
### ServiceQuotaExceededException
AppClient の作成時に次の例外が発生した場合、 AWS アカウントごとに作成できる AppClient の数を超えています。上限は 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 が正しいことを確認します。AppClient を作成または更新したときに指定した、リダイレクト URL のいずれかと一致する必要があります。許可済みのリダイレクト URL を一覧表示するには、[GetAppClient](manage-appclients.md#get_appclient_details) API オペレーションを実行します。
## `Token` エラー
### TokenException
いくつかの理由から、以下のエラーが発生する場合があります。
```
TokenException
HTTP Status Code: 400
```
**理由 1: 無効なメールが指定されている**
```
Message: Invalid Email used
```
使用しているメールアドレスが、AppClient を作成したときに `starterUserEmails` 属性にリストされたアドレスと一致していることを確認します。一致しない場合は、一致する E メールアドレスに変更してから再度試します。使用しているメールを表示するには、[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 または空です。[Token](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 for productivity (プレビュー) の使用を開始する
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
このセクションでは、 AWS AppFabric for productivity (プレビュー) を有効にしてタスク管理とワークフロー効率を向上させたい SaaS アプリケーションのエンドユーザーを対象としています。以下の手順に従ってアプリケーションを接続し、AppFabric を承認すれば、クロスアプリケーションインサイトを表示し、好みのアプリケーションのアクション (メール送信や会議のスケジュール設定など) を実行することができます。接続できるアプリケーションは、Asana、Atlassian Jira Suite、Google Workspace、Microsoft 365、Miro、Slack、Smartsheet などです。AppFabric にコンテンツへのアクセスを許可すると、AppFabric からお使いのアプリケーションに、クロスアプリケーションのインサイトやアクションを直接取り込むことができるため、作業効率の向上やワークフローの最新状態の把握に役立ちます。
AppFabric for productivity は、Amazon Bedrockを活用した生成 AI を使用しています。AppFabric は、ユーザーが明示的に許可した場合にのみ、インサイトとアクションを生成します。ユーザーは、各アプリケーションに、使用するコンテンツを完全にコントロールする権限を付与します。AppFabric が、インサイトの生成に使用される、基盤となる大規模言語モデルのトレーニングや改善に、お客様のデータを使用することはありません。詳細については、「[Amazon Bedrock よくある質問](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 for productivity (プレビュー) 機能へのアクセスを管理する](productivity-end-users-managing-access.md)
+ [AppFabric for productivity のエンドユーザーエラーのトラブルシューティング](productivity-end-users-errors.md)
## 前提条件
作業を開始する前に、以下の条件がそろっていることを確認します。
+ AppFabric にサインインするための認証情報: AppFabric for productivity の使用を開始するには、Asana、Google Workspace、Microsoft 365、Slack のいずれかのプロバイダーのフェデレーションサインイン認証情報 (ユーザー名とパスワード) が必要です。AppFabric にサインインすると、AppFabric for productivity を有効にするそれぞれのアプリケーションで、ユーザーとして認識されます。サインインすると、お使いのアプリケーションを接続してインサイトの生成を開始できます。
+ アプリケーションを接続するための認証情報: クロスアプリケーションのインサイトとアクションは、ユーザーが認可するアプリケーションに基づいてのみ生成されます。サインインの認証情報は (ユーザー名とパスワード) は、認可するアプリケーションごとに、必要になります。サポートされているアプリケーションには、Asana、Atlassian Jira Suite、Google Workspace、Microsoft 365、Miro、Slack、Smartsheet などがあります。
## ステップ 1. AppFabric にサインイン
アプリケーションを AppFabric に接続し、お使いのコンテンツやインサイトを好みのアプリケーションに直接取り込みます。
1. AppFabric は、どのアプリケーションでもさまざまな方法で使用することができ、アプリケーションのエクスペリエンスを高めます。そのため、以下の AppFabric for productivity のホームページにアクセスするためのエントリポイントは、アプリケーションごとに異なります。このホームページでは、AppFabric を有効にするプロセスに関するコンテキストが設定されており、ユーザーは最初にサインインを求められます。ユーザーが AppFabric を有効にしようとしているすべてのアプリケーションで、この画面が表示されます。
![\[Sign-in prompt for AWS AppFabric, highlighting AI-powered productivity features.\]](http://docs.aws.amazon.com/ja_jp/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/ja_jp/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/ja_jp/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/ja_jp/appfabric/latest/adminguide/images/fabric-04.png)
## ステップ 2. インサイトを表示することをアプリに許可する
サインインすると、AppFabric for productivity を有効にしようとしているアプリケーション内に、クロスアプリケーションのインサイトとアクションを表示することを、AppFabric に許可するかどうかを尋ねる同意ページが表示されます。例えば、AppFabric に、Google Workspace のメールやカレンダーのイベントを取り込み Asana に表示することを許可するかどうか、といったようにです。この同意のステップは、AppFabric を有効にするアプリケーションごとに 1 回実行すれば、その後は必要ありません。
![\[Dialog box requesting permission to display insights and artifacts within an application.\]](http://docs.aws.amazon.com/ja_jp/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/ja_jp/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/ja_jp/appfabric/latest/adminguide/images/fabric-07.png)
アプリケーションが正常に接続すると、そのアプリケーションのステータスが [未接続] から[接続済み] に変わります。以上の承認ステップは、インサイトやアクションの生成に使用するアプリケーションごとに実行する必要があります。
アプリケーションは、1 度接続すればその状態が永久に続くわけではありません。定期的に接続し直す必要があります。なぜ必要かというと、インサイトを生成するためのアクセス権限が引き続き付与されていることを確認するためです。
アプリケーションのステータスには、以下の状態があります。
+ 接続済み - AppFabric は承認済みで、アプリケーションのデータを使ってインサイトを生成しています。
+ 未接続 - AppFabric は、アプリケーションのデータを使ってインサイトを生成していません。接続するとインサイトの生成を開始できます。
+ 承認に失敗しました。再接続してください。- アプリケーションの認可に失敗した可能性があります。このエラーが表示されたときは、**[接続]** をクリックして再度アプリケーションを接続します。
![\[Application connection status interface showing connected and unconnected apps.\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/images/fabric-08.png)
セットアップが完了したので、アプリケーションに戻ることができます。アプリケーション内にインサイトが表示されるまで、数時間かかることがあります。
接続済みのアプリケーションを管理するときは、必要に応じてこのページに戻ります。アプリケーションを**切断**すると、AppFabric は、そのアプリケーションのデータを使用したり、新しいデータを収集して新しいインサイトを生成したりすることを停止します。切断したアプリケーションのデータは、7 日以内に、その間アプリケーションをを再度接続しなければ、自動的に削除されます。
## ステップ 4. 自分のアプリケーションでインサイトを確認しクロスアプリケーションアクションを実行する
アプリケーションを AppFabric に接続すると、有用性の高いインサイトにアクセスしたり、好みのアプリケーションからクロスアプリケーションアクションを直接実行したりすることができるようになります。注: この機能は各アプリで確実に使用できるわけではなく、使用できるかどうかは、アプリケーションデベロッパーが AppFabric for productivity のどの機能を有効にしているかに依存します。
**クロスアプリケーションインサイト**
AppFabric for productivity には次の 2 種類のインサイトがあります。
+ 実行可能なインサイト: AppFabric が、接続したアプリケーション間を横断して E メール、カレンダーイベント、タスク、メッセージ等の情報を分析し、ユーザーが優先すべき重要なキーインサイトを生成します。さらに、推奨されるアクション (メールの送信、会議のスケジュール設定、タスクの作成など) が生成されることもあります。これらのアクションは、好みのアプリケーションを開いたまま、編集および実行することが可能です。例えば、対処すべきカスタマーエスカレーションがあります、推奨されるアクションはこちらです、といったインサイトを受け取って、顧客とのミーティングをスケジュールする、といったことが行えます。
+ 会議の準備に関するインサイト: この機能を使うと、今後の会議に向けて準備することができます。AppFabric が今後の会議を分析し、会議の目的を簡潔にまとめます。さらに、接続されているアプリケーションから、関連するアーティファクト (E メール、メッセージ、タスクなど) が表示されます。アプリケーションを切り替えてコンテンツを探す手間が省け、会議の準備を効率的に進めることができます。
**クロスアプリケーションアクション**
特定のインサイトではさらに、AppFabric で、推奨されるアクション (メールの送信、会議のスケジュール設定、タスクの作成など) を生成することもできます。アクションを生成するときに、接続済みアプリケーションのコンテンツとコンテキストに基づいて特定のフィールドを自動入力することができます。例えば、インサイトに基づいて、推奨される返信メールやタスクの名称を生成するなどです。推奨されるアクションをクリックすると、AppFabric が所有するユーザーインターフェイスが表示され、自動入力されたコンテンツは、アクションを実行する前にここで編集することができます。生成 AI と、基盤となる大規模言語モデル (LLM) はハルシネーションを起こすことがあるため、AppFabric は、ユーザーが事前に確認および入力を行っていないアクションは実行しません。
**注記**
ユーザーは、AppFabric LLM の出力を検証し確定する責任を負います。AppFabric は LLM の出力の精度や品質を保証しません。詳細については、「[AWS Responsible AI Policy](https://aws.amazon.com/machine-learning/responsible-ai/policy/)」を参照してください。
### E メールの作成 (Google Workspace、Microsoft 365)
AppFabric では、ユーザーは、好みのアプリケーション内でメールを編集し送信することができます。差出人、宛先、Cc/Bcc、メールの件名、メール本文など、基本のフィールドはサポートされています。AppFabric では、タスクの完了に要する時間を短縮するため、これらのフィールドにコンテンツを入力することがあります。E メールの編集が完了したら、**[送信]** を選択して E メールを送信します。
メールを送信するには、以下のフィールドへの入力は必須です。
+ 1 つ以上の受信者の E メールアドレス (To、CC、BCC)。有効な E メールアドレスである必要があります。
+ 件名と本文のフィールド。
![\[Email form with From, To, CC, BCC, Subject line, and Message fields for sending.\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/images/fabric-12.png)
E メールが送信されると、送信されたことを示す確認画面が表示されます。さらに、指定されたアプリケーションで E メールを表示するためのリンクが表示されます。このリンクをクリックするとアプリケーションにすばやく移動でき、メールが送信されたことを確認できます。
![\[Email sent confirmation with recipient details and message preview.\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/images/fabric-13.png)
### カレンダーイベントの作成 (Google Workspace、Microsoft 365)
AppFabric では、ユーザーは、好みのアプリケーション内でカレンダーを編集したり作成したりできます。基本のカレンダーイベントフィールド (イベントのタイトル、場所、開始/終了日時、招待者リスト、イベントの内容など) がサポートされています。AppFabric では、タスクの完了に要する時間を短縮するため、これらのフィールドにコンテンツを入力することがあります。カレンダーイベントの編集が完了したら、**[作成]** を選択してイベントを作成します。
カレンダーイベントを作成するときは、以下のフィールドへの入力は必須です。
+ タイトル、開始日時、終了日時、イベントの内容。
+ 開始日時は終了日時より前にすることはできません。
+ 招待フィールドは任意ですが、入力する場合は有効な E メールアドレスを入力する必要があります。
![\[Calendar event creation form with title, time, location, invitees, and description fields.\]](http://docs.aws.amazon.com/ja_jp/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/ja_jp/appfabric/latest/adminguide/images/fabric-15.png)
### タスクの作成 (Asana)
AppFabric では、ユーザーは、好みのアプリケーション内から Asana のタスクを編集したり作成したりできます。基本のタスクフィールド (タスク名、タスク所有者、期日、タスクの内容など) がサポートされています。AppFabric では、タスクの作成に要する時間を短縮するため、これらのフィールドにコンテンツを入力することがあります。タスクの編集が完了したら、**[作成]** を選択してタスクを作成します。タスクは、LLM の推奨に従って、該当する Asana ワークスペース、プロジェクト、タスクのいずれかに作成されます。
Asana タスクを作成するときは、以下のフィールドへの入力は必須です。
+ タイトルと内容。
+ 変更された場合、担当者には有効な E メールアドレスを入力しなければなりません。
![\[Create Task form with fields for title, assignee, due date, and description for a finance meeting task.\]](http://docs.aws.amazon.com/ja_jp/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/ja_jp/appfabric/latest/adminguide/images/fabric-17.png)
### タスクの作成 (Smartsheet)
AppFabric では、ユーザーは、好みのアプリケーション内から Smartsheet のタスクを編集したり作成したりできます。基本のタスクフィールド (タスク名、タスク所有者、期日、タスクの内容など) がサポートされています。AppFabric では、タスクの作成に要する時間を短縮するため、これらのフィールドにコンテンツを入力することがあります。タスクの編集が完了したら、**[作成]** を選択してタスクを作成します。Smartsheet のタスクでは、AppFabric は新しいプライベートの Smartsheet シートを作成し、作成済みのタスクをすべて入力します。これは、AppFabric が生成するアクションを、1 つの場所で体系的に一元化できるようにするために行われます。
Smartsheet タスクを作成するときは、以下のフィールドへの入力は必須です。
+ タイトルと内容。
+ 入力された場合、担当者には有効な E メールアドレスを入力しなければなりません。
![\[Create Task form with fields for title, assignees, due date, and description for an AWS AppFabric Action.\]](http://docs.aws.amazon.com/ja_jp/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/ja_jp/appfabric/latest/adminguide/images/fabric-19.png)
# IT およびセキュリティ管理者向けの AppFabric for productivity (プレビュー) 機能へのアクセスを管理する
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppFabric for productivity のユーザーポータルは、AppFabric for productivity (プレビュー版) 機能と連携している SaaS アプリケーションの、すべてのユーザーに公開されています。こうした生成 AI 機能へのアクセスを組織内で管理したいと考えている IT 管理者の方は、以下の方法を検討できます。
+ ID プロバイダー (IdP) ログインを制限する: ID プロバイダー経由のログインアクセスをブロックすることで、生成 AI 機能へのユーザーアクセスを制御できます。
+ 特定のアプリケーションの OAuth を無効にする: OAuth を無効にすることで、ダウンストリームで制限を実行できます。このアクションをとると、ユーザーは、OAuth 認証を必要とするアプリケーションを会社のワークスペースに接続できなくなります。
# AppFabric for productivity のエンドユーザーエラーのトラブルシューティング
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
このセクションでは、AppFabric for productivity のよくあるエラーとトラブルシューティングについて説明します。
## 未検証のアプリケーション
AppFabric for productivity を使用してエクスペリエンスを強化するアプリケーションは、エンドユーザーに機能を公開する前に検証プロセスを経る必要があります。AppFabric にサインインしようとしたときに [未検証] のバナーが表示された場合、そのアプリケーションは、デベロッパーの ID とアプリケーションの登録情報の正確性とを確認する AppFabric の検証プロセスが完了していないことを意味します。アプリケーションはすべて、未検証の状態からスタートし、検証プロセスが完了した場合のみ、検証済みの状態になります。
未検証のアプリケーションを使用するときは注意が必要です。アプリケーションの開発者が不明である場合は、ステータスが検証済みに変わってから使用を開始するようにします。
![\[Warning message for an unverified application in AWS AppFabric, advising caution before authorization.\]](http://docs.aws.amazon.com/ja_jp/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/ja_jp/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/ja_jp/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/ja_jp/appfabric/latest/adminguide/images/fabric-21.png)
# AppFabric for productivity APIsプレビュー)
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
このセクションでは、 AWS AppFabric 生産性向上機能の API オペレーション、データ型、一般的なエラーについて説明します。
**注記**
その他の AppFabric API については、「[AWS AppFabric API Reference](https://docs.aws.amazon.com/appfabric/latest/api/)」を参照してください。
**Topics**
+ [AppFabric for productivity の API アクション (プレビュー)](productivity-actions.md)
+ [AppFabric for productivity の API データ型 (プレビュー)](productivity-data-types.md)
+ [AppFabric for productivity の一般的な API エラー (プレビュー)](productivity-common-errors.md)
# AppFabric for productivity の API アクション (プレビュー)
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppFabric for productivity 機能では、次のアクションがサポートされています。
AppFabric API のその他のアクションについては、「[AWS AppFabric API Actions](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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppClient を認証します。
**Topics**
+ [リクエストボディ](#API_Authorize_request)
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
| パラメータ | 説明 |
| --- | --- |
| **app\$1client\$1id** | 承認する AppClient の ID です。 |
| **redirect\$1uri** | 承認後にエンドユーザーがリダイレクトされる URI です。 |
| **state** | リクエストとコールバック間の状態を維持するための一意の値です。 |
# CreateAppClient
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppClient を作成します。
**Topics**
+ [リクエストボディ](#API_CreateAppClient_request)
+ [レスポンス要素](#API_CreateAppClient_response)
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
| パラメータ | 説明 |
| --- | --- |
| **appName** | アプリケーションの名前。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 255 です。 必須: はい |
| **clientToken** | リクエストの冪等性のために割り当てる一意の識別子 (大文字と小文字を区別) を指定します。これにより、同じ操作を誤って 2 度実行することなく、リクエストを安全に再試行できます。操作の後半の呼び出しで同じ値を渡す場合は、他のすべてのパラメータにも同じ値を渡す必要があります。[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 です。最大長は 1,011 です。 パターン: `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 です。redirectUrls は 5 個まで追加できます。例えば、`https://localhost:8080`。 型: 文字列の配列 配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。 長さの制限：最小長 1、最大長は 2,048 です。 パターン: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` 必須: はい |
| **starterUserEmails** | AppClient が検証されるまでインサイトを受け取ることが許可されている、ユーザーのためのスターターメールアドレス。 型: 文字列の配列 配列メンバー: 1 項目の定数です。 長さの制約: 最小長は 0 です。最大長は 320 です。 パターン: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` 必須: はい |
| **[タグ]** | リソースに割り当てるタグの、キーと値のペアのマップ。 タイプ: タグオブジェクトの配列 配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。 必須: いいえ |
## レスポンス要素
アクションが成功すると、HTTP 201 レスポンスが返されます。
サービスから以下のデータが JSON 形式で返されます。
| パラメータ | 説明 |
| --- | --- |
| **appClientSummary** | AppClient の概要が含まれています。 タイプ:[AppClientSummary](API_AppClientSummary.md) オブジェクト |
# DeleteAppClient
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
アプリケーションクライアントを削除します。
**Topics**
+ [リクエストボディ](#API_DeleteAppClient_request)
+ [レスポンス要素](#API_DeleteAppClient_response)
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
| パラメータ | 説明 |
| --- | --- |
| **appClientIdentifier** | リクエストに使用する AppClient の Amazon リソースネーム (ARN) または Universal Unique Identifier (UUID) です。 長さの制限：最小長 1、最大長は 1,011 です。 パターン: `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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppClient に関する情報を返します。
**Topics**
+ [リクエストボディ](#API_GetAppClient_request)
+ [レスポンス要素](#API_GetAppClient_response)
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
| パラメータ | 説明 |
| --- | --- |
| **appClientIdentifier** | リクエストに使用する AppClient の Amazon リソースネーム (ARN) または Universal Unique Identifier (UUID) です。 長さの制限：最小長 1、最大長は 1,011 です。 パターン: `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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
実行可能な E メールメッセージ、タスク、その他の更新の最も重要なものを一覧表示します。
**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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
すべての AppClients のリストを返します。
**Topics**
+ [リクエストボディ](#API_ListAppClients_request)
+ [レスポンス要素](#API_ListAppClients_response)
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
| パラメータ | 説明 |
| --- | --- |
| **maxResults** | コールごとに返される結果の最大数です。`nextToken` を使用すると結果ページをさらに取得できます。 こちらはあくまでも上限です。1 回のコールで返される実際の結果が、指定の最大数より少なくなる場合もあります。 有効範囲: 最小値 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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
実行可能なカレンダーイベントの最も重要なものを一覧表示します。
**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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
特定のインサイトまたはアクションに関するフィードバックを送ることをユーザーに許可します。
**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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppClients が認可コードをアクセストークンと交換できるようにする情報が含まれます。
**Topics**
+ [リクエストボディ](#API_Token_request)
+ [レスポンス要素](#API_Token_response)
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
| パラメータ | 説明 |
| --- | --- |
| **コード** | 認可エンドポイントから受信した認可コードです。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。 必須: いいえ |
| **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 です。最大長は 4,096 です。 必須: いいえ |
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
| パラメータ | 説明 |
| --- | --- |
| **appfabric\$1user\$1id** | トークン用のユーザーの ID。この値は、リクエストが `authorization_code` グラントタイプを使用している場合のみ返されます。 タイプ: 文字列 |
| **expires\$1in** | トークンの有効期限が切れるまでの残りの秒数。 タイプ: Long |
| **refresh\$1token** | 次のリクエストに使用する更新トークンです。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。 |
| **token** (トークン) | アクセストークンです。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。 |
| **token\$1type** | トークンのタイプです。 タイプ: 文字列 |
# UpdateAppClient
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppClient を更新します。
**Topics**
+ [リクエストボディ](#API_UpdateAppClient_request)
+ [レスポンス要素](#API_UpdateAppClient_response)
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
| パラメータ | 説明 |
| --- | --- |
| **appClientIdentifier** | リクエストに使用する AppClient の Amazon リソースネーム (ARN) または Universal Unique Identifier (UUID) です。 長さの制限：最小長 1、最大長は 1,011 です。 パターン: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必須: はい |
| **redirectUrls** | 承認後にエンドユーザーがリダイレクトされる URI です。redirectUrls は 5 個まで追加できます。例えば、`https://localhost:8080`。 型: 文字列の配列 配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。 長さの制限：最小長 1、最大長は 2,048 です。 パターン: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` |
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
| パラメータ | 説明 |
| --- | --- |
| **appClient** | AppClient に関する情報が含まれます。 タイプ: [AppClient](API_AppClient.md) オブジェクト |
# AppFabric for productivity の API データ型 (プレビュー)
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppFabric API には、さまざまなアクションに使用される複数のデータ型が含まれています。このセクションでは、AppFabric for productivity 機能のデータ型について詳しく説明します。
AppFabric API のその他のデータ型については、「[AWS AppFabric API Data Types](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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
アプリケーションポートフォリオの E メール、カレンダーの招待、メッセージ、タスクに基づく、ユーザーにとって重要かつ最も適したアクションの概要が含まれます。ユーザーは、すべてのアプリケーションを横断する先を見越したインサイトを確認でき、その日の最適な進め方を確認することができます。これらのインサイトを見れば、ユーザーが、インサイトのサマリーだけでなく、インサイトを生成した、各アプリケーションやアーティファクトなどの参照情報 (埋め込みリンクなど) にも目を向けるべき理由がわかります。
| パラメータ | 説明 |
| --- | --- |
| **insightId** | 生成されたインサイトの一意の ID です。 |
| **insightContent** | インサイトの概要と、インサイトの生成に使用されたアーティファクトへの埋め込みリンクを返します。 こちらは、埋め込みリンク (`` タグ) を含む HTML コンテンツです。 |
| **insightTitle** | 生成されたインサイトの件名です。 |
| **createdAt** | インサイトが生成された日時です。 |
| **actions** | 生成されたインサイトで推奨されるアクションのリストです。 アクションオブジェクトには、以下のパラメータが含まれています。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/API_ActionableInsights.html) |
# AppClient
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppClient に関する情報が含まれます。
**Topics**
| パラメータ | 説明 |
| --- | --- |
| **appName** | アプリケーションの名前。 タイプ: 文字列 必須: はい |
| **arn** | AppClient の Amazon リソースネーム (ARN) です。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 1,011 です。 パターン: `arn:.+` 必須: はい |
| **[ Description]** ( 説明) | アプリケーションの説明です。 タイプ: 文字列 必須: はい |
| **iconUrl** | AppClient のアイコンまたはロゴの URL です。 タイプ: 文字列 必須: いいえ |
| **redirectUrls** | AppClient で許可されているリダイレクト URL。 型: 文字列の配列 配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。 長さの制限：最小長 1、最大長は 2,048 です。 パターン: `(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** | AppClient AWS Key Management Service 用に によって生成された の カスタマー管理キー Amazon リソースネーム (ARN)。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 1,011 です。 パターン: `arn:.+` 必須: いいえ |
| **appClientId** | AppClient の ID です。app-client の 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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppClient に関する情報が含まれます。
**Topics**
| パラメータ | 説明 |
| --- | --- |
| **arn** | AppClient の Amazon リソースネーム (ARN) です。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 1,011 です。 パターン: `arn:.+` 必須: はい |
| **verificationStatus** | AppClient の検証ステータスです。 型: 文字列 有効な値：`pending_verification \| verified \| rejected` 必須: はい |
| **appClientId** | AppClient の ID です。app-client の 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 for productivity 機能はプレビュー版であり、変更される可能性があります。 |
上位 3 件の会議の概要と、会議の目的、関連するクロスアプリケーションアーティファクト、また、タスク、E メール、メッセージ、カレンダーイベントのアクティビティが含まれます。
| パラメータ | 説明 |
| --- | --- |
| **insightId** | 生成されたインサイトの一意の ID です。 |
| **insightContent** | インサイトの説明で、詳細が文字列の形式で強調表示されています。例えば、なぜこのインサイトが重要なのか、など。 |
| **insightTitle** | 生成されたインサイトの件名です。 |
| **createdAt** | インサイトが生成された日時です。 |
| **calendarEvent** | ユーザーが注意すべき重要なカレンダーイベントまたは会議です。 カレンダーイベントオブジェクト: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **resources** | インサイトの生成に関連する他のリソースを含むリストです。 リソースオブジェクト: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **nextToken** | 次回のインサイトのセットを取得するためのページネーショントークンです。こちらはオプションのフィールドで、null が返された場合は、ロードするインサイトがそれ以上ないことを意味します。 |
# VerificationDetails
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppClient 検証のステータスと理由が含まれます。
**Topics**
| パラメータ | 説明 |
| --- | --- |
| **verificationStatus** | AppClient の検証ステータスです。 型: 文字列 有効な値：`pending_verification \| verified \| rejected` 必須: はい |
| **statusReason** | AppClient の検証ステータスの理由です。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 1,024 です。 必須: いいえ |
# AppFabric for productivity の一般的な API エラー (プレビュー)
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
このセクションでは、 AWS AppFabric productivity 機能の API アクションに共通するエラーを一覧表示します。
AppFabric のその他の一般的な API エラーについては、「AWS AppFabric API Reference」の [AppFabric for productivity の AppClients AppClients のトラブルシューティング](ahead-app-dev-errors.md) および「[AWS AppFabric API common errors](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html)」を参照してください。
| 例外名 | 説明 |
| --- | --- |
| **TokenException** | トークンリクエストは無効です。 HTTP ステータスコード: 400 |
# AppFabric でのデータ処理
| |
| --- |
| AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 |
AppFabric では、ユーザーコンテンツを個別に、AppFabric が管理する Amazon S3 バケットにそれぞれ分けて保存する手順を取っています。そうすることで、各ユーザーに固有のインサイトを生成することができます。ユーザーのコンテンツは、保管時および転送中の暗号化を含め、合理的な手段を講じて保護しています。お客様のコンテンツは、取り込まれてから 30 日以内に自動的に削除されるようにシステムで設定されています。AppFabric は、ユーザーがアクセスできなくなったデータアーティファクトを使用して、インサイトを生成することはありません。例えば、ユーザーがデータソース (アプリケーション) を切断した場合、AppFabric はそのアプリケーションからデータを収集することを停止し、切断したアプリケーションに残っているアーティファクトを使ってインサイトを生成することはしません。AppFabric のシステムは、こうしたデータを 30 日以内に削除するように設定されています。
AppFabric が、インサイトの生成に使用される、基盤となる大規模言語モデルのトレーニングや改善に、ユーザーのコンテンツを使用することはありません。AppFabric の生成 AI 機能の詳細については、「[Amazon Bedrock よくある質問](https://aws.amazon.com/bedrock/faqs/)」を参照してください。
## 保管中の暗号化
AWS AppFabric は保管時の暗号化をサポートしています。これは、AppFabric がディスクに保持されているときにユーザーに関連するすべてのデータを透過的に暗号化し、データにアクセスするときに復号するサーバー側の暗号化機能です。
## 転送中の暗号化
AppFabric は、TLS 1.2 を使用して転送中のすべてのコンテンツを保護し、 AWS 署名バージョン 4 で AWS サービスの API リクエストに署名します。