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.
# Qu'est-ce que c'est AWS AppFabric pour la productivité ?
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
**Note**
Propulsé par Amazon Bedrock : AWS implémente la [détection](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) automatique des abus. Parce que AWS AppFabric la productivité repose sur Amazon Bedrock, les utilisateurs héritent des contrôles mis en œuvre dans Amazon Bedrock pour renforcer la sûreté, la sécurité et l'utilisation responsable de l'IA.
AWS AppFabric for productivity (version préliminaire) permet de réinventer la productivité des utilisateurs finaux dans les applications tierces en générant des informations et des actions basées sur le contexte de plusieurs applications. Les développeurs d'applications reconnaissent que l'accès aux données utilisateur depuis d'autres applications est important pour créer une expérience applicative plus productive, mais ils ne souhaitent pas créer et gérer des intégrations avec chaque application. AppFabric Pour ce qui est de la productivité, les développeurs d'applications ont accès à des outils basés sur l'IA générative APIs qui génèrent des informations et des actions relatives aux données inter-applications afin de fournir une expérience utilisateur plus riche grâce à des assistants d'IA générative nouveaux ou existants. AppFabric pour la productivité intègre les données de plusieurs applications, éliminant ainsi la nécessité pour les développeurs de créer ou de maintenir point-to-point des intégrations. Les développeurs d'applications peuvent intégrer AppFabric la productivité directement dans l'interface utilisateur de leur application, afin de garantir une expérience cohérente à leurs utilisateurs finaux tout en faisant ressortir le contexte pertinent des autres applications.
AppFabric pour la productivité connecte les données provenant d'applications couramment utilisées telles queAsana,,Atlassian Jira Suite,Google Workspace,,Microsoft 365,Miro, SlackSmartsheet, et bien d'autres encore. AppFabric pour la productivité permet aux développeurs d'applications de créer plus facilement des expériences applicatives plus personnalisées qui améliorent l'adoption, la satisfaction et la fidélité des utilisateurs. Dans le même temps, les utilisateurs finaux bénéficient de l'accès aux informations dont ils ont besoin à partir de leurs applications sans interrompre leur flux de travail.
**Topics**
+ [Avantages](#benefits)
+ [Cas d’utilisation](#use-cases)
+ [Accès à AppFabric des fins de productivité](#acessing-appfabric)
+ [Commencez avec un outil AppFabric de productivité (version préliminaire) pour les développeurs d'applications](getting-started-appdeveloper-productivity.md)
+ [Commencez AppFabric à améliorer la productivité (version préliminaire) pour les utilisateurs finaux](getting-started-users-productivity.md)
+ [AppFabric pour la productivité APIs (version préliminaire)](productivity-apis.md)
+ [Traitement des données dans AppFabric](productivity-data-processing.md)
## Avantages
En AppFabric matière de productivité, les développeurs d'applications ont accès à des informations et à des actions sur les données inter-applications APIs qui leur permettent de proposer des expériences plus riches aux utilisateurs finaux grâce à des assistants d'IA générative nouveaux ou existants.
+ **Source unique de données utilisateur inter-applications** : AppFabric pour la productivité, intègre les données de plusieurs applications, ce qui évite aux développeurs de créer ou de gérer des point-to-point intégrations. Les données des applications SaaS sont traitées pour être utilisées dans d'autres applications en normalisant automatiquement les types de données disparates dans un format compréhensible par toutes les applications, ce qui permet aux développeurs d'applications d'intégrer davantage de données qui améliorent réellement la productivité des utilisateurs finaux.
+ **Contrôle total de l'expérience utilisateur** : les développeurs intègrent AppFabric la productivité directement dans l'interface utilisateur de leur application, en gardant le contrôle total de l'expérience utilisateur tout en fournissant des informations personnalisées et des actions recommandées aux utilisateurs finaux grâce au contexte de l'ensemble de leurs applications. Cela rend AppFabric la productivité disponible dans l'application SaaS préférée des utilisateurs finaux et est accessible dans l'application qu'ils préfèrent pour accomplir leurs tâches. Les utilisateurs finaux passent moins de temps à passer d'une application à l'autre et peuvent ainsi rester concentrés sur leur travail.
+ **Accélérez les délais de commercialisation** : en un seul appel d'API, les développeurs d'applications peuvent obtenir des informations au niveau de l'utilisateur sur les données d'un utilisateur générées sans avoir à affiner un modèle, à rédiger une invite personnalisée ou à créer des intégrations entre plusieurs applications. AppFabric élimine cette complexité pour permettre aux développeurs d'applications de créer, d'intégrer ou d'enrichir plus rapidement les capacités d'IA générative. Cela permet aux développeurs d'applications de concentrer leurs ressources sur les tâches les plus importantes.
+ **Des références à des artefacts pour renforcer la confiance des utilisateurs** : dans le cadre des résultats, des artefacts pertinents ou AppFabric des fichiers source seront mis en évidence dans le but de générer les informations nécessaires pour renforcer la confiance des utilisateurs finaux dans les résultats du LLM.
+ **Autorisations utilisateur simplifiées : les** artefacts utilisateur utilisés pour générer des informations sont basés sur ce à quoi l'utilisateur a accès. AppFabric pour la productivité utilise les autorisations et le contrôle d'accès d'un éditeur de logiciels indépendants comme source de vérité.
## Cas d’utilisation
Les développeurs d'applications peuvent utiliser la notion de productivité AppFabric pour repenser la productivité au sein de leurs applications. AppFabric for productivity en propose deux APIs axées sur les cas d'utilisation suivants pour aider leurs utilisateurs finaux à être plus productifs :
+ Donnez la priorité à votre journée
+ L'API d'informations exploitables aide les utilisateurs à gérer au mieux leur journée en leur fournissant des informations pertinentes provenant de l'ensemble de leurs applications, notamment les e-mails, le calendrier, les messages, les tâches, etc. En outre, les utilisateurs peuvent exécuter des actions inter-applications telles que la création d'e-mails, la planification de réunions et la création d'actions à partir de leur application préférée. Par exemple, un employé qui a connu une escalade de clientèle pendant la nuit verra non seulement un résumé des conversations du jour au lendemain, mais pourra également voir une action recommandée pour planifier une réunion avec le responsable de compte du client. Les actions sont préremplies avec les champs obligatoires (tels que le nom et le propriétaire de la tâche, ou l'expéditeur/destinataire de l'e-mail), avec la possibilité de modifier le contenu prérempli avant d'exécuter l'action.
+ Préparez-vous pour les prochaines réunions
+ L'API de préparation des réunions aide les utilisateurs à mieux préparer les réunions en résumant l'objectif de la réunion et en mettant en évidence les artefacts 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.
## Accès à AppFabric des fins de productivité
AppFabric for productivity est actuellement lancé en version préliminaire et disponible dans l'est des États-Unis (Virginie du Nord) Région AWS. Pour plus d'informations sur Régions AWS, consultez la section [AWS AppFabric Points de terminaison et quotas](https://docs.aws.amazon.com/general/latest/gr/appfabric.html) dans le *Références générales AWS*.
Dans chaque région, vous pouvez accéder à AppFabric des fins de productivité de l'une des manières suivantes :
+ En tant que développeur d'applications
+ [Commencez avec un outil AppFabric de productivité (version préliminaire) pour les développeurs d'applications](getting-started-appdeveloper-productivity.md)
+ En tant qu'utilisateur final
+ [Commencez AppFabric à améliorer la productivité (version préliminaire) pour les utilisateurs finaux](getting-started-users-productivity.md)
# Commencez avec un outil AppFabric de 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](https://aws.amazon.com/appfabric/supported-applications/).
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](#request_verification)). 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.
**Topics**
+ [Conditions préalables](#getting-started-prerequisites)
+ [Étape 1. Créez et AppFabric améliorez la productivité AppClient](#create_appclient)
+ [Étape 2. Authentifiez et autorisez votre application](#authorize_data_access)
+ [Étape 3. Ajoutez l'URL du portail AppFabric utilisateur à votre application](#end_user_portal)
+ [Étape 4 : AppFabric À utiliser pour mettre en évidence des informations et des actions provenant de différentes applications](#surface_insights_actions)
+ [Étape 5. Demande AppFabric de vérification de votre candidature](#request_verification)
+ [Gérez AppFabric pour optimiser la productivité AppClients](manage-appclients.md)
+ [Résoudre les problèmes AppFabric pour AppClients améliorer la productivité](ahead-app-dev-errors.md)
## Conditions préalables
Avant de commencer, vous devez créer un Compte AWS. Pour de plus amples informations, veuillez consulter [Inscrivez-vous pour un Compte AWS](prerequisites.md#sign-up-for-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é, consultez[AppFabric pour des exemples de politiques IAM de productivité](security_iam_id-based-policy-examples.md#appfabric-for-productivity-policy-examples). Bien qu'il soit avantageux d'avoir un utilisateur administratif, il n'est pas obligatoire pour la configuration initiale. Pour de plus amples informations, veuillez consulter [Création d’un utilisateur doté d’un accès administratif](prerequisites.md#create-an-admin).
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.
## É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' OAuth application 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](#request_verification)). 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 de plus amples informations, veuillez consulter [CreateAppClient](API_CreateAppClient.md).
Vous pouvez enregistrer votre application auprès de AWS services à l'aide de l'`CreateAppClient`API en utilisant plusieurs langages de programmation, notamment Python, Node.js, Java, C\$1, Go et Rust. Pour plus d'informations, consultez la section [Demander des exemples de signature](https://docs.aws.amazon.com/IAM/latest/UserGuide/signature-v4-examples.html) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 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](getting-started-users-productivity.md#provide-consent).
+ `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](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) 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 est`a1b2c3d4-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é dans`starterUserEmails`) 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](#end_user_portal), 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: " \
--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/"
}'
```
Si l’action aboutit, le service renvoie une réponse HTTP 200.
```
{
"appClientConfigSummary": {
"appClientArn": "arn:aws:appfabric:::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 de plus amples informations, veuillez consulter [Autoriser](API_Authorize.md). 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 de plus amples informations, veuillez consulter [Jeton](API_Token.md).
Pour plus d'informations sur l'octroi de l'autorisation d'autoriser une application, consultez[Autoriser l'accès pour autoriser les applications](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-token).
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](#create_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](#create_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..amazonaws.com/oauth2/authorize?app_client_id=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\
redirect_uri=https://localhost:8080&state=a8904edc-890c-1005-1996-29a757272a44
```
1. 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
```
1. É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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 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](#create_appclient). Par exemple, `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `grant_type`(obligatoire) - La valeur doit être`authorization_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](#create_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 de`Bearer`.
+ `appfabric_user_id`- L'identifiant de AppFabric l'utilisateur. Ceci n'est renvoyé que pour les demandes utilisant le type de `authorization_code` subvention.
```
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\"
}"
```
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" : ""
}
```
## É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 seront prêts à améliorer leur productivité, ils seront 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 une redirection URLs.
1. 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..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, consultez[Traitement des données dans AppFabric](productivity-data-processing.md).
Vous pouvez utiliser les outils suivants basés sur l'IA APIs 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](#productivity-actionable-insights) ci-dessous.
+ `ListMeetingInsights`— Pour plus d'informations, consultez la section [Préparation de la réunion](#productivity-meeting-insights) plus loin dans ce guide.
### Informations exploitables () `ListActionableInsights`
L'`ListActionableInsights`API 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 de langage (LLMs) 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 il faut ISVs 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` \$1 `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 (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` \$1 `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 de plus amples informations, veuillez consulter [ActionableInsights](API_ActionableInsights.md).
```
curl -v --location \
"https://productivity.appfabric..amazonaws.com"\
"/actionableInsights" \
--header "Authorization: Bearer "
```
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 de la réunion (`ListMeetingInsights`)
L'`ListMeetingInsights`API 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 artefacts 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 de l'é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` \$1 `EVENT` \$1 `MESSAGE` \$1 `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 de plus amples informations, veuillez consulter [MeetingInsights](API_MeetingInsights.md).
```
curl --location \
"https://productivity.appfabric..amazonaws.com"\
"/meetingContexts" \
--header "Authorization: Bearer "
```
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` \$1 `MEETING_INSIGHT` \$1 `ACTION`
+ `feedbackRating`- Évaluation des commentaires 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 de plus amples informations, veuillez consulter [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
}'
```
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](mailto: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 :
+ Pour des raisons de productivité, vous Compte AWS devez utiliser un AppFabric code valide
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](https://aws.amazon.com/partners/services-tiers/).
+ Votre organisation doit avoir dépensé au moins 10 000\$1 en AppFabric services au cours des trois dernières années.
+ Votre candidature doit figurer sur le AWS Marketplace. Pour plus d'informations, consultez le [AWS Marketplace](https://aws.amazon.com/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.
# Gérez AppFabric pour optimiser la productivité AppClients
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Vous pouvez gérer votre productivité AppClients afin AppFabric de garantir le bon fonctionnement et la maintenance des processus d'authentification et d'autorisation.
## Obtenez les détails d'un AppClient
Utilisez le fonctionnement de l' AppFabric `GetAppClient`API pour afficher les informations vous concernant AppClient, notamment pour vérifier AppClient son statut. Pour de plus amples informations, veuillez consulter [GetAppClient](API_GetAppClient.md).
Pour obtenir des informations sur un AppClient, vous devez disposer, au minimum, des autorisations de politique `"appfabric:GetAppClient"` IAM. Pour de plus amples informations, veuillez consulter [Autoriser l'accès pour obtenir des informations sur AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-get-appclient).
**Champs de demande**
+ `appClientId`- L' AppClient identifiant.
**Champs de réponse**
+ `appName`- Le nom de l'application qui sera affiché aux utilisateurs sur la page de consentement du portail AppFabric utilisateur.
+ `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.
+ `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`.
+ `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é dans`starterUserEmails`) peut utiliser le AppClient.
+ `verified`- Le processus de vérification a été effectué avec succès AppFabric et AppClient est maintenant 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 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
```
Si l’action aboutit, le service renvoie une réponse 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"
}
}
}
```
## Liste AppClients
Utilisez l'opération AppFabric `ListAppClients` API pour afficher la liste de vos AppClients. AppFabric n'en autorise qu'un AppClient par Compte AWS. Ceci est sujet à modification dans le futur. Pour de plus amples informations, veuillez consulter [ListAppClients](API_ListAppClients.md).
Pour créer une liste AppClients, vous devez disposer, au minimum, des autorisations de politique `"appfabric:ListAppClients"` IAM. Pour de plus amples informations, veuillez consulter [Autoriser l'accès à la liste AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-list-appclient).
**Champs de demande**
+ Il n'y a aucun champ obligatoire.
**Champs de réponse**
+ `appClientARN`- Le nom de ressource Amazon (ARN) qui inclut l' AppClient ID. Par exemple, l' AppClient identifiant est`a1b2c3d4-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é dans`starterUserEmails`) peut utiliser le AppClient.
+ `verified`- Le processus de vérification a été effectué avec succès AppFabric et AppClient est maintenant 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 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
```
Si l’action aboutit, le service renvoie une réponse HTTP 200.
```
200 OK
{
"appClientList": [
{
"appClientArn": "arn:aws:appfabric::111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"verificationStatus": "pending_verification"
}
]
}
```
## Mettre à jour un AppClient
Utilisez l'opération AppFabric `UpdateAppClient` API pour mettre à jour les URL de redirection mappées à votre. AppClient Si vous devez modifier d'autres paramètres, tels que AppName starterUserEmails, ou autre, vous devez les supprimer AppClient et en créer un nouveau. Pour de plus amples informations, veuillez consulter [UpdateAppClient](API_UpdateAppClient.md).
Pour mettre à jour un AppClient, vous devez disposer, au minimum, des autorisations de politique `"appfabric:UpdateAppClient"` IAM. Pour de plus amples informations, veuillez consulter [Autoriser l'accès à la mise à jour AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient).
**Champs de demande**
+ `appClientId`(obligatoire) - L' AppClient ID avec lequel vous mettez à jour les URL de redirection.
+ `redirectUrls`(obligatoire) - La liste mise à jour des URL de redirection. Vous pouvez ajouter jusqu'à 5 URL de redirection.
**Champs de réponse**
+ `appName`- Le nom de l'application qui sera affiché aux utilisateurs sur la page de consentement du portail AppFabric utilisateur.
+ `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.
+ `description`- Une description de l'application.
+ `redirectUrls`- L'URI vers lequel rediriger les utilisateurs finaux après autorisation. 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`.
+ `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é dans`starterUserEmails`) peut utiliser le AppClient.
+ `verified`- Le processus de vérification a été effectué avec succès AppFabric et AppClient est maintenant 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 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"]
}'
```
Si l’action aboutit, le service renvoie une réponse 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"
}
}
}
```
## Supprimer un AppClient
Utilisez l'opération AppFabric `DeleteAppClient` API pour supprimer celles dont AppClients vous n'avez plus besoin. Pour de plus amples informations, veuillez consulter [DeleteAppClient](API_DeleteAppClient.md).
Pour supprimer un AppClient, vous devez disposer, au minimum, des autorisations de politique `"appfabric:DeleteAppClient"` IAM. Pour de plus amples informations, veuillez consulter [Autoriser l'accès pour supprimer AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-delete-appclient).
**Champs de demande**
+ `appClientId`- L' AppClient identifiant.
**Champs de réponse**
+ Il n'y a aucun champ de réponse.
```
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
```
Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.
## Actualiser les jetons pour les utilisateurs finaux
Les jetons que vous AppClient obtenez pour les utilisateurs finaux peuvent être actualisés à leur expiration. Cela peut être fait à l'aide de l'[Jeton](API_Token.md)API avec le grant\$1type`refresh_token`. Le `refresh_token` à utiliser est renvoyé dans le cadre de la réponse de l'API token lorsque le grant\$1type est. `authorization_code` Le délai d'expiration par défaut est de 12 heures. Pour appeler l'API d'actualisation, vous devez disposer de l'autorisation de politique `"appfabric:Token"` IAM. Pour plus d’informations, consultez [Jeton](API_Token.md) et [Autoriser l'accès à la mise à jour AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient).
**Champs de demande**
+ `refresh_token`(obligatoire) - Le jeton d'actualisation reçu lors de la `/token` demande initiale.
+ `app_client_id`(obligatoire) - L'ID de la AppClient ressource créée pour Compte AWS.
+ `grant_type`(obligatoire) - Cela doit être le cas`refresh_token`.
**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 de`Bearer`.
+ `appfabric_user_id`- L'identifiant de AppFabric l'utilisateur. Ceci n'est renvoyé que pour les demandes utilisant le type de `authorization_code` subvention.
```
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\"
}"
```
Si l’action aboutit, le service renvoie une réponse HTTP 200.
```
200 OK
{
"expires_in": 43200,
"token": "apkaeibaerjr2example",
"token_type": "Bearer",
"appfabric_user_id" : "${UserID}"
}
```
# Résoudre les problèmes AppFabric pour AppClients améliorer la productivité
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Cette section décrit les erreurs courantes et les solutions de résolution des problèmes liés AppFabric à la productivité.
## Candidature non vérifiée
Les développeurs d'applications qui utilisent AppFabric des outils de productivité pour enrichir leurs expériences applicatives passeront par un processus de vérification avant de lancer leurs fonctionnalités aux utilisateurs finaux. Toutes les applications commencent comme non vérifiées et ne deviennent vérifiées que lorsque le processus de vérification est terminé. Cela signifie que le message que `starterUserEmails` vous avez utilisé lors de la création d'un AppClient sera affiché.
![\[Warning message for an unverified application in AWS AppFabric, requesting data access.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-24.png)
## Erreurs liées à l’`CreateAppClient`
### ServiceQuotaExceededException
Si vous recevez l'exception suivante lors de la création d'un AppClient, vous avez dépassé le nombre d'exceptions AppClients pouvant être créées par Compte AWS. La limite est de 1. Code d'état 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
```
## Erreurs liées à l’`GetAppClient`
### ResourceNotFoundException
Si vous recevez l'exception suivante lorsque vous obtenez les détails d'un AppClient, assurez-vous d'avoir saisi le bon AppClient identifiant. Cette erreur signifie que le fichier spécifié n' AppClient a pas été trouvé.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Erreurs liées à l’`DeleteAppClient`
### ConflictException
Si vous recevez l'exception suivante lors de la suppression d'une AppClient, une autre demande de suppression est en cours. Patientez jusqu'à ce qu'il soit terminé, puis réessayez. Code d’état HTTP : 409
```
ConflictException
Another delete request is in progress. Wait until it completes then try again.
HTTP Status Code: 409
```
### ResourceNotFoundException
Si vous recevez l'exception suivante lors de la suppression d'un AppClient, assurez-vous d'avoir saisi le bon AppClient identifiant. Cette erreur signifie que le fichier spécifié n' AppClient a pas été trouvé.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Erreurs liées à l’`UpdateAppClient`
### ResourceNotFoundException
Si vous recevez l'exception suivante lors de la mise à jour d'un AppClient, assurez-vous d'avoir saisi le bon AppClient identifiant. Cette erreur signifie que le fichier spécifié n' AppClient a pas été trouvé.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Erreurs liées à l’`Authorize`
### ValidationException
L'exception suivante peut s'afficher si l'un des paramètres de l'API ne répond pas aux contraintes définies dans les spécifications de l'API.
```
ValidationException
HTTP Status Code: 400
```
**Raison 1 : Lorsque AppClient l'identifiant n'est pas spécifié**
Le `app_client_id` est absent dans les paramètres de la demande. Créez-le AppClient s'il n'a pas encore été créé ou utilisez le vôtre existant `app_client_id` et réessayez. Pour trouver l' AppClient ID, utilisez l'opération [ListAppClient](manage-appclients.md#list_appclients)API.
**Raison 2 : Quand AppFabric n'a pas accès à la clé gérée par le client**
```
Message: AppFabric couldn't access the customer managed key configured for AppClient.
```
AppFabric n'est actuellement pas en mesure d'accéder aux clés gérées par le client, probablement en raison de récentes modifications de ses autorisations. Vérifiez que la clé spécifiée existe et que AppFabric les autorisations d'accès appropriées sont accordées.
**Raison 3 : L'URL de redirection spécifiée n'est pas valide**
```
Message: Redirect url invalid
```
Assurez-vous que l'URL de redirection figurant dans votre demande est correcte. Elle doit correspondre à l'une des redirections URLs spécifiées lors de la création ou de la mise à jour du AppClient. Pour afficher la liste des redirections autorisées URLs, utilisez l'opération [GetAppClient](manage-appclients.md#get_appclient_details)API.
## Erreurs liées à l’`Token`
### TokenException
Vous pouvez bénéficier de l'exception suivante pour plusieurs raisons.
```
TokenException
HTTP Status Code: 400
```
**Raison 1 : Lorsqu'un e-mail non valide est spécifié**
```
Message: Invalid Email used
```
Assurez-vous que l'adresse e-mail que vous utilisez correspond à celle répertoriée pour l'`starterUserEmails`attribut lorsque vous avez créé le AppClient. Si les e-mails ne correspondent pas, utilisez l'adresse e-mail correspondante et réessayez. Pour afficher l'e-mail utilisé, utilisez l'opération [GetAppClient](manage-appclients.md#get_appclient_details)API.
**Raison 2 : Pour grant\$1type en tant que refresh\$1token lorsque le jeton n'est pas spécifié.**
```
Message: refresh_token must be non-null for Refresh Token Grant-type
```
Le jeton d'actualisation spécifié dans la demande est nul ou vide. Spécifiez une réponse d'appel active `refresh_token` reçue dans l'API [Token](getting-started-appdeveloper-productivity.md#authorize_data_access).
### ThrottlingException
Vous pouvez recevoir l'exception suivante si l'API est appelée à un taux supérieur au quota autorisé.
```
ThrottlingException
HTTP Status Code: 429
```
## `ListActionableInsights``ListMeetingInsights`, et `PutFeedback` erreurs
### ValidationException
L'exception suivante peut s'afficher si l'un des paramètres de l'API ne satisfait pas à la contrainte définie dans les spécifications de l'API.
```
ValidationException
HTTP Status Code: 400
```
### ThrottlingException
Vous pouvez recevoir l'exception suivante si l'API est appelée à un taux supérieur au quota autorisé.
```
ThrottlingException
HTTP Status Code: 429
```
# Commencez AppFabric à améliorer la productivité (version préliminaire) pour les utilisateurs finaux
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Cette section est destinée aux utilisateurs finaux d'applications SaaS qui souhaitent améliorer la productivité (version préliminaire) afin AWS AppFabric d'améliorer la gestion des tâches et l'efficacité de leurs flux de travail. Suivez ces étapes pour connecter vos applications et autoriser AppFabric la diffusion d'informations croisées entre applications et vous aider à effectuer des actions (telles que l'envoi d'un e-mail ou la planification d'une réunion) à partir de vos applications préférées. Vous pouvez connecter des applications telles que AsanaAtlassian Jira Suite,,Google Workspace,Microsoft 365,Miro,Slack,Smartsheet,,, etc. Une fois que vous avez autorisé l'accès AppFabric à votre contenu, AppFabric vous bénéficiez d'informations et d'actions inter-applications directement dans vos applications préférées, ce qui vous permet de travailler plus efficacement et de respecter vos flux de travail actuels.
AppFabric pour la productivité, utilise une IA générative alimentée par Amazon Bedrock. AppFabric ne générera des informations et des actions qu'après avoir reçu votre autorisation explicite. Vous autorisez chaque application individuelle à garder le contrôle total du contenu utilisé. AppFabric n'utilisera pas vos données pour entraîner ou améliorer les grands modèles linguistiques sous-jacents utilisés pour générer des informations. Pour plus d'informations, consultez [Amazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/).
**Topics**
+ [Conditions préalables](#getting-started-prerequisites)
+ [Étape 1. Connectez-vous à AppFabric](#sign-in-appfabric)
+ [Étape 2. Donnez votre accord pour que l'application affiche des informations](#provide-consent)
+ [Étape 3. Connectez vos applications pour générer des informations et des actions](#connect-apps)
+ [Étape 4 : Commencez à obtenir des informations et à exécuter des actions inter-applications dans votre application](#insights_in_app)
+ [Gérez l'accès AppFabric aux fonctionnalités de productivité (version préliminaire) destinées aux administrateurs informatiques et de sécurité](productivity-end-users-managing-access.md)
+ [Résoudre les erreurs des utilisateurs finaux AppFabric pour améliorer la productivité](productivity-end-users-errors.md)
## Conditions préalables
Avant de commencer, assurez-vous que vous disposez des éléments suivants :
+ Informations d'identification auxquelles vous connecter AppFabric : pour commencer à utiliser à des AppFabric fins de productivité, vous aurez besoin d'informations d'identification fédérées (nom d'utilisateur et mot de passe) pour l'un des fournisseurs suivants :Asana, Google WorkspaceMicrosoft 365, ou. Slack La connexion à nous AppFabric permet de vous identifier en tant qu'utilisateur dans chaque application que vous activez AppFabric pour des raisons de productivité. Une fois connecté, vous pouvez connecter vos applications pour commencer à générer des informations.
+ Informations d'identification pour connecter vos applications : les informations et actions inter-applications ne sont générées que sur la base des applications que vous autorisez. Vous aurez besoin d'informations d'identification (nom d'utilisateur et mot de passe) pour chacune des applications que vous souhaitez autoriser. Les applications prises en charge incluent Asana Atlassian Jira SuiteGoogle Workspace,Microsoft 365,Miro,Slack, etSmartsheet.
## Étape 1. Connectez-vous à AppFabric
Connectez les applications AppFabric pour intégrer votre contenu et vos informations directement dans vos applications préférées.
1. Chaque application sera utilisée AppFabric pour améliorer la productivité de différentes manières afin de vous offrir des expériences applicatives plus riches. De ce fait, chaque application aura un point d'entrée différent AppFabric pour accéder à la page d'accueil dédiée à la productivité ci-dessous. La page d'accueil définit le contexte du processus à activer AppFabric et vous invite d'abord à vous connecter. Toutes les applications que vous souhaitez activer AppFabric atteindront cet écran.
![\[Sign-in prompt for AWS AppFabric, highlighting AI-powered productivity features.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-01.png)
1. Connectez-vous à l'aide des informations d'identification de l'un de ces fournisseurs : AsanaGoogle Workspace,Microsoft 365, ouSlack. Pour une expérience optimale, nous vous recommandons de vous connecter en utilisant le même fournisseur pour chaque application que vous activez AppFabric . Par exemple, si vous choisissez les informations d'identification Google Workspace dans App1, nous vous recommandons de choisir Google Workspace dans App2, ainsi que chaque fois que vous devez vous reconnecter. Si vous vous connectez auprès d'un autre fournisseur, vous devez recommencer le processus de connexion des applications.
![\[AWS AppFabric sign-in page with options for Slack, Microsoft, Google, and Asana.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-02.png)
1. Si vous y êtes invité, entrez vos informations de connexion et acceptez de vous connecter AppFabric depuis ce fournisseur.
![\[Slack sign-in page with options for Google, Apple, or email authentication.\]](http://docs.aws.amazon.com/fr_fr/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/fr_fr/appfabric/latest/adminguide/images/fabric-04.png)
## Étape 2. Donnez votre accord pour que l'application affiche des informations
Une fois connecté, une page de consentement s' AppFabric affichera vous demandant si vous autorisez l'affichage AppFabric d'informations et d'actions inter-applications dans l'application dans laquelle vous activez AppFabric la productivité. Par exemple, autorisez-vous AppFabric à prendre vos Google Workspace e-mails et les événements de votre calendrier et à les afficherAsana. Vous ne devez effectuer cette étape de consentement qu'une seule fois par application que vous activez AppFabric .
![\[Dialog box requesting permission to display insights and artifacts within an application.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-05.png)
## Étape 3. Connectez vos applications pour générer des informations et des actions
Une fois que vous avez rempli la page de consentement, vous êtes redirigé vers la page **des applications Connect** où vous pouvez connecter, déconnecter ou reconnecter des applications individuelles qui sont finalement utilisées pour générer des informations et des actions entre applications. Dans la plupart des cas, après vous être connecté et avoir donné votre accord, vous continuerez à utiliser cette page pour gérer vos applications connectées.
Pour connecter une application, cliquez sur le bouton **Connect** situé à côté de l'application que vous utilisez.
![\[List of applications to connect, including Smartsheet, Slack, and Google Workspace, all showing as not connected.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-06.png)
Vous devrez fournir vos informations de connexion à l'application et AppFabric autoriser l'accès à vos données pour générer des informations et effectuer des actions.
![\[Dialog box requesting permission for AWS AppFabric to access Slack workspace data.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-07.png)
Une fois que vous avez connecté une application avec succès, le statut de cette application passe de « Non connecté » à « Connecté ». Rappel : vous devez effectuer cette étape d'autorisation pour chaque application que vous souhaitez utiliser pour générer des informations et des actions.
Une fois que vous avez connecté une application, elle n'est pas connectée pour toujours. Vous devrez régulièrement reconnecter les applications. Nous faisons cela pour nous assurer que nous avons toujours votre autorisation pour générer des informations.
Les statuts possibles des applications sont les suivants :
+ Connecté : AppFabric est autorisé et génère des informations à l'aide de vos données à partir de cette application.
+ Non connecté : ne génère AppFabric pas d'informations à partir des données de cette application. Vous pouvez vous connecter pour commencer à générer des informations.
+ L'autorisation a échoué. Veuillez vous reconnecter. - Il peut y avoir un échec d'autorisation avec une application spécifique. Si cette erreur s'affiche, essayez de reconnecter votre application à l'aide du bouton **Connect**.
![\[Application connection status interface showing connected and unconnected apps.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-08.png)
La configuration est terminée et vous pouvez retourner à votre application. Au moins quelques heures peuvent être nécessaires pour commencer à obtenir des informations au sein de vos applications.
Le cas échéant, vous pouvez revenir à cette page pour gérer vos applications connectées. Si vous choisissez de **déconnecter** une application, vous AppFabric cesserez d'utiliser les données de cette application ou de collecter de nouvelles données pour générer de nouvelles informations. Les données des applications déconnectées seront automatiquement supprimées dans les 7 jours si vous choisissez de ne pas reconnecter l'application dans ce délai.
## Étape 4 : Commencez à obtenir des informations et à exécuter des actions inter-applications dans votre application
Une fois que vous aurez connecté vos applications AppFabric, vous aurez accès à des informations précieuses et pourrez effectuer des actions inter-applications directement depuis votre application préférée. Remarque : cette fonctionnalité n'est pas garantie dans chaque application et dépend entièrement des fonctionnalités AppFabric de productivité que le développeur de l'application a choisi d'activer.
**Informations croisées entre les applications**
AppFabric for productivity propose deux types d'informations :
+ Informations exploitables : AppFabric analyse les informations contenues dans vos e-mails, les événements de votre calendrier, vos tâches et vos messages sur l'ensemble de vos applications connectées et génère des informations clés qu'il peut être important de prioriser. En outre, AppFabric peut générer des actions recommandées (telles que l'envoi d'un e-mail, la planification d'une réunion et la création d'une tâche) que vous pouvez modifier et exécuter tout en restant dans votre application préférée. Par exemple, vous pouvez recevoir un message indiquant qu'il y a une escalade de clientèle à gérer et une suggestion d'action suivante pour planifier un rendez-vous avec votre client.
+ Informations sur la préparation des réunions : cette fonctionnalité vous aide à préparer au mieux les réunions à venir. AppFabric analysera vos prochaines réunions et générera un résumé concis de l'objectif de la réunion. En outre, il fera apparaître des artefacts pertinents (tels que des e-mails, des messages et des tâches) provenant de vos applications connectées, qui vous seront utiles pour vous aider à préparer efficacement la réunion sans avoir à passer d'une application à l'autre pour rechercher du contenu.
**Actions entre applications**
Pour certaines informations, cela AppFabric peut également générer des actions recommandées telles que l'envoi d'un e-mail, la planification d'une réunion ou la création d'une tâche. Lorsque vous générez des actions, vous AppFabric pouvez préremplir certains champs en fonction du contenu et du contexte de vos applications connectées. Par exemple, AppFabric peut générer une réponse par e-mail ou un nom de tâche suggéré en fonction des informations. Lorsque vous cliquez sur une action suggérée, vous êtes redirigé vers une AppFabric interface utilisateur personnalisée dans laquelle vous pouvez modifier le contenu prérempli avant d'exécuter l'action. AppFabric n'exécutera pas d'actions sans l'avis de l'utilisateur et sans l'intervention préalable de l'utilisateur, car l'IA générative et les grands modèles linguistiques sous-jacents (LLM) peuvent halluciner de temps à autre.
**Note**
Vous avez la responsabilité de valider et de confirmer les résultats du AppFabric LLM. AppFabric ne garantit pas l'exactitude ou la qualité de ses sorties LLM. Pour plus d'informations, consultez la section [Politique en matière d'IA AWS responsable](https://aws.amazon.com/machine-learning/responsible-ai/policy/).
### Créez des e-mails (Google Workspace,Microsoft 365)
AppFabric vous permet de modifier et d'envoyer un e-mail depuis votre application préférée. Nous prenons en charge les champs de courrier électronique de base, notamment les champs From, To, Cc/Bcc, la ligne d'objet de l'e-mail et le corps du message. AppFabric peut générer du contenu dans ces champs pour vous aider à réduire le temps nécessaire à l'exécution de la tâche. Une fois que vous avez terminé de modifier l'e-mail, choisissez **Envoyer** pour envoyer l'e-mail.
Les champs suivants sont obligatoires pour envoyer un e-mail :
+ Au moins un des e-mails des destinataires (To, CC et BCC) est requis et doit être une adresse e-mail valide.
+ Ligne d'objet et champs de message.
![\[Email form with From, To, CC, BCC, Subject line, and Message fields for sending.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-12.png)
Une fois l'e-mail envoyé, vous verrez une confirmation indiquant qu'il a été envoyé. De plus, vous verrez un lien permettant de consulter l'e-mail dans l'application désignée. Vous pouvez utiliser ce lien pour accéder rapidement à l'application et vérifier que l'e-mail a bien été envoyé.
![\[Email sent confirmation with recipient details and message preview.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-13.png)
### Créer des événements de calendrier (Google Workspace,Microsoft 365)
AppFabric vous permet de modifier et de créer un événement de calendrier depuis votre application préférée. Nous prenons en charge les champs d'événements de base du calendrier, notamment le titre de l'événement, le lieu, l' Start/End heure et la date, la liste des invités et les détails de l'événement. AppFabric peut générer du contenu dans ces champs pour vous aider à réduire le temps nécessaire à l'exécution de la tâche. Une fois que vous avez terminé de modifier l'événement du calendrier, choisissez **Créer** pour créer l'événement.
Les champs suivants sont obligatoires pour créer un événement de calendrier :
+ Champs de titre, de début, de fin et de description.
+ L'heure et la date de début ne doivent pas être antérieures à l'heure et la date de fin.
+ Le champ d'invitation est facultatif, mais nécessite des adresses e-mail valides si elles sont fournies.
![\[Calendar event creation form with title, time, location, invitees, and description fields.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-14.png)
Une fois l'événement du calendrier envoyé, vous verrez une confirmation indiquant que l'événement a été créé. De plus, vous verrez un lien permettant de consulter l'événement dans l'application désignée. Vous pouvez utiliser ce lien pour accéder rapidement à l'application et vérifier que l'événement a été créé.
![\[Calendar event creation confirmation with event details and option to view in Google Calendar.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-15.png)
### Créer des tâches (Asana)
AppFabric vous permet de modifier et de créer une tâche Asana depuis votre application préférée. Nous prenons en charge les champs de tâches de base tels que le nom de la tâche, le propriétaire de la tâche, la date d'échéance et la description de la tâche. AppFabric peut générer du contenu dans ces champs afin de vous aider à réduire le temps de création de la tâche. Une fois que vous avez terminé de modifier la tâche, choisissez **Créer** pour créer la tâche. Les tâches sont créées dans l'Asanaespace de travail, le projet ou la tâche applicable, comme suggéré par le LLM.
Les champs suivants sont obligatoires pour créer une Asana tâche :
+ Champs de titre et de description.
+ L'adresse e-mail du destinataire doit être valide en cas de modification.
![\[Create Task form with fields for title, assignee, due date, and description for a finance meeting task.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-16.png)
Une fois la tâche créée, vous verrez une confirmation indiquant qu'elle a été créée dansAsana. En outre, vous verrez un lien permettant d'afficher la tâcheAsana. Vous pouvez utiliser ce lien pour accéder rapidement à l'application afin de vérifier que la tâche a été créée, ou pour la déplacer vers l'Asanaespace de travail, le projet ou la tâche appropriés.
![\[Task creation confirmation with details and a link to view in Asana.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-17.png)
### Créer des tâches (Smartsheet)
AppFabric vous permet de modifier et de créer une tâche Smartsheet depuis votre application préférée. Nous prenons en charge les champs de tâches de base tels que le nom de la tâche, le propriétaire de la tâche, la date d'échéance et la description de la tâche. AppFabric peut générer du contenu dans ces champs afin de vous aider à réduire le temps de création de la tâche. Une fois que vous avez terminé de modifier la tâche, choisissez **Créer** pour créer la tâche. Pour les Smartsheet tâches, AppFabric créera une nouvelle Smartsheet feuille privée et renseignera toutes les tâches créées. Cela permet de centraliser les actions AppFabric générées en un seul endroit de manière structurée.
Les champs suivants sont obligatoires pour créer une Smartsheet tâche :
+ Champs de titre et de description.
+ L'adresse e-mail du destinataire doit être valide si elle est fournie.
![\[Create Task form with fields for title, assignees, due date, and description for an AWS AppFabric Action.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-18.png)
Une fois la tâche créée, vous verrez une confirmation indiquant qu'elle a été créée dansSmartsheet. En outre, vous verrez un lien permettant d'afficher la tâcheSmartsheet. Vous pouvez utiliser ce lien pour accéder rapidement à l'application afin d'afficher la tâche dans la Smartsheet feuille créée. Toutes les Smartsheet tâches futures seront renseignées dans cette feuille. Si la feuille est supprimée, AppFabric il en créera une nouvelle.
![\[AWS AppFabric Action interface showing a successfully created task with details.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-19.png)
# Gérez l'accès AppFabric aux fonctionnalités de productivité (version préliminaire) destinées aux administrateurs informatiques et de sécurité
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Le portail utilisateur AppFabric pour la productivité est accessible au public à tous les utilisateurs d'applications SaaS qui ont intégré AppFabric les fonctionnalités de productivité (version préliminaire). Si vous êtes un administrateur informatique qui souhaite gérer l'accès à ces fonctionnalités d'IA générative au sein de votre organisation, envisagez les options suivantes :
+ Restreindre la connexion au fournisseur d'identité (IdP) : vous pouvez bloquer l'accès à la connexion via votre fournisseur d'identité pour contrôler l'accès des utilisateurs aux fonctionnalités génératives de l'IA.
+ Désactiver OAuth pour des applications spécifiques : implémentez les restrictions en aval en les OAuth désactivant. Cette action empêche les utilisateurs de connecter les applications nécessitant une OAuth authentification à l'espace de travail de l'entreprise.
# Résoudre les erreurs des utilisateurs finaux AppFabric pour améliorer la productivité
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Cette section décrit les erreurs courantes et les solutions de résolution des problèmes liés AppFabric à la productivité.
## Candidature non vérifiée
Les applications dont AppFabric la productivité permet d'enrichir leur expérience applicative seront soumises à un processus de vérification avant de lancer leurs fonctionnalités aux utilisateurs finaux. Si vous voyez apparaître une bannière « non vérifiée » lorsque vous essayez de vous connecter AppFabric, cela signifie que l'application n'a pas été soumise au processus AppFabric de vérification qui confirme l'identité du développeur de l'application et l'exactitude des informations d'enregistrement de l'application. Toutes les applications commencent comme non vérifiées et ne deviennent vérifiées que lorsque le processus de vérification est terminé.
Soyez prudent lorsque vous utilisez une application non vérifiée. Si vous n'êtes pas sûr des développeurs de l'application, vous pouvez attendre que l'application atteigne le statut vérifié avant de continuer.
![\[Warning message for an unverified application in AWS AppFabric, advising caution before authorization.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-20.png)
## Quelque chose s'est mal passé. Veuillez réessayer ou vérifier auprès de votre administrateur (`InternalServerException`)
Ce message peut s'afficher lorsque le portail AppFabric utilisateur ne répertorie pas les applications ou déconnecte une application en raison d'une erreur, d'une exception ou d'un échec inconnu. Réessayez ultérieurement.
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-23.png)
## La demande a été refusée suite à une limitation des demandes. Veuillez réessayer dans quelques temps (`ThrottlingException`)
Ce message peut s'afficher lorsque le portail AppFabric utilisateur ne répertorie pas les applications ou déconnecte une application en raison d'un problème de régulation. Réessayez ultérieurement.
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-22.png)
## Vous n'êtes pas autorisé à utiliser AppFabric. Veuillez vous AppFabric reconnecter (`AccessDeniedException`)
Ce message peut s'afficher lorsque le portail AppFabric utilisateur ne répertorie pas les applications ou déconnecte une application en raison d'une exception de refus d'accès. Connectez-vous à AppFabric nouveau à.
![\[Connect applications interface showing connected and unconnected apps with action buttons.\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/images/fabric-21.png)
# AppFabric pour la productivité APIs (version préliminaire)
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Cette section fournit les opérations d'API, les types de données et les erreurs courantes pour les fonctionnalités de AWS AppFabric productivité.
**Note**
Pour tous les autres AppFabric APIs, consultez la [référence de AWS AppFabric l'API](https://docs.aws.amazon.com/appfabric/latest/api/).
**Topics**
+ [Actions d'API AppFabric pour améliorer la productivité (version préliminaire)](productivity-actions.md)
+ [Types de données d'API AppFabric pour la productivité (version préliminaire)](productivity-data-types.md)
+ [Erreurs d'API courantes AppFabric pour la productivité (version préliminaire)](productivity-common-errors.md)
# Actions d'API AppFabric pour améliorer la productivité (version préliminaire)
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Les actions suivantes sont prises en charge AppFabric pour les fonctionnalités de productivité.
Pour toutes les autres actions d' AppFabric API, consultez les [actions AWS AppFabric d'API](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html).
**Topics**
+ [Autoriser](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)
+ [Jeton](API_Token.md)
+ [UpdateAppClient](API_UpdateAppClient.md)
# Autoriser
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Autorise un AppClient.
**Topics**
+ [Corps de la demande](#API_Authorize_request)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **ID du client de l'application** | L'ID du AppClient à autoriser. |
| **redirect\$1uri** | L'URI vers lequel rediriger les utilisateurs finaux après autorisation. |
| **state** | Une valeur unique pour maintenir l'état entre la demande et le rappel. |
# CreateAppClient
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Crée un AppClient.
**Topics**
+ [Corps de la demande](#API_CreateAppClient_request)
+ [Éléments de réponse](#API_CreateAppClient_response)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **Nom de l'application** | Nom de l'application. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255 caractères. Obligatoire : oui |
| **ClientToken** | Spécifie un identifiant unique distinguant majuscules et minuscules que vous fournissez pour garantir l'idempuissance de la demande. Cela vous permet de réessayer la demande en toute sécurité sans effectuer accidentellement la même opération une deuxième fois. Pour transmettre la même valeur à un appel ultérieur à une opération, vous devez également transmettre la même valeur pour tous les autres paramètres. Nous vous recommandons d'utiliser une valeur de [type UUID](https://wikipedia.org/wiki/Universally_unique_identifier). Si vous ne fournissez pas cette valeur, il en AWS génère une au hasard pour vous. Si vous réessayez l'opération avec les mêmes paramètres`ClientToken`, mais avec des paramètres différents, la nouvelle tentative échoue avec une `IdempotentParameterMismatch` erreur. Type : Chaîne Modèle : `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obligatoire : non |
| **customerManagedKeyIdentifiant** | L'ARN du clé gérée par le client produit généré par AWS Key Management Service. La clé est utilisée pour chiffrer les données. Si aucune clé n'est spécifiée, une Clé gérée par AWS est utilisée. Carte des paires clé-valeur de la balise ou des balises à attribuer à la ressource. 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](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) dans le *guide du AWS Key Management Service développeur*. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1011. Modèle : `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obligatoire : non |
| **description** | Description de l'application. Type : Chaîne Obligatoire : oui |
| **URL de l'icône** | URL de l'icône ou du logo du AppClient. Type : chaîne Obligatoire : non |
| **URL de redirection** | L'URI vers lequel rediriger les utilisateurs finaux après autorisation. Vous pouvez ajouter jusqu'à 5 URL de redirection. Par exemple, `https://localhost:8080`. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 2048. Modèle : `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` Obligatoire : oui |
| **starterUserEmails** | Adresses e-mail de démarrage pour les utilisateurs autorisés à recevoir des informations jusqu'à ce qu'elles soient vérifiées. AppClient Type : tableau de chaînes Membres du tableau : nombre fixe de 1 élément. Contraintes de longueur : longueur minimale de 0. Longueur maximale de 320 Modèle : `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` Obligatoire : oui |
| **tags** | Carte des paires clé-valeur de la balise ou des balises à attribuer à la ressource. Type : Tableau d'objets Tag Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non |
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 201.
Les données suivantes sont renvoyées au format JSON par le service.
| Paramètre | Description |
| --- | --- |
| **appClientSummary** | Contient un résumé du AppClient. Type : objet [AppClientSummary](API_AppClientSummary.md) |
# DeleteAppClient
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Supprime un client d'application.
**Topics**
+ [Corps de la demande](#API_DeleteAppClient_request)
+ [Éléments de réponse](#API_DeleteAppClient_response)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **appClientIdentifier** | Le nom de ressource Amazon (ARN) ou l'identifiant unique universel (UUID) AppClient à utiliser pour la demande. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1011. Modèle : `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obligatoire : oui |
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.
# GetAppClient
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Renvoie des informations sur un AppClient.
**Topics**
+ [Corps de la demande](#API_GetAppClient_request)
+ [Éléments de réponse](#API_GetAppClient_response)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **appClientIdentifier** | Le nom de ressource Amazon (ARN) ou l'identifiant unique universel (UUID) AppClient à utiliser pour la demande. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1011. Modèle : `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obligatoire : oui |
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
| Paramètre | Description |
| --- | --- |
| **Client de l'application** | Contient des informations sur un AppClient. Type : objet [AppClient](API_AppClient.md) |
# ListActionableInsights
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Répertorie les messages électroniques, les tâches et les autres mises à jour exploitables les plus importants.
**Topics**
+ [Corps de la demande](#API_ListActionableInsights_request)
+ [Éléments de réponse](#API_ListActionableInsights_response)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **nextToken** | S'il `nextToken` est renvoyé, d'autres résultats sont disponibles. La valeur de `nextToken` est un jeton de pagination unique pour chaque page. Effectuez l'appel à nouveau en utilisant le jeton renvoyé pour récupérer la page suivante. Gardez tous les autres arguments inchangés. Chaque jeton de pagination expire au bout de 24 heures. L'utilisation d'un jeton de pagination expiré renverra une * InvalidToken erreur HTTP 400*. |
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 201.
Les données suivantes sont renvoyées au format JSON par le service.
| Paramètre | Description |
| --- | --- |
| **ActionableInsightsList** | Répertorie les informations exploitables, y compris le titre, la description, les actions et l'horodatage créé. Pour de plus amples informations, veuillez consulter [ActionableInsights](API_ActionableInsights.md). |
| **nextToken** | S'il `nextToken` est renvoyé, d'autres résultats sont disponibles. La valeur de `nextToken` est un jeton de pagination unique pour chaque page. Effectuez l'appel à nouveau en utilisant le jeton renvoyé pour récupérer la page suivante. Gardez tous les autres arguments inchangés. Chaque jeton de pagination expire au bout de 24 heures. L'utilisation d'un jeton de pagination expiré renverra une * InvalidToken erreur HTTP 400*. Type : Chaîne |
# ListAppClients
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Renvoie une liste de tous les éléments AppClients.
**Topics**
+ [Corps de la demande](#API_ListAppClients_request)
+ [Éléments de réponse](#API_ListAppClients_response)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **maxResults** | Le nombre maximum de résultats renvoyés par appel. Vous pouvez l'utiliser `nextToken` pour obtenir d'autres pages de résultats. Il ne s'agit que d'une limite supérieure. Le nombre réel de résultats renvoyés par appel peut être inférieur au maximum spécifié. Plage valide : valeur minimum de 1. Valeur maximale fixée à 100. |
| **nextToken** | S'il `nextToken` est renvoyé, d'autres résultats sont disponibles. La valeur de `nextToken` est un jeton de pagination unique pour chaque page. Effectuez l'appel à nouveau en utilisant le jeton renvoyé pour récupérer la page suivante. Gardez tous les autres arguments inchangés. Chaque jeton de pagination expire au bout de 24 heures. L'utilisation d'un jeton de pagination expiré renverra une * InvalidToken erreur HTTP 400*. |
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
| Paramètre | Description |
| --- | --- |
| **appClientList** | Contient une liste de AppClient résultats. Type : tableau d’objets [AppClientSummary](API_AppClientSummary.md) |
| **nextToken** | S'il `nextToken` est renvoyé, d'autres résultats sont disponibles. La valeur de `nextToken` est un jeton de pagination unique pour chaque page. Effectuez l'appel à nouveau en utilisant le jeton renvoyé pour récupérer la page suivante. Gardez tous les autres arguments inchangés. Chaque jeton de pagination expire au bout de 24 heures. L'utilisation d'un jeton de pagination expiré renverra une * InvalidToken erreur HTTP 400*. Type : Chaîne |
# ListMeetingInsights
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Répertorie les événements du calendrier actionnables les plus importants.
**Topics**
+ [Corps de la demande](#API_ListMeetingInsights_request)
+ [Éléments de réponse](#API_ListMeetingInsights_response)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **nextToken** | S'il `nextToken` est renvoyé, d'autres résultats sont disponibles. La valeur de `nextToken` est un jeton de pagination unique pour chaque page. Effectuez l'appel à nouveau en utilisant le jeton renvoyé pour récupérer la page suivante. Gardez tous les autres arguments inchangés. Chaque jeton de pagination expire au bout de 24 heures. L'utilisation d'un jeton de pagination expiré renverra une * InvalidToken erreur HTTP 400*. |
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 201.
Les données suivantes sont renvoyées au format JSON par le service.
| Paramètre | Description |
| --- | --- |
| **MeetingInsightList** | Répertorie les informations exploitables sur les réunions. Pour de plus amples informations, veuillez consulter [MeetingInsights](API_MeetingInsights.md). |
| **nextToken** | S'il `nextToken` est renvoyé, d'autres résultats sont disponibles. La valeur de `nextToken` est un jeton de pagination unique pour chaque page. Effectuez l'appel à nouveau en utilisant le jeton renvoyé pour récupérer la page suivante. Gardez tous les autres arguments inchangés. Chaque jeton de pagination expire au bout de 24 heures. L'utilisation d'un jeton de pagination expiré renverra une * InvalidToken erreur HTTP 400*. Type : Chaîne |
# PutFeedback
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Permet aux utilisateurs de soumettre des commentaires pour une idée ou une action donnée.
**Topics**
+ [Corps de la demande](#API_PutFeedback_request)
+ [Éléments de réponse](#API_PutFeedback_response)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **id** | ID de l'objet pour lequel le commentaire est envoyé. Cela peut être le InsightId ou le ActionId. |
| **Feedback pour** | Type d'aperçu pour lequel le commentaire est soumis. Valeurs possibles : `ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION` |
| **Évaluation des commentaires** | Évaluation des commentaires de `1` à`5`. Plus la note est élevée, mieux c'est. |
## Éléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 201 avec un corps HTTP vide.
# Jeton
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Contient des informations permettant d' AppClients échanger un code d'autorisation contre un jeton d'accès.
**Topics**
+ [Corps de la demande](#API_Token_request)
+ [Éléments de réponse](#API_Token_response)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **code** | Le code d'autorisation reçu du point de terminaison d'autorisation. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048. Obligatoire : non |
| **type de subvention** | Type de subvention pour le jeton. Doit être `authorization_code` ou `refresh_token`. Type : Chaîne Obligatoire : oui |
| **ID du client de l'application** | ID du AppClient. Type : Chaîne Modèle : `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obligatoire : oui |
| **redirect\$1uri** | L'URI de redirection transmis au point de terminaison d'autorisation. Type : chaîne Obligatoire : non |
| **jeton de rafraîchissement** | Le jeton d'actualisation reçu suite à la demande de jeton initiale. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 4096. Obligatoire : non |
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
| Paramètre | Description |
| --- | --- |
| **ID utilisateur d'appfabric\$1** | L'ID de l'utilisateur pour le jeton. Ceci n'est renvoyé que pour les demandes utilisant le type de `authorization_code` subvention. Type : Chaîne |
| **expirer\$1in** | Le nombre de secondes avant l'expiration du jeton. Type : Long |
| **jeton de rafraîchissement** | Le jeton d'actualisation à utiliser pour une demande ultérieure. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048. |
| ****token | Le jeton d'accès. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048. |
| **type\$1jeton** | Le type de jeton. Type : Chaîne |
# UpdateAppClient
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Met à jour un AppClient.
**Topics**
+ [Corps de la demande](#API_UpdateAppClient_request)
+ [Éléments de réponse](#API_UpdateAppClient_response)
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
| Paramètre | Description |
| --- | --- |
| **appClientIdentifier** | Le nom de ressource Amazon (ARN) ou l'identifiant unique universel (UUID) AppClient à utiliser pour la demande. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1011. Modèle : `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obligatoire : oui |
| **URL de redirection** | L'URI vers lequel rediriger les utilisateurs finaux après autorisation. Vous pouvez ajouter jusqu'à 5 URL de redirection. Par exemple, `https://localhost:8080`. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 2048. Modèle : `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` |
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
| Paramètre | Description |
| --- | --- |
| **Client de l'application** | Contient des informations sur un AppClient. Type : objet [AppClient](API_AppClient.md) |
# Types de données d'API AppFabric pour la productivité (version préliminaire)
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
L' AppFabric API contient plusieurs types de données utilisés par diverses actions. Cette section décrit en détail les types de données AppFabric pour les fonctionnalités de productivité.
Pour tous les autres types de données d' AppFabric API, consultez les [types de données d'AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/API_Types.html).
**Important**
L'ordre de chaque élément dans une structure de type de données n'est pas garanti. Les candidatures ne doivent pas être soumises à un ordre particulier.
**Topics**
+ [ActionableInsights](API_ActionableInsights.md)
+ [AppClient](API_AppClient.md)
+ [AppClientSummary](API_AppClientSummary.md)
+ [MeetingInsights](API_MeetingInsights.md)
+ [VerificationDetails](API_VerificationDetails.md)
# ActionableInsights
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Contient un résumé des actions importantes et appropriées pour un utilisateur en fonction des e-mails, des invitations du calendrier, des messages et des tâches de son portefeuille d'applications. Les utilisateurs peuvent consulter des informations proactives provenant de l'ensemble de leurs applications pour les aider à mieux orienter leur journée. Ces informations justifient pourquoi un utilisateur doit s'intéresser au résumé des informations, ainsi que des références, telles que des liens intégrés, aux applications individuelles et aux artefacts qui ont généré les informations.
| Paramètre | Description |
| --- | --- |
| **ID d'Insight** | L'identifiant unique de l'aperçu généré. |
| **Contenu Insight** | 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. Il s'agirait d'un contenu HTML contenant des liens intégrés (``balises). |
| **Titre d'Insight** | Titre de l'aperçu généré. |
| **Créé à CreatedAt** | Quand l'aperçu a été généré. |
| **actions** | Une liste d'actions recommandées pour les informations générées. L'objet action contient les paramètres suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/API_ActionableInsights.html) |
# AppClient
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Contient des informations sur un AppClient.
**Topics**
| Paramètre | Description |
| --- | --- |
| **Nom de l'application** | Nom de l'application. Type : Chaîne Obligatoire : oui |
| **arn** | Amazon Resource Name (ARN) du AppClient. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1011. Modèle : `arn:.+` Obligatoire : oui |
| **description** | Description de l'application. Type : Chaîne Obligatoire : oui |
| **URL de l'icône** | URL de l'icône ou du logo du AppClient. Type : chaîne Obligatoire : non |
| **URL de redirection** | La redirection autorisée URLs pour AppClient. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 2048. Modèle : `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` Obligatoire : oui |
| **starterUserEmails** | Adresses e-mail de démarrage pour les utilisateurs autorisés à recevoir des informations jusqu'à ce qu'elles soient vérifiées. AppClient Type : tableau de chaînes Membres du tableau : nombre fixe de 1 élément. Contraintes de longueur : longueur minimale de 0. Longueur maximale de 320 Modèle : `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` Obligatoire : oui |
| **Détails de vérification** | Contient le statut et le motif de la AppClient vérification. Type : objet [VerificationDetails](API_VerificationDetails.md) Obligatoire : oui |
| **customerManagedKeyArn** | Le nom de ressource Amazon (ARN) du fichier clé gérée par le client généré par AWS Key Management Service pour le AppClient. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1011. Modèle : `arn:.+` Obligatoire : non |
| **appClientId** | ID du AppClient. Destiné à être utilisé dans les flux o-auth pour le client d'application. Type : Chaîne Modèle : `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obligatoire : non |
# AppClientSummary
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Contient des informations sur un AppClient.
**Topics**
| Paramètre | Description |
| --- | --- |
| **arn** | Amazon Resource Name (ARN) du AppClient. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1011. Modèle : `arn:.+` Obligatoire : oui |
| **État de la vérification** | État AppClient de la vérification. Type : Chaîne Valeurs valides : `pending_verification \| verified \| rejected` Obligatoire : oui |
| **appClientId** | ID du AppClient. Destiné à être utilisé dans les flux o-auth pour le client d'application. Type : Chaîne Modèle : `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obligatoire : non |
# MeetingInsights
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Contient un résumé des 3 principales réunions ainsi que l'objectif de la réunion, les artefacts inter-applications associés et les activités liées aux tâches, aux e-mails, aux messages et aux événements du calendrier.
| Paramètre | Description |
| --- | --- |
| **ID d'Insight** | L'identifiant unique de l'aperçu généré. |
| **Contenu Insight** | Description de l'aperçu mettant en évidence les détails sous forme de chaîne. Par exemple, pourquoi cette information est-elle importante ? |
| **Titre d'Insight** | Titre de l'aperçu généré. |
| **Créé à CreatedAt** | Quand l'aperçu a été généré. |
| **Évènement du calendrier** | Événement ou réunion important du calendrier sur lequel l'utilisateur doit se concentrer. Objet de l'événement du calendrier : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **resources** | La liste contenant les autres ressources liées à la génération de l'aperçu. Objet de ressource : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **nextToken** | 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. |
# VerificationDetails
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Contient le statut et le motif de la AppClient vérification.
**Topics**
| Paramètre | Description |
| --- | --- |
| **État de la vérification** | État AppClient de la vérification. Type : Chaîne Valeurs valides : `pending_verification \| verified \| rejected` Obligatoire : oui |
| **Motif du statut** | La raison du statut de AppClient vérification. Type : Chaîne Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 1024. Obligatoire : non |
# Erreurs d'API courantes AppFabric pour la productivité (version préliminaire)
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
Cette section répertorie les erreurs communes aux actions d'API relatives aux fonctionnalités de AWS AppFabric productivité.
Pour toutes les autres erreurs d'API AppFabric courantes, consultez [Résoudre les problèmes AppFabric pour AppClients améliorer la productivité](ahead-app-dev-errors.md) la section « [Erreurs courantes d'AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html) » dans la *référence des AWS AppFabric API*.
| Nom de l'exception | Description |
| --- | --- |
| **TokenException** | La demande de jeton n'est pas valide. Code d’état HTTP : 400 |
# Traitement des données dans AppFabric
| |
| --- |
| La fonctionnalité AWS AppFabric de productivité est en cours d'aperçu et est sujette à modification. |
AppFabric prend des mesures pour stocker le contenu utilisateur individuellement, dans un compartiment Amazon S3 géré par et séparément AppFabric, ce qui nous permet de générer des informations spécifiques aux utilisateurs. Nous utilisons des mesures de protection raisonnables pour protéger votre contenu, notamment le chiffrement au repos et en transit. Nous avons configuré nos systèmes pour supprimer automatiquement le contenu client dans les 30 jours suivant son ingestion. AppFabric ne génère pas d'informations à l'aide d'artefacts de données auxquels l'utilisateur n'a plus accès. Par exemple, lorsqu'un utilisateur déconnecte une source de données (une application), AppFabric arrête de collecter des données depuis cette application et n'utilise aucun artefact persistant provenant des applications déconnectées pour générer des informations. AppFabricLes systèmes sont configurés pour supprimer ces données dans un délai de 30 jours.
AppFabric n'utilise pas le contenu utilisateur pour entraîner ou améliorer les grands modèles linguistiques sous-jacents utilisés pour générer des informations. Pour plus d'informations sur AppFabric la fonctionnalité d'IA générative, consultez [Amazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/).
## Chiffrement au repos
AWS AppFabric prend en charge le chiffrement au repos, une fonctionnalité de chiffrement côté serveur qui chiffre de AppFabric manière transparente toutes les données relatives aux utilisateurs lorsqu'elles sont conservées sur le disque, et les déchiffre lorsque vous accédez aux données.
## Chiffrement en transit
AppFabric sécurise tout le contenu en transit à l'aide de TLS 1.2 et signe les demandes d'API pour les AWS services avec AWS Signature Version 4.