Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# A cosa serve AWS AppFabric la produttività?
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
**Nota**
[Realizzato da Amazon Bedrock: AWS implementa il rilevamento automatico degli abusi.](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) Poiché AWS AppFabric la produttività si basa su Amazon Bedrock, gli utenti ereditano i controlli implementati in Amazon Bedrock per rafforzare la sicurezza e l'uso responsabile dell'intelligenza artificiale.
AWS AppFabric for productivity (preview) aiuta a reimmaginare la produttività degli utenti finali nelle applicazioni di terze parti generando informazioni e azioni contestualizzate da più applicazioni. Gli sviluppatori di app riconoscono che l'accesso ai dati degli utenti da altre app è importante per creare un'esperienza più produttiva, ma non vogliono creare e gestire integrazioni con ogni applicazione. AppFabric Per la produttività, gli sviluppatori di applicazioni hanno accesso a sistemi di intelligenza artificiale generativa APIs che generano informazioni e azioni sui dati tra le app in modo da fornire esperienze più complete agli utenti finali attraverso assistenti di intelligenza artificiale generativi nuovi o esistenti. AppFabric for productivity integra i dati provenienti da più applicazioni, eliminando la necessità per gli sviluppatori di creare o mantenere integrazioni. point-to-point Gli sviluppatori di applicazioni possono integrare AppFabric la produttività direttamente nell'interfaccia utente dell'applicazione, mantenendo un'esperienza coerente per gli utenti finali e facendo emergere il contesto pertinente da altre applicazioni.
AppFabric for productivity collega i dati provenienti da applicazioni di uso comune comeAsana,,Atlassian Jira Suite,Google Workspace,Microsoft 365, Miro SlackSmartsheet, e altro ancora. AppFabric for productivity offre agli sviluppatori di app un modo più semplice per creare esperienze di app più personalizzate che migliorino l'adozione, la soddisfazione e la fidelizzazione degli utenti. Nel frattempo, gli utenti finali traggono vantaggio dall'accesso alle informazioni di cui hanno bisogno da tutte le loro applicazioni senza interrompere il flusso di lavoro.
**Topics**
+ [Vantaggi](#benefits)
+ [Casi d’uso](#use-cases)
+ [Accesso AppFabric per la produttività](#acessing-appfabric)
+ [Guida introduttiva AppFabric alla produttività (anteprima) per gli sviluppatori di applicazioni](getting-started-appdeveloper-productivity.md)
+ [Guida introduttiva alla AppFabric produttività (anteprima) per gli utenti finali](getting-started-users-productivity.md)
+ [AppFabric per la produttività APIs (anteprima)](productivity-apis.md)
+ [Elaborazione dei dati in AppFabric](productivity-data-processing.md)
## Vantaggi
Grazie a AppFabric For Productivity, gli sviluppatori di applicazioni possono accedere a dati APIs che generano informazioni e azioni su più app, in modo da fornire esperienze più complete agli utenti finali attraverso assistenti di intelligenza artificiale generativi nuovi o esistenti.
+ **Un'unica fonte di dati utente tra app: AppFabric per la produttività integra i dati** di più applicazioni eliminando la necessità per gli sviluppatori di creare o mantenere integrazioni. point-to-point I dati delle app SaaS vengono elaborati per essere utilizzati in altre applicazioni normalizzando automaticamente diversi tipi di dati in un formato comprensibile da qualsiasi applicazione, consentendo agli sviluppatori di app di incorporare più dati che migliorano effettivamente la produttività degli utenti finali.
+ **Controllo completo dell'esperienza utente**: gli sviluppatori AppFabric integrano la produttività direttamente nell'interfaccia utente delle loro applicazioni, mantenendo il pieno controllo dell'esperienza utente e fornendo al contempo approfondimenti personalizzati e azioni consigliate agli utenti finali con il contesto di tutte le applicazioni. Ciò rende AppFabric la produttività disponibile nell'applicazione SaaS preferita dagli utenti finali ed è accessibile nell'app che preferiscono per completare le proprie attività. Gli utenti finali dedicano meno tempo a passare da un'app all'altra e possono rimanere concentrati sul flusso del proprio lavoro.
+ **Accelera il time-to-market**: con una singola chiamata API, gli sviluppatori di app possono ricevere informazioni a livello di utente sui dati generati dall'utente senza dover mettere a punto un modello, scrivere un prompt personalizzato o creare integrazioni tra più applicazioni. AppFabric astrae questa complessità per consentire agli sviluppatori di app di creare, incorporare o arricchire più rapidamente le funzionalità di intelligenza artificiale generativa. Ciò consente agli sviluppatori di app di concentrarsi sulle proprie risorse per le attività più importanti.
+ **Riferimenti agli artefatti per creare la fiducia degli utenti**: come parte dell'output AppFabric , per motivi di produttività, verranno evidenziati gli artefatti o i file sorgente pertinenti utilizzati per generare le informazioni necessarie per creare la fiducia dell'utente finale negli output LLM.
+ **Autorizzazioni utente semplificate**: gli artefatti utente utilizzati per generare approfondimenti si basano su ciò a cui l'utente ha accesso. AppFabric per la produttività utilizza l'autorizzazione e il controllo degli accessi di un ISV come fonte di verità.
## Casi d’uso
Gli sviluppatori di app possono utilizzare For Productivity AppFabric per reimmaginare la produttività all'interno delle loro applicazioni. AppFabric for productivity ne offre due APIs incentrate sui seguenti casi d'uso per aiutare gli utenti finali a essere più produttivi:
+ Dai priorità alla tua giornata
+ L'API Actionable Insights aiuta gli utenti a gestire al meglio la loro giornata facendo emergere informazioni tempestive da tutte le loro applicazioni, tra cui e-mail, calendario, messaggi, attività e altro ancora. Inoltre, gli utenti possono eseguire azioni tra app come la creazione di e-mail, la pianificazione di riunioni e la creazione di azioni dalla loro applicazione preferita. Ad esempio, un dipendente che ha avuto un problema con i clienti durante la notte non solo vedrà un riepilogo delle conversazioni avvenute durante la notte, ma potrà anche visualizzare le azioni consigliate per pianificare un incontro con l'Account Manager del cliente. Le azioni sono precompilate con campi obbligatori (ad esempio nome e proprietario dell'attività o mittente/destinatario dell'e-mail), con la possibilità di modificare il contenuto precompilato prima di eseguire l'azione.
+ Preparati per le prossime riunioni
+ L'API per la preparazione delle riunioni aiuta gli utenti a prepararsi al meglio per le riunioni riassumendo lo scopo della riunione e facendo emergere gli elementi pertinenti tra le app come e-mail, messaggi e altro. Gli utenti possono prepararsi rapidamente per le riunioni ora e non perdere tempo a passare da un'app all'altra per trovare contenuti.
## Accesso AppFabric per la produttività
AppFabric for productivity è attualmente lanciato in anteprima e disponibile negli Stati Uniti orientali (Virginia settentrionale) Regione AWS. Per ulteriori informazioni su Regioni AWS, consulta [AWS AppFabric endpoint e quote](https://docs.aws.amazon.com/general/latest/gr/appfabric.html) in. *Riferimenti generali di AWS*
In ogni regione, puoi accedere AppFabric alla produttività in uno dei seguenti modi:
+ In qualità di sviluppatore di app
+ [Guida introduttiva AppFabric alla produttività (anteprima) per gli sviluppatori di applicazioni](getting-started-appdeveloper-productivity.md)
+ Come utente finale
+ [Guida introduttiva alla AppFabric produttività (anteprima) per gli utenti finali](getting-started-users-productivity.md)
# Guida introduttiva AppFabric alla produttività (anteprima) per gli sviluppatori di applicazioni
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Questa sezione aiuta gli sviluppatori di app a integrarsi AWS AppFabric per la produttività (anteprima) nelle loro applicazioni. AWS AppFabric for productivity consente agli sviluppatori di creare esperienze di app più complete per i propri utenti generando informazioni e azioni basate sull'intelligenza artificiale da e-mail, eventi del calendario, attività, messaggi e altro ancora su più applicazioni. [Per un elenco delle applicazioni supportate, consulta AWS AppFabric Applicazioni supportate.](https://aws.amazon.com/appfabric/supported-applications/)
AppFabric for productivity offre agli sviluppatori di app la possibilità di creare e sperimentare in un ambiente sicuro e controllato. Quando inizi a utilizzare AppFabric for productivity per la prima volta, crei AppClient e registri un singolo utente di test. Questo approccio è progettato per aiutarti a comprendere e testare il flusso di autenticazione e comunicazione tra l'applicazione e AppFabric. Dopo aver eseguito il test con un singolo utente, puoi inviare la tua applicazione AppFabric per la verifica prima di espandere l'accesso ad altri utenti (vedi[Fase 5. Richiedi AppFabric di verificare la tua candidatura](#request_verification)). AppFabric verificherà le informazioni sulle applicazioni prima di consentirne l'adozione su larga scala per proteggere gli sviluppatori di app, gli utenti finali e i relativi dati, aprendo la strada a un'espansione dell'adozione da parte degli utenti in modo responsabile.
**Topics**
+ [Prerequisiti](#getting-started-prerequisites)
+ [Passaggio 1. Crea un piano AppFabric per la produttività AppClient](#create_appclient)
+ [Passaggio 2. Autentica e autorizza la tua applicazione](#authorize_data_access)
+ [Fase 3. Aggiungi l'URL del portale AppFabric utente alla tua applicazione](#end_user_portal)
+ [Passaggio 4. Utilizzalo AppFabric per far emergere informazioni e azioni tra app](#surface_insights_actions)
+ [Fase 5. Richiedi AppFabric di verificare la tua candidatura](#request_verification)
+ [Gestisci AppFabric per la produttività AppClients](manage-appclients.md)
+ [Risolvi i problemi per la AppClients produttività AppFabric](ahead-app-dev-errors.md)
## Prerequisiti
Prima di iniziare, devi creare un Account AWS. Per ulteriori informazioni, consulta [Registrati per un Account AWS](prerequisites.md#sign-up-for-aws). È inoltre necessario creare almeno un utente con accesso alla policy `"appfabric:CreateAppClient"` IAM elencata di seguito, che consente all'utente di registrare l'applicazione con AppFabric. Per ulteriori informazioni sulla concessione delle autorizzazioni per le funzionalità AppFabric per la produttività, consulta. [AppFabric per la produttività, esempi di policy IAM](security_iam_id-based-policy-examples.md#appfabric-for-productivity-policy-examples) Avere un utente amministrativo è vantaggioso, ma non è obbligatorio per la configurazione iniziale. Per ulteriori informazioni, consulta [Crea un utente con accesso amministrativo](prerequisites.md#create-an-admin).
AppFabric for productivity è disponibile solo negli Stati Uniti orientali (Virginia settentrionale) durante l'anteprima. Assicurati di trovarti in questa regione prima di iniziare i passaggi seguenti.
## Passaggio 1. Crea un piano AppFabric per la produttività AppClient
Prima di poter iniziare a raccogliere AppFabric informazioni sulla produttività all'interno della tua applicazione, devi creare un AppFabric AppClient. An AppClient è essenzialmente la porta di accesso AppFabric alla produttività, poiché funge da client OAuth applicativo sicuro che consente una comunicazione sicura tra l'applicazione e AppFabric. Quando ne crei uno AppClient, ti verrà fornito un AppClient ID, un identificatore univoco fondamentale per garantire che AppFabric sappia che funziona con la tua applicazione e con la tua Account AWS.
AppFabric for productivity offre agli sviluppatori di app la possibilità di creare e sperimentare in un ambiente sicuro e controllato. Quando inizi a utilizzare AppFabric for productivity per la prima volta, crei AppClient e registri un singolo utente di test. Questo approccio è progettato per aiutarti a comprendere e testare il flusso di autenticazione e comunicazione tra l'applicazione e AppFabric. Dopo aver eseguito il test con un singolo utente, puoi inviare la tua applicazione AppFabric per la verifica prima di espandere l'accesso ad altri utenti (vedi[Fase 5. Richiedi AppFabric di verificare la tua candidatura](#request_verification)). AppFabric verificherà le informazioni sulle applicazioni prima di consentirne l'adozione su larga scala per proteggere gli sviluppatori di app, gli utenti finali e i relativi dati, aprendo la strada a un'espansione dell'adozione da parte degli utenti in modo responsabile.
Per creare un AppClient, utilizza l'operazione AWS AppFabric `CreateAppClient` API. Se è necessario aggiornare il file AppClient after, è possibile utilizzare l'operazione `UpdateAppClient` API per modificare solo gli URL di reindirizzamento. Se devi modificare uno qualsiasi degli altri parametri associati al tuo, AppClient come AppName o description, devi eliminarli AppClient e crearne uno nuovo. Per ulteriori informazioni, consulta [CreateAppClient](API_CreateAppClient.md).
È possibile registrare l'applicazione con AWS i servizi utilizzando l'`CreateAppClient`API utilizzando diversi linguaggi di programmazione, tra cui Python, Node.js, Java, C\$1, Go e Rust. Per ulteriori informazioni, consulta [Request signature examples](https://docs.aws.amazon.com/IAM/latest/UserGuide/signature-v4-examples.html) nella *IAM User Guide*. È necessario utilizzare le credenziali della versione 4 della firma dell'account per eseguire questa operazione API. Per ulteriori informazioni sulla versione 4 della firma, consulta [Signing AWS API request](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.
**Campi di richiesta**
+ `appName`- Il nome dell'applicazione che verrà visualizzato agli utenti nella pagina di consenso del portale AppFabric utenti. La pagina di consenso richiede agli utenti finali l'autorizzazione a visualizzare AppFabric informazioni dettagliate all'interno dell'applicazione. Per i dettagli sulla pagina di consenso, consulta[Passaggio 2. Fornisci il consenso affinché l'app mostri approfondimenti](getting-started-users-productivity.md#provide-consent).
+ `description`- Una descrizione dell'applicazione.
+ `redirectUrls`- L'URI a cui reindirizzare gli utenti finali dopo l'autorizzazione. È possibile aggiungere fino a 5 URL di reindirizzamento. Ad esempio, `https://localhost:8080`.
+ `starterUserEmails`- Un indirizzo email utente a cui sarà consentito l'accesso per ricevere gli approfondimenti fino alla verifica dell'applicazione. È consentito un solo indirizzo e-mail. Ad esempio, `anyuser@example.com`
+ `customerManagedKeyIdentifier`(opzionale) - L'ARN della chiave gestita dal cliente (generata da KMS) da utilizzare per crittografare i dati. Se non specificato, verrà utilizzata la chiave AWS AppFabric gestita. Per ulteriori informazioni sulle chiavi Chiavi di proprietà di AWS gestite dal cliente, consulta [Customer keys and AWS keys](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) nella *AWS Key Management Service Developer Guide*.
**Campi di risposta**
+ `appClientArn`- L'Amazon Resource Name (ARN) che include l' AppClient ID. Ad esempio, l' AppClient ID è`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `verificationStatus`- Lo stato AppClient della verifica.
+ `pending_verification`- La verifica di AppClient è ancora in corso con AppFabric. Fino alla AppClient verifica, solo un utente (specificato in`starterUserEmails`) può utilizzare il AppClient. L'utente vedrà una notifica nel portale AppFabric utente, introdotta in[Fase 3. Aggiungi l'URL del portale AppFabric utente alla tua applicazione](#end_user_portal), che indica che l'applicazione non è verificata.
+ `verified`- Il processo di verifica è stato completato con successo AppFabric e ora AppClient è completamente verificato.
+ `rejected`- Il processo di verifica per AppClient è stato rifiutato da AppFabric. AppClient Non può essere utilizzato da altri utenti finché il processo di verifica non viene riavviato e completato con successo.
```
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/"
}'
```
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
```
{
"appClientConfigSummary": {
"appClientArn": "arn:aws:appfabric:::appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"verificationStatus": "pending_verification"
}
}
```
## Passaggio 2. Autentica e autorizza la tua applicazione
Consenti alla tua applicazione di integrare in modo sicuro gli AppFabric approfondimenti stabilendo un flusso di autorizzazione OAuth 2.0. Innanzitutto, è necessario creare un codice di autorizzazione che verifichi l'identità dell'applicazione. Per ulteriori informazioni, consulta [Autorizza](API_Authorize.md). Quindi scambierete questo codice di autorizzazione con un token di accesso, che concede all'applicazione le autorizzazioni per recuperare e visualizzare AppFabric informazioni all'interno dell'applicazione. Per ulteriori informazioni, consulta [Token](API_Token.md).
Per ulteriori informazioni sulla concessione dell'autorizzazione all'autorizzazione di un'applicazione, consulta. [Consenti l'accesso per autorizzare le applicazioni](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-token)
1. Per creare un codice di autorizzazione, utilizzate l'operazione AWS AppFabric `oauth2/authorize` API.
**Campi di richiesta**
+ `app_client_id`(obbligatorio): l' AppClient ID per il file Account AWS creato nel [passaggio 1. Crea un AppClient](#create_appclient). Ad esempio, `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `redirect_uri`(obbligatorio): l'URI a cui reindirizzare gli utenti finali dopo l'autorizzazione utilizzata nel [passaggio 1. Crea un AppClient](#create_appclient). Ad esempio, `https://localhost:8080`.
+ `state`(obbligatorio): un valore univoco per mantenere lo stato tra la richiesta e il callback. Ad esempio, `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. Dopo l'autenticazione, verrai reindirizzato all'URI specificato con un codice di autorizzazione restituito come parametro di query. Ad esempio, dove`code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`.
```
https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44
```
1. Scambia questo codice di autorizzazione con un token di accesso utilizzando l'operazione AppFabric `oauth2/token` API.
Questo token viene utilizzato per le richieste API ed è inizialmente valido `starterUserEmails` fino alla AppClient verifica. Dopo AppClient la verifica, questo token può essere utilizzato per qualsiasi utente. È necessario utilizzare le credenziali della versione 4 della firma dell'account per eseguire questa operazione API. Per ulteriori informazioni sulla versione 4 della firma, consulta [Signing AWS API request](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.
**Campi di richiesta**
+ `code`(obbligatorio) - Il codice di autorizzazione che hai ricevuto dopo l'autenticazione nell'ultimo passaggio. Ad esempio, `mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`.
+ `app_client_id`(obbligatorio) - L' AppClient ID per il file Account AWS creato nel [passaggio 1. Crea un AppClient](#create_appclient). Ad esempio, `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `grant_type`(obbligatorio): il valore deve essere`authorization_code`.
+ `redirect_uri`(obbligatorio): l'URI a cui reindirizzare gli utenti dopo l'autorizzazione utilizzata nel [passaggio 1. Crea un AppClient](#create_appclient). Deve essere lo stesso URI di reindirizzamento utilizzato per creare un codice di autorizzazione. Ad esempio, `https://localhost:8080`.
**Campi di risposta**
+ `expires_in`- Quanto tempo prima della scadenza del token. Il tempo di scadenza predefinito è di 12 ore.
+ `refresh_token`- Il token di aggiornamento ricevuto dalla richiesta iniziale /token.
+ `token`- Il token ricevuto dalla richiesta iniziale /token.
+ `token_type`- Il valore sarà`Bearer`.
+ `appfabric_user_id`- L'id AppFabric utente. Viene restituito solo per le richieste che utilizzano il tipo di `authorization_code` concessione.
```
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\"
}"
```
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
```
{
"expires_in": 43200,
"refresh_token": "apkaeibaerjr2example",
"token": "apkaeibaerjr2example",
"token_type": "Bearer",
"appfabric_user_id" : ""
}
```
## Fase 3. Aggiungi l'URL del portale AppFabric utente alla tua applicazione
Gli utenti finali devono autorizzarsi AppFabric ad accedere ai dati delle loro applicazioni che vengono utilizzati per generare approfondimenti. AppFabric elimina la complessità per gli sviluppatori di app di gestire questo processo creando un portale utente dedicato (una schermata pop-up) per consentire agli utenti finali di autorizzare le proprie app. Quando gli utenti saranno pronti a dare AppFabric impulso alla produttività, verranno indirizzati al portale utenti che consente loro di connettersi e gestire le applicazioni utilizzate per generare approfondimenti e azioni tra app. Una volta effettuato l'accesso, gli utenti possono connettere le applicazioni a AppFabric per aumentare la produttività e poi tornare all'applicazione per esplorare le informazioni e le azioni da intraprendere. Per integrare l'applicazione con AppFabric una maggiore produttività, è necessario aggiungere un AppFabric URL specifico all'applicazione. Questo passaggio è fondamentale per consentire agli utenti di accedere al portale AppFabric utenti direttamente dall'applicazione.
1. Accedi alle impostazioni dell'applicazione e individua la sezione per aggiungere il reindirizzamento URLs.
1. Dopo aver trovato l'area appropriata, aggiungi il seguente AppFabric URL come URL di reindirizzamento all'applicazione:
```
https://userportal.appfabric..amazonaws.com/eup_login
```
Dopo aver aggiunto l'URL, l'applicazione verrà configurata per indirizzare gli utenti al portale AppFabric utenti. Qui, gli utenti possono accedere, connettersi e gestire le applicazioni utilizzate AppFabric per generare informazioni sulla produttività.
## Passaggio 4. Utilizzalo AppFabric per far emergere informazioni e azioni tra app
Dopo che gli utenti hanno collegato le loro applicazioni, puoi utilizzare le informazioni acquisite dagli utenti per migliorarne la produttività riducendo il cambio di app e contesto. AppFabric genera informazioni dettagliate per un utente solo in base a ciò a cui l'utente è autorizzato a accedere. AppFabric archivia i dati dell'utente in un Account AWS file di proprietà di AppFabric. Per informazioni su come vengono AppFabric utilizzati i tuoi dati, consulta[Elaborazione dei dati in AppFabric](productivity-data-processing.md).
Puoi utilizzare i seguenti strumenti basati sull'intelligenza artificiale APIs per generare e far emergere informazioni e azioni a livello di utente all'interno delle tue app:
+ `ListActionableInsights`— Per ulteriori informazioni, consulta la sezione [Actionable](#productivity-actionable-insights) Insights di seguito.
+ `ListMeetingInsights`— Per ulteriori informazioni, consulta la sezione [Preparazione delle riunioni](#productivity-meeting-insights) più avanti in questa guida.
### Informazioni utilizzabili () `ListActionableInsights`
L'`ListActionableInsights`API aiuta gli utenti a gestire al meglio la loro giornata facendo emergere informazioni fruibili basate sulle attività delle loro applicazioni, tra cui e-mail, calendario, messaggi, attività e altro ancora. Gli approfondimenti restituiti mostreranno anche collegamenti incorporati agli artefatti utilizzati per generare le informazioni, aiutando gli utenti a visualizzare rapidamente quali dati sono stati utilizzati per generare le informazioni. Inoltre, l'API può restituire azioni suggerite in base alle informazioni e consentire agli utenti di eseguire azioni tra app dall'interno dell'applicazione. In particolare, l'API si integra con piattaforme come AsanaGoogle Workspace,Microsoft 365, e consente Smartsheet agli utenti di inviare e-mail, creare eventi di calendario e creare attività. I modelli di linguaggio di grandi dimensioni (LLMs) possono precompilare i dettagli relativi a un'azione consigliata (come il corpo dell'e-mail o il nome dell'attività), che gli utenti possono personalizzare prima dell'esecuzione, semplificando il processo decisionale e migliorando la produttività. Analogamente all'esperienza degli utenti finali per l'autorizzazione delle applicazioni, AppFabric utilizza lo stesso portale dedicato per consentire agli utenti di visualizzare, modificare ed eseguire azioni tra app. Per eseguire azioni, è AppFabric necessario ISVs reindirizzare gli utenti a un portale AppFabric utenti in cui possono visualizzare i dettagli delle azioni ed eseguirle. Ogni azione generata da AppFabric ha un URL univoco. Questo URL è disponibile nella risposta della risposta dell'`ListActionableInsights`API.
Di seguito è riportato un riepilogo delle azioni supportate tra app e in quali app:
+ Invia e-mail (Google Workspace,Microsoft 365)
+ Crea un evento del calendario (Google Workspace,Microsoft 365)
+ Crea attività (Asana,Smartsheet)
**Campi di richiesta**
+ `nextToken`(opzionale) - Il token di impaginazione per recuperare il prossimo set di approfondimenti.
+ `includeActionExecutionStatus`- Un filtro che accetta l'elenco degli stati di esecuzione delle azioni. Le azioni vengono filtrate in base ai valori di stato trasmessi. Valori possibili: `NOT_EXECUTED` \$1 `EXECUTED`
**Intestazione della richiesta**
+ L'intestazione di autorizzazione deve essere passata con il `Bearer Token ` valore.
**Campi di risposta**
+ `insightId`- L'ID univoco per l'analisi generata.
+ `insightContent`- Ciò restituisce un riepilogo dell'analisi e dei collegamenti incorporati agli artefatti utilizzati per generare l'analisi. Nota: si tratterebbe di un contenuto HTML contenente link incorporati (tag).
+ `insightTitle`- Il titolo dell'intuizione generata.
+ `createdAt`- Quando è stata generata l'intuizione.
+ `actions`- Un elenco di azioni consigliate per l'analisi generata. Oggetto d'azione:
+ `actionId`- L'id univoco per l'azione generata.
+ `actionIconUrl`- L'URL dell'icona dell'app in cui si suggerisce di eseguire l'azione.
+ `actionTitle`- Il titolo dell'azione generata.
+ `actionUrl`- L'URL univoco per l'utente finale per visualizzare ed eseguire l'azione nel AppFabric portale utenti. Nota: per l'esecuzione di azioni, le app ISV reindirizzeranno gli utenti al portale AppFabric utenti (schermata pop-up) utilizzando questo URL.
+ `actionExecutionStatus`- Un enum che indica lo stato dell'azione. I valori possibili sono: \$1 `EXECUTED` `NOT_EXECUTED`
+ `nextToken`(opzionale) - Il token di impaginazione per recuperare il prossimo set di approfondimenti. È un campo opzionale che, se restituito nullo, significa che non ci sono più approfondimenti da caricare.
Per ulteriori informazioni, consulta [ActionableInsights](API_ActionableInsights.md).
```
curl -v --location \
"https://productivity.appfabric..amazonaws.com"\
"/actionableInsights" \
--header "Authorization: Bearer "
```
Se l'operazione riesce, il servizio restituisce una risposta 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
}
```
### Preparazione della riunione () `ListMeetingInsights`
L'`ListMeetingInsights`API aiuta gli utenti a prepararsi al meglio per le riunioni imminenti riassumendo lo scopo della riunione e facendo emergere elementi pertinenti trasversali alle app come e-mail, messaggi e altro. Gli utenti possono prepararsi rapidamente per le riunioni ora e non perdere tempo a passare da un'app all'altra per trovare contenuti.
**Campi di richiesta**
+ `nextToken`(opzionale) - Il token di impaginazione per recuperare il prossimo set di approfondimenti.
**Intestazione della richiesta**
+ L'intestazione di autorizzazione deve essere passata con il `Bearer Token` valore.
**Campi di risposta**
+ `insightId`- L'ID univoco per l'analisi generata.
+ `insightContent`- La descrizione dell'intuizione che evidenzia i dettagli in formato stringa. Ad esempio, perché questa intuizione è importante.
+ `insightTitle`- Il titolo dell'intuizione generata.
+ `createdAt`- Quando è stata generata l'intuizione.
+ `calendarEvent`- L'evento o la riunione importante del calendario su cui l'utente dovrebbe concentrarsi. Oggetto Calendar Event:
+ `startTime`- L'ora di inizio dell'evento.
+ `endTime`- L'ora di fine dell'evento.
+ `eventUrl`- L'URL dell'evento del calendario sull'app ISV.
+ `resources`- L'elenco contenente le altre risorse relative alla generazione dell'analisi. Oggetto risorsa:
+ `appName`- Il nome dell'app a cui appartiene la risorsa.
+ `resourceTitle`- Il titolo della risorsa.
+ `resourceType`- Il tipo di risorsa. I valori possibili sono: `EMAIL` \$1 `EVENT` \$1 `MESSAGE` \$1 `TASK`
+ `resourceUrl`- L'URL della risorsa nell'app.
+ `appIconUrl`- L'URL dell'immagine dell'app a cui appartiene la risorsa.
+ `nextToken`(opzionale) - Il token di impaginazione per recuperare il prossimo set di approfondimenti. È un campo opzionale che, se restituito nullo, significa che non ci sono più approfondimenti da caricare.
Per ulteriori informazioni, consulta [MeetingInsights](API_MeetingInsights.md).
```
curl --location \
"https://productivity.appfabric..amazonaws.com"\
"/meetingContexts" \
--header "Authorization: Bearer "
```
Se l'operazione riesce, il servizio restituisce una risposta 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
}
```
### Fornisci feedback per le tue intuizioni o le tue azioni
Utilizza il funzionamento dell' AppFabric `PutFeedback`API per fornire feedback sugli approfondimenti e sulle azioni generati. Puoi incorporare questa funzionalità nelle tue app per fornire un modo per inviare una valutazione di feedback (da 1 a 5, dove maggiore è la valutazione, migliore è) per un determinato InsightId o ActionId.
**Campi di richiesta**
+ `id`- L'identificatore dell'oggetto per il quale viene inviato il feedback. Può essere il InsightId o il ActionId.
+ `feedbackFor`- Il tipo di risorsa per cui viene inviato il feedback. Valori possibili: `ACTIONABLE_INSIGHT` \$1 `MEETING_INSIGHT` \$1 `ACTION`
+ `feedbackRating`- Valutazione del feedback da `1` a`5`. Un punteggio più alto è, meglio è.
**Campi di risposta**
+ Non ci sono campi di risposta.
Per ulteriori informazioni, consulta [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
}'
```
Se l'operazione riesce, il servizio invia una risposta HTTP 201 con un corpo HTTP vuoto.
## Fase 5. Richiedi AppFabric di verificare la tua candidatura
A questo punto, hai aggiornato l'interfaccia utente dell'applicazione per incorporare informazioni e azioni AppFabric tra app e hai ricevuto informazioni dettagliate per un singolo utente. Dopo esserti soddisfatto dei test e aver voluto estendere la tua esperienza AppFabric arricchita ad altri utenti, puoi inviare la tua candidatura AppFabric per la revisione e la verifica. AppFabric verificherà le informazioni sulle applicazioni prima di consentirne l'adozione su larga scala per proteggere gli sviluppatori di app, gli utenti finali e i relativi dati, aprendo la strada a un'espansione dell'adozione da parte degli utenti in modo responsabile.
**Avvia il processo di verifica**
Inizia il processo di verifica inviando un'email a [appfabric-appverification@amazon.com](mailto:appfabric-appverification@amazon.com) e richiedendo che la tua app venga verificata.
Includi i seguenti dettagli nella tua email:
+ Il tuo Account AWS ID
+ Il nome dell'applicazione per cui richiedi la verifica
+ Il tuo AppClient ID
+ Le tue informazioni di contatto
Inoltre, fornisci le seguenti informazioni, se disponibili, per aiutarci a valutare la priorità e l'impatto:
+ Numero stimato di utenti a cui intendi concedere l'accesso
+ La data di lancio prevista
**Nota**
Se hai un Account AWS manager o un responsabile dello sviluppo dei AWS partner, copiali nella tua email. L'inclusione di questi contatti può aiutare a velocizzare il processo di verifica.
**Criteri di verifica**
Prima di iniziare il processo di verifica, devi soddisfare i seguenti criteri:
+ È necessario utilizzare un valore valido Account AWS per AppFabric la produttività
Inoltre, soddisfi almeno uno di questi criteri:
+ La tua organizzazione è un AWS partner AWS Partner Network con almeno un livello «AWS Select». Per ulteriori informazioni, consulta [AWS Partner Services Tiers.](https://aws.amazon.com/partners/services-tiers/)
+ La tua organizzazione avrebbe dovuto spendere almeno 10.000 dollari in AppFabric servizi negli ultimi tre anni.
+ La tua candidatura deve essere elencata nel Marketplace AWS. Per ulteriori informazioni, consulta il [AWS Marketplace](https://aws.amazon.com/marketplace).
**Attendi l'aggiornamento dello stato della verifica**
Dopo aver esaminato la tua richiesta, risponderemo via e-mail e lo stato della tua richiesta AppClient cambierà da `pending_verification` a`verified`. Se la tua richiesta viene rifiutata, dovrai riavviare la procedura di verifica.
# Gestisci AppFabric per la produttività AppClients
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
È possibile gestire la produttività AppFabric per AppClients garantire il funzionamento e la manutenzione senza intoppi dei processi di autenticazione e autorizzazione.
## Ottieni i dettagli di un AppClient
Utilizza il funzionamento dell' AppFabric `GetAppClient`API per visualizzare i dettagli del tuo AppClient, incluso il controllo dello AppClient stato. Per ulteriori informazioni, consulta [GetAppClient](API_GetAppClient.md).
Per ottenere i dettagli di un AppClient, devi disporre almeno delle autorizzazioni della policy `"appfabric:GetAppClient"` IAM. Per ulteriori informazioni, consulta [Consenti l'accesso per ottenere i dettagli di AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-get-appclient).
**Campi di richiesta**
+ `appClientId`- L' AppClient ID.
**Campi di risposta**
+ `appName`- Il nome dell'applicazione che verrà visualizzato agli utenti nella pagina di consenso del portale AppFabric utenti.
+ `customerManagedKeyIdentifier`(opzionale) - L'ARN della chiave gestita dal cliente (generata da KMS) da utilizzare per crittografare i dati. Se non specificato, verrà utilizzata la chiave AWS AppFabric gestita.
+ `description`- Una descrizione dell'applicazione.
+ `redirectUrls`- L'URI a cui reindirizzare gli utenti finali dopo l'autorizzazione. È possibile aggiungere fino a 5 URL di reindirizzamento. Ad esempio, `https://localhost:8080`.
+ `starterUserEmails`- Un indirizzo email utente a cui sarà consentito l'accesso per ricevere gli approfondimenti fino alla verifica dell'applicazione. È consentito un solo indirizzo e-mail. Ad esempio, `anyuser@example.com`.
+ `verificationStatus`- Lo stato AppClient della verifica.
+ `pending_verification`- La verifica di AppClient è ancora in corso con AppFabric. Fino alla AppClient verifica, solo un utente (specificato in`starterUserEmails`) può utilizzare il AppClient.
+ `verified`- Il processo di verifica è stato completato con successo AppFabric e ora AppClient è completamente verificato.
+ `rejected`- Il processo di verifica per AppClient è stato rifiutato da AppFabric. AppClient Non può essere utilizzato da altri utenti finché il processo di verifica non viene riavviato e completato con successo.
```
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
```
Se l'operazione riesce, il servizio restituisce una risposta 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"
}
}
}
```
## Elenco AppClients
Usa l'operazione AppFabric `ListAppClients` API per visualizzare un elenco dei tuoi AppClients. AppFabric ne consente solo uno AppClient per Account AWS. Questo è soggetto a modifiche in futuro. Per ulteriori informazioni, consulta [ListAppClients](API_ListAppClients.md).
Per poter elencare AppClients, è necessario disporre almeno delle autorizzazioni relative alla policy `"appfabric:ListAppClients"` IAM. Per ulteriori informazioni, consulta [Consenti l'accesso all'elenco AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-list-appclient).
**Campi di richiesta**
+ Non ci sono campi obbligatori.
**Campi di risposta**
+ `appClientARN`- L'Amazon Resource Name (ARN) che include l' AppClient ID. Ad esempio, l' AppClient ID è`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `verificationStatus`- Lo stato AppClient della verifica.
+ `pending_verification`- La verifica di AppClient è ancora in corso con AppFabric. Fino alla AppClient verifica, solo un utente (specificato in`starterUserEmails`) può utilizzare il AppClient.
+ `verified`- Il processo di verifica è stato completato con successo AppFabric e ora AppClient è completamente verificato.
+ `rejected`- Il processo di verifica per AppClient è stato rifiutato da AppFabric. AppClient Non può essere utilizzato da altri utenti finché il processo di verifica non viene riavviato e completato con successo.
```
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
```
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
```
200 OK
{
"appClientList": [
{
"appClientArn": "arn:aws:appfabric::111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"verificationStatus": "pending_verification"
}
]
}
```
## Aggiorna un AppClient
Utilizza l'operazione AppFabric `UpdateAppClient` API per aggiornare gli URL di reindirizzamento mappati al tuo. AppClient Se è necessario modificare altri parametri, ad esempio, o altro AppName starterUserEmails, è necessario eliminarli AppClient e crearne uno nuovo. Per ulteriori informazioni, consulta [UpdateAppClient](API_UpdateAppClient.md).
Per aggiornare un AppClient, è necessario disporre almeno delle autorizzazioni della policy `"appfabric:UpdateAppClient"` IAM. Per ulteriori informazioni, consulta [Consenti l'accesso all'aggiornamento AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient).
**Campi di richiesta**
+ `appClientId`(obbligatorio): l' AppClient ID con cui stai aggiornando gli URL di reindirizzamento.
+ `redirectUrls`(obbligatorio): l'elenco aggiornato dei redirectURL. Puoi aggiungere fino a 5 redirectURL.
**Campi di risposta**
+ `appName`- Il nome dell'applicazione che verrà visualizzato agli utenti nella pagina di consenso del portale AppFabric utenti.
+ `customerManagedKeyIdentifier`(opzionale) - L'ARN della chiave gestita dal cliente (generata da KMS) da utilizzare per crittografare i dati. Se non specificato, verrà utilizzata la chiave AWS AppFabric gestita.
+ `description`- Una descrizione dell'applicazione.
+ `redirectUrls`- L'URI a cui reindirizzare gli utenti finali dopo l'autorizzazione. Ad esempio, `https://localhost:8080`.
+ `starterUserEmails`- Un indirizzo e-mail utente a cui sarà consentito l'accesso per ricevere gli approfondimenti fino alla verifica dell'applicazione. È consentito un solo indirizzo e-mail. Ad esempio, `anyuser@example.com`.
+ `verificationStatus`- Lo stato AppClient della verifica.
+ `pending_verification`- La verifica di AppClient è ancora in corso con AppFabric. Fino alla AppClient verifica, solo un utente (specificato in`starterUserEmails`) può utilizzare il AppClient.
+ `verified`- Il processo di verifica è stato completato con successo AppFabric e ora AppClient è completamente verificato.
+ `rejected`- Il processo di verifica per AppClient è stato rifiutato da AppFabric. AppClient Non può essere utilizzato da altri utenti finché il processo di verifica non viene riavviato e completato con successo.
```
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"]
}'
```
Se l'operazione riesce, il servizio restituisce una risposta 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"
}
}
}
```
## Eliminare un AppClient
Usa l'operazione AppFabric `DeleteAppClient` API per eliminare quelli AppClients che non ti servono più. Per ulteriori informazioni, consulta [DeleteAppClient](API_DeleteAppClient.md).
Per eliminare un AppClient, devi disporre almeno delle autorizzazioni della policy `"appfabric:DeleteAppClient"` IAM. Per ulteriori informazioni, consulta [Consenti l'accesso per l'eliminazione AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-delete-appclient).
**Campi di richiesta**
+ `appClientId`- L' AppClient ID.
**Campi di risposta**
+ Non ci sono campi di risposta.
```
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
```
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Token di aggiornamento per gli utenti finali
I token AppClient acquisiti per gli utenti finali possono essere aggiornati alla scadenza. Questo può essere fatto utilizzando l'[Token](API_Token.md)API con grant\$1type. `refresh_token` L'oggetto `refresh_token` da utilizzare viene restituito come parte della risposta dell'API del token quando grant\$1type è. `authorization_code` Le scadenze predefinite sono 12 ore. Per chiamare l'API di aggiornamento, devi disporre dell'autorizzazione della `"appfabric:Token"` policy IAM. Per ulteriori informazioni, consultare [Token](API_Token.md) e [Consenti l'accesso all'aggiornamento AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient).
**Campi di richiesta**
+ `refresh_token`(obbligatorio): il token di aggiornamento ricevuto dalla `/token` richiesta iniziale.
+ `app_client_id`(obbligatorio) - L'ID della AppClient risorsa creata per. Account AWS
+ `grant_type`(obbligatorio) - Deve essere`refresh_token`.
**Campi di risposta**
+ `expires_in`- Quanto tempo prima della scadenza del token. Il tempo di scadenza predefinito è di 12 ore.
+ `refresh_token`- Il token di aggiornamento ricevuto dalla richiesta iniziale /token.
+ `token`- Il token ricevuto dalla richiesta iniziale /token.
+ `token_type`- Il valore sarà`Bearer`.
+ `appfabric_user_id`- L'id AppFabric utente. Viene restituito solo per le richieste che utilizzano il tipo di `authorization_code` concessione.
```
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\"
}"
```
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
```
200 OK
{
"expires_in": 43200,
"token": "apkaeibaerjr2example",
"token_type": "Bearer",
"appfabric_user_id" : "${UserID}"
}
```
# Risolvi i problemi per la AppClients produttività AppFabric
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Questa sezione descrive gli errori comuni e la risoluzione dei problemi relativi AppFabric alla produttività.
## Applicazione non verificata
Gli sviluppatori di app che utilizzano AppFabric le app per la produttività per arricchire le proprie esperienze con le app passeranno attraverso un processo di verifica prima di lanciare le funzionalità agli utenti finali. Tutte le applicazioni iniziano come non verificate e passano a verificate solo quando il processo di verifica è completo. Ciò significa che il file che `starterUserEmails` hai usato durante la creazione AppClient vedrà questo messaggio.
![\[Warning message for an unverified application in AWS AppFabric, requesting data access.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-24.png)
## Errori `CreateAppClient`
### ServiceQuotaExceededException
Se ricevi la seguente eccezione durante la creazione di un AppClient, significa che hai superato il numero di eccezioni AppClients che puoi creare per Account AWS. Il limite è 1. Codice di stato 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
```
## Errori `GetAppClient`
### ResourceNotFoundException
Se ricevi la seguente eccezione quando ricevi i dettagli di un AppClient, assicurati di aver inserito l' AppClient identificatore corretto. Questo errore indica che l'oggetto specificato non AppClient è stato trovato.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Errori `DeleteAppClient`
### ConflictException
Se si riceve la seguente eccezione quando si elimina un AppClient, è in corso un'altra richiesta di eliminazione. Attendi il completamento, quindi riprova. Codice di stato HTTP: 409
```
ConflictException
Another delete request is in progress. Wait until it completes then try again.
HTTP Status Code: 409
```
### ResourceNotFoundException
Se ricevi la seguente eccezione quando elimini un AppClient, assicurati di aver inserito l'identificatore corretto AppClient . Questo errore indica che l'oggetto specificato non AppClient è stato trovato.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Errori `UpdateAppClient`
### ResourceNotFoundException
Se ricevi la seguente eccezione durante l'aggiornamento di un AppClient, assicurati di aver inserito l' AppClient identificatore corretto. Questo errore indica che l'oggetto specificato non AppClient è stato trovato.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Errori `Authorize`
### ValidationException
Potresti ricevere la seguente eccezione se uno qualsiasi dei parametri dell'API non soddisfa i vincoli definiti nelle specifiche dell'API.
```
ValidationException
HTTP Status Code: 400
```
**Motivo 1: quando l' AppClient ID non è specificato**
`app_client_id`Manca nei parametri della richiesta. Crea il AppClient file se non è ancora stato creato o usa quello esistente `app_client_id` e riprova. Per trovare l' AppClient ID, usa l'operazione [ListAppClient](manage-appclients.md#list_appclients)API.
**Motivo 2: AppFabric When non ha accesso alla chiave gestita dal cliente**
```
Message: AppFabric couldn't access the customer managed key configured for AppClient.
```
AppFabric al momento non è in grado di accedere alle chiavi gestite dal cliente, probabilmente a causa delle recenti modifiche alle sue autorizzazioni. Verifica che la chiave specificata esista e assicurati che AppFabric siano concesse le autorizzazioni di accesso appropriate.
**Motivo 3: l'URL di reindirizzamento specificato non è valido**
```
Message: Redirect url invalid
```
Assicurati che l'URL di reindirizzamento nella richiesta sia corretto. Deve corrispondere a uno dei reindirizzamenti URLs specificati al momento della creazione o dell'aggiornamento di. AppClient Per visualizzare l'elenco dei reindirizzamenti consentiti URLs, utilizza l'operazione [GetAppClient](manage-appclients.md#get_appclient_details)API.
## Errori `Token`
### TokenException
Potresti ricevere la seguente eccezione per alcuni motivi.
```
TokenException
HTTP Status Code: 400
```
**Motivo 1: quando viene specificata un'e-mail non valida**
```
Message: Invalid Email used
```
Assicurati che l'indirizzo email che stai utilizzando corrisponda a quello elencato per l'`starterUserEmails`attributo quando hai creato il AppClient. Se le email non corrispondono, passa all'indirizzo e-mail corrispondente e riprova. Per visualizzare l'e-mail utilizzata, utilizza l'operazione [GetAppClient](manage-appclients.md#get_appclient_details)API.
**Motivo 2: per grant\$1type come refresh\$1token quando il token non è specificato.**
```
Message: refresh_token must be non-null for Refresh Token Grant-type
```
Il token di aggiornamento specificato nella richiesta è nullo o vuoto. Specificare un valore attivo `refresh_token` ricevuto nella risposta alla chiamata dell'API [Token](getting-started-appdeveloper-productivity.md#authorize_data_access).
### ThrottlingException
Potresti ricevere la seguente eccezione se l'API viene chiamata a una frequenza superiore alla quota consentita.
```
ThrottlingException
HTTP Status Code: 429
```
## `ListActionableInsights``ListMeetingInsights`, ed `PutFeedback` errori
### ValidationException
Potresti ricevere la seguente eccezione se uno qualsiasi dei parametri dell'API non soddisfa il vincolo definito nelle specifiche dell'API.
```
ValidationException
HTTP Status Code: 400
```
### ThrottlingException
Potresti ricevere la seguente eccezione se l'API viene chiamata a una frequenza superiore alla quota consentita.
```
ThrottlingException
HTTP Status Code: 429
```
# Guida introduttiva alla AppFabric produttività (anteprima) per gli utenti finali
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Questa sezione è destinata agli utenti finali di applicazioni SaaS che desiderano abilitare la produttività (anteprima) AWS AppFabric per migliorare la gestione delle attività e l'efficienza del flusso di lavoro. Segui questi passaggi per connettere le tue applicazioni e autorizzarle AppFabric a far emergere informazioni trasversali tra app e aiutarti a completare azioni (come inviare un'e-mail o pianificare una riunione) dalle tue applicazioni preferite. Puoi connettere applicazioni comeAsana,,Atlassian Jira Suite,Google Workspace, Microsoft 365 Miro SlackSmartsheet, e altre ancora. Dopo aver autorizzato l'accesso AppFabric ai tuoi contenuti, AppFabric porta informazioni e azioni tra app direttamente all'interno delle tue app preferite, aiutandoti a lavorare in modo più efficiente e a rimanere all'interno dei flussi di lavoro correnti.
AppFabric per la produttività utilizza l'intelligenza artificiale generativa basata su Amazon Bedrock. AppFabric genererà informazioni e azioni solo dopo aver ricevuto la tua autorizzazione esplicita. Autorizzi ogni singola applicazione a mantenere il pieno controllo del contenuto utilizzato. AppFabric non utilizzerà i tuoi dati per addestrare o migliorare i modelli linguistici di grandi dimensioni sottostanti utilizzati per generare approfondimenti. Per ulteriori informazioni, consulta [Amazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/).
**Topics**
+ [Prerequisiti](#getting-started-prerequisites)
+ [Passaggio 1. Accedere a AppFabric](#sign-in-appfabric)
+ [Passaggio 2. Fornisci il consenso affinché l'app mostri approfondimenti](#provide-consent)
+ [Fase 3. Connect le tue applicazioni per generare informazioni e azioni](#connect-apps)
+ [Passaggio 4. Inizia a visualizzare informazioni dettagliate ed esegui azioni tra app nella tua applicazione](#insights_in_app)
+ [Gestisci l'accesso alle AppFabric funzionalità di produttività (anteprima) per gli amministratori IT e di sicurezza](productivity-end-users-managing-access.md)
+ [Risolvi gli errori degli utenti finali in AppFabric termini di produttività](productivity-end-users-errors.md)
## Prerequisiti
Prima di iniziare, assicurati di avere quanto segue:
+ Credenziali di accesso AppFabric: per iniziare a utilizzarle AppFabric per la produttività, sono necessarie credenziali di accesso federate (nome utente e password) per uno dei seguenti provider:Asana,, Google Workspace o. Microsoft 365 Slack L'accesso ci AppFabric consente di identificarti come utente in ogni applicazione abilitata per la produttività. AppFabric Dopo aver effettuato l'accesso, puoi connettere le tue applicazioni per iniziare a generare approfondimenti.
+ Credenziali per connettere le tue applicazioni: le informazioni e le azioni tra app vengono generate solo in base alle applicazioni che autorizzi. Avrai bisogno delle credenziali di accesso (nome utente e password) per ciascuna delle applicazioni che desideri autorizzare. Le applicazioni supportate includonoAsana,Atlassian Jira Suite,Google Workspace, Microsoft 365Miro, Slack e. Smartsheet
## Passaggio 1. Accedere a AppFabric
Connect le applicazioni AppFabric per portare contenuti e approfondimenti direttamente all'interno delle applicazioni preferite.
1. Ogni applicazione verrà utilizzata AppFabric per la produttività in modi diversi per offrirti esperienze di app più ricche. Per questo motivo, ogni applicazione avrà un punto di accesso diverso AppFabric per accedere alla home page dedicata alla produttività riportata di seguito. La home page specifica il processo da abilitare AppFabric e richiede innanzitutto di effettuare l'accesso. Ogni applicazione che desideri abilitare accederà AppFabric a questa schermata.
![\[Sign-in prompt for AWS AppFabric, highlighting AI-powered productivity features.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-01.png)
1. Accedi con le tue credenziali di uno di questi provider:Asana, Google WorkspaceMicrosoft 365, oSlack. Per un'esperienza ottimale, ti consigliamo di accedere utilizzando lo stesso provider per ogni applicazione abilitata. AppFabric Ad esempio, se scegli le credenziali di Google Workspace in App1, ti consigliamo di Google Workspace sceglierle in App2 e ogni altra volta che devi effettuare nuovamente l'accesso. Se accedi con un altro provider, dovrai riavviare il processo di connessione delle applicazioni.
![\[AWS AppFabric sign-in page with options for Slack, Microsoft, Google, and Asana.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-02.png)
1. Se richiesto, inserisci le tue credenziali di accesso e accetta l'accesso AppFabric da questo provider.
![\[Slack sign-in page with options for Google, Apple, or email authentication.\]](http://docs.aws.amazon.com/it_it/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/it_it/appfabric/latest/adminguide/images/fabric-04.png)
## Passaggio 2. Fornisci il consenso affinché l'app mostri approfondimenti
Dopo l'accesso, AppFabric verrà visualizzata una pagina di consenso che ti chiederà se consenti di AppFabric visualizzare informazioni e azioni tra app all'interno dell'applicazione in cui stai abilitando AppFabric la produttività. Ad esempio, consenti di AppFabric prendere Google Workspace le tue e-mail e gli eventi del calendario e visualizzarli. Asana Devi completare questa fase di consenso solo una volta per applicazione AppFabric in cui abiliti.
![\[Dialog box requesting permission to display insights and artifacts within an application.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-05.png)
## Fase 3. Connect le tue applicazioni per generare informazioni e azioni
Dopo aver completato la pagina di consenso, verrai indirizzato alla pagina **Connect applications** dove puoi connettere, disconnettere o ricollegare singole applicazioni che vengono utilizzate in ultima analisi per generare informazioni e azioni tra app. Nella maggior parte dei casi, dopo aver effettuato l'accesso e fornito il consenso, continuerai a utilizzare questa pagina per gestire le applicazioni connesse.
Per connettere un'applicazione, scegli il pulsante **Connetti** accanto a qualsiasi applicazione che usi.
![\[List of applications to connect, including Smartsheet, Slack, and Google Workspace, all showing as not connected.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-06.png)
Dovrai fornire le tue credenziali di accesso per l'applicazione e consentire l' AppFabricautorizzazione ad accedere ai tuoi dati per generare approfondimenti e completare azioni.
![\[Dialog box requesting permission for AWS AppFabric to access Slack workspace data.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-07.png)
Dopo aver collegato correttamente un'applicazione, lo stato dell'applicazione cambierà da «Non connessa» a «Connessa». Promemoria: è necessario completare questa fase di autorizzazione per ogni applicazione che si desidera utilizzare per generare informazioni e azioni.
Dopo aver connesso un'applicazione, questa non è connessa per sempre. Dovrai riconnettere periodicamente le applicazioni. Lo facciamo per assicurarci di avere ancora la tua autorizzazione a generare approfondimenti.
I possibili stati dell'applicazione sono:
+ Connesso: AppFabric è autorizzato e genera approfondimenti utilizzando i dati dell'utente provenienti da questa applicazione.
+ Non connesso: AppFabric non genera approfondimenti utilizzando i dati di questa applicazione. Puoi connetterti per iniziare a generare approfondimenti.
+ Autorizzazione fallita. Riconnettiti. - Potrebbe esserci un errore di autorizzazione con un'applicazione specifica. Se vedi questo errore, prova a ricollegare l'applicazione usando il pulsante **Connect**.
![\[Application connection status interface showing connected and unconnected apps.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-08.png)
La configurazione è completa e puoi tornare alla tua applicazione. Potrebbero essere necessarie almeno alcune ore per iniziare a visualizzare informazioni dettagliate all'interno delle applicazioni.
Se necessario, puoi tornare a questa pagina per gestire le applicazioni connesse. Se scegli di **disconnettere** un'applicazione, AppFabric smetterà di utilizzare i dati di quell'applicazione o di raccogliere nuovi dati per generare nuove informazioni. I dati delle applicazioni disconnesse verranno automaticamente eliminati entro 7 giorni se si sceglie di non ricollegare l'applicazione in quel lasso di tempo.
## Passaggio 4. Inizia a visualizzare informazioni dettagliate ed esegui azioni tra app nella tua applicazione
Dopo aver collegato le applicazioni AppFabric, avrai accesso a informazioni preziose e la possibilità di eseguire azioni tra app direttamente dalla tua applicazione preferita. Nota: questa funzionalità non è garantita in ogni app e dipende interamente dalle funzionalità AppFabric di produttività che lo sviluppatore dell'applicazione ha scelto di abilitare.
**Informazioni su più app**
AppFabric for productivity offre due tipi di approfondimenti:
+ Informazioni fruibili: AppFabric analizza le informazioni provenienti da e-mail, eventi del calendario, attività e messaggi tra le app connesse e genera informazioni chiave a cui potrebbe essere importante dare priorità. Inoltre, AppFabric può generare azioni consigliate (come inviare e-mail, pianificare riunioni e creare attività) che è possibile modificare ed eseguire rimanendo nella propria applicazione preferita. Ad esempio, potresti ricevere un messaggio che ti dice che c'è un'escalation di clienti da affrontare e ti suggeriamo un'azione successiva per pianificare un incontro con il cliente.
+ Informazioni sulla preparazione delle riunioni: questa funzione ti aiuta a prepararti al meglio per le riunioni imminenti. AppFabric analizzerà le riunioni imminenti e genererà un breve riepilogo dello scopo della riunione. Inoltre, mostrerà elementi pertinenti (come e-mail, messaggi e attività) dalle applicazioni connesse che saranno utili per prepararsi in modo efficiente alla riunione senza dover passare da un'app all'altra per trovare contenuti.
**Azioni tra app**
Per alcune informazioni, AppFabric può anche generare azioni consigliate come l'invio di un'e-mail, la pianificazione di una riunione o la creazione di un'attività. Durante la generazione di azioni, AppFabric può precompilare determinati campi in base al contenuto e al contesto delle applicazioni connesse. Ad esempio, AppFabric può generare una risposta e-mail suggerita o il nome dell'attività in base alle informazioni. Quando fai clic su un'azione suggerita, verrai indirizzato a un'interfaccia utente AppFabric proprietaria in cui puoi modificare il contenuto precompilato prima di eseguire l'azione. AppFabric non eseguirà azioni senza prima aver prima esaminato e inserito l'utente, poiché l'IA generativa e i modelli di linguaggio di grandi dimensioni (LLM) sottostanti possono avere allucinazioni di tanto in tanto.
**Nota**
Hai la responsabilità di convalidare e confermare gli output LLM. AppFabric AppFabric non garantisce l'accuratezza o la qualità delle sue uscite LLM. Per ulteriori informazioni, consulta la Politica sull'[IA AWS responsabile](https://aws.amazon.com/machine-learning/responsible-ai/policy/).
### Crea email (Google Workspace,Microsoft 365)
AppFabric consente di modificare e inviare un'e-mail dall'applicazione preferita. Supportiamo i campi e-mail di base, tra cui From, To, Cc/Bcc, Email Subject Line e Email Body Message. AppFabric può generare contenuti in questi campi per aiutarti a ridurre i tempi di completamento dell'attività. Dopo aver modificato l'e-mail, scegli **Invia** per inviare l'e-mail.
I seguenti campi sono obbligatori per inviare un'email:
+ Almeno uno dei messaggi di posta elettronica dei destinatari (To, CC e BCC) è obbligatorio e deve essere un indirizzo e-mail valido.
+ Riga dell'oggetto e campi del messaggio.
![\[Email form with From, To, CC, BCC, Subject line, and Message fields for sending.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-12.png)
Dopo l'invio dell'email, vedrai una conferma che l'email è stata inviata. Inoltre, vedrai un link per visualizzare l'e-mail nell'applicazione designata. Puoi utilizzare questo link per accedere rapidamente all'applicazione e verificare che l'e-mail sia stata inviata.
![\[Email sent confirmation with recipient details and message preview.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-13.png)
### Crea eventi del calendario (Google Workspace,Microsoft 365)
AppFabric consente di modificare e creare un evento del calendario dall'interno dell'applicazione preferita. Supportiamo i campi di base degli eventi del calendario, tra cui il titolo dell'evento, il luogo, l' Start/End ora e la data, l'elenco degli invitati e i dettagli dell'evento. AppFabric possiamo generare contenuti in questi campi per aiutarti a ridurre i tempi di completamento dell'attività. Dopo aver modificato l'evento del calendario, scegli **Crea** per creare l'evento.
I seguenti campi sono obbligatori per creare un evento del calendario:
+ Campi Titolo, Inizio, Fine e Descrizione.
+ L'ora e la data di inizio non devono essere precedenti all'ora e alla data di fine.
+ Il campo di invito è facoltativo, ma richiede indirizzi e-mail validi, se forniti.
![\[Calendar event creation form with title, time, location, invitees, and description fields.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-14.png)
Dopo l'invio dell'evento del calendario, vedrai una conferma che l'evento è stato creato. Inoltre, vedrai un link per visualizzare l'evento nell'applicazione designata. È possibile utilizzare questo collegamento per accedere rapidamente all'applicazione e verificare che l'evento sia stato creato.
![\[Calendar event creation confirmation with event details and option to view in Google Calendar.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-15.png)
### Crea attività (Asana)
AppFabric consente di modificare e creare un'attività Asana dall'interno dell'applicazione preferita. Supportiamo campi di attività di base come Nome dell'attività, Proprietario dell'attività, Data di scadenza e Descrizione dell'attività. AppFabric può generare contenuti in questi campi per aiutarti a ridurre i tempi di creazione dell'attività. Dopo aver modificato l'attività, scegli **Crea** per creare l'attività. Le attività vengono create nell'Asanaarea di lavoro o nel progetto o nell'attività applicabile, come suggerito dal LLM.
I seguenti campi sono obbligatori per creare un'Asanaattività:
+ Campi Titolo e Descrizione.
+ L'assegnatario deve avere un indirizzo e-mail valido se modificato.
![\[Create Task form with fields for title, assignee, due date, and description for a finance meeting task.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-16.png)
Dopo aver creato l'attività, vedrai una conferma che l'attività è stata creata in. Asana Inoltre, vedrai un link in cui visualizzare l'attivitàAsana. È possibile utilizzare questo collegamento per accedere rapidamente all'applicazione e verificare che l'attività sia stata creata o spostarla nell'Asanaarea di lavoro, nel progetto o nell'attività appropriati.
![\[Task creation confirmation with details and a link to view in Asana.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-17.png)
### Crea attività () Smartsheet
AppFabric consente di modificare e creare un'attività Smartsheet dall'interno dell'applicazione preferita. Supportiamo campi di attività di base come Nome dell'attività, Proprietario dell'attività, Data di scadenza e Descrizione dell'attività. AppFabric può generare contenuti in questi campi per aiutarti a ridurre i tempi di creazione dell'attività. Dopo aver modificato l'attività, scegli **Crea** per creare l'attività. Per Smartsheet le attività, AppFabric creerà un nuovo Smartsheet foglio privato e popolerà tutte le attività create. Questo viene fatto per aiutare a centralizzare le azioni AppFabric generate in un unico posto in modo strutturato.
I seguenti campi sono necessari per creare un'Smartsheetattività:
+ Campi Titolo e Descrizione.
+ L'assegnatario deve avere un indirizzo e-mail valido, se fornito.
![\[Create Task form with fields for title, assignees, due date, and description for an AWS AppFabric Action.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-18.png)
Dopo aver creato l'attività, vedrai una conferma che l'attività è stata creata in. Smartsheet Inoltre, vedrai un link in cui visualizzare l'attivitàSmartsheet. È possibile utilizzare questo collegamento per accedere rapidamente all'applicazione e visualizzare l'attività nel Smartsheet foglio creato. Tutte le Smartsheet attività future verranno inserite in questo foglio. Se il foglio viene eliminato, AppFabric ne creerà uno nuovo.
![\[AWS AppFabric Action interface showing a successfully created task with details.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-19.png)
# Gestisci l'accesso alle AppFabric funzionalità di produttività (anteprima) per gli amministratori IT e di sicurezza
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Il portale AppFabric per gli utenti di for productivity è accessibile pubblicamente a tutti gli utenti di applicazioni SaaS che hanno integrato le funzionalità di AppFabric for productivity (anteprima). Se sei un amministratore IT che desidera gestire l'accesso a queste funzionalità di intelligenza artificiale generativa all'interno della tua organizzazione, prendi in considerazione queste opzioni:
+ Limita l'accesso all'Identity Provider (IdP): puoi bloccare l'accesso tramite il tuo Identity Provider per controllare l'accesso degli utenti alle funzionalità di intelligenza artificiale generativa.
+ Disattiva OAuth per applicazioni specifiche: implementa le restrizioni a valle disabilitando. OAuth Questa azione impedisce agli utenti di connettere le applicazioni che richiedono OAuth l'autenticazione all'area di lavoro dell'azienda.
# Risolvi gli errori degli utenti finali in AppFabric termini di produttività
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Questa sezione descrive gli errori comuni e la risoluzione dei problemi relativi AppFabric alla produttività.
## Applicazione non verificata
Le applicazioni che utilizzano la produttività AppFabric per arricchire l'esperienza delle app verranno sottoposte a un processo di verifica prima di rilasciare le funzionalità agli utenti finali. Se compare un banner «non verificato» quando provi ad accedere AppFabric, significa che l'applicazione non è stata sottoposta AppFabric al processo di verifica che confermi l'identità dello sviluppatore dell'app e l'accuratezza delle informazioni di registrazione dell'applicazione. Tutte le applicazioni iniziano come non verificate e passano a verificate solo quando il processo di verifica è completo.
Fai attenzione quando usi un'applicazione non verificata. Se non sei sicuro degli sviluppatori dell'app, puoi attendere che l'applicazione raggiunga lo stato di verifica prima di procedere.
![\[Warning message for an unverified application in AWS AppFabric, advising caution before authorization.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-20.png)
## Qualcosa è andato storto. Riprova o verifica con il tuo amministratore (`InternalServerException`)
Potresti ricevere questo messaggio quando il portale AppFabric utente non riesce a elencare le applicazioni o disconnette un'applicazione a causa di un errore, un'eccezione o un errore sconosciuto. Riprova più tardi.
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-23.png)
## La richiesta è stata negata a causa del throttling della richiesta. Riprova tra qualche tempo () `ThrottlingException`
Potresti ricevere questo messaggio quando il portale AppFabric utente non riesce a elencare le applicazioni o disconnette un'applicazione a causa di un problema di limitazione. Riprova più tardi.
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-22.png)
## Non sei autorizzato a utilizzare. AppFabric Effettua AppFabric nuovamente il login a (`AccessDeniedException`)
Potresti ricevere questo messaggio quando il portale AppFabric utente non riesce a elencare le applicazioni o disconnette un'applicazione a causa di un'eccezione di accesso negato. Effettua AppFabric nuovamente l'accesso a.
![\[Connect applications interface showing connected and unconnected apps with action buttons.\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/images/fabric-21.png)
# AppFabric per la produttività APIs (anteprima)
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Questa sezione fornisce le operazioni dell'API, i tipi di dati e gli errori comuni per le funzionalità di AWS AppFabric produttività.
**Nota**
Per tutte le altre AppFabric APIs, consulta l'[AWS AppFabric API Reference](https://docs.aws.amazon.com/appfabric/latest/api/).
**Topics**
+ [Azioni API AppFabric per la produttività (anteprima)](productivity-actions.md)
+ [Tipi di dati API AppFabric per la produttività (anteprima)](productivity-data-types.md)
+ [Errori API comuni AppFabric per la produttività (anteprima)](productivity-common-errors.md)
# Azioni API AppFabric per la produttività (anteprima)
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Le seguenti azioni sono supportate AppFabric per le funzionalità di produttività.
Per tutte le altre azioni AppFabric API, consulta la sezione [Azioni AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html).
**Topics**
+ [Autorizza](API_Authorize.md)
+ [CreateAppClient](API_CreateAppClient.md)
+ [DeleteAppClient](API_DeleteAppClient.md)
+ [GetAppClient](API_GetAppClient.md)
+ [ListActionableInsights](API_ListActionableInsights.md)
+ [ListAppClients](API_ListAppClients.md)
+ [ListMeetingInsights](API_ListMeetingInsights.md)
+ [PutFeedback](API_PutFeedback.md)
+ [Token](API_Token.md)
+ [UpdateAppClient](API_UpdateAppClient.md)
# Autorizza
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Autorizza un AppClient.
**Topics**
+ [Corpo della richiesta](#API_Authorize_request)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **app\$1client\$1id** | L'ID del da autorizzare. AppClient |
| **redirect\$1uri** | L'URI a cui reindirizzare gli utenti finali dopo l'autorizzazione. |
| **state** | Un valore unico per mantenere lo stato tra la richiesta e il callback. |
# CreateAppClient
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Crea un AppClient.
**Topics**
+ [Corpo della richiesta](#API_CreateAppClient_request)
+ [Elementi di risposta](#API_CreateAppClient_response)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **AppName** | Il nome dell'app. Tipo: String Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255. Obbligatorio: sì |
| **Token client** | Specifica un identificatore univoco con distinzione tra maiuscole e minuscole fornito per garantire l'idempotenza della richiesta. Ciò consente di riprovare la richiesta in tutta sicurezza senza eseguire accidentalmente la stessa operazione una seconda volta. Per passare lo stesso valore a una chiamata successiva a un'operazione è necessario passare lo stesso valore anche per tutti gli altri parametri. Si consiglia di utilizzare un [tipo di valore UUID](https://wikipedia.org/wiki/Universally_unique_identifier). Se non fornisci questo valore, ne AWS genera uno casuale per te. Se si riprova l'operazione con gli stessi parametri`ClientToken`, ma con parametri diversi, il tentativo fallisce e viene restituito un `IdempotentParameterMismatch` errore. Tipo: stringa Modello: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obbligatorio: no |
| **customerManagedKeyIdentifier (Identificatore)** | L'ARN del file chiave gestita dal cliente generato da. AWS Key Management Service La chiave viene utilizzata per crittografare i dati. Se non viene specificata alcuna chiave, Chiave gestita da AWS viene utilizzata una. Una mappa delle coppie chiave-valore del tag o dei tag da assegnare alla risorsa. *Per ulteriori informazioni sulle chiavi gestite Chiavi di proprietà di AWS dai clienti, consulta [Customer keys and AWS keys](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) nella Developer Guide.AWS Key Management Service * Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011. Modello: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obbligatorio: no |
| **description** | Una descrizione dell'app. Tipo: stringa Obbligatorio: sì |
| **IconUrl** | L'URL dell'icona o del logo di AppClient. ▬Tipo: stringa Obbligatorio: no |
| **URL di reindirizzamento** | L'URI a cui reindirizzare gli utenti finali dopo l'autorizzazione. Puoi aggiungere fino a 5 URL di reindirizzamento. Ad esempio, `https://localhost:8080`. Tipo: array di stringhe Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi. Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri. Modello: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` Obbligatorio: sì |
| **starterUserEmails** | Indirizzi email iniziali per gli utenti a cui è consentito l'accesso alla ricezione di informazioni dettagliate fino alla verifica. AppClient Tipo: array di stringhe Membri dell'array: numero minimo di 1 elemento. Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 320. Modello: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` Obbligatorio: sì |
| **tags** | Una mappa delle coppie chiave-valore del tag o dei tag da assegnare alla risorsa. Tipo: matrice di oggetti Tag Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item. Obbligatorio: no |
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
| Parametro | Description |
| --- | --- |
| **appClientSummary** | Contiene un riepilogo di AppClient. Tipo: oggetto [AppClientSummary](API_AppClientSummary.md) |
# DeleteAppClient
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Elimina un client applicativo.
**Topics**
+ [Corpo della richiesta](#API_DeleteAppClient_request)
+ [Elementi di risposta](#API_DeleteAppClient_response)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **appClientIdentifier** | L'Amazon Resource Name (ARN) o l'Universal Unique Identifier (UUID) da utilizzare AppClient per la richiesta. Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011. Modello: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obbligatorio: sì |
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
# GetAppClient
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Restituisce informazioni su un AppClient.
**Topics**
+ [Corpo della richiesta](#API_GetAppClient_request)
+ [Elementi di risposta](#API_GetAppClient_response)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **appClientIdentifier** | L'Amazon Resource Name (ARN) o l'Universal Unique Identifier (UUID) da utilizzare AppClient per la richiesta. Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011. Modello: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obbligatorio: sì |
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
| Parametro | Description |
| --- | --- |
| **AppClient** | Contiene informazioni su un AppClient. Tipo: oggetto [AppClient](API_AppClient.md) |
# ListActionableInsights
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Elenca i messaggi e-mail, le attività e gli altri aggiornamenti utilizzabili più importanti.
**Topics**
+ [Corpo della richiesta](#API_ListActionableInsights_request)
+ [Elementi di risposta](#API_ListActionableInsights_response)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **nextToken** | Se `nextToken` viene restituito, ci sono altri risultati disponibili. Il valore di `nextToken` è un token di impaginazione unico per ogni pagina. Effettua nuovamente la chiamata utilizzando il token restituito per recuperare la pagina successiva. Mantieni invariati tutti gli altri argomenti. Ogni token di impaginazione scade dopo 24 ore. *L'utilizzo di un token di impaginazione scaduto restituirà un errore HTTP 400. InvalidToken * |
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
| Parametro | Description |
| --- | --- |
| **ActionableInsightsList** | Elenca le informazioni utili, tra cui titolo, descrizione, azioni e data e ora di creazione. Per ulteriori informazioni, consulta [ActionableInsights](API_ActionableInsights.md). |
| **nextToken** | Se `nextToken` viene restituito, ci sono più risultati disponibili. Il valore di `nextToken` è un token di impaginazione unico per ogni pagina. Effettua nuovamente la chiamata utilizzando il token restituito per recuperare la pagina successiva. Mantieni invariati tutti gli altri argomenti. Ogni token di impaginazione scade dopo 24 ore. *L'utilizzo di un token di impaginazione scaduto restituirà un errore HTTP 400. InvalidToken * Tipo: String |
# ListAppClients
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Restituisce un elenco di tutti AppClients.
**Topics**
+ [Corpo della richiesta](#API_ListAppClients_request)
+ [Elementi di risposta](#API_ListAppClients_response)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **maxResults** | Il numero massimo di risultati restituiti per chiamata. È possibile utilizzare `nextToken` per ottenere ulteriori pagine di risultati. Questo è solo un limite superiore. Il numero effettivo di risultati restituiti per chiamata potrebbe essere inferiore al massimo specificato. Intervallo valido: valore minimo di 1. valore massimo pari a 100. |
| **nextToken** | Se `nextToken` viene restituito, ci sono più risultati disponibili. Il valore di `nextToken` è un token di impaginazione unico per ogni pagina. Effettua nuovamente la chiamata utilizzando il token restituito per recuperare la pagina successiva. Mantieni invariati tutti gli altri argomenti. Ogni token di impaginazione scade dopo 24 ore. *L'utilizzo di un token di impaginazione scaduto restituirà un errore HTTP 400. InvalidToken * |
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
| Parametro | Description |
| --- | --- |
| **appClientList** | Contiene un elenco di risultati. AppClient Tipo: matrice di oggetti [AppClientSummary](API_AppClientSummary.md) |
| **nextToken** | Se `nextToken` viene restituito, ci sono altri risultati disponibili. Il valore di `nextToken` è un token di impaginazione unico per ogni pagina. Effettua nuovamente la chiamata utilizzando il token restituito per recuperare la pagina successiva. Mantieni invariati tutti gli altri argomenti. Ogni token di impaginazione scade dopo 24 ore. *L'utilizzo di un token di impaginazione scaduto restituirà un errore HTTP 400. InvalidToken * Tipo: String |
# ListMeetingInsights
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Elenca gli eventi più importanti del calendario su cui è possibile intervenire.
**Topics**
+ [Corpo della richiesta](#API_ListMeetingInsights_request)
+ [Elementi di risposta](#API_ListMeetingInsights_response)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **nextToken** | Se `nextToken` viene restituito, ci sono altri risultati disponibili. Il valore di `nextToken` è un token di impaginazione unico per ogni pagina. Effettua nuovamente la chiamata utilizzando il token restituito per recuperare la pagina successiva. Mantieni invariati tutti gli altri argomenti. Ogni token di impaginazione scade dopo 24 ore. *L'utilizzo di un token di impaginazione scaduto restituirà un errore HTTP 400. InvalidToken * |
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
| Parametro | Description |
| --- | --- |
| **MeetingInsightList** | Elenca le informazioni utili sulla riunione. Per ulteriori informazioni, consulta [MeetingInsights](API_MeetingInsights.md). |
| **nextToken** | Se `nextToken` viene restituito, ci sono più risultati disponibili. Il valore di `nextToken` è un token di impaginazione unico per ogni pagina. Effettua nuovamente la chiamata utilizzando il token restituito per recuperare la pagina successiva. Mantieni invariati tutti gli altri argomenti. Ogni token di impaginazione scade dopo 24 ore. *L'utilizzo di un token di impaginazione scaduto restituirà un errore HTTP 400. InvalidToken * Tipo: String |
# PutFeedback
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Consente agli utenti di inviare feedback per una determinata analisi o azione.
**Topics**
+ [Corpo della richiesta](#API_PutFeedback_request)
+ [Elementi di risposta](#API_PutFeedback_response)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **id** | L'ID dell'oggetto per il quale viene inviato il feedback. Può essere il InsightId o il ActionId. |
| **Feedback per** | Il tipo di approfondimento per il quale viene inviato il feedback. Valori possibili: `ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION` |
| **Valutazione del feedback** | Valutazione del feedback da a`1`. `5` Più alto è il punteggio, meglio è. |
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 201 con un corpo HTTP vuoto.
# Token
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Contiene informazioni che consentono di AppClients scambiare un codice di autorizzazione con un token di accesso.
**Topics**
+ [Corpo della richiesta](#API_Token_request)
+ [Elementi di risposta](#API_Token_response)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **code** | Il codice di autorizzazione ricevuto dall'endpoint di autorizzazione. Tipo: String Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri. Obbligatorio: no |
| **grant\$1type** | Il tipo di concessione per il token. Deve essere `authorization_code` o `refresh_token`. Tipo: stringa Obbligatorio: sì |
| **app\$1client\$1id** | L'ID del AppClient. Tipo: stringa Modello: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obbligatorio: sì |
| **redirect\$1uri** | L'URI di reindirizzamento passato all'endpoint di autorizzazione. ▬Tipo: stringa Obbligatorio: no |
| **refresh\$1token** | Il token di aggiornamento ricevuto dalla richiesta iniziale del token. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 4096. Obbligatorio: no |
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
| Parametro | Description |
| --- | --- |
| **appfabric\$1user\$1id** | L'ID dell'utente per il token. Viene restituito solo per le richieste che utilizzano il tipo di `authorization_code` concessione. Tipo: String |
| **expires\$1in** | Il numero di secondi che mancano alla scadenza del token. Tipo: long |
| **refresh\$1token** | Il token di aggiornamento da utilizzare per una richiesta successiva. Tipo: String Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri. |
| **t**oken | Il token di accesso. Tipo: String Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri. |
| **token\$1type** | Il tipo di token. Tipo: String |
# UpdateAppClient
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Aggiorna un AppClient.
**Topics**
+ [Corpo della richiesta](#API_UpdateAppClient_request)
+ [Elementi di risposta](#API_UpdateAppClient_response)
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
| Parametro | Description |
| --- | --- |
| **appClientIdentifier** | L'Amazon Resource Name (ARN) o l'Universal Unique Identifier (UUID) da utilizzare AppClient per la richiesta. Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011. Modello: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obbligatorio: sì |
| **URL di reindirizzamento** | L'URI a cui reindirizzare gli utenti finali dopo l'autorizzazione. Puoi aggiungere fino a 5 URL di reindirizzamento. Ad esempio, `https://localhost:8080`. Tipo: array di stringhe Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi. Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri. Modello: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` |
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
| Parametro | Description |
| --- | --- |
| **AppClient** | Contiene informazioni su un AppClient. Tipo: oggetto [AppClient](API_AppClient.md) |
# Tipi di dati API AppFabric per la produttività (anteprima)
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
L' AppFabric API contiene diversi tipi di dati utilizzati da varie azioni. Questa sezione descrive in dettaglio i tipi di dati AppFabric per le funzionalità di produttività.
Per tutti gli altri tipi di dati AppFabric API, consulta [Tipi di dati AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/API_Types.html).
**Importante**
L'ordine di ogni elemento in una struttura di tipi di dati non è garantito. Le applicazioni non devono assumere un determinato ordine.
**Topics**
+ [ActionableInsights](API_ActionableInsights.md)
+ [AppClient](API_AppClient.md)
+ [AppClientSummary](API_AppClientSummary.md)
+ [MeetingInsights](API_MeetingInsights.md)
+ [VerificationDetails](API_VerificationDetails.md)
# ActionableInsights
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Contiene un riepilogo delle azioni importanti e adatte per un utente in base a e-mail, inviti al calendario, messaggi e attività dal portafoglio di app. Gli utenti possono visualizzare informazioni proattive provenienti da tutte le loro applicazioni per aiutarli a orientare al meglio la giornata. Queste informazioni giustificano il motivo per cui un utente dovrebbe interessarsi al riepilogo delle informazioni, oltre a riferimenti, come i link incorporati, alle singole app e agli artefatti che hanno generato le informazioni.
| Parametro | Description |
| --- | --- |
| **InsightID** | L'ID univoco per l'analisi generata. |
| **Insight Content** | Ciò restituisce un riepilogo delle informazioni e dei collegamenti incorporati agli artefatti utilizzati per generare l'analisi. Si tratterebbe di un contenuto HTML contenente link incorporati (``tag). |
| **Titolo approfondito** | Il titolo dell'intuizione generata. |
| **CreatedAt** | Quando è stata generata l'intuizione. |
| **azioni** | Un elenco di azioni consigliate per l'analisi generata. L'oggetto azione contiene i seguenti parametri: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/API_ActionableInsights.html) |
# AppClient
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Contiene informazioni su un AppClient.
**Topics**
| Parametro | Description |
| --- | --- |
| **AppName** | Il nome dell'applicazione. Tipo: stringa Obbligatorio: sì |
| **arn** | L'Amazon Resource Name (ARN) del AppClient. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011. Modello: `arn:.+` Obbligatorio: sì |
| **description** | Una descrizione dell'applicazione. Tipo: stringa Obbligatorio: sì |
| **IconUrl** | L'URL dell'icona o del logo di AppClient. ▬Tipo: stringa Obbligatorio: no |
| **URL di reindirizzamento** | Il reindirizzamento consentito per URLs . AppClient Tipo: array di stringhe Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi. Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri. Modello: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` Obbligatorio: sì |
| **starterUserEmails** | Indirizzi email iniziali per gli utenti a cui AppClient è consentito l'accesso per ricevere approfondimenti fino alla verifica. Tipo: array di stringhe Membri dell'array: numero minimo di 1 elemento. Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 320. Modello: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` Obbligatorio: sì |
| **Dettagli di verifica** | Contiene lo stato e il motivo della AppClient verifica. Tipo: oggetto [VerificationDetails](API_VerificationDetails.md) Obbligatorio: sì |
| **customerManagedKeyArn** | L'Amazon Resource Name (ARN) del file chiave gestita dal cliente generato da AWS Key Management Service per. AppClient Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011. Modello: `arn:.+` Obbligatorio: no |
| **appClientId** | L'ID del AppClient. Pensato per essere usato nei flussi o-auth per l'app-client. Tipo: stringa Modello: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obbligatorio: no |
# AppClientSummary
| |
| --- |
| La funzione AWS AppFabric per la produttività è in anteprima ed è soggetta a modifiche. |
Contiene informazioni su un AppClient.
**Topics**
| Parametro | Description |
| --- | --- |
| **fienile** | L'Amazon Resource Name (ARN) del AppClient. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011. Modello: `arn:.+` Obbligatorio: sì |
| **Stato della verifica** | Lo stato della AppClient verifica. Tipo: String Valori validi: `pending_verification \| verified \| rejected` Obbligatorio: sì |
| **appClientId** | L'ID del AppClient. Pensato per essere usato nei flussi o-auth per l'app-client. Tipo: stringa Modello: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obbligatorio: no |
# MeetingInsights
| |
| --- |
| La funzione AWS AppFabric per la produttività è in anteprima ed è soggetta a modifiche. |
Contiene un riepilogo delle 3 riunioni principali insieme allo scopo della riunione, agli elementi correlati tra le app e alle attività relative a attività, e-mail, messaggi ed eventi del calendario.
| Parametro | Description |
| --- | --- |
| **InsightID** | L'ID univoco per l'analisi generata. |
| **Insight Content** | La descrizione dell'analisi che evidenzia i dettagli in formato stringa. Ad esempio, perché questa intuizione è importante. |
| **Titolo di approfondimento** | Il titolo dell'intuizione generata. |
| **CreatedAt** | Quando è stata generata l'intuizione. |
| **Evento del calendario** | L'evento o la riunione importante del calendario su cui l'utente dovrebbe concentrarsi. Oggetto Calendar Event: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **resources** | L'elenco contenente le altre risorse relative alla generazione dell'analisi. Oggetto risorsa: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **nextToken** | Il token di impaginazione per recuperare il prossimo set di approfondimenti. È un campo opzionale che, se restituito nullo, significa che non ci sono più approfondimenti da caricare. |
# VerificationDetails
| |
| --- |
| La funzione AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Contiene lo stato e il motivo della AppClient verifica.
**Topics**
| Parametro | Description |
| --- | --- |
| **Stato della verifica** | Lo stato della AppClient verifica. Tipo: String Valori validi: `pending_verification \| verified \| rejected` Obbligatorio: sì |
| **Status/Motivo** | Il motivo dello stato AppClient della verifica. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri. Obbligatorio: no |
# Errori API comuni AppFabric per la produttività (anteprima)
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
Questa sezione elenca gli errori comuni alle azioni API per le funzionalità di AWS AppFabric produttività.
Per tutti gli altri errori AppFabric comuni delle API, consulta [Risolvi i problemi per la AppClients produttività AppFabric](ahead-app-dev-errors.md) gli [AWS AppFabric errori comuni](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html) delle *AWS AppFabric API nel riferimento API*.
| Nome dell'eccezione | Description |
| --- | --- |
| **TokenException** | La richiesta del token non è valida. Codice di stato HTTP: 400 |
# Elaborazione dei dati in AppFabric
| |
| --- |
| La funzionalità AWS AppFabric per la produttività è disponibile in anteprima ed è soggetta a modifiche. |
AppFabric adotta misure per archiviare i contenuti degli utenti individualmente, in un bucket Amazon S3 gestito da AppFabric e separatamente; il che aiuta a garantire la generazione di informazioni specifiche per l'utente. Utilizziamo misure di sicurezza ragionevoli per proteggere i tuoi contenuti, che possono includere la crittografia in archivio e in transito. Abbiamo configurato i nostri sistemi per eliminare automaticamente i contenuti dei clienti entro 30 giorni dall'inserimento. AppFabric non genera approfondimenti utilizzando artefatti di dati a cui un utente non ha più accesso. Ad esempio, quando un utente disconnette una fonte di dati (un'app), AppFabric smette di raccogliere dati da quell'app e non utilizza alcun artefatto persistente delle app disconnesse per generare approfondimenti. AppFabrici sistemi sono configurati per eliminare tali dati entro 30 giorni.
AppFabric non utilizza i contenuti degli utenti per addestrare o migliorare i modelli linguistici di grandi dimensioni sottostanti utilizzati per generare approfondimenti. Per ulteriori informazioni sulla funzionalità AppFabric di intelligenza artificiale generativa, consulta [Amazon FAQs Bedrock](https://aws.amazon.com/bedrock/faqs/).
## Crittografia dei dati a riposo
AWS AppFabric supporta la crittografia a riposo, una funzionalità di crittografia lato server in cui crittografa in AppFabric modo trasparente tutti i dati relativi agli utenti quando vengono salvati su disco e li decrittografa quando accedi ai dati.
## Crittografia dei dati in transito
AppFabric protegge tutti i contenuti in transito utilizzando TLS 1.2 e firma le richieste API per i AWS servizi con AWS Signature Version 4.