Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Apa AWS AppFabric untuk produktivitas?
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
**catatan**
[Didukung oleh Amazon Bedrock: AWS mengimplementasikan deteksi penyalahgunaan otomatis.](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) Karena AWS AppFabric untuk produktivitas dibangun di Amazon Bedrock, pengguna mewarisi kontrol yang diterapkan di Amazon Bedrock untuk menegakkan keselamatan, keamanan, dan penggunaan AI yang bertanggung jawab.
AWS AppFabric untuk produktivitas (pratinjau) membantu menata kembali produktivitas pengguna akhir dalam aplikasi pihak ketiga dengan menghasilkan wawasan dan tindakan dengan konteks dari beberapa aplikasi. Pengembang aplikasi menyadari bahwa mengakses data pengguna dari aplikasi lain penting dalam menciptakan pengalaman aplikasi yang lebih produktif, tetapi mereka tidak ingin membangun dan mengelola integrasi dengan setiap aplikasi. Dengan AppFabric produktivitas, pengembang aplikasi mendapatkan akses ke AI generatif APIs yang menghasilkan wawasan dan tindakan data lintas aplikasi sehingga mereka dapat memberikan pengalaman pengguna akhir yang lebih kaya melalui asisten AI generatif baru atau yang sudah ada. AppFabric untuk produktivitas mengintegrasikan data dari beberapa aplikasi menghilangkan kebutuhan pengembang untuk membangun atau memelihara point-to-point integrasi. Pengembang aplikasi dapat menyematkan AppFabric produktivitas langsung ke UI aplikasi mereka, mempertahankan pengalaman yang konsisten untuk pengguna akhir mereka sambil memunculkan konteks yang relevan dari aplikasi lain.
AppFabric untuk produktivitas menghubungkan data dari aplikasi yang umum digunakan sepertiAsana,,Atlassian Jira Suite,Google Workspace,Microsoft 365,Miro, SlackSmartsheet, dan banyak lagi. AppFabric Untuk produktivitas memberi pengembang aplikasi cara yang lebih mudah untuk membangun pengalaman aplikasi yang lebih personal yang meningkatkan adopsi, kepuasan, dan loyalitas pengguna. Sementara itu, pengguna akhir mendapat manfaat dari mengakses wawasan yang mereka butuhkan dari seluruh aplikasi mereka tanpa mengganggu alur kerja mereka.
**Topics**
+ [Manfaat](#benefits)
+ [Kasus penggunaan](#use-cases)
+ [Mengakses AppFabric produktivitas](#acessing-appfabric)
+ [Memulai AppFabric untuk produktivitas (pratinjau) untuk pengembang aplikasi](getting-started-appdeveloper-productivity.md)
+ [Memulai AppFabric untuk produktivitas (pratinjau) untuk pengguna akhir](getting-started-users-productivity.md)
+ [AppFabric untuk produktivitas APIs (pratinjau)](productivity-apis.md)
+ [Pemrosesan data di AppFabric](productivity-data-processing.md)
## Manfaat
Dengan AppFabric produktivitas, pengembang aplikasi mendapatkan akses untuk APIs menghasilkan wawasan dan tindakan data lintas aplikasi sehingga mereka dapat memberikan pengalaman pengguna akhir yang lebih kaya melalui asisten AI generatif baru atau yang sudah ada.
+ **Sumber tunggal data pengguna lintas aplikasi**: AppFabric untuk produktivitas mengintegrasikan data dari beberapa aplikasi yang menghilangkan kebutuhan pengembang untuk membangun atau memelihara point-to-point integrasi. Data aplikasi SaaS diproses untuk digunakan dalam aplikasi lain dengan secara otomatis menormalkan tipe data yang berbeda ke dalam format yang dapat dimengerti oleh aplikasi apa pun, memungkinkan pengembang aplikasi untuk memasukkan lebih banyak data yang benar-benar meningkatkan produktivitas pengguna akhir.
+ **Kontrol penuh atas pengalaman pengguna**: Pengembang menyematkan AppFabric produktivitas langsung ke UI aplikasi mereka, mempertahankan kontrol penuh atas pengalaman pengguna sambil memberikan wawasan yang dipersonalisasi dan tindakan yang direkomendasikan kepada pengguna akhir dengan konteks dari seluruh aplikasi mereka. Ini membuat AppFabric produktivitas tersedia di aplikasi SaaS pilihan pengguna akhir dan dapat diakses di aplikasi yang mereka sukai untuk menyelesaikan tugas mereka. Pengguna akhir menghabiskan lebih sedikit waktu untuk beralih antar aplikasi, dan dapat tetap mengikuti alur pekerjaan mereka.
+ **Mempercepat waktu ke pasar**: Dalam satu panggilan API, pengembang aplikasi dapat menerima wawasan tingkat pengguna di seluruh data pengguna yang dihasilkan tanpa harus menyempurnakan model, menulis prompt khusus, atau membangun integrasi di beberapa aplikasi. AppFabric mengabstraksi kompleksitas ini untuk memungkinkan pengembang aplikasi membangun, menyematkan, atau memperkaya kemampuan AI generatif lebih cepat. Hal ini memungkinkan pengembang aplikasi untuk fokus pada sumber daya mereka pada tugas-tugas yang paling penting.
+ **Referensi artifak untuk membangun kepercayaan pengguna**: Sebagai bagian dari output, AppFabric untuk produktivitas akan memunculkan artefak yang relevan atau file sumber yang digunakan untuk menghasilkan wawasan guna membangun kepercayaan pengguna akhir pada output LLM.
+ **Izin pengguna yang disederhanakan**: Artefak pengguna yang digunakan untuk menghasilkan wawasan didasarkan pada akses pengguna. AppFabric Untuk produktivitas menggunakan izin ISV dan kontrol akses sebagai sumber kebenaran.
## Kasus penggunaan
Pengembang aplikasi dapat menggunakan produktivitas AppFabric untuk menata kembali produktivitas di dalam aplikasi mereka. AppFabric untuk produktivitas menawarkan dua APIs fokus pada kasus penggunaan berikut untuk membantu pengguna akhir mereka menjadi lebih produktif:
+ Prioritaskan hari Anda
+ API wawasan yang dapat ditindaklanjuti membantu pengguna mengelola hari mereka dengan memunculkan wawasan tepat waktu dari seluruh aplikasi mereka termasuk email, kalender, pesan, tugas, dan banyak lagi. Selain itu, pengguna dapat melakukan tindakan lintas aplikasi seperti membuat email, menjadwalkan rapat, dan membuat item tindakan dari aplikasi pilihan mereka. Misalnya, seorang karyawan yang mengalami eskalasi pelanggan dalam semalam tidak hanya akan melihat ringkasan percakapan semalam, tetapi juga akan dapat melihat tindakan yang disarankan untuk menjadwalkan pertemuan dengan Manajer Akun pelanggan. Tindakan diisi sebelumnya dengan bidang wajib (seperti nama tugas dan pemilik, atau pengirim/penerima email), dengan kemampuan untuk mengedit konten yang telah diisi sebelumnya sebelum menjalankan tindakan.
+ Mempersiapkan pertemuan mendatang
+ API persiapan rapat membantu pengguna mempersiapkan rapat dengan merangkum tujuan pertemuan dan menampilkan artefak lintas aplikasi yang relevan seperti email, pesan, dan lainnya. Pengguna dapat dengan cepat mempersiapkan rapat sekarang dan tidak membuang waktu beralih antar aplikasi untuk menemukan konten.
## Mengakses AppFabric produktivitas
AppFabric untuk produktivitas saat ini diluncurkan sebagai pratinjau dan tersedia di AS Timur (Virginia N.) Wilayah AWS. Untuk informasi selengkapnya Wilayah AWS, lihat [AWS AppFabric titik akhir dan kuota](https://docs.aws.amazon.com/general/latest/gr/appfabric.html) di. *Referensi Umum AWS*
Di setiap Wilayah, Anda dapat mengakses AppFabric produktivitas dengan salah satu cara berikut:
+ Sebagai pengembang aplikasi
+ [Memulai AppFabric untuk produktivitas (pratinjau) untuk pengembang aplikasi](getting-started-appdeveloper-productivity.md)
+ Sebagai pengguna akhir
+ [Memulai AppFabric untuk produktivitas (pratinjau) untuk pengguna akhir](getting-started-users-productivity.md)
# Memulai AppFabric untuk produktivitas (pratinjau) untuk pengembang aplikasi
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Bagian ini membantu pengembang aplikasi mengintegrasikan AWS AppFabric produktivitas (pratinjau) ke dalam aplikasi mereka. AWS AppFabric Untuk produktivitas memungkinkan pengembang untuk membangun pengalaman aplikasi yang lebih kaya bagi penggunanya dengan menghasilkan wawasan dan tindakan yang didukung AI dari email, acara kalender, tugas, pesan, dan lainnya di beberapa aplikasi. Untuk daftar aplikasi yang didukung, lihat Aplikasi yang [AWS AppFabric Didukung](https://aws.amazon.com/appfabric/supported-applications/).
AppFabric Untuk produktivitas menawarkan pengembang aplikasi akses untuk membangun dan bereksperimen dalam lingkungan yang aman dan terkendali. Ketika Anda pertama kali mulai menggunakan AppFabric untuk produktivitas, Anda membuat AppClient dan mendaftarkan pengguna uji tunggal. Pendekatan ini dirancang untuk membantu Anda memahami dan menguji aliran otentikasi dan komunikasi antara aplikasi Anda dan AppFabric aplikasi. Setelah Anda menguji dengan satu pengguna, Anda dapat mengirimkan aplikasi Anda AppFabric untuk verifikasi sebelum memperluas akses ke pengguna tambahan (lihat[Langkah 5. Permintaan AppFabric untuk memverifikasi aplikasi Anda](#request_verification)). AppFabric akan memverifikasi informasi aplikasi sebelum memungkinkan adopsi yang tersebar luas untuk membantu melindungi pengembang aplikasi, pengguna akhir, dan data mereka — membuka jalan untuk memperluas adopsi pengguna dengan cara yang bertanggung jawab.
**Topics**
+ [Prasyarat](#getting-started-prerequisites)
+ [Langkah 1. Buat AppFabric untuk produktivitas AppClient](#create_appclient)
+ [Langkah 2. Otentikasi dan otorisasi aplikasi Anda](#authorize_data_access)
+ [Langkah 3. Tambahkan URL portal AppFabric pengguna ke aplikasi Anda](#end_user_portal)
+ [Langkah 4. Gunakan AppFabric untuk memunculkan wawasan dan tindakan lintas aplikasi](#surface_insights_actions)
+ [Langkah 5. Permintaan AppFabric untuk memverifikasi aplikasi Anda](#request_verification)
+ [Kelola AppFabric untuk produktivitas AppClients](manage-appclients.md)
+ [Memecahkan masalah untuk AppClients produktivitas AppFabric](ahead-app-dev-errors.md)
## Prasyarat
Sebelum Anda memulai, Anda perlu membuat file Akun AWS. Untuk informasi selengkapnya, lihat [Mendaftar untuk Akun AWS](prerequisites.md#sign-up-for-aws). Anda juga perlu membuat setidaknya satu pengguna dengan akses ke kebijakan `"appfabric:CreateAppClient"` IAM yang tercantum di bawah ini, yang memungkinkan pengguna untuk mendaftarkan aplikasi Anda. AppFabric Untuk informasi selengkapnya tentang pemberian izin untuk fitur produktivitas, lihat. AppFabric [AppFabric untuk contoh kebijakan IAM produktivitas](security_iam_id-based-policy-examples.md#appfabric-for-productivity-policy-examples) Meskipun memiliki pengguna administratif bermanfaat, itu tidak wajib untuk pengaturan awal. Untuk informasi selengkapnya, lihat [Buat pengguna dengan akses administratif](prerequisites.md#create-an-admin).
AppFabric untuk produktivitas hanya di AS Timur (Virginia N.) selama pratinjau. Pastikan Anda berada di wilayah ini sebelum memulai langkah-langkah di bawah ini.
## Langkah 1. Buat AppFabric untuk produktivitas AppClient
Sebelum Anda dapat mulai muncul AppFabric untuk wawasan produktivitas dalam aplikasi Anda, Anda perlu membuat. AppFabric AppClient An pada dasarnya AppClient adalah pintu gerbang Anda AppFabric untuk produktivitas, berfungsi sebagai klien OAuth aplikasi aman yang memungkinkan komunikasi aman antara aplikasi Anda dan AppFabric aplikasi. Saat Anda membuat AppClient, Anda akan diberikan AppClient ID, pengenal unik yang penting untuk memastikan AppFabric bahwa itu berfungsi dengan aplikasi Anda dan Anda Akun AWS.
AppFabric Untuk produktivitas menawarkan pengembang aplikasi akses untuk membangun dan bereksperimen dalam lingkungan yang aman dan terkendali. Ketika Anda pertama kali mulai menggunakan AppFabric untuk produktivitas, Anda membuat AppClient dan mendaftarkan pengguna uji tunggal. Pendekatan ini dirancang untuk membantu Anda memahami dan menguji aliran otentikasi dan komunikasi antara aplikasi Anda dan AppFabric aplikasi. Setelah Anda menguji dengan satu pengguna, Anda dapat mengirimkan aplikasi Anda AppFabric untuk verifikasi sebelum memperluas akses ke pengguna tambahan (lihat[Langkah 5. Permintaan AppFabric untuk memverifikasi aplikasi Anda](#request_verification)). AppFabric akan memverifikasi informasi aplikasi sebelum memungkinkan adopsi yang tersebar luas untuk membantu melindungi pengembang aplikasi, pengguna akhir, dan data mereka — membuka jalan untuk memperluas adopsi pengguna dengan cara yang bertanggung jawab.
Untuk membuat AppClient, gunakan operasi AWS AppFabric `CreateAppClient` API. Jika Anda perlu memperbarui AppClient setelahnya, Anda dapat menggunakan operasi `UpdateAppClient` API untuk mengubah hanya redirecTurls. Jika Anda perlu mengubah salah satu parameter lain yang terkait dengan Anda AppClient seperti AppName atau deskripsi, Anda harus menghapus AppClient dan membuat yang baru. Untuk informasi selengkapnya, lihat [CreateAppClient](API_CreateAppClient.md).
Anda dapat mendaftarkan aplikasi Anda dengan AWS layanan menggunakan `CreateAppClient` API menggunakan beberapa bahasa pemrograman, termasuk Python, Node.js, Java, C \$1, Go dan Rust. Untuk informasi selengkapnya, lihat [Meminta contoh tanda tangan](https://docs.aws.amazon.com/IAM/latest/UserGuide/signature-v4-examples.html) di *Panduan Pengguna IAM*. Anda perlu menggunakan kredensyal versi 4 tanda tangan akun Anda untuk melakukan operasi API ini. Untuk informasi selengkapnya tentang tanda tangan versi 4, lihat [Menandatangani permintaan AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) di *Panduan Pengguna IAM*.
**Bidang Permintaan**
+ `appName`- Nama aplikasi yang akan ditampilkan kepada pengguna di halaman persetujuan portal AppFabric pengguna. Halaman persetujuan meminta izin pengguna akhir untuk menampilkan AppFabric wawasan di dalam aplikasi Anda. Untuk detail tentang halaman persetujuan, lihat[Langkah 2. Memberikan persetujuan bagi aplikasi untuk menampilkan wawasan](getting-started-users-productivity.md#provide-consent).
+ `description`- Deskripsi untuk aplikasi.
+ `redirectUrls`- URI untuk mengarahkan pengguna akhir setelah otorisasi. Anda dapat menambahkan hingga 5 RedirecTurls. Misalnya, `https://localhost:8080`.
+ `starterUserEmails`- Alamat email pengguna yang akan diizinkan mengakses untuk menerima wawasan sampai aplikasi diverifikasi. Hanya satu alamat email yang diizinkan. Sebagai contoh, `anyuser@example.com`.
+ `customerManagedKeyIdentifier`(opsional) - ARN kunci yang dikelola pelanggan (dihasilkan oleh KMS) untuk digunakan untuk mengenkripsi data. Jika tidak ditentukan, maka kunci yang AWS AppFabric dikelola akan digunakan. Untuk informasi selengkapnya tentang Kunci milik AWS dan kunci yang dikelola [pelanggan, lihat Kunci dan AWS kunci](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) pelanggan di *Panduan AWS Key Management Service Pengembang*.
**Bidang Respons**
+ `appClientArn`- Nama Sumber Daya Amazon (ARN) yang menyertakan ID. AppClient Misalnya, AppClient ID adalah`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `verificationStatus`- Status AppClient verifikasi.
+ `pending_verification`- Verifikasi AppClient masih dalam proses dengan AppFabric. Sampai AppClient diverifikasi, hanya satu pengguna (ditentukan dalam`starterUserEmails`) yang dapat menggunakan file AppClient. Pengguna akan melihat pemberitahuan di portal AppFabric pengguna, diperkenalkan di[Langkah 3. Tambahkan URL portal AppFabric pengguna ke aplikasi Anda](#end_user_portal), yang menunjukkan bahwa aplikasi tidak diverifikasi.
+ `verified`- Proses verifikasi telah berhasil diselesaikan oleh AppFabric dan sekarang sepenuhnya diverifikasi. AppClient
+ `rejected`- Proses verifikasi untuk AppClient ditolak oleh AppFabric. AppClient Tidak dapat digunakan oleh pengguna tambahan sampai proses verifikasi dimulai kembali dan diselesaikan dengan sukses.
```
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/"
}'
```
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
```
{
"appClientConfigSummary": {
"appClientArn": "arn:aws:appfabric:::appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"verificationStatus": "pending_verification"
}
}
```
## Langkah 2. Otentikasi dan otorisasi aplikasi Anda
Aktifkan aplikasi Anda untuk mengintegrasikan AppFabric wawasan dengan aman dengan membuat alur otorisasi OAuth 2.0. Pertama, Anda perlu membuat kode otorisasi, yang memverifikasi identitas aplikasi Anda. Untuk informasi selengkapnya, lihat [Otorisasi](API_Authorize.md). Kemudian Anda akan menukar kode otorisasi ini dengan token akses, yang memberikan izin kepada aplikasi Anda untuk mengambil dan menampilkan AppFabric wawasan dalam aplikasi Anda. Untuk informasi selengkapnya, lihat [Token](API_Token.md).
Untuk informasi selengkapnya tentang pemberian izin untuk mengotorisasi aplikasi, lihat. [Izinkan akses untuk mengotorisasi aplikasi](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-token)
1. Untuk membuat kode otorisasi, gunakan operasi AWS AppFabric `oauth2/authorize` API.
**Bidang Permintaan**
+ `app_client_id`(wajib) - AppClient ID untuk yang Akun AWS dibuat di [Langkah 1. Buat sebuah AppClient](#create_appclient). Misalnya, `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `redirect_uri`(wajib) - URI untuk mengarahkan pengguna akhir setelah otorisasi yang Anda gunakan pada [Langkah 1. Buat sebuah AppClient](#create_appclient). Misalnya, `https://localhost:8080`.
+ `state`(required) - Nilai unik untuk mempertahankan status antara permintaan dan callback. Misalnya, `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. Setelah otentikasi, Anda akan diarahkan ke URI yang ditentukan dengan kode otorisasi yang dikembalikan sebagai parameter kueri. Misalnya, di mana`code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`.
```
https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44
```
1. Tukarkan kode otorisasi ini dengan token akses menggunakan operasi AppFabric `oauth2/token` API.
Token ini digunakan untuk permintaan API dan awalnya valid untuk `starterUserEmails` sampai AppClient diverifikasi. Setelah AppClient diverifikasi, token ini dapat digunakan untuk setiap pengguna. Anda perlu menggunakan kredensyal versi 4 tanda tangan akun Anda untuk melakukan operasi API ini. Untuk informasi selengkapnya tentang tanda tangan versi 4, lihat [Menandatangani permintaan AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) di *Panduan Pengguna IAM*.
**Bidang Permintaan**
+ `code`(wajib) - Kode otorisasi yang Anda terima setelah mengautentikasi pada langkah terakhir. Misalnya, `mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`.
+ `app_client_id`(wajib) - AppClient ID untuk yang Akun AWS dibuat di [Langkah 1. Buat sebuah AppClient](#create_appclient). Misalnya, `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `grant_type`(wajib) - Nilainya harus`authorization_code`.
+ `redirect_uri`(wajib) - URI untuk mengarahkan pengguna setelah otorisasi yang Anda gunakan pada [Langkah 1. Buat sebuah AppClient](#create_appclient). Ini harus URI pengalihan yang sama yang digunakan untuk membuat kode otorisasi. Misalnya, `https://localhost:8080`.
**Bidang Respons**
+ `expires_in`- Seberapa cepat sebelum token kedaluwarsa. Waktu kedaluwarsa default adalah 12 jam.
+ `refresh_token`- Token penyegaran yang diterima dari permintaan /token awal.
+ `token`- Token yang diterima dari permintaan /token awal.
+ `token_type`- Nilainya akan`Bearer`.
+ `appfabric_user_id`- Id AppFabric pengguna. Ini dikembalikan hanya untuk permintaan yang menggunakan jenis `authorization_code` hibah.
```
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\"
}"
```
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
```
{
"expires_in": 43200,
"refresh_token": "apkaeibaerjr2example",
"token": "apkaeibaerjr2example",
"token_type": "Bearer",
"appfabric_user_id" : ""
}
```
## Langkah 3. Tambahkan URL portal AppFabric pengguna ke aplikasi Anda
Pengguna akhir perlu mengotorisasi AppFabric untuk mengakses data dari aplikasi mereka yang digunakan untuk menghasilkan wawasan. AppFabric menghilangkan kerumitan bagi pengembang aplikasi untuk memiliki proses ini dengan membangun portal pengguna khusus (layar pop-up) bagi pengguna akhir untuk mengotorisasi aplikasi mereka. Ketika pengguna siap AppFabric untuk mengaktifkan produktivitas, mereka akan dibawa ke portal pengguna yang memungkinkan mereka untuk menghubungkan dan mengelola aplikasi yang digunakan untuk menghasilkan wawasan dan tindakan lintas aplikasi. Saat masuk, pengguna dapat menghubungkan aplikasi AppFabric untuk produktivitas dan kemudian kembali ke aplikasi Anda untuk menjelajahi wawasan dan tindakan. Untuk mengintegrasikan aplikasi Anda dengan AppFabric produktivitas, Anda perlu menambahkan AppFabric URL tertentu ke aplikasi Anda. Langkah ini sangat penting untuk memungkinkan pengguna mengakses portal AppFabric pengguna langsung dari aplikasi Anda.
1. Arahkan ke pengaturan aplikasi Anda dan temukan bagian untuk menambahkan pengalihan URLs.
1. Setelah Anda menemukan area yang sesuai, tambahkan AppFabric URL berikut sebagai URL pengalihan ke aplikasi Anda:
```
https://userportal.appfabric..amazonaws.com/eup_login
```
Setelah Anda menambahkan URL, aplikasi Anda akan diatur untuk mengarahkan pengguna ke portal AppFabric pengguna. Di sini, pengguna dapat masuk dan terhubung serta mengelola aplikasi mereka yang digunakan AppFabric untuk menghasilkan wawasan produktivitas.
## Langkah 4. Gunakan AppFabric untuk memunculkan wawasan dan tindakan lintas aplikasi
Setelah pengguna menghubungkan aplikasi mereka, Anda dapat membawa wawasan pengguna Anda untuk meningkatkan produktivitas mereka dengan membantu mengurangi peralihan aplikasi dan konteks. AppFabric hanya menghasilkan wawasan untuk pengguna berdasarkan apa yang pengguna memiliki izin untuk mengakses. AppFabric menyimpan data pengguna yang Akun AWS dimiliki oleh AppFabric. Untuk informasi tentang cara AppFabric menggunakan data Anda, lihat[Pemrosesan data di AppFabric](productivity-data-processing.md).
Anda dapat menggunakan AI berikut ini APIs untuk menghasilkan dan memunculkan wawasan dan tindakan tingkat pengguna dalam aplikasi Anda:
+ `ListActionableInsights`— Untuk informasi selengkapnya, lihat bagian [Wawasan yang dapat ditindaklanjuti](#productivity-actionable-insights) di bawah ini.
+ `ListMeetingInsights`— Untuk informasi lebih lanjut, lihat bagian [Persiapan Rapat](#productivity-meeting-insights) nanti di panduan ini.
### Wawasan yang dapat ditindaklanjuti () `ListActionableInsights`
`ListActionableInsights`API membantu pengguna mengelola wawasan yang dapat ditindaklanjuti dengan sebaik-baiknya berdasarkan aktivitas di seluruh aplikasi mereka, termasuk email, kalender, pesan, tugas, dan lainnya. Wawasan yang dikembalikan juga akan menampilkan tautan tertanam ke artefak yang digunakan untuk menghasilkan wawasan — membantu pengguna melihat data apa yang digunakan untuk menghasilkan wawasan dengan cepat. Selain itu, API dapat menampilkan tindakan yang disarankan berdasarkan wawasan dan memungkinkan pengguna untuk menjalankan tindakan lintas aplikasi dari dalam aplikasi Anda. Secara khusus, API terintegrasi dengan platform sepertiAsana,, Google WorkspaceMicrosoft 365, dan Smartsheet untuk memungkinkan pengguna mengirim email, membuat acara kalender, dan membuat tugas. Model bahasa besar (LLMs) dapat mengisi detail sebelumnya dalam tindakan yang disarankan (seperti badan email atau nama tugas), yang dapat disesuaikan pengguna sebelum eksekusi — menyederhanakan pengambilan keputusan dan meningkatkan produktivitas. Mirip dengan pengalaman bagi pengguna akhir untuk mengotorisasi aplikasi, AppFabric menggunakan portal khusus yang sama bagi pengguna untuk melihat, mengedit, dan menjalankan tindakan lintas aplikasi. Untuk mengeksekusi tindakan, AppFabric diperlukan ISVs untuk mengarahkan kembali pengguna ke portal AppFabric pengguna di mana mereka dapat melihat detail tindakan dan mengeksekusinya. Setiap tindakan yang dihasilkan oleh AppFabric memiliki URL yang unik. URL ini tersedia dalam respons respons `ListActionableInsights` API.
Di bawah ini adalah ringkasan tindakan lintas aplikasi yang didukung dan aplikasi mana:
+ Kirim email (Google Workspace,Microsoft 365)
+ Membuat kalender acara (Google Workspace,Microsoft 365)
+ Buat tugas (Asana,Smartsheet)
**Bidang Permintaan**
+ `nextToken`(opsional) - Token pagination untuk mengambil kumpulan wawasan berikutnya.
+ `includeActionExecutionStatus`- Filter yang menerima daftar status eksekusi tindakan. Tindakan disaring berdasarkan nilai status yang diteruskan. Nilai yang mungkin: `NOT_EXECUTED` \$1 `EXECUTED`
**Permintaan Header**
+ Header otorisasi harus diteruskan dengan `Bearer Token ` nilainya.
**Bidang Respons**
+ `insightId`- Id unik untuk wawasan yang dihasilkan.
+ `insightContent`- Ini mengembalikan ringkasan wawasan dan tautan tertanam ke artefak yang digunakan untuk menghasilkan wawasan. Catatan: Ini akan menjadi konten HTML yang berisi tautan tertanam (tag).
+ `insightTitle`- Judul wawasan yang dihasilkan.
+ `createdAt`- Saat wawasan dihasilkan.
+ `actions`- Daftar tindakan yang direkomendasikan untuk wawasan yang dihasilkan. Objek aksi:
+ `actionId`- Id unik untuk tindakan yang dihasilkan.
+ `actionIconUrl`- URL ikon untuk aplikasi tempat tindakan disarankan untuk dieksekusi.
+ `actionTitle`- Judul tindakan yang dihasilkan.
+ `actionUrl`- URL unik untuk pengguna akhir untuk melihat dan menjalankan tindakan di AppFabric portal pengguna. Catatan: untuk menjalankan tindakan, aplikasi ISV akan mengarahkan ulang pengguna ke portal AppFabric pengguna (layar pop up) menggunakan URL ini.
+ `actionExecutionStatus`- Enum yang menunjukkan status tindakan. Nilai yang mungkin adalah: `EXECUTED` \$1 `NOT_EXECUTED`
+ `nextToken`(opsional) - Token pagination untuk mengambil kumpulan wawasan berikutnya. Ini adalah bidang opsional yang jika dikembalikan null berarti tidak ada lagi wawasan untuk dimuat.
Untuk informasi selengkapnya, lihat [ActionableInsights](API_ActionableInsights.md).
```
curl -v --location \
"https://productivity.appfabric..amazonaws.com"\
"/actionableInsights" \
--header "Authorization: Bearer "
```
Jika tindakan berhasil, layanan mengirimkan kembali respons 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
}
```
### Persiapan rapat (`ListMeetingInsights`)
`ListMeetingInsights`API membantu pengguna mempersiapkan diri terbaik untuk pertemuan mendatang dengan meringkas tujuan pertemuan dan menampilkan artefak lintas aplikasi yang relevan seperti email, pesan, dan banyak lagi. Pengguna dapat dengan cepat mempersiapkan rapat sekarang dan tidak membuang waktu beralih antar aplikasi untuk menemukan konten.
**Bidang Permintaan**
+ `nextToken`(opsional) - Token pagination untuk mengambil kumpulan wawasan berikutnya.
**Permintaan Header**
+ Header otorisasi harus diteruskan dengan `Bearer Token` nilainya.
**Bidang Respons**
+ `insightId`- Id unik untuk wawasan yang dihasilkan.
+ `insightContent`- Deskripsi wawasan yang menyoroti detail dalam format string. Seperti, mengapa wawasan ini penting.
+ `insightTitle`- Judul wawasan yang dihasilkan.
+ `createdAt`- Saat wawasan dihasilkan.
+ `calendarEvent`- Acara atau rapat kalender penting yang harus difokuskan pengguna. Kalender objek Acara:
+ `startTime`- Waktu mulai acara.
+ `endTime`- Waktu akhir acara.
+ `eventUrl`- URL untuk acara kalender di aplikasi ISV.
+ `resources`- Daftar yang berisi sumber daya lain yang terkait dengan menghasilkan wawasan. Objek sumber daya:
+ `appName`- Nama aplikasi tempat sumber daya berada.
+ `resourceTitle`- Judul sumber daya.
+ `resourceType`- Jenis sumber daya. Nilai yang mungkin adalah: `EMAIL` \$1 `EVENT` \$1 `MESSAGE` \$1 `TASK`
+ `resourceUrl`- URL sumber daya di aplikasi.
+ `appIconUrl`- URL gambar aplikasi tempat sumber daya berada.
+ `nextToken`(opsional) - Token pagination untuk mengambil kumpulan wawasan berikutnya. Ini adalah bidang opsional yang jika dikembalikan null berarti tidak ada lagi wawasan untuk dimuat.
Untuk informasi selengkapnya, lihat [MeetingInsights](API_MeetingInsights.md).
```
curl --location \
"https://productivity.appfabric..amazonaws.com"\
"/meetingContexts" \
--header "Authorization: Bearer "
```
Jika tindakan berhasil, layanan mengirimkan kembali respon 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
}
```
### Berikan umpan balik untuk wawasan atau tindakan Anda
Gunakan operasi AppFabric `PutFeedback` API untuk memberikan umpan balik untuk wawasan dan tindakan yang dihasilkan. Anda dapat menyematkan fitur ini di aplikasi Anda untuk memberikan cara untuk mengirimkan peringkat umpan balik (1 hingga 5, di mana peringkat yang lebih tinggi semakin baik) untuk yang diberikan InsightId atau ActionId.
**Bidang permintaan**
+ `id`- Pengidentifikasi objek yang umpan baliknya dikirimkan. Ini bisa berupa InsightId atau ActionId.
+ `feedbackFor`- Jenis sumber daya yang umpan balik dikirimkan. Nilai yang mungkin: `ACTIONABLE_INSIGHT` \$1 `MEETING_INSIGHT` \$1 `ACTION`
+ `feedbackRating`- Peringkat umpan balik dari `1` ke`5`. Rating yang lebih tinggi semakin baik.
**Bidang respons**
+ Tidak ada bidang respons.
Untuk informasi selengkapnya, lihat [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
}'
```
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 201 dengan badan HTTP kosong.
## Langkah 5. Permintaan AppFabric untuk memverifikasi aplikasi Anda
Untuk titik ini, Anda telah memperbarui UI aplikasi untuk menyematkan wawasan dan tindakan AppFabric lintas aplikasi, dan menerima wawasan untuk satu pengguna. Setelah puas dengan pengujian dan ingin memperluas pengalaman yang AppFabric diperkaya kepada pengguna tambahan, Anda dapat mengirimkan aplikasi Anda AppFabric untuk ditinjau dan diverifikasi. AppFabric akan memverifikasi informasi aplikasi sebelum memungkinkan adopsi yang tersebar luas untuk membantu melindungi pengembang aplikasi, pengguna akhir, dan data mereka — membuka jalan untuk memperluas adopsi pengguna dengan cara yang bertanggung jawab.
**Memulai proses verifikasi**
Mulailah proses verifikasi dengan mengirimkan email ke [appfabric-appverification@amazon.com](mailto:appfabric-appverification@amazon.com) dan meminta agar aplikasi Anda diverifikasi.
Sertakan detail berikut di email Anda:
+ Akun AWS ID Anda
+ Nama aplikasi yang Anda cari verifikasi
+ AppClient ID Anda
+ Informasi kontak Anda
Selain itu, berikan informasi berikut, jika tersedia, untuk membantu kami menilai prioritas dan dampak:
+ Perkiraan jumlah pengguna yang Anda rencanakan untuk memberikan akses
+ Tanggal peluncuran target Anda
**catatan**
Jika Anda memiliki Akun AWS manajer atau manajer pengembangan AWS mitra, silakan salin di email Anda. Menyertakan kontak ini dapat membantu mempercepat proses verifikasi.
**Kriteria verifikasi**
Sebelum memulai proses verifikasi, Anda harus memenuhi kriteria berikut:
+ Anda harus menggunakan valid Akun AWS untuk digunakan AppFabric untuk produktivitas
Selain itu, Anda memenuhi setidaknya satu dari kriteria ini:
+ Organisasi Anda adalah AWS mitra AWS Partner Network dengan setidaknya tingkat “AWS Pilih”. Untuk informasi selengkapnya, lihat [AWS Tingkat Layanan Mitra.](https://aws.amazon.com/partners/services-tiers/)
+ Organisasi Anda seharusnya menghabiskan setidaknya \$110.000 untuk AppFabric layanan dalam tiga tahun terakhir.
+ Aplikasi Anda harus terdaftar di AWS Marketplace. Untuk informasi selengkapnya, lihat [AWS Marketplace](https://aws.amazon.com/marketplace).
**Tunggu pembaruan status verifikasi**
Setelah aplikasi Anda ditinjau, kami akan merespons melalui email dan status Anda AppClient akan berubah dari `pending_verification` menjadi`verified`. Jika aplikasi Anda ditolak, Anda harus memulai kembali proses verifikasi.
# Kelola AppFabric untuk produktivitas AppClients
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Anda dapat mengelola produktivitas Anda AppFabric AppClients untuk memastikan kelancaran operasi dan pemeliharaan proses otentikasi dan otorisasi.
## Dapatkan detail dari sebuah AppClient
Gunakan operasi AppFabric `GetAppClient` API untuk melihat detail tentang Anda AppClient, termasuk memeriksa AppClient status. Untuk informasi selengkapnya, lihat [GetAppClient](API_GetAppClient.md).
Untuk mendapatkan detail AppClient, Anda harus memiliki, setidaknya, izin kebijakan `"appfabric:GetAppClient"` IAM. Untuk informasi selengkapnya, lihat [Izinkan akses untuk mendapatkan detail AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-get-appclient).
**Bidang Permintaan**
+ `appClientId`- AppClient Id.
**Bidang Respons**
+ `appName`- Nama aplikasi yang akan ditampilkan kepada pengguna di halaman persetujuan portal AppFabric pengguna.
+ `customerManagedKeyIdentifier`(opsional) - ARN dari Customer Managed Key (dihasilkan oleh KMS) untuk digunakan untuk mengenkripsi data. Jika tidak ditentukan, maka Kunci AWS AppFabric Terkelola akan digunakan.
+ `description`- Deskripsi untuk aplikasi.
+ `redirectUrls`- URI untuk mengarahkan pengguna akhir setelah otorisasi. Anda dapat menambahkan hingga 5 RedirecTurls. Misalnya, `https://localhost:8080`.
+ `starterUserEmails`- Alamat email pengguna yang akan diizinkan mengakses untuk menerima wawasan sampai aplikasi diverifikasi. Hanya satu alamat email yang diizinkan. Misalnya, `anyuser@example.com`.
+ `verificationStatus`- Status AppClient verifikasi.
+ `pending_verification`- Verifikasi AppClient masih dalam proses dengan AppFabric. Sampai AppClient diverifikasi, hanya satu pengguna (ditentukan dalam`starterUserEmails`) yang dapat menggunakan file AppClient.
+ `verified`- Proses verifikasi telah berhasil diselesaikan oleh AppFabric dan sekarang sepenuhnya diverifikasi. AppClient
+ `rejected`- Proses verifikasi untuk AppClient ditolak oleh AppFabric. AppClient Tidak dapat digunakan oleh pengguna tambahan sampai proses verifikasi dimulai kembali dan diselesaikan dengan sukses.
```
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
```
Jika tindakan berhasil, layanan mengirimkan kembali respons 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"
}
}
}
```
## Daftar AppClients
Gunakan operasi AppFabric `ListAppClients` API untuk melihat daftar Anda AppClients. AppFabric hanya memungkinkan satu AppClient per Akun AWS. Ini dapat berubah di masa depan. Untuk informasi selengkapnya, lihat [ListAppClients](API_ListAppClients.md).
Untuk mendaftar AppClients, Anda harus memiliki, setidaknya, izin kebijakan `"appfabric:ListAppClients"` IAM. Untuk informasi selengkapnya, lihat [Izinkan akses ke daftar AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-list-appclient).
**Bidang Permintaan**
+ Tidak ada bidang wajib.
**Bidang Respons**
+ `appClientARN`- Nama Sumber Daya Amazon (ARN) yang menyertakan ID. AppClient Misalnya, AppClient ID adalah`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `verificationStatus`- Status AppClient verifikasi.
+ `pending_verification`- Verifikasi AppClient masih dalam proses dengan AppFabric. Sampai AppClient diverifikasi, hanya satu pengguna (ditentukan dalam`starterUserEmails`) yang dapat menggunakan file AppClient.
+ `verified`- Proses verifikasi telah berhasil diselesaikan oleh AppFabric dan sekarang sepenuhnya diverifikasi. AppClient
+ `rejected`- Proses verifikasi untuk AppClient ditolak oleh AppFabric. AppClient Tidak dapat digunakan oleh pengguna tambahan sampai proses verifikasi dimulai kembali dan diselesaikan dengan sukses.
```
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
```
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
```
200 OK
{
"appClientList": [
{
"appClientArn": "arn:aws:appfabric::111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"verificationStatus": "pending_verification"
}
]
}
```
## Perbarui AppClient
Gunakan operasi AppFabric `UpdateAppClient` API untuk memperbarui redirectUrls yang dipetakan ke Anda. AppClient Jika Anda perlu mengubah parameter lain, seperti AppName, starterUserEmails, atau lainnya, Anda harus menghapus AppClient dan membuat yang baru. Untuk informasi selengkapnya, lihat [UpdateAppClient](API_UpdateAppClient.md).
Untuk memperbarui AppClient, Anda harus memiliki, setidaknya, izin kebijakan `"appfabric:UpdateAppClient"` IAM. Untuk informasi selengkapnya, lihat [Izinkan akses untuk memperbarui AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient).
**Bidang Permintaan**
+ `appClientId`(required) - AppClient ID yang Anda perbarui redirectUrls.
+ `redirectUrls`(wajib) - Daftar RedirecTurls yang diperbarui. Anda dapat menambahkan hingga 5 RedirecTurls.
**Bidang Respons**
+ `appName`- Nama aplikasi yang akan ditampilkan kepada pengguna di halaman persetujuan portal AppFabric pengguna.
+ `customerManagedKeyIdentifier`(opsional) - ARN dari Customer Managed Key (dihasilkan oleh KMS) untuk digunakan untuk mengenkripsi data. Jika tidak ditentukan, maka Kunci AWS AppFabric Terkelola akan digunakan.
+ `description`- Deskripsi untuk aplikasi.
+ `redirectUrls`- URI untuk mengarahkan pengguna akhir setelah otorisasi. Misalnya, `https://localhost:8080`.
+ `starterUserEmails`- Alamat email pengguna yang akan diizinkan mengakses untuk menerima wawasan sampai aplikasi diverifikasi. Hanya satu alamat email yang diizinkan. Misalnya, `anyuser@example.com`.
+ `verificationStatus`- Status AppClient verifikasi.
+ `pending_verification`- Verifikasi AppClient masih dalam proses dengan AppFabric. Sampai AppClient diverifikasi, hanya satu pengguna (ditentukan dalam`starterUserEmails`) yang dapat menggunakan file AppClient.
+ `verified`- Proses verifikasi telah berhasil diselesaikan oleh AppFabric dan sekarang sepenuhnya diverifikasi. AppClient
+ `rejected`- Proses verifikasi untuk AppClient ditolak oleh AppFabric. AppClient Tidak dapat digunakan oleh pengguna tambahan sampai proses verifikasi dimulai kembali dan diselesaikan dengan sukses.
```
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"]
}'
```
Jika tindakan berhasil, layanan mengirimkan kembali respons 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"
}
}
}
```
## Menghapus sebuah AppClient
Gunakan operasi AppFabric `DeleteAppClient` API untuk menghapus apa pun yang tidak lagi AppClients Anda perlukan. Untuk informasi selengkapnya, lihat [DeleteAppClient](API_DeleteAppClient.md).
Untuk menghapus AppClient, Anda harus memiliki, setidaknya, izin kebijakan `"appfabric:DeleteAppClient"` IAM. Untuk informasi selengkapnya, lihat [Izinkan akses untuk menghapus AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-delete-appclient).
**Bidang permintaan**
+ `appClientId`- AppClient Id.
**Bidang respons**
+ Tidak ada bidang respons.
```
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
```
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 dengan isi HTTP kosong.
## Segarkan token untuk pengguna akhir
Token yang Anda AppClient peroleh untuk pengguna akhir dapat di-refresh pada saat kedaluwarsa. Ini dapat dilakukan dengan menggunakan [Token](API_Token.md) API dengan `refresh_token` grant\$1type. Yang `refresh_token` akan digunakan dikembalikan sebagai bagian dari respons API token saat grant\$1type. `authorization_code` Kedaluwarsa default adalah 12 jam. Untuk memanggil refresh API, Anda harus memiliki izin kebijakan `"appfabric:Token"` IAM. Untuk informasi selengkapnya, lihat [Token](API_Token.md) dan [Izinkan akses untuk memperbarui AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient).
**Bidang Permintaan**
+ `refresh_token`(wajib) - Token penyegaran yang diterima dari `/token` permintaan awal.
+ `app_client_id`(wajib) - ID AppClient sumber daya yang dibuat untuk file Akun AWS.
+ `grant_type`(wajib) - Ini harus`refresh_token`.
**Bidang Respons**
+ `expires_in`- Seberapa cepat sebelum token kedaluwarsa. Waktu kedaluwarsa default adalah 12 jam.
+ `refresh_token`- Token penyegaran yang diterima dari permintaan /token awal.
+ `token`- Token yang diterima dari permintaan /token awal.
+ `token_type`- Nilainya akan`Bearer`.
+ `appfabric_user_id`- Id AppFabric pengguna. Ini dikembalikan hanya untuk permintaan yang menggunakan jenis `authorization_code` hibah.
```
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\"
}"
```
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
```
200 OK
{
"expires_in": 43200,
"token": "apkaeibaerjr2example",
"token_type": "Bearer",
"appfabric_user_id" : "${UserID}"
}
```
# Memecahkan masalah untuk AppClients produktivitas AppFabric
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Bagian ini menjelaskan kesalahan umum dan pemecahan masalah AppFabric untuk produktivitas.
## Aplikasi yang belum diverifikasi
Pengembang aplikasi yang menggunakan produktivitas AppFabric untuk memperkaya pengalaman aplikasi mereka akan melalui proses verifikasi sebelum meluncurkan fitur mereka ke pengguna akhir. Semua aplikasi dimulai sebagai tidak diverifikasi dan berubah menjadi diverifikasi hanya ketika proses verifikasi selesai. Ini berarti bahwa yang `starterUserEmails` Anda gunakan saat membuat AppClient akan melihat pesan ini.
![\[Warning message for an unverified application in AWS AppFabric, requesting data access.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-24.png)
## Kesalahan `CreateAppClient`
### ServiceQuotaExceededException
Jika Anda menerima pengecualian berikut saat membuat AppClient, Anda telah melebihi jumlah AppClients yang dapat dibuat per Akun AWS. Batasnya adalah 1. Kode Status 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
```
## Kesalahan `GetAppClient`
### ResourceNotFoundException
Jika Anda menerima pengecualian berikut saat mendapatkan detail untuk sebuah AppClient, pastikan Anda telah memasukkan AppClient pengenal yang benar. Kesalahan ini menandakan bahwa yang ditentukan tidak AppClient ditemukan.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Kesalahan `DeleteAppClient`
### ConflictException
Jika Anda menerima pengecualian berikut saat menghapus AppClient, permintaan penghapusan lainnya sedang berlangsung. Tunggu sampai selesai lalu coba lagi. Kode Status HTTP: 409
```
ConflictException
Another delete request is in progress. Wait until it completes then try again.
HTTP Status Code: 409
```
### ResourceNotFoundException
Jika Anda menerima pengecualian berikut saat menghapus AppClient, pastikan Anda telah memasukkan AppClient pengenal yang benar. Kesalahan ini menandakan bahwa yang ditentukan tidak AppClient ditemukan.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Kesalahan `UpdateAppClient`
### ResourceNotFoundException
Jika Anda menerima pengecualian berikut saat memperbarui AppClient, pastikan Anda telah memasukkan AppClient pengenal yang benar. Kesalahan ini menandakan bahwa yang ditentukan tidak AppClient ditemukan.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Kesalahan `Authorize`
### ValidationException
Anda mungkin menerima pengecualian berikut jika salah satu parameter API tidak memenuhi batasan yang ditentukan dalam spesifikasi API.
```
ValidationException
HTTP Status Code: 400
```
**Alasan 1: Ketika AppClient ID tidak ditentukan**
Yang `app_client_id` hilang dalam parameter permintaan. Buat AppClient jika belum dibuat atau gunakan yang sudah ada `app_client_id` dan coba lagi. Untuk menemukan AppClient ID, gunakan operasi [ListAppClient](manage-appclients.md#list_appclients)API.
**Alasan 2: Kapan AppFabric tidak memiliki akses ke kunci yang dikelola pelanggan**
```
Message: AppFabric couldn't access the customer managed key configured for AppClient.
```
AppFabric saat ini tidak dapat mengakses kunci yang dikelola pelanggan, kemungkinan karena perubahan terbaru dalam izinnya. Verifikasi kunci yang ditentukan ada dan pastikan AppFabric diberikan izin akses yang sesuai.
**Alasan 3: URL pengalihan yang ditentukan tidak valid**
```
Message: Redirect url invalid
```
Pastikan URL pengalihan dalam permintaan Anda sudah benar. Itu harus cocok dengan salah satu pengalihan URLs yang ditentukan saat Anda membuat atau memperbarui. AppClient Untuk melihat daftar pengalihan yang diizinkan URLs, gunakan operasi [GetAppClient](manage-appclients.md#get_appclient_details)API.
## Kesalahan `Token`
### TokenException
Anda mungkin menerima pengecualian berikut karena beberapa alasan.
```
TokenException
HTTP Status Code: 400
```
**Alasan 1: Ketika email yang tidak valid ditentukan**
```
Message: Invalid Email used
```
Pastikan alamat email yang Anda gunakan cocok dengan yang tercantum untuk `starterUserEmails` atribut saat Anda membuat AppClient. Jika email tidak cocok, ubah ke alamat email yang cocok dan coba lagi. Untuk melihat email yang digunakan, gunakan operasi [GetAppClient](manage-appclients.md#get_appclient_details)API.
**Alasan 2: Untuk grant\$1type sebagai refresh\$1token saat token tidak ditentukan.**
```
Message: refresh_token must be non-null for Refresh Token Grant-type
```
Token penyegaran yang ditentukan dalam permintaan adalah nol atau kosong. Tentukan aktif yang `refresh_token` diterima dalam respons panggilan [Token](getting-started-appdeveloper-productivity.md#authorize_data_access) API.
### ThrottlingException
Anda mungkin menerima pengecualian berikut jika API dipanggil pada tingkat yang lebih dari kuota yang diizinkan.
```
ThrottlingException
HTTP Status Code: 429
```
## `ListActionableInsights`,`ListMeetingInsights`, dan `PutFeedback` kesalahan
### ValidationException
Anda mungkin menerima pengecualian berikut jika salah satu parameter API tidak memenuhi batasan yang ditentukan pada spesifikasi API.
```
ValidationException
HTTP Status Code: 400
```
### ThrottlingException
Anda mungkin menerima pengecualian berikut jika API dipanggil pada tingkat yang lebih dari kuota yang diizinkan.
```
ThrottlingException
HTTP Status Code: 429
```
# Memulai AppFabric untuk produktivitas (pratinjau) untuk pengguna akhir
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas ada dalam pratinjau dan dapat berubah sewaktu-waktu. |
Bagian ini ditujukan untuk pengguna akhir aplikasi SaaS yang ingin mengaktifkan produktivitas (pratinjau) AWS AppFabric untuk meningkatkan manajemen tugas dan efisiensi alur kerja mereka. Ikuti langkah-langkah berikut untuk menghubungkan aplikasi Anda dan otorisasi AppFabric untuk memunculkan wawasan lintas aplikasi dan membantu Anda menyelesaikan tindakan (seperti mengirim email atau menjadwalkan rapat) dari aplikasi pilihan Anda. Anda dapat menghubungkan aplikasi sepertiAsana,,Atlassian Jira Suite,Google Workspace,Microsoft 365,Miro,Slack,Smartsheet, dan lainnya. Setelah Anda mengizinkan AppFabric untuk mengakses konten Anda, AppFabric bawalah wawasan dan tindakan lintas aplikasi secara langsung dalam aplikasi pilihan Anda — membantu Anda bekerja lebih efisien dan tetap berada dalam alur kerja Anda saat ini.
AppFabric untuk produktivitas menggunakan AI generatif yang didukung oleh Amazon Bedrock. AppFabric akan menghasilkan wawasan dan tindakan hanya setelah menerima izin eksplisit Anda. Anda mengizinkan setiap aplikasi individu untuk tetap memegang kendali penuh atas konten mana yang digunakan. AppFabric tidak akan menggunakan data Anda untuk melatih atau meningkatkan model bahasa besar yang mendasari yang digunakan untuk menghasilkan wawasan. Untuk informasi lebih lanjut, silakan lihat [Amazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/).
**Topics**
+ [Prasyarat](#getting-started-prerequisites)
+ [Langkah 1. Masuk ke AppFabric](#sign-in-appfabric)
+ [Langkah 2. Memberikan persetujuan bagi aplikasi untuk menampilkan wawasan](#provide-consent)
+ [Langkah 3. Connect aplikasi Anda untuk menghasilkan wawasan dan tindakan](#connect-apps)
+ [Langkah 4. Mulai melihat wawasan dan jalankan tindakan lintas aplikasi di aplikasi Anda](#insights_in_app)
+ [Mengelola akses ke AppFabric fitur produktivitas (pratinjau) untuk administrator TI dan keamanan](productivity-end-users-managing-access.md)
+ [Memecahkan masalah kesalahan pengguna akhir untuk produktivitas AppFabric](productivity-end-users-errors.md)
## Prasyarat
Sebelum memulai, pastikan Anda memiliki yang berikut:
+ Kredensi untuk masuk AppFabric: Untuk mulai menggunakan AppFabric produktivitas, Anda memerlukan kredenal masuk gabungan (nama pengguna dan kata sandi) untuk salah satu penyedia berikut:,,, atau. Asana Google Workspace Microsoft 365 Slack Masuk untuk AppFabric membantu kami mengidentifikasi Anda sebagai pengguna di setiap aplikasi yang Anda aktifkan AppFabric untuk produktivitas. Setelah masuk, Anda dapat menghubungkan aplikasi Anda untuk mulai menghasilkan wawasan.
+ Kredensi untuk menghubungkan aplikasi Anda: Wawasan dan tindakan lintas aplikasi hanya dibuat berdasarkan aplikasi yang Anda otorisasi. Anda akan memerlukan kredensi masuk (nama pengguna dan kata sandi) untuk setiap aplikasi yang ingin Anda otorisasi. Aplikasi yang didukung meliputi AsanaAtlassian Jira Suite,Google Workspace,,Microsoft 365,Miro,Slack, danSmartsheet.
## Langkah 1. Masuk ke AppFabric
Connect aplikasi AppFabric untuk membawa konten dan wawasan Anda langsung ke dalam aplikasi pilihan Anda.
1. Setiap aplikasi akan digunakan AppFabric untuk produktivitas dengan berbagai cara untuk memberi Anda pengalaman aplikasi yang lebih kaya. Karena itu, setiap aplikasi akan memiliki titik masuk yang berbeda untuk mencapai halaman AppFabric beranda produktivitas di bawah ini. Halaman beranda menetapkan konteks tentang proses untuk mengaktifkan AppFabric dan pertama-tama meminta Anda untuk masuk. Setiap aplikasi yang ingin Anda aktifkan AppFabric akan mencapai layar ini.
![\[Sign-in prompt for AWS AppFabric, highlighting AI-powered productivity features.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-01.png)
1. Masuk dengan kredensi Anda dari salah satu penyedia ini:Asana,, Google WorkspaceMicrosoft 365, atau. Slack Untuk pengalaman terbaik, kami sarankan masuk menggunakan penyedia yang sama untuk setiap aplikasi yang Anda aktifkan AppFabric . Misalnya, jika Anda memilih kredensi Google Workspace di App1, sebaiknya pilih Google Workspace di App2, serta setiap kali Anda perlu masuk kembali. Jika Anda masuk dengan penyedia lain, Anda harus memulai ulang proses menghubungkan aplikasi.
![\[AWS AppFabric sign-in page with options for Slack, Microsoft, Google, and Asana.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-02.png)
1. Jika diminta, masukkan kredenal masuk Anda dan terima masuk AppFabric dari penyedia ini.
![\[Slack sign-in page with options for Google, Apple, or email authentication.\]](http://docs.aws.amazon.com/id_id/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/id_id/appfabric/latest/adminguide/images/fabric-04.png)
## Langkah 2. Memberikan persetujuan bagi aplikasi untuk menampilkan wawasan
Setelah masuk, AppFabric akan menampilkan halaman persetujuan yang menanyakan apakah Anda mengizinkan AppFabric untuk menampilkan wawasan dan tindakan lintas aplikasi di dalam aplikasi yang Anda aktifkan AppFabric untuk produktivitas. Misalnya, apakah Anda mengizinkan AppFabric untuk mengambil Google Workspace email dan acara kalender Anda dan menampilkannyaAsana. Anda hanya perlu menyelesaikan langkah persetujuan ini satu kali per aplikasi yang Anda aktifkan AppFabric .
![\[Dialog box requesting permission to display insights and artifacts within an application.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-05.png)
## Langkah 3. Connect aplikasi Anda untuk menghasilkan wawasan dan tindakan
Setelah Anda menyelesaikan halaman persetujuan, Anda akan dibawa ke halaman **Connect Applications** di mana Anda dapat menghubungkan, memutuskan, atau menyambungkan kembali aplikasi individual yang pada akhirnya digunakan untuk menghasilkan wawasan dan tindakan lintas aplikasi Anda. Dalam kebanyakan kasus, setelah Anda masuk dan memberikan persetujuan, Anda akan terus menggunakan halaman ini untuk mengelola aplikasi yang terhubung.
Untuk menghubungkan aplikasi, pilih tombol **Connect** di sebelah aplikasi apa pun yang Anda gunakan.
![\[List of applications to connect, including Smartsheet, Slack, and Google Workspace, all showing as not connected.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-06.png)
Anda harus memberikan kredensi masuk untuk aplikasi, dan mengizinkan AppFabric izin untuk mengakses data Anda untuk menghasilkan wawasan dan tindakan lengkap.
![\[Dialog box requesting permission for AWS AppFabric to access Slack workspace data.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-07.png)
Setelah Anda berhasil menghubungkan aplikasi, Status untuk aplikasi itu akan berubah dari “Tidak Terhubung” menjadi “Terhubung”. Pengingat: Anda harus menyelesaikan langkah otorisasi ini untuk setiap aplikasi yang ingin Anda gunakan untuk menghasilkan wawasan dan tindakan.
Setelah Anda menghubungkan aplikasi, itu tidak terhubung selamanya. Anda harus menghubungkan kembali aplikasi secara berkala. Kami melakukan ini untuk memastikan kami masih memiliki izin Anda untuk menghasilkan wawasan.
Status aplikasi yang mungkin adalah:
+ Terhubung - AppFabric diotorisasi dan menghasilkan wawasan menggunakan data Anda dari aplikasi ini.
+ Tidak Terhubung - AppFabric tidak menghasilkan wawasan menggunakan data dari aplikasi ini. Anda dapat terhubung untuk mulai menghasilkan wawasan.
+ Otorisasi gagal. Silakan sambungkan kembali. - Mungkin ada kegagalan otorisasi dengan aplikasi tertentu. Jika Anda melihat kesalahan ini, coba sambungkan kembali aplikasi Anda menggunakan tombol **Connect**.
![\[Application connection status interface showing connected and unconnected apps.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-08.png)
Pengaturan selesai dan Anda dapat kembali ke aplikasi Anda. Diperlukan setidaknya beberapa jam untuk mulai melihat wawasan di dalam aplikasi Anda.
Jika diperlukan, Anda dapat menavigasi kembali ke halaman ini untuk mengelola aplikasi yang terhubung. Jika Anda memilih untuk **Memutuskan sambungan** aplikasi, AppFabric akan berhenti menggunakan data dari aplikasi tersebut atau mengumpulkan data baru untuk menghasilkan wawasan baru. Data dari aplikasi yang terputus akan secara otomatis dihapus dalam waktu 7 hari jika Anda memilih untuk tidak menghubungkan kembali aplikasi pada waktu itu.
## Langkah 4. Mulai melihat wawasan dan jalankan tindakan lintas aplikasi di aplikasi Anda
Setelah menghubungkan aplikasi AppFabric, Anda akan memiliki akses ke wawasan berharga dan kemampuan untuk melakukan tindakan lintas aplikasi langsung dari aplikasi pilihan Anda. Catatan: fungsionalitas ini tidak dijamin di setiap aplikasi dan sepenuhnya bergantung pada fitur produktivitas mana AppFabric yang telah dipilih pengembang aplikasi untuk diaktifkan.
**Wawasan lintas aplikasi**
AppFabric untuk produktivitas menawarkan dua jenis wawasan:
+ Wawasan yang dapat ditindaklanjuti: AppFabric menganalisis informasi dari email, acara kalender, tugas, dan pesan di seluruh aplikasi yang terhubung dan menghasilkan wawasan penting yang mungkin penting untuk Anda prioritaskan. Selain itu, AppFabric dapat menghasilkan tindakan yang disarankan (seperti mengirim email, menjadwalkan rapat, dan membuat tugas) yang dapat Anda edit dan jalankan saat tinggal di aplikasi pilihan Anda. Misalnya, Anda mungkin menerima wawasan yang mengatakan ada eskalasi pelanggan yang harus ditangani dan tindakan selanjutnya yang disarankan untuk menjadwalkan pertemuan dengan pelanggan Anda.
+ Wawasan persiapan rapat: Fitur ini membantu Anda mempersiapkan diri terbaik untuk pertemuan mendatang. AppFabric akan menganalisis pertemuan Anda yang akan datang dan menghasilkan ringkasan singkat tentang tujuan pertemuan. Selain itu, ini akan memunculkan artefak yang relevan (seperti email, pesan, dan tugas) dari aplikasi Anda yang terhubung yang akan berguna untuk membantu Anda mempersiapkan rapat secara efisien tanpa beralih antar aplikasi untuk menemukan konten.
**Tindakan lintas aplikasi**
Untuk wawasan tertentu, AppFabric mungkin juga menghasilkan tindakan yang disarankan seperti mengirim email, menjadwalkan rapat, atau membuat tugas. Saat membuat tindakan, AppFabric dapat mengisi terlebih dahulu bidang tertentu berdasarkan konten dan konteks aplikasi Anda yang terhubung. Misalnya, AppFabric dapat menghasilkan respons email yang disarankan atau nama tugas berdasarkan wawasan. Ketika Anda mengklik tindakan yang disarankan, Anda akan dibawa ke antarmuka pengguna yang AppFabric dimiliki tempat Anda dapat mengedit konten yang telah diisi sebelumnya sebelum menjalankan tindakan. AppFabric tidak akan menjalankan tindakan tanpa tinjauan dan input pengguna terlebih dahulu sebagai AI generatif dan model bahasa besar (LLM) yang mendasarinya dapat berhalusinasi dari waktu ke waktu.
**catatan**
Anda memiliki tanggung jawab untuk memvalidasi dan mengkonfirmasi output AppFabric LLM. AppFabric tidak menjamin keakuratan atau kualitas output LLM nya. Untuk informasi selengkapnya, lihat [Kebijakan AI yang Bertanggung AWS Jawab](https://aws.amazon.com/machine-learning/responsible-ai/policy/).
### Buat email (Google Workspace,Microsoft 365)
AppFabric memungkinkan Anda untuk mengedit dan mengirim email dari dalam aplikasi pilihan Anda. Kami mendukung bidang email dasar termasuk From, To, Cc/Bcc, Email Subject Line, dan Email Body Message. AppFabric dapat menghasilkan konten di bidang ini untuk membantu Anda mengurangi waktu untuk menyelesaikan tugas. Setelah selesai mengedit email, pilih **Kirim** untuk mengirim email.
Bidang berikut diperlukan untuk mengirim email:
+ Setidaknya satu email penerima (Kepada, CC, dan BCC) diperlukan, dan harus berupa alamat email yang valid.
+ Baris subjek dan bidang Pesan.
![\[Email form with From, To, CC, BCC, Subject line, and Message fields for sending.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-12.png)
Setelah email dikirim, Anda akan melihat konfirmasi bahwa email telah dikirim. Selain itu, Anda akan melihat tautan untuk melihat email di aplikasi yang ditunjuk. Anda dapat menggunakan tautan ini untuk menavigasi ke aplikasi dengan cepat dan memverifikasi email telah dikirim.
![\[Email sent confirmation with recipient details and message preview.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-13.png)
### Buat acara kalender (Google Workspace,Microsoft 365)
AppFabric memungkinkan Anda untuk mengedit dan membuat acara kalender dari dalam aplikasi pilihan Anda. Kami mendukung bidang acara kalender dasar termasuk Judul Acara, Lokasi, Start/End Waktu dan Tanggal, daftar Undangan, dan detail Acara. AppFabric dapat menghasilkan konten di bidang ini untuk membantu Anda mengurangi waktu untuk menyelesaikan tugas. Setelah selesai mengedit acara kalender, pilih **Buat** untuk membuat acara.
Bidang berikut diperlukan untuk membuat acara kalender:
+ Bidang Judul, Mulai, Berakhir, dan Deskripsi.
+ Waktu dan tanggal mulai tidak boleh lebih awal dari Waktu dan tanggal Berakhir.
+ Bidang undangan bersifat opsional, tetapi memerlukan alamat email yang valid jika disediakan.
![\[Calendar event creation form with title, time, location, invitees, and description fields.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-14.png)
Setelah acara kalender dikirim, Anda akan melihat konfirmasi bahwa acara telah dibuat. Selain itu, Anda akan melihat tautan untuk melihat acara di aplikasi yang ditunjuk. Anda dapat menggunakan tautan ini untuk menavigasi ke aplikasi dengan cepat dan memverifikasi acara telah dibuat.
![\[Calendar event creation confirmation with event details and option to view in Google Calendar.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-15.png)
### Buat tugas (Asana)
AppFabric memungkinkan Anda untuk mengedit dan membuat tugas Asana dari dalam aplikasi pilihan Anda. Kami mendukung bidang tugas dasar seperti Nama Tugas, Pemilik Tugas, Tanggal Jatuh Tempo, dan Deskripsi Tugas. AppFabric dapat menghasilkan konten di bidang ini untuk membantu Anda mengurangi waktu untuk membuat tugas. Setelah selesai mengedit tugas, pilih **Buat** untuk membuat tugas. Tugas dibuat di Asana ruang kerja atau proyek atau tugas yang berlaku, seperti yang disarankan oleh LLM.
Bidang berikut diperlukan untuk membuat Asana tugas:
+ Bidang Judul dan Deskripsi.
+ Penerima tugas harus alamat email yang valid jika diubah.
![\[Create Task form with fields for title, assignee, due date, and description for a finance meeting task.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-16.png)
Setelah tugas dibuat, Anda akan melihat konfirmasi bahwa tugas telah dibuatAsana. Selain itu, Anda akan melihat tautan untuk melihat tugas diAsana. Anda dapat menggunakan tautan ini untuk menavigasi ke aplikasi dengan cepat untuk memverifikasi tugas telah dibuat, atau memindahkannya ke Asana ruang kerja atau proyek atau tugas yang sesuai.
![\[Task creation confirmation with details and a link to view in Asana.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-17.png)
### Buat tugas (Smartsheet)
AppFabric memungkinkan Anda untuk mengedit dan membuat tugas Smartsheet dari dalam aplikasi pilihan Anda. Kami mendukung bidang tugas dasar seperti Nama Tugas, Pemilik Tugas, Tanggal Jatuh Tempo, dan Deskripsi Tugas. AppFabric dapat menghasilkan konten di bidang ini untuk membantu Anda mengurangi waktu untuk membuat tugas. Setelah selesai mengedit tugas, pilih **Buat** untuk membuat tugas. Untuk Smartsheet tugas, AppFabric akan membuat Smartsheet lembar pribadi baru dan mengisi tugas yang dibuat. Ini dilakukan untuk membantu memusatkan tindakan yang AppFabric dihasilkan di satu tempat secara terstruktur.
Bidang berikut diperlukan untuk membuat Smartsheet tugas:
+ Bidang Judul dan Deskripsi.
+ Penerima tugas harus alamat email yang valid jika disediakan.
![\[Create Task form with fields for title, assignees, due date, and description for an AWS AppFabric Action.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-18.png)
Setelah tugas dibuat, Anda akan melihat konfirmasi bahwa tugas telah dibuatSmartsheet. Selain itu, Anda akan melihat tautan untuk melihat tugas diSmartsheet. Anda dapat menggunakan tautan ini untuk menavigasi dengan cepat ke aplikasi untuk melihat tugas di Smartsheet lembar yang dibuat. Semua Smartsheet tugas future akan diisi di lembar ini. Jika lembar dihapus, AppFabric akan membuat yang baru.
![\[AWS AppFabric Action interface showing a successfully created task with details.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-19.png)
# Mengelola akses ke AppFabric fitur produktivitas (pratinjau) untuk administrator TI dan keamanan
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Portal pengguna AppFabric untuk produktivitas dapat diakses publik oleh semua pengguna aplikasi SaaS yang telah terintegrasi AppFabric dengan fitur produktivitas (pratinjau). Jika Anda seorang Administrator TI yang ingin mengelola akses ke fitur AI generatif ini dalam organisasi Anda, pertimbangkan opsi ini:
+ Batasi Login Penyedia Identitas (IDP): Anda dapat memblokir akses masuk melalui Penyedia Identitas Anda untuk mengontrol akses pengguna ke fitur AI generatif.
+ Nonaktifkan OAuth untuk Aplikasi Tertentu: Menerapkan pembatasan hilir dengan OAuth menonaktifkan. Tindakan ini mencegah pengguna menghubungkan aplikasi yang memerlukan OAuth otentikasi ke ruang kerja perusahaan.
# Memecahkan masalah kesalahan pengguna akhir untuk produktivitas AppFabric
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Bagian ini menjelaskan kesalahan umum dan pemecahan masalah AppFabric untuk produktivitas.
## Aplikasi yang belum diverifikasi
Aplikasi yang digunakan AppFabric untuk produktivitas untuk memperkaya pengalaman aplikasi mereka akan melalui proses verifikasi sebelum meluncurkan fitur mereka ke pengguna akhir. Jika Anda menemukan spanduk “tidak terverifikasi” saat mencoba masuk AppFabric, ini berarti aplikasi belum menjalani AppFabric proses verifikasi yang mengonfirmasi identitas pengembang aplikasi dan keakuratan informasi pendaftaran aplikasi. Semua aplikasi dimulai sebagai tidak diverifikasi dan berubah menjadi diverifikasi hanya ketika proses verifikasi selesai.
Berhati-hatilah saat menggunakan aplikasi yang belum diverifikasi. Jika Anda tidak yakin tentang pengembang aplikasi, Anda dapat menunggu hingga aplikasi mencapai status terverifikasi sebelum melanjutkan.
![\[Warning message for an unverified application in AWS AppFabric, advising caution before authorization.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-20.png)
## Ada yang tidak beres. Silakan coba lagi atau periksa dengan Admin Anda (`InternalServerException`)
Anda mungkin mendapatkan pesan ini ketika portal AppFabric pengguna gagal mencantumkan aplikasi atau memutuskan sambungan aplikasi karena kesalahan, pengecualian, atau kegagalan yang tidak diketahui. Coba lagi nanti.
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-23.png)
## Permintaan ditolak karena throttling permintaan. Silakan coba lagi dalam beberapa waktu (`ThrottlingException`)
Anda mungkin mendapatkan pesan ini ketika portal AppFabric pengguna gagal mencantumkan aplikasi atau memutuskan sambungan aplikasi karena masalah pelambatan. Coba lagi nanti.
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-22.png)
## Anda tidak berwenang untuk menggunakan AppFabric. Silakan masuk AppFabric lagi (`AccessDeniedException`)
Anda mungkin mendapatkan pesan ini ketika portal AppFabric pengguna gagal untuk daftar aplikasi atau memutuskan sambungan aplikasi karena akses ditolak pengecualian. Masuk AppFabric lagi.
![\[Connect applications interface showing connected and unconnected apps with action buttons.\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/images/fabric-21.png)
# AppFabric untuk produktivitas APIs (pratinjau)
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Bagian ini menyediakan operasi API, tipe data, dan kesalahan umum untuk fitur AWS AppFabric produktivitas.
**catatan**
Untuk yang lainnya AppFabric APIs, lihat [Referensi AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/).
**Topics**
+ [Tindakan API AppFabric untuk produktivitas (pratinjau)](productivity-actions.md)
+ [Jenis data API AppFabric untuk produktivitas (pratinjau)](productivity-data-types.md)
+ [Kesalahan API umum AppFabric untuk produktivitas (pratinjau)](productivity-common-errors.md)
# Tindakan API AppFabric untuk produktivitas (pratinjau)
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Tindakan berikut didukung untuk fitur AppFabric untuk produktivitas.
Untuk semua tindakan AppFabric API lainnya, lihat [Tindakan AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html).
**Topics**
+ [Otorisasi](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)
+ [Token](API_Token.md)
+ [UpdateAppClient](API_UpdateAppClient.md)
# Otorisasi
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Mengotorisasi sebuah. AppClient
**Topics**
+ [Isi permintaan](#API_Authorize_request)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **app\$1client\$1id** | ID AppClient untuk mengotorisasi. |
| **redirect\$1uri** | URI untuk mengarahkan pengguna akhir setelah otorisasi. |
| **negara** | Nilai unik untuk mempertahankan status antara permintaan dan callback. |
# CreateAppClient
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Menciptakan sebuah AppClient.
**Topics**
+ [Isi permintaan](#API_CreateAppClient_request)
+ [Elemen jawaban](#API_CreateAppClient_response)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **AppName** | Nama aplikasi. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum sebesar 255. Wajib: Ya |
| **ClientToken** | Menentukan pengidentifikasi unik dan peka huruf besar/kecil yang Anda berikan untuk memastikan idempotensi permintaan. Ini memungkinkan Anda mencoba kembali permintaan dengan aman tanpa sengaja melakukan operasi yang sama untuk kedua kalinya. Meneruskan nilai yang sama ke panggilan selanjutnya ke operasi mengharuskan Anda juga meneruskan nilai yang sama untuk semua parameter lainnya. Kami menyarankan Anda menggunakan [jenis nilai UUID.](https://wikipedia.org/wiki/Universally_unique_identifier) Jika Anda tidak memberikan nilai ini, maka AWS hasilkan nilai acak untuk Anda. Jika Anda mencoba lagi operasi dengan yang sama`ClientToken`, tetapi dengan parameter yang berbeda, percobaan ulang gagal dengan kesalahan`IdempotentParameterMismatch`. Tipe: String Pola: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Wajib: Tidak |
| **customerManagedKeyPengenal** | ARN yang kunci yang dikelola pelanggan dihasilkan oleh. AWS Key Management Service Kuncinya digunakan untuk mengenkripsi data. Jika tidak ada kunci yang ditentukan, maka an Kunci yang dikelola AWS digunakan. Peta pasangan kunci-nilai tag atau tag untuk ditetapkan ke sumber daya. Untuk informasi selengkapnya tentang Kunci milik AWS dan kunci yang dikelola [pelanggan, lihat Kunci dan AWS kunci](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) pelanggan di *Panduan AWS Key Management Service Pengembang*. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 1011. Pola: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Wajib: Tidak |
| **deskripsi** | Deskripsi untuk aplikasi. Tipe: String Diperlukan: Ya |
| **IconURL** | URL ke ikon atau logo untuk AppClient. Tipe: String Wajib: Tidak |
| **RedirecTurls** | URI untuk mengarahkan pengguna akhir setelah otorisasi. Anda dapat menambahkan hingga 5 RedirecTurls. Misalnya, `https://localhost:8080`. Tipe: Array string Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 item. Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048. Pola: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` Wajib: Ya |
| **starterUserEmails** | Alamat email pemula untuk pengguna yang diizinkan mengakses untuk menerima wawasan hingga AppClient diverifikasi. Tipe: Array string Anggota Array: Jumlah tetap 1 item. Batasan Panjang: Panjang minimum sebesar 0. Panjang maksimum 320. Pola: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` Diperlukan: Ya |
| **tag** | Peta pasangan kunci-nilai tag atau tag untuk ditetapkan ke sumber daya. Jenis: Array objek Tag Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item. Wajib: Tidak |
## Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.
Layanan mengembalikan data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **appClientSummary** | Berisi ringkasan dari AppClient. Tipe: Objek [AppClientSummary](API_AppClientSummary.md) |
# DeleteAppClient
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Menghapus klien aplikasi.
**Topics**
+ [Isi permintaan](#API_DeleteAppClient_request)
+ [Elemen jawaban](#API_DeleteAppClient_response)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **appClientIdentifier** | Nama Sumber Daya Amazon (ARN) atau Universal Unique Identifier (UUID) yang akan digunakan AppClient untuk permintaan tersebut. Batasan Panjang: Panjang minimum 1. Panjang maksimum 1011. Pola: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Diperlukan: Ya |
## Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 dengan isi HTTP kosong.
# GetAppClient
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Mengembalikan informasi tentang sebuah AppClient.
**Topics**
+ [Isi permintaan](#API_GetAppClient_request)
+ [Elemen jawaban](#API_GetAppClient_response)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **appClientIdentifier** | Nama Sumber Daya Amazon (ARN) atau Universal Unique Identifier (UUID) yang akan digunakan AppClient untuk permintaan tersebut. Batasan Panjang: Panjang minimum 1. Panjang maksimum 1011. Pola: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Diperlukan: Ya |
## Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **AppClient** | Berisi informasi tentang sebuah AppClient. Tipe: Objek [AppClient](API_AppClient.md) |
# ListActionableInsights
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Daftar pesan email yang paling penting yang dapat ditindaklanjuti, tugas, dan pembaruan lainnya.
**Topics**
+ [Isi permintaan](#API_ListActionableInsights_request)
+ [Elemen jawaban](#API_ListActionableInsights_response)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **NextToken** | Jika `nextToken` dikembalikan, ada lebih banyak hasil yang tersedia. Nilai `nextToken` adalah token pagination unik untuk setiap halaman. Lakukan panggilan lagi menggunakan token yang dikembalikan untuk mengambil halaman berikutnya. Jaga agar semua argumen lainnya tidak berubah. Setiap token pagination berakhir setelah 24 jam. Menggunakan token pagination yang kedaluwarsa akan mengembalikan kesalahan *HTTP 400 InvalidToken *. |
## Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.
Layanan mengembalikan data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **ActionableInsightsList** | Daftar wawasan yang dapat ditindaklanjuti, termasuk judul, deskripsi, tindakan, dan stempel waktu yang dibuat. Untuk informasi selengkapnya, lihat [ActionableInsights](API_ActionableInsights.md). |
| **NextToken** | Jika `nextToken` dikembalikan, ada lebih banyak hasil yang tersedia. Nilai `nextToken` adalah token pagination unik untuk setiap halaman. Lakukan panggilan lagi menggunakan token yang dikembalikan untuk mengambil halaman berikutnya. Jaga agar semua argumen lainnya tidak berubah. Setiap token pagination berakhir setelah 24 jam. Menggunakan token pagination yang kedaluwarsa akan mengembalikan kesalahan *HTTP 400 InvalidToken *. Tipe: String |
# ListAppClients
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Mengembalikan daftar semua AppClients.
**Topics**
+ [Isi permintaan](#API_ListAppClients_request)
+ [Elemen jawaban](#API_ListAppClients_response)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **maxResults** | Jumlah maksimum hasil yang dikembalikan per panggilan. Anda dapat menggunakan `nextToken` untuk mendapatkan halaman hasil lebih lanjut. Ini hanya batas atas. Jumlah aktual hasil yang dikembalikan per panggilan mungkin kurang dari maksimum yang ditentukan. Rentang yang Valid: Nilai minimum 1. Nilai maksimum 100. |
| **NextToken** | Jika `nextToken` dikembalikan, ada lebih banyak hasil yang tersedia. Nilai `nextToken` adalah token pagination unik untuk setiap halaman. Lakukan panggilan lagi menggunakan token yang dikembalikan untuk mengambil halaman berikutnya. Jaga agar semua argumen lainnya tidak berubah. Setiap token pagination berakhir setelah 24 jam. Menggunakan token pagination yang kedaluwarsa akan mengembalikan kesalahan *HTTP 400 InvalidToken *. |
## Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **appClientList** | Berisi daftar AppClient hasil. Tipe: Array objek [AppClientSummary](API_AppClientSummary.md) |
| **NextToken** | Jika `nextToken` dikembalikan, ada lebih banyak hasil yang tersedia. Nilai `nextToken` adalah token pagination unik untuk setiap halaman. Lakukan panggilan lagi menggunakan token yang dikembalikan untuk mengambil halaman berikutnya. Jaga agar semua argumen lainnya tidak berubah. Setiap token pagination berakhir setelah 24 jam. Menggunakan token pagination yang kedaluwarsa akan mengembalikan kesalahan *HTTP 400 InvalidToken *. Tipe: String |
# ListMeetingInsights
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Daftar acara kalender yang paling penting yang dapat ditindaklanjuti.
**Topics**
+ [Isi permintaan](#API_ListMeetingInsights_request)
+ [Elemen jawaban](#API_ListMeetingInsights_response)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **NextToken** | Jika `nextToken` dikembalikan, ada lebih banyak hasil yang tersedia. Nilai `nextToken` adalah token pagination unik untuk setiap halaman. Lakukan panggilan lagi menggunakan token yang dikembalikan untuk mengambil halaman berikutnya. Jaga agar semua argumen lainnya tidak berubah. Setiap token pagination berakhir setelah 24 jam. Menggunakan token pagination yang kedaluwarsa akan mengembalikan kesalahan *HTTP 400 InvalidToken *. |
## Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.
Layanan mengembalikan data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **MeetingInsightList** | Daftar wawasan pertemuan yang dapat ditindaklanjuti. Untuk informasi selengkapnya, lihat [MeetingInsights](API_MeetingInsights.md). |
| **NextToken** | Jika `nextToken` dikembalikan, ada lebih banyak hasil yang tersedia. Nilai `nextToken` adalah token pagination unik untuk setiap halaman. Lakukan panggilan lagi menggunakan token yang dikembalikan untuk mengambil halaman berikutnya. Jaga agar semua argumen lainnya tidak berubah. Setiap token pagination berakhir setelah 24 jam. Menggunakan token pagination yang kedaluwarsa akan mengembalikan kesalahan *HTTP 400 InvalidToken *. Tipe: String |
# PutFeedback
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Memungkinkan pengguna mengirimkan umpan balik untuk wawasan atau tindakan tertentu.
**Topics**
+ [Isi permintaan](#API_PutFeedback_request)
+ [Elemen jawaban](#API_PutFeedback_response)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **id** | ID objek yang umpan baliknya dikirimkan. Ini bisa berupa InsightId atau ActionId. |
| **Umpan Balik** | Jenis wawasan yang umpan baliknya dikirimkan. Nilai yang mungkin: `ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION` |
| **Umpan Balik Penilaian** | Peringkat Umpan Balik dari `1` ke`5`. Rating yang lebih tinggi semakin baik. |
## Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 201 dengan badan HTTP kosong.
# Token
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Berisi informasi yang memungkinkan AppClients untuk bertukar kode otorisasi untuk token akses.
**Topics**
+ [Isi permintaan](#API_Token_request)
+ [Elemen jawaban](#API_Token_response)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **kode** | Kode otorisasi yang diterima dari titik akhir otorisasi. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048. Wajib: Tidak |
| **grant\$1type** | Jenis hibah untuk token. Harus `authorization_code` atau `refresh_token`. Tipe: String Diperlukan: Ya |
| **app\$1client\$1id** | ID dari AppClient. Tipe: String Pola: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Wajib: Ya |
| **redirect\$1uri** | URI pengalihan diteruskan ke titik akhir otorisasi. Tipe: String Wajib: Tidak |
| **refresh\$1token** | Token penyegaran diterima dari permintaan token awal. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 4096. Wajib: Tidak |
## Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **appfabric\$1user\$1id** | ID pengguna untuk token. Ini dikembalikan hanya untuk permintaan yang menggunakan jenis `authorization_code` hibah. Tipe: String |
| **kedaluwarsa\$1in** | Jumlah detik hingga token kedaluwarsa. Tipe: Long |
| **refresh\$1token** | Token penyegaran yang akan digunakan untuk permintaan berikutnya. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048. |
| **t**oken | Token akses. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048. |
| **token\$1type** | Jenis token. Tipe: String |
# UpdateAppClient
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Pembaruan an AppClient.
**Topics**
+ [Isi permintaan](#API_UpdateAppClient_request)
+ [Elemen jawaban](#API_UpdateAppClient_response)
## Isi permintaan
Permintaan menerima data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **appClientIdentifier** | Nama Sumber Daya Amazon (ARN) atau Universal Unique Identifier (UUID) yang akan digunakan AppClient untuk permintaan tersebut. Batasan Panjang: Panjang minimum 1. Panjang maksimum 1011. Pola: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Wajib: Ya |
| **RedirecTurls** | URI untuk mengarahkan pengguna akhir setelah otorisasi. Anda dapat menambahkan hingga 5 RedirecTurls. Misalnya, `https://localhost:8080`. Tipe: Array string Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 item. Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048. Pola: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` |
## Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
| Parameter | Deskripsi |
| --- | --- |
| **AppClient** | Berisi informasi tentang sebuah AppClient. Tipe: Objek [AppClient](API_AppClient.md) |
# Jenis data API AppFabric untuk produktivitas (pratinjau)
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
AppFabric API berisi beberapa tipe data yang digunakan berbagai tindakan. Bagian ini menjelaskan tipe data untuk fitur produktivitas secara rinci. AppFabric
Untuk semua tipe data AppFabric API lainnya, lihat [Jenis Data AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/API_Types.html).
**penting**
Urutan setiap elemen dalam struktur tipe data tidak dijamin. Aplikasi tidak harus mengambil urutan tertentu.
**Topics**
+ [ActionableInsights](API_ActionableInsights.md)
+ [AppClient](API_AppClient.md)
+ [AppClientSummary](API_AppClientSummary.md)
+ [MeetingInsights](API_MeetingInsights.md)
+ [VerificationDetails](API_VerificationDetails.md)
# ActionableInsights
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Berisi ringkasan tindakan penting dan sesuai untuk pengguna berdasarkan email, undangan kalender, pesan, dan tugas dari portofolio aplikasi mereka. Pengguna dapat melihat wawasan proaktif dari seluruh aplikasi mereka untuk membantu mereka mengarahkan hari mereka dengan sebaik-baiknya. Wawasan ini memberikan pembenaran tentang mengapa pengguna harus peduli dengan ringkasan wawasan bersama dengan referensi, seperti tautan yang disematkan, ke aplikasi individual dan artefak yang menghasilkan wawasan.
| Parameter | Deskripsi |
| --- | --- |
| **InsightID** | Id unik untuk wawasan yang dihasilkan. |
| **InsightContent** | Ini mengembalikan ringkasan wawasan dan tautan tertanam ke artefak yang digunakan untuk menghasilkan wawasan. Ini akan menjadi konten HTML yang berisi tautan tertanam (``tag). |
| **InsightTitle** | Judul wawasan yang dihasilkan. |
| **createDat** | Ketika wawasan dihasilkan. |
| **tindakan** | Daftar tindakan yang direkomendasikan untuk wawasan yang dihasilkan. Objek tindakan berisi parameter berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/API_ActionableInsights.html) |
# AppClient
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Berisi informasi tentang sebuah AppClient.
**Topics**
| Parameter | Deskripsi |
| --- | --- |
| **AppName** | Nama aplikasi. Tipe: String Diperlukan: Ya |
| **arn** | Amazon Resource Name (ARN) dari AppClient. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 1011. Pola: `arn:.+` Wajib: Ya |
| **deskripsi** | Deskripsi untuk aplikasi. Tipe: String Diperlukan: Ya |
| **IconURL** | URL ke ikon atau logo untuk AppClient. Tipe: String Wajib: Tidak |
| **RedirecTurls** | Pengalihan yang diizinkan URLs untuk. AppClient Tipe: Array string Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 item. Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048. Pola: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` Wajib: Ya |
| **starterUserEmails** | Alamat email pemula untuk pengguna yang diizinkan mengakses untuk menerima wawasan hingga AppClient diverifikasi. Tipe: Array string Anggota Array: Jumlah tetap 1 item. Batasan Panjang: Panjang minimum sebesar 0. Panjang maksimum 320. Pola: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` Wajib: Ya |
| **VerifikasiDetail** | Berisi status dan alasan AppClient verifikasi. Tipe: Objek [VerificationDetails](API_VerificationDetails.md) Wajib: Ya |
| **customerManagedKeyArn** | Nama Sumber Daya Amazon (ARN) dari yang kunci yang dikelola pelanggan dihasilkan oleh AWS Key Management Service for the. AppClient Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 1011. Pola: `arn:.+` Wajib: Tidak |
| **appClientId** | ID dari AppClient. Dimaksudkan untuk digunakan dalam aliran o-auth untuk klien aplikasi. Tipe: String Pola: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Wajib: Tidak |
# AppClientSummary
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Berisi informasi tentang sebuah AppClient.
**Topics**
| Parameter | Deskripsi |
| --- | --- |
| **arn** | Amazon Resource Name (ARN) dari AppClient. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 1011. Pola: `arn:.+` Wajib: Ya |
| **VerifikasiStatus** | Status AppClient verifikasi. Tipe: String Nilai yang Valid: `pending_verification \| verified \| rejected` Wajib: Ya |
| **appClientId** | ID dari AppClient. Dimaksudkan untuk digunakan dalam aliran o-auth untuk klien aplikasi. Tipe: String Pola: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Wajib: Tidak |
# MeetingInsights
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Berisi ringkasan dari 3 pertemuan teratas bersama dengan tujuan pertemuan, artefak lintas aplikasi terkait, dan aktivitas dari tugas, email, pesan, dan acara kalender.
| Parameter | Deskripsi |
| --- | --- |
| **InsightID** | Id unik untuk wawasan yang dihasilkan. |
| **InsightContent** | Deskripsi wawasan yang menyoroti detail dalam format string. Seperti, mengapa wawasan ini penting. |
| **InsightTitle** | Judul wawasan yang dihasilkan. |
| **createDat** | Ketika wawasan dihasilkan. |
| **KalenderEvent** | Acara atau rapat kalender penting yang harus difokuskan pengguna. Kalender objek Acara: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **sumber daya** | Daftar yang berisi sumber daya lain yang terkait dengan menghasilkan wawasan. Objek sumber daya: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **NextToken** | Token pagination untuk mengambil kumpulan wawasan berikutnya. Ini adalah bidang opsional yang jika dikembalikan null berarti tidak ada lagi wawasan untuk dimuat. |
# VerificationDetails
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Berisi status dan alasan AppClient verifikasi.
**Topics**
| Parameter | Deskripsi |
| --- | --- |
| **VerifikasiStatus** | Status AppClient verifikasi. Tipe: String Nilai yang Valid: `pending_verification \| verified \| rejected` Wajib: Ya |
| **StatusReason** | Alasan status AppClient verifikasi. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024. Wajib: Tidak |
# Kesalahan API umum AppFabric untuk produktivitas (pratinjau)
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas dalam pratinjau dan dapat berubah sewaktu-waktu. |
Bagian ini mencantumkan kesalahan yang umum terjadi pada tindakan API untuk fitur AWS AppFabric produktivitas.
Untuk semua kesalahan API AppFabric umum lainnya, lihat [Memecahkan masalah untuk AppClients produktivitas AppFabric](ahead-app-dev-errors.md) dan [kesalahan umum AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html) di *Referensi AWS AppFabric API*.
| Nama pengecualian | Deskripsi |
| --- | --- |
| **TokenException** | Permintaan token tidak valid. Kode Status HTTP: 400 |
# Pemrosesan data di AppFabric
| |
| --- |
| Fitur AWS AppFabric untuk produktivitas ada dalam pratinjau dan dapat berubah sewaktu-waktu. |
AppFabric mengambil langkah-langkah untuk menyimpan konten pengguna satu per satu, dalam bucket Amazon S3 yang dikelola oleh AppFabric, dan secara terpisah; yang membantu memastikan bahwa kami menghasilkan wawasan khusus pengguna. Kami menggunakan perlindungan yang wajar untuk melindungi konten Anda, yang dapat mencakup enkripsi saat istirahat dan dalam perjalanan. Kami telah mengonfigurasi sistem kami untuk menghapus konten pelanggan secara otomatis dalam waktu 30 hari sejak konsumsi. AppFabric tidak menghasilkan wawasan menggunakan artefak data yang tidak lagi dapat diakses oleh pengguna. Misalnya, ketika pengguna memutuskan sumber data (aplikasi), AppFabric berhenti mengumpulkan data dari aplikasi tersebut dan tidak menggunakan artefak yang tersisa dari aplikasi yang terputus untuk menghasilkan wawasan. AppFabricSistem dikonfigurasi untuk menghapus data tersebut dalam waktu 30 hari.
AppFabric tidak menggunakan konten pengguna untuk melatih atau meningkatkan model bahasa besar yang mendasari yang digunakan untuk menghasilkan wawasan. Untuk informasi selengkapnya AppFabric tentang fitur AI generatif, lihat [Amazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/).
## Enkripsi saat diam
AWS AppFabric mendukung enkripsi saat istirahat, fitur enkripsi sisi server di mana AppFabric secara transparan mengenkripsi semua data yang terkait dengan pengguna saat disimpan ke disk, dan mendekripsi mereka saat Anda mengakses data.
## Enkripsi saat bergerak
AppFabric mengamankan semua konten dalam perjalanan menggunakan TLS 1.2 dan menandatangani permintaan API untuk AWS layanan dengan AWS Signature Version 4.