Mise en route AppFabric pour la productivité (version préliminaire) pour les développeurs d'applications - AWS AppFabric
PrérequisÉtape 1. Créez et AppFabric améliorez la productivité AppClientÉtape 2. Authentifiez et autorisez votre applicationÉtape 3. Ajoutez l'URL du portail AppFabric utilisateur à votre applicationÉtape 4 : AppFabric À utiliser pour mettre en évidence des informations et des actions provenant de différentes applicationsÉtape 5. Demande AppFabric de vérification de votre candidature

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mise en route AppFabric pour la productivité (version préliminaire) pour les développeurs d'applications

La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification.

Cette section aide les développeurs d'applications à intégrer AWS AppFabric des applications à des fins de productivité (version préliminaire). AWS AppFabric for productivity permet aux développeurs de créer des expériences applicatives plus riches pour leurs utilisateurs en générant des informations et des actions basées sur l'IA à partir d'e-mails, d'événements de calendrier, de tâches, de messages, etc. dans de multiples applications. Pour obtenir la liste des applications prises en charge, consultez la section Applications AWS AppFabric prises en charge.

AppFabric for productivity permet aux développeurs d'applications de créer et d'expérimenter dans un environnement sécurisé et contrôlé. Lorsque vous commencez à utiliser AppFabric pour la productivité, vous créez AppClient et enregistrez un seul utilisateur de test. Cette approche est conçue pour vous aider à comprendre et à tester le flux d'authentification et de communication entre votre application et AppFabric. Après avoir effectué le test avec un seul utilisateur, vous pouvez soumettre votre demande à des AppFabric fins de vérification avant d'étendre l'accès à d'autres utilisateurs (voirÉtape 5. Demande AppFabric de vérification de votre candidature). AppFabric vérifiera les informations des applications avant de permettre une adoption généralisée afin de protéger les développeurs d'applications, les utilisateurs finaux et leurs données, ouvrant ainsi la voie à une adoption plus large par les utilisateurs de manière responsable.

Rubriques

Prérequis

Avant de commencer, vous devez créer un Compte AWS. Pour plus d’informations, consultez Inscrivez-vous pour un Compte AWS. Vous devez également créer au moins un utilisateur ayant accès à la politique "appfabric:CreateAppClient" IAM répertoriée ci-dessous, qui permet à l'utilisateur d'enregistrer votre application. AppFabric Pour plus d'informations sur l'octroi d'autorisations AppFabric pour les fonctionnalités de productivité, consultezAppFabric pour des exemples de politiques IAM de productivité. Bien qu'il soit avantageux d'avoir un utilisateur administratif, il n'est pas obligatoire pour la configuration initiale. Pour plus d’informations, consultez Création d'un utilisateur doté d'un accès administratif.

AppFabric pour la productivité, uniquement dans l'est des États-Unis (Virginie du Nord) lors de la prévisualisation. Assurez-vous que vous vous trouvez dans cette région avant de commencer les étapes ci-dessous.

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

Étape 1. Créez et AppFabric améliorez la productivité AppClient

Avant de pouvoir commencer à faire surface AppFabric pour obtenir des informations sur la productivité au sein de votre application, vous devez créer un AppFabric AppClient. An AppClient est essentiellement votre passerelle vers AppFabric la productivité, fonctionnant comme un client d'application OAuth sécurisé permettant une communication sécurisée entre votre application et. AppFabric Lorsque vous créez un AppClient, vous recevrez un AppClient identifiant, un identifiant unique essentiel pour garantir AppFabric qu'il fonctionne avec votre application et votre Compte AWS.

AppFabric for productivity permet aux développeurs d'applications de créer et d'expérimenter dans un environnement sécurisé et contrôlé. Lorsque vous commencez à utiliser AppFabric pour la productivité, vous créez AppClient et enregistrez un seul utilisateur de test. Cette approche est conçue pour vous aider à comprendre et à tester le flux d'authentification et de communication entre votre application et AppFabric. Après avoir effectué le test avec un seul utilisateur, vous pouvez soumettre votre demande à des AppFabric fins de vérification avant d'étendre l'accès à d'autres utilisateurs (voirÉtape 5. Demande AppFabric de vérification de votre candidature). AppFabric vérifiera les informations des applications avant de permettre une adoption généralisée afin de protéger les développeurs d'applications, les utilisateurs finaux et leurs données, ouvrant ainsi la voie à une adoption plus large par les utilisateurs de manière responsable.

Pour créer un AppClient, utilisez l'opération AWS AppFabric CreateAppClient API. Si vous devez mettre à jour AppClient after, vous pouvez utiliser l'opération UpdateAppClient API pour modifier uniquement les URL de redirection. Si vous devez modifier l'un des autres paramètres qui vous sont associés, AppClient tels que AppName ou description, vous devez le supprimer AppClient et en créer un nouveau. Pour plus d’informations, consultez CreateAppClient.

Vous pouvez enregistrer votre application auprès de AWS services à l'aide de l'CreateAppClientAPI en utilisant plusieurs langages de programmation, notamment Python, Node.js, Java, C#, Go et Rust. Pour plus d'informations, consultez la section Demander des exemples de signature dans le guide de l'utilisateur IAM. Vous devez utiliser les informations d'identification de la version 4 de la signature de votre compte pour effectuer cette opération d'API. Pour plus d'informations sur la version 4 de signature, voir Signing AWS API requests dans le guide de l'utilisateur IAM.

Champs de demande

  • appName- Le nom de l'application qui sera affiché aux utilisateurs sur la page de consentement du portail AppFabric utilisateur. La page de consentement demande aux utilisateurs finaux l'autorisation d'afficher AppFabric des informations dans votre application. Pour plus de détails sur la page de consentement, voirÉtape 2. Donnez votre accord pour que l'application affiche des informations.

  • description- Une description de l'application.

  • redirectUrls- L'URI vers lequel rediriger les utilisateurs finaux après autorisation. Vous pouvez ajouter jusqu'à 5 URL de redirection. Par exemple, https://localhost:8080.

  • starterUserEmails- Une adresse e-mail d'utilisateur qui sera autorisée à accéder pour recevoir les informations jusqu'à ce que l'application soit vérifiée. Une seule adresse e-mail est autorisée. Par exemple, anyuser@example.com

  • customerManagedKeyIdentifier(facultatif) - L'ARN de la clé gérée par le client (générée par KMS) à utiliser pour chiffrer les données. Si elle n'est pas spécifiée, la clé AWS AppFabric gérée sera utilisée. Pour plus d'informations sur Clés détenues par AWS les clés gérées par le client, consultez la section Clés et AWS clés client dans le guide du AWS Key Management Service développeur.

Champs de réponse

  • appClientArn- Le nom de ressource Amazon (ARN) qui inclut l' AppClient ID. Par exemple, l' AppClient identifiant esta1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

  • verificationStatus- L'état AppClient de la vérification.

    • pending_verification- La vérification du AppClient est toujours en cours avec AppFabric. Jusqu'à ce que le AppClient soit vérifié, un seul utilisateur (spécifié dansstarterUserEmails) peut utiliser le AppClient. L'utilisateur verra une notification dans le portail AppFabric utilisateur, introduit dansÉtape 3. Ajoutez l'URL du portail AppFabric utilisateur à votre application, indiquant que l'application n'est pas vérifiée.

    • verified- Le processus de vérification a été effectué avec succès AppFabric et AppClient est désormais entièrement vérifié.

    • rejected- Le processus de vérification du AppClient a été rejeté par AppFabric. Il AppClient ne peut pas être utilisé par d'autres utilisateurs tant que le processus de vérification n'est pas relancé et terminé avec succès.

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>"
}'

Si l’action aboutit, le service renvoie une réponse HTTP 200.

{
    "appClientConfigSummary": {
        "appClientArn": "arn:aws:appfabric:<region>:<account>:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "verificationStatus": "pending_verification"
    }
}

Étape 2. Authentifiez et autorisez votre application

Permettez à votre application d'intégrer les AppFabric informations en toute sécurité en établissant un flux d'autorisation OAuth 2.0. Tout d'abord, vous devez créer un code d'autorisation qui vérifie l'identité de votre application. Pour plus d’informations, consultez Autoriser. Vous échangerez ensuite ce code d'autorisation contre un jeton d'accès, qui accorde à votre application les autorisations nécessaires pour récupérer et afficher AppFabric des informations au sein de votre application. Pour plus d’informations, consultez Jeton.

Pour plus d'informations sur l'octroi de l'autorisation d'autoriser une application, consultezAutoriser l'accès pour autoriser les applications.

  1. Pour créer un code d'autorisation, utilisez l'opération AWS AppFabric oauth2/authorize API.

    Champs de demande

    • app_client_id(obligatoire) - L' AppClient ID du fichier Compte AWS créé à l'étape 1. Créez un AppClient. Par exemple, a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

    • redirect_uri(obligatoire) - L'URI vers lequel rediriger les utilisateurs finaux après l'autorisation que vous avez utilisée à l'étape 1. Créez un AppClient. Par exemple, https://localhost:8080.

    • state(obligatoire) - Une valeur unique pour maintenir l'état entre la demande et le rappel. Par exemple, a8904edc-890c-1005-1996-29a757272a44.

    GET https://productivity.appfabric.<region>.amazonaws.com/oauth2/authorize?app_client_id=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\
redirect_uri=https://localhost:8080&state=a8904edc-890c-1005-1996-29a757272a44

  2. Après l'authentification, vous serez redirigé vers l'URI spécifié avec un code d'autorisation renvoyé en tant que paramètre de requête. Par exemple, oùcode=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc.

    https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44

  3. Échangez ce code d'autorisation contre un jeton d'accès à l'aide de l'opération AppFabric oauth2/token API.

    Ce jeton est utilisé pour les demandes d'API et est initialement valide starterUserEmails jusqu'à ce qu' AppClient il soit vérifié. Une fois AppClient le vérifié, ce jeton peut être utilisé pour n'importe quel utilisateur. Vous devez utiliser les informations d'identification de la version 4 de la signature de votre compte pour effectuer cette opération d'API. Pour plus d'informations sur la version 4 de signature, voir Signing AWS API requests dans le guide de l'utilisateur IAM.

    Champs de demande

    • code(obligatoire) - Le code d'autorisation que vous avez reçu après vous être authentifié à la dernière étape. Par exemple, mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc.

    • app_client_id(obligatoire) - L' AppClient ID du fichier Compte AWS créé à l'étape 1. Créez un AppClient. Par exemple, a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

    • grant_type(obligatoire) - La valeur doit êtreauthorization_code.

    • redirect_uri(obligatoire) - L'URI vers lequel rediriger les utilisateurs après l'autorisation que vous avez utilisée à l'étape 1. Créez un AppClient. Il doit s'agir du même URI de redirection que celui utilisé pour créer un code d'autorisation. Par exemple, https://localhost:8080.

    Champs de réponse

    • expires_in- Combien de temps avant l'expiration du jeton. Le délai d'expiration par défaut est de 12 heures.

    • refresh_token- Le jeton d'actualisation reçu lors de la demande initiale /token.

    • token- Le jeton reçu lors de la demande initiale /token.

    • token_type- La valeur sera deBearer.

    • appfabric_user_id- Le nom AppFabric d'utilisateur. Ceci n'est renvoyé que pour les demandes utilisant le type de authorization_code subvention.

    curl --location \
"https://appfabric.<region>.amazonaws.com/oauth2/token" \
--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 ..." \
--data "{
    \"code\": \"mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc",
    \"app_client_id\": \"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\",
    \"grant_type\": \"authorization_code\",
    \"redirect_uri\": \"https://localhost:8080\"
}"

    Si l’action aboutit, le service renvoie une réponse HTTP 200.

    {
    "expires_in": 43200,
    "refresh_token": "apkaeibaerjr2example",
    "token": "apkaeibaerjr2example",
    "token_type": "Bearer", 
    "appfabric_user_id" : "<userId>"
}

Étape 3. Ajoutez l'URL du portail AppFabric utilisateur à votre application

Les utilisateurs finaux doivent être autorisés AppFabric à accéder aux données de leurs applications qui sont utilisées pour générer des informations. AppFabric simplifie ce processus pour les développeurs d'applications en créant un portail utilisateur dédié (écran contextuel) permettant aux utilisateurs finaux d'autoriser leurs applications. Lorsque les utilisateurs sont prêts à améliorer leur productivité, ils sont redirigés vers le portail utilisateur qui leur permet de connecter et de gérer les applications utilisées pour générer des informations et des actions inter-applications. AppFabric Une fois connectés, les utilisateurs peuvent connecter des applications à AppFabric des fins de productivité, puis revenir à votre application pour explorer les informations et les actions. Pour intégrer votre application à des AppFabric fins de productivité, vous devez ajouter une AppFabric URL spécifique à votre application. Cette étape est essentielle pour permettre aux utilisateurs d'accéder au portail AppFabric utilisateur directement depuis votre application.

  1. Accédez aux paramètres de votre application et recherchez la section permettant d'ajouter des URL de redirection.

  2. Une fois que vous avez trouvé la zone appropriée, ajoutez l' AppFabric URL suivante comme URL de redirection vers votre application :

    https://userportal.appfabric.<region>.amazonaws.com/eup_login

Après avoir ajouté l'URL, votre application sera configurée pour diriger les utilisateurs vers le portail AppFabric utilisateur. Ici, les utilisateurs peuvent se connecter, se connecter et gérer leurs applications utilisées AppFabric pour générer des informations sur la productivité.

Étape 4 : AppFabric À utiliser pour mettre en évidence des informations et des actions provenant de différentes applications

Une fois que les utilisateurs ont connecté leurs applications, vous pouvez leur apporter les informations dont ils ont besoin pour améliorer leur productivité en réduisant le changement d'application et de contexte. AppFabric ne génère des informations pour un utilisateur que sur la base des informations auxquelles il est autorisé à accéder. AppFabric stocke les données utilisateur dans un Compte AWS fichier appartenant à AppFabric. Pour plus d'informations sur l' AppFabric utilisation de vos données, consultezTraitement des données.

Vous pouvez utiliser les API basées sur l'IA suivantes pour générer et mettre en évidence des informations et des actions au niveau des utilisateurs au sein de vos applications :

  • ListActionableInsights— Pour plus d'informations, consultez la section Informations exploitables ci-dessous.

  • ListMeetingInsights— Pour plus d'informations, consultez la section Préparation de la réunion plus loin dans ce guide.

Informations exploitables () ListActionableInsights

L'ListActionableInsightsAPI aide les utilisateurs à gérer au mieux leur journée en fournissant des informations exploitables basées sur l'activité de leurs applications, notamment les e-mails, le calendrier, les messages, les tâches, etc. Les informations renvoyées afficheront également des liens intégrés vers les artefacts utilisés pour générer les informations, ce qui aidera les utilisateurs à visualiser rapidement les données utilisées pour générer les informations. En outre, l'API peut renvoyer des suggestions d'actions basées sur les informations et permettre aux utilisateurs d'exécuter des actions inter-applications depuis votre application. Plus précisément, l'API s'intègre à des plateformes telles que AsanaGoogle Workspace,Microsoft 365, et Smartsheet pour permettre aux utilisateurs d'envoyer des e-mails, de créer des événements de calendrier et de créer des tâches. Les grands modèles linguistiques (LLM) peuvent prérenseigner les détails d'une action recommandée (tels que le corps de l'e-mail ou le nom de la tâche), que les utilisateurs peuvent personnaliser avant l'exécution, ce qui simplifie la prise de décision et améliore la productivité. À l'instar de l'expérience utilisée par les utilisateurs finaux pour autoriser les applications, AppFabric utilise le même portail dédié permettant aux utilisateurs de visualiser, de modifier et d'exécuter des actions entre applications. Pour exécuter des actions, AppFabric les ISV doivent rediriger les utilisateurs vers un portail AppFabric utilisateur où ils peuvent voir les détails des actions et les exécuter. Chaque action générée par AppFabric possède une URL unique. Cette URL est disponible dans la réponse de ListActionableInsights l'API.

Vous trouverez ci-dessous un résumé des actions inter-applications prises en charge et des applications dans lesquelles :

  • Envoyer un e-mail (Google Workspace,Microsoft 365)

  • Créer un événement de calendrier (Google Workspace,Microsoft 365)

  • Créer une tâche (Asana,Smartsheet)

Champs de demande

  • nextToken(facultatif) - Le jeton de pagination pour récupérer le prochain ensemble d'informations.

  • includeActionExecutionStatus- Un filtre qui accepte la liste des statuts d'exécution des actions. Les actions sont filtrées en fonction des valeurs de statut transmises. Valeurs possibles : NOT_EXECUTED | EXECUTED

En-tête de demande

  • L'en-tête d'autorisation doit être transmis avec la Bearer Token valeur.

Champs de réponse

  • insightId- L'identifiant unique de l'aperçu généré.

  • insightContent- Cela renvoie un résumé de l'aperçu et des liens intégrés vers les artefacts utilisés pour générer l'aperçu. Remarque : Il s'agirait d'un contenu HTML contenant des liens intégrés (<a>balises).

  • insightTitle- Le titre de l'aperçu généré.

  • createdAt- Quand les informations ont été générées.

  • actions- Une liste d'actions recommandées pour les informations générées. Objet de l'action :

    • actionId- L'identifiant unique de l'action générée.

    • actionIconUrl- L'URL de l'icône de l'application dans laquelle il est suggéré d'exécuter l'action.

    • actionTitle- Le titre de l'action générée.

    • actionUrl- L'URL unique permettant à l'utilisateur final de visualiser et d'exécuter l'action dans AppFabric le portail utilisateur. Remarque : pour exécuter des actions, les applications ISV redirigeront les utilisateurs vers le portail AppFabric utilisateur (écran contextuel) à l'aide de cette URL.

    • actionExecutionStatus- Une énumération indiquant le statut de l'action. Les valeurs possibles sont les suivantes : EXECUTED | NOT_EXECUTED

  • nextToken(facultatif) - Le jeton de pagination pour récupérer le prochain ensemble d'informations. Il s'agit d'un champ facultatif qui, s'il est renvoyé nul, signifie qu'il n'y a plus d'informations à charger.

Pour plus d’informations, consultez ActionableInsights.

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

Si l’action aboutit, le service renvoie une réponse 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
}

Préparation des réunions (ListMeetingInsights)

L'ListMeetingInsightsAPI aide les utilisateurs à mieux préparer les réunions à venir en résumant l'objectif de la réunion et en mettant en évidence les éléments pertinents provenant de différentes applications, tels que les e-mails, les messages, etc. Les utilisateurs peuvent désormais se préparer rapidement pour les réunions et ne perdent pas de temps à passer d'une application à l'autre pour trouver du contenu.

Champs de demande

  • nextToken(facultatif) - Le jeton de pagination pour récupérer le prochain ensemble d'informations.

En-tête de demande

  • L'en-tête d'autorisation doit être transmis avec la Bearer Token valeur.

Champs de réponse

  • insightId- L'identifiant unique de l'aperçu généré.

  • insightContent- La description de l'aperçu mettant en évidence les détails sous forme de chaîne. Par exemple, pourquoi cette information est-elle importante ?

  • insightTitle- Le titre de l'aperçu généré.

  • createdAt- Quand les informations ont été générées.

  • calendarEvent- L'événement ou la réunion importante du calendrier sur laquelle l'utilisateur doit se concentrer. Objet d'événement du calendrier :

    • startTime- L'heure de début de l'événement.

    • endTime- L'heure de fin de l'événement.

    • eventUrl- L'URL de l'événement du calendrier sur l'application ISV.

  • resources- La liste contenant les autres ressources liées à la génération de l'aperçu. Objet de ressource :

    • appName- Le nom de l'application à laquelle appartient la ressource.

    • resourceTitle- Le titre de la ressource.

    • resourceType- Le type de ressource. Les valeurs possibles sont les suivantes : EMAIL | EVENT | MESSAGE | TASK

    • resourceUrl- L'URL de la ressource dans l'application.

    • appIconUrl- L'URL de l'image de l'application à laquelle appartient la ressource.

  • nextToken(facultatif) - Le jeton de pagination pour récupérer le prochain ensemble d'informations. Il s'agit d'un champ facultatif qui, s'il est renvoyé nul, signifie qu'il n'y a plus d'informations à charger.

Pour plus d’informations, consultez MeetingInsights.

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

Si l’action aboutit, le service renvoie une réponse 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
}

Fournissez des commentaires sur vos idées ou vos actions

Utilisez l'opération AppFabric PutFeedback API pour fournir des commentaires sur les informations et les actions générées. Vous pouvez intégrer cette fonctionnalité dans vos applications pour fournir un moyen de soumettre une évaluation (de 1 à 5, la note la plus élevée étant la meilleure) pour un InsightId ou ActionId.

Champs de demande

  • id- L'identifiant de l'objet pour lequel le commentaire est soumis. Cela peut être le InsightId ou le ActionId.

  • feedbackFor- Le type de ressource pour lequel les commentaires sont soumis. Valeurs possibles : ACTIONABLE_INSIGHT | MEETING_INSIGHT | ACTION

  • feedbackRating- Évaluation des commentaires allant de 1 à5. Plus la note est élevée, mieux c'est.

Champs de réponse

  • Il n'y a aucun champ de réponse.

Pour plus d’informations, consultez 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
}'

Si l'action aboutit, le service renvoie une réponse HTTP 201 avec un corps HTTP vide.

Étape 5. Demande AppFabric de vérification de votre candidature

À ce stade, vous avez mis à jour l'interface utilisateur de votre application pour intégrer des informations et des actions AppFabric inter-applications, et vous avez reçu des informations pour un seul utilisateur. Une fois que vous êtes satisfait des tests et que vous souhaitez étendre votre expérience AppFabric enrichie à d'autres utilisateurs, vous pouvez soumettre votre candidature AppFabric pour examen et vérification. AppFabric vérifiera les informations des applications avant de permettre une adoption généralisée afin de protéger les développeurs d'applications, les utilisateurs finaux et leurs données, ouvrant ainsi la voie à une adoption plus large par les utilisateurs de manière responsable.

Lancer le processus de vérification

Commencez le processus de vérification en envoyant un e-mail à appfabric-appverification@amazon.com et en demandant que votre application soit vérifiée.

Incluez les informations suivantes dans votre e-mail :

  • Votre Compte AWS identifiant

  • Le nom de l'application pour laquelle vous souhaitez obtenir une vérification

  • Votre AppClient identifiant

  • Vos coordonnées

En outre, veuillez fournir les informations suivantes, si elles sont disponibles, pour nous aider à évaluer la priorité et l'impact :

  • Nombre estimatif d'utilisateurs auxquels vous comptez accorder l'accès

  • Votre date de lancement cible

Note

Si vous avez un Compte AWS responsable ou un responsable du développement des AWS partenaires, veuillez le copier sur votre e-mail. L'inclusion de ces contacts peut contribuer à accélérer le processus de vérification.

Critères de vérification

Avant de lancer le processus de vérification, vous devez répondre aux critères suivants :

  • Vous devez utiliser un code valide Compte AWS pour être utilisé AppFabric pour des raisons de productivité

De plus, vous répondez à au moins l'un des critères suivants :

  • Votre organisation est un AWS partenaire doté d'au moins un niveau « AWS  Select ». AWS Partner Network Pour plus d'informations, consultez la section Niveaux de services aux AWS partenaires.

  • Votre organisation doit avoir dépensé au moins 10 000$ en AppFabric services au cours des trois dernières années.

  • Votre candidature doit être répertoriée sur le AWS Marketplace. Pour plus d'informations, consultez le AWS Marketplace.

Attendez la mise à jour du statut de vérification

Une fois votre candidature examinée, nous vous répondrons par e-mail et le statut de votre candidature AppClient passera de pending_verification àverified. Si votre demande est rejetée, vous devrez relancer le processus de vérification.