Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai AppFabric untuk produktivitas (pratinjau) untuk pengembang aplikasi

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.

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 (lihatLangkah 5. Permintaan AppFabric untuk memverifikasi aplikasi Anda). 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.

Prasyarat

Sebelum Anda memulai, Anda perlu membuat file Akun AWS. Untuk informasi selengkapnya, lihat Mendaftar untuk Akun 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 Meskipun memiliki pengguna administratif bermanfaat, itu tidak wajib untuk pengaturan awal. Untuk informasi selengkapnya, lihat Buat pengguna dengan akses administratif.

AppFabric untuk produktivitas hanya di AS Timur (Virginia N.) selama pratinjau. Pastikan Anda berada di wilayah ini sebelum memulai langkah-langkah di bawah ini.

{
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "appfabric:CreateAppClient"
            ],
            "Resource": ["arn:aws:appfabric:*:*:appclient/*"]
        }
    ],
    "Version": "2012-10-17"
}

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 (lihatLangkah 5. Permintaan AppFabric untuk memverifikasi aplikasi Anda). 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.

Anda dapat mendaftarkan aplikasi Anda dengan AWS layanan menggunakan CreateAppClient API menggunakan beberapa bahasa pemrograman, termasuk Python, Node.js, Java, C #, Go dan Rust. Untuk informasi selengkapnya, lihat Meminta contoh tanda tangan 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 di Panduan Pengguna IAM.

Bidang Permintaan

Bidang Respons

curl --request POST \
  --header "Content-Type: application/json" \
  --header "X-Amz-Content-Sha256: <sha256_payload>" \
  --header "X-Amz-Security-Token: <security_token>" \
  --header "X-Amz-Date: 20230922T172215Z" \
  --header "Authorization: AWS4-HMAC-SHA256 ..." \
  --url https://appfabric.<region>.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:<region>:<account>:key/<key>"
}'

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

{
    "appClientConfigSummary": {
        "appClientArn": "arn:aws:appfabric:<region>:<account>: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. 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.

Untuk informasi selengkapnya tentang pemberian izin untuk mengotorisasi aplikasi, lihat. Izinkan akses untuk mengotorisasi aplikasi

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.

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, lihatPemrosesan data di AppFabric.

Anda dapat menggunakan AI berikut ini APIs untuk menghasilkan dan memunculkan wawasan dan tindakan tingkat pengguna dalam aplikasi Anda:

Wawasan yang dapat ditindaklanjuti () ListActionableInsights

ListActionableInsightsAPI 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 seperti Asana, Google Workspace, Microsoft 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:

Bidang Permintaan

Permintaan Header

Bidang Respons

Untuk informasi selengkapnya, lihat ActionableInsights.

curl -v --location \
  "https://productivity.appfabric.<region>.amazonaws.com"\
"/actionableInsights" \
  --header "Authorization: Bearer <token>"

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)

ListMeetingInsightsAPI 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

Bidang Respons

Untuk informasi selengkapnya, lihat MeetingInsights.

curl --location \
  "https://productivity.appfabric.<region>.amazonaws.com"\
"/meetingContexts" \
  --header "Authorization: Bearer <token>"

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

Bidang respons

Untuk informasi selengkapnya, lihat PutFeedback.

curl --request POST \
  --url "https://productivity.appfabric.<region>.amazonaws.com"\
"/feedback" \
  --header "Authorization: Bearer <token>" \
  --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 dan meminta agar aplikasi Anda diverifikasi.

Sertakan detail berikut di email Anda:

Selain itu, berikan informasi berikut, jika tersedia, untuk membantu kami menilai prioritas dan dampak:

Kriteria verifikasi

Sebelum memulai proses verifikasi, Anda harus memenuhi kriteria berikut:

Selain itu, Anda memenuhi setidaknya satu dari kriteria ini:

Tunggu pembaruan status verifikasi

Setelah aplikasi Anda ditinjau, kami akan merespons melalui email dan status Anda AppClient akan berubah dari pending_verification menjadiverified. Jika aplikasi Anda ditolak, Anda harus memulai kembali proses verifikasi.