As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# O que AWS AppFabric significa produtividade?
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
**nota**
[Desenvolvido pelo Amazon Bedrock: AWS implementa a detecção automática de abusos.](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) Como AWS AppFabric a produtividade é construída no Amazon Bedrock, os usuários herdam os controles implementados no Amazon Bedrock para garantir a segurança e o uso responsável da IA.
AWS AppFabric for productivity (versão prévia) ajuda a reimaginar a produtividade do usuário final em aplicativos de terceiros, gerando insights e ações com contexto de vários aplicativos. Os desenvolvedores de aplicações reconhecem que acessar os dados do usuário de outras aplicações é importante para criar uma experiência de aplicação mais produtiva, mas eles não querem criar e gerenciar integrações com cada aplicação. Com AppFabric o objetivo de aumentar a produtividade, os desenvolvedores de aplicativos obtêm acesso à IA generativa APIs que gera informações e ações de dados entre aplicativos para que possam fornecer experiências mais ricas ao usuário final por meio de assistentes de IA generativos novos ou existentes. AppFabric para produtividade, integra dados de vários aplicativos, eliminando a necessidade de os desenvolvedores criarem ou manterem point-to-point integrações. Os desenvolvedores de aplicativos podem incorporar AppFabric a produtividade diretamente na interface do usuário do aplicativo, mantendo uma experiência consistente para os usuários finais e, ao mesmo tempo, revelando o contexto relevante de outros aplicativos.
AppFabric para produtividade, conecta dados de aplicativos comumente usadosAsana, como,Atlassian Jira Suite,Google Workspace,Microsoft 365,Miro, SlackSmartsheet, e muito mais. AppFabric para produtividade, os desenvolvedores de aplicativos têm uma maneira mais fácil de criar experiências de aplicativos mais personalizadas que melhoram a adoção, a satisfação e a fidelidade dos usuários. Enquanto isso, os usuários finais se beneficiam do acesso às informações de que precisam em suas aplicações, sem interromper o fluxo de trabalho.
**Topics**
+ [Benefícios](#benefits)
+ [Casos de uso](#use-cases)
+ [Acesso AppFabric para produtividade](#acessing-appfabric)
+ [Comece a usar AppFabric para produtividade (versão prévia) para desenvolvedores de aplicativos](getting-started-appdeveloper-productivity.md)
+ [Comece a usar AppFabric para aumentar a produtividade (versão prévia) para usuários finais](getting-started-users-productivity.md)
+ [AppFabric para produtividade APIs (versão prévia)](productivity-apis.md)
+ [Processamento de dados em AppFabric](productivity-data-processing.md)
## Benefícios
Com AppFabric o objetivo de produtividade, os desenvolvedores de aplicativos obtêm acesso a informações e ações de dados entre aplicativos para APIs que possam fornecer experiências mais ricas ao usuário final por meio de assistentes de IA generativos novos ou existentes.
+ **Fonte única de dados de usuários entre aplicativos**: AppFabric para produtividade, integra dados de vários aplicativos, eliminando a necessidade de os desenvolvedores criarem ou manterem point-to-point integrações. Os dados SaaS da aplicação são processados para uso em outras aplicações, normalizando automaticamente tipos de dados diferentes em um formato compreensível por qualquer aplicação, permitindo que os desenvolvedores de aplicações incorporem mais dados que, na verdade, melhorem a produtividade dos usuários finais.
+ **Controle total da experiência do usuário**: os desenvolvedores AppFabric incorporam a produtividade diretamente na interface do usuário do aplicativo, mantendo o controle total da experiência do usuário e fornecendo insights personalizados e ações recomendadas aos usuários finais com o contexto de todos os aplicativos. Isso torna AppFabric a produtividade disponível no aplicativo SaaS preferido dos usuários finais e pode ser acessado no aplicativo que eles preferem para concluir suas tarefas. Os usuários finais passam menos tempo alternando entre aplicações, e podem permanecer no fluxo de seu trabalho.
+ **Acelere o tempo de lançamento no mercado**: em uma única chamada de API, os desenvolvedores de aplicativos podem receber insights em nível de usuário sobre os dados de um usuário que são gerados sem precisar ajustar um modelo, escrever um prompt personalizado ou criar integrações em vários aplicativos. AppFabric abstrai essa complexidade para permitir que os desenvolvedores de aplicativos criem, incorporem ou enriqueçam os recursos de IA generativa com mais rapidez. Isso permite que os desenvolvedores de aplicações se concentrem em seus recursos nas tarefas mais importantes.
+ **Referências de artefatos para aumentar a confiança do usuário**: como parte do resultado, AppFabric para fins de produtividade, apresentarão artefatos relevantes ou arquivos de origem usados para gerar insights para criar a confiança do usuário final nas saídas do LLM.
+ **Permissões de usuário simplificadas**: os artefatos do usuário usados para gerar insights são baseados no que o usuário tem acesso. AppFabric para produtividade, usa a permissão e o controle de acesso de um ISV como a fonte da verdade.
## Casos de uso
Os desenvolvedores de aplicativos podem usar a produtividade AppFabric para reimaginar a produtividade em seus aplicativos. AppFabric for productivity oferece duas opções APIs focadas nos seguintes casos de uso para ajudar seus usuários finais a serem mais produtivos:
+ Priorize seu dia
+ A API de informações acionáveis ajuda os usuários a gerenciar melhor seu dia, exibindo informações oportunas de todas as aplicações, incluindo emails, calendário, mensagens, tarefas e muito mais. Além disso, os usuários podem executar ações entre aplicações, como criar emails, agendar reuniões e criar itens de ação a partir da aplicação preferida. Por exemplo, um funcionário que tenha tido um escalonamento de clientes durante a noite não só verá um resumo das conversas noturnas, mas também poderá ver uma ação recomendada para agendar uma reunião com o gerente de contas do cliente. As ações são previamente preenchidas com campos obrigatórios (como nome e proprietário da tarefa ou remetente/destinatário do email), com a capacidade de editar o conteúdo previamente preenchido antes de executar a ação.
+ Prepare-se para as próximas reuniões
+ A API de preparação de reuniões ajuda os usuários a se prepararem melhor para as reuniões, resumindo o objetivo da reunião e revelando artefatos relevantes entre aplicações, como emails, mensagens e muito mais. Os usuários podem se preparar rapidamente para as reuniões agora e não perder tempo alternando entre aplicações para localizar conteúdo.
## Acesso AppFabric para produtividade
AppFabric para produtividade está atualmente lançado como uma prévia e está disponível no Leste dos EUA (Norte da Virgínia) Região da AWS. Para obter mais informações sobre Regiões da AWS, consulte [AWS AppFabric endpoints e cotas](https://docs.aws.amazon.com/general/latest/gr/appfabric.html) no. *Referência geral da AWS*
Em cada região, você pode acessar AppFabric a produtividade de qualquer uma das seguintes formas:
+ Como um desenvolvedor de aplicações
+ [Comece a usar AppFabric para produtividade (versão prévia) para desenvolvedores de aplicativos](getting-started-appdeveloper-productivity.md)
+ Como um usuário final
+ [Comece a usar AppFabric para aumentar a produtividade (versão prévia) para usuários finais](getting-started-users-productivity.md)
# Comece a usar AppFabric para produtividade (versão prévia) para desenvolvedores de aplicativos
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Esta seção ajuda os desenvolvedores de aplicativos a integrarem seus aplicativos AWS AppFabric para fins de produtividade (pré-visualização). AWS AppFabric para produtividade, permite que os desenvolvedores criem experiências de aplicativos mais ricas para seus usuários, gerando informações e ações baseadas em IA a partir de e-mails, eventos do calendário, tarefas, mensagens e muito mais em vários aplicativos. Para obter uma lista dos aplicativos compatíveis, consulte [Aplicativos AWS AppFabric compatíveis](https://aws.amazon.com/appfabric/supported-applications/).
AppFabric para produtividade oferece aos desenvolvedores de aplicativos acesso para criar e experimentar em um ambiente seguro e controlado. Ao começar a usar AppFabric para fins de produtividade, você cria um AppClient e registra um único usuário de teste. Essa abordagem foi projetada para ajudá-lo a entender e testar o fluxo de autenticação e comunicação entre seu aplicativo AppFabric e. Depois de testar com um único usuário, você pode enviar sua inscrição AppFabric para verificação antes de expandir o acesso a outros usuários (consulte[Etapa 5. Solicitação AppFabric para verificar sua inscrição](#request_verification)). AppFabric verificará as informações do aplicativo antes de permitir uma ampla adoção para ajudar a proteger os desenvolvedores de aplicativos, os usuários finais e seus dados, abrindo caminho para expandir a adoção pelos usuários de forma responsável.
**Topics**
+ [Pré-requisitos](#getting-started-prerequisites)
+ [Etapa 1. Crie um AppFabric para produtividade AppClient](#create_appclient)
+ [Etapa 2. Autentique e autorize sua aplicação](#authorize_data_access)
+ [Etapa 3. Adicione a URL AppFabric do portal do usuário ao seu aplicativo](#end_user_portal)
+ [Etapa 4: Use AppFabric para revelar informações e ações entre aplicativos](#surface_insights_actions)
+ [Etapa 5. Solicitação AppFabric para verificar sua inscrição](#request_verification)
+ [Gerencie AppFabric para aumentar a produtividade AppClients](manage-appclients.md)
+ [Solucione problemas AppFabric para AppClients aumentar a produtividade](ahead-app-dev-errors.md)
## Pré-requisitos
Antes de começar, você precisa criar um Conta da AWS. Para obter mais informações, consulte [Inscreva-se para um Conta da AWS](prerequisites.md#sign-up-for-aws). Você também precisa criar pelo menos um usuário com acesso à política do `"appfabric:CreateAppClient"` IAM listada abaixo, que permite que o usuário registre seu aplicativo com AppFabric. Para obter mais informações sobre a concessão de permissões AppFabric para os recursos de produtividade, consulte[AppFabric exemplos de políticas de IAM para produtividade](security_iam_id-based-policy-examples.md#appfabric-for-productivity-policy-examples). Embora ter um usuário administrativo seja benéfico, isso não é obrigatório para a configuração inicial. Para obter mais informações, consulte [Criar um usuário com acesso administrativo](prerequisites.md#create-an-admin).
AppFabric para produtividade é somente no Leste dos EUA (Norte da Virgínia) durante a pré-visualização. Certifique-se de estar nessa região antes de iniciar as etapas abaixo.
## Etapa 1. Crie um AppFabric para produtividade AppClient
Antes de começar a AppFabric buscar insights de produtividade em seu aplicativo, você precisa criar um AppFabric AppClient. An AppClient é essencialmente sua porta de entrada AppFabric para produtividade, funcionando como um cliente de OAuth aplicativo seguro, permitindo a comunicação segura entre seu aplicativo AppFabric e. Ao criar um AppClient, você receberá um AppClient ID, um identificador exclusivo crucial para garantir que ele AppFabric saiba que está funcionando com seu aplicativo e com o seu Conta da AWS.
AppFabric para produtividade oferece aos desenvolvedores de aplicativos acesso para criar e experimentar em um ambiente seguro e controlado. Ao começar a usar AppFabric para fins de produtividade, você cria um AppClient e registra um único usuário de teste. Essa abordagem foi projetada para ajudá-lo a entender e testar o fluxo de autenticação e comunicação entre seu aplicativo AppFabric e. Depois de testar com um único usuário, você pode enviar sua inscrição AppFabric para verificação antes de expandir o acesso a outros usuários (consulte[Etapa 5. Solicitação AppFabric para verificar sua inscrição](#request_verification)). AppFabric verificará as informações do aplicativo antes de permitir uma ampla adoção para ajudar a proteger os desenvolvedores de aplicativos, os usuários finais e seus dados, abrindo caminho para expandir a adoção pelos usuários de forma responsável.
Para criar um AppClient, use a operação de AWS AppFabric `CreateAppClient` API. Se precisar atualizar o AppClient after, você pode usar a operação da `UpdateAppClient` API para alterar somente os redirectURLs. Se você precisar alterar qualquer um dos outros parâmetros associados ao seu, AppClient como AppName ou description, exclua o AppClient e crie um novo. Para obter mais informações, consulte [CreateAppClient](API_CreateAppClient.md).
Você pode registrar seu aplicativo com AWS serviços usando a `CreateAppClient` API usando várias linguagens de programação, incluindo Python, Node.js, Java, C\$1, Go e Rust. Para obter mais informações, consulte [Solicitação de exemplos de assinaturas](https://docs.aws.amazon.com/IAM/latest/UserGuide/signature-v4-examples.html) no *Guia do usuário do IAM*. Você precisa usar suas credenciais de assinatura de conta versão 4 para realizar essa operação de API. Para obter mais informações sobre a assinatura versão 4, consulte [Solicitações de AWS API de assinatura](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) no *Guia do usuário do IAM*.
**Campos de solicitação**
+ `appName`- O nome do aplicativo que será exibido aos usuários na página de consentimento do portal do AppFabric usuário. A página de consentimento solicita permissão aos usuários finais para exibir AppFabric insights dentro do seu aplicativo. Para obter detalhes sobre a página de consentimento, consulte [Etapa 2. Forneça consentimento para que a aplicação exiba informações](getting-started-users-productivity.md#provide-consent).
+ `description`: uma descrição da aplicação.
+ `redirectUrls`: o URI para o qual redirecionar os usuários finais após a autorização. É possível adicionar até 5 redirectUrls. Por exemplo, .`https://localhost:8080`
+ `starterUserEmails`: um endereço de email do usuário que terá acesso para receber as informações até que a aplicação seja verificada. Só é permitido um endereço de email. Por exemplo, `anyuser@example.com`.
+ `customerManagedKeyIdentifier` (opcional): o ARN da chave gerenciada pelo cliente (gerada pelo KMS) a ser usada para criptografar os dados. Se não for especificada, a chave AWS AppFabric gerenciada será usada. Para ter mais informações sobre Chaves pertencentes à AWS e chaves gerenciadas pelo cliente, consulte [Chaves de clientes e chaves AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) no *Guia do desenvolvedor AWS Key Management Service *.
**Campos de resposta**
+ `appClientArn`- O nome de recurso da Amazon (ARN) que inclui o AppClient ID. Por exemplo, o AppClient ID é`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `verificationStatus`- O status da AppClient verificação.
+ `pending_verification`- A verificação do ainda AppClient está em andamento com AppFabric. Até que AppClient seja verificado, somente um usuário (especificado em`starterUserEmails`) pode usar AppClient o. O usuário verá uma notificação no portal do AppFabric usuário, introduzida em[Etapa 3. Adicione a URL AppFabric do portal do usuário ao seu aplicativo](#end_user_portal), indicando que o aplicativo não foi verificado.
+ `verified`- O processo de verificação foi concluído com sucesso AppFabric e agora AppClient está totalmente verificado.
+ `rejected`- O processo de verificação do AppClient foi rejeitado por AppFabric. Eles AppClient não podem ser usados por usuários adicionais até que o processo de verificação seja reiniciado e concluído com êxito.
```
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 a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
```
{
"appClientConfigSummary": {
"appClientArn": "arn:aws:appfabric:::appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"verificationStatus": "pending_verification"
}
}
```
## Etapa 2. Autentique e autorize sua aplicação
Permita que seu aplicativo integre AppFabric insights com segurança estabelecendo um fluxo de autorização OAuth 2.0. Primeiro, você precisa criar um código de autorização que verifique a identidade da sua aplicação. Para obter mais informações, consulte [Autorizar](API_Authorize.md). Em seguida, você trocará esse código de autorização por um token de acesso, que concede ao seu aplicativo as permissões para buscar e exibir AppFabric insights dentro do seu aplicativo. Para obter mais informações, consulte [Token](API_Token.md).
Para obter mais informações sobre como conceder permissão para autorizar uma aplicação, consulte [Permitir acesso para autorizar aplicações](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-token).
1. Para criar um código de autorização, use a operação AWS AppFabric `oauth2/authorize` da API.
**Campos de solicitação**
+ `app_client_id`(obrigatório) - O AppClient ID do Conta da AWS criado na [Etapa 1. Crie um AppClient](#create_appclient). Por exemplo, .`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`
+ `redirect_uri` (obrigatório): o URI para o qual redirecionar os usuários finais após a autorização que você usou na [Etapa 1. Crie um AppClient](#create_appclient). Por exemplo, .`https://localhost:8080`
+ `state` (obrigatório): um valor exclusivo para manter o estado entre a solicitação e o retorno de chamada. Por exemplo, .`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. Após a autenticação, você irá para o URI especificado com um código de autorização retornado como parâmetro de consulta. Por exemplo, onde `code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`.
```
https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44
```
1. Troque esse código de autorização por um token de acesso usando a operação AppFabric `oauth2/token` da API.
Esse token é usado para solicitações de API e é inicialmente válido `starterUserEmails` até que AppClient seja verificado. Depois de AppClient verificado, esse token pode ser usado por qualquer usuário. Você precisa usar suas credenciais de assinatura de conta versão 4 para realizar essa operação de API. Para obter mais informações sobre a assinatura versão 4, consulte [Solicitações de AWS API de assinatura](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) no *Guia do usuário do IAM*.
**Campos de solicitação**
+ `code` (obrigatório): o código de autorização que você recebeu após a autenticação na última etapa. Por exemplo, .`mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`
+ `app_client_id`(obrigatório) - O AppClient ID do Conta da AWS criado na [Etapa 1. Crie um AppClient](#create_appclient). Por exemplo, .`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`
+ `grant_type` (obrigatório): o valor deve ser `authorization_code`.
+ `redirect_uri` (obrigatório): o URI para o qual redirecionar os usuários após a autorização que você usou na [Etapa 1. Crie um AppClient](#create_appclient). Esse deve ser o mesmo URI de redirecionamento usado para criar um código de autorização. Por exemplo, .`https://localhost:8080`
**Campos de resposta**
+ `expires_in`: quanto tempo falta para o token expirar. O tempo de expiração padrão é de 12 horas.
+ `refresh_token`: o token de atualização recebido da solicitação inicial do token.
+ `token`: o token recebido da solicitação inicial do token.
+ `token_type`: o valor será `Bearer`.
+ `appfabric_user_id`- O ID AppFabric do usuário. Isso é retornado somente para solicitações que usem o tipo de concessão `authorization_code`.
```
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 a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
```
{
"expires_in": 43200,
"refresh_token": "apkaeibaerjr2example",
"token": "apkaeibaerjr2example",
"token_type": "Bearer",
"appfabric_user_id" : ""
}
```
## Etapa 3. Adicione a URL AppFabric do portal do usuário ao seu aplicativo
Os usuários finais precisam se AppFabric autorizar a acessar dados de seus aplicativos que são usados para gerar insights. AppFabric elimina a complexidade de os desenvolvedores de aplicativos controlarem esse processo criando um portal de usuário dedicado (uma tela pop-up) para que os usuários finais autorizem seus aplicativos. Quando os usuários estiverem prontos AppFabric para aumentar a produtividade, eles serão direcionados ao portal do usuário, que permite conectar e gerenciar aplicativos usados para gerar insights e ações entre aplicativos. Quando conectados, os usuários podem conectar aplicativos AppFabric para aumentar a produtividade e depois voltar ao seu aplicativo para explorar os insights e as ações. Para integrar seu aplicativo AppFabric para fins de produtividade, você precisa adicionar um AppFabric URL específico ao seu aplicativo. Essa etapa é crucial para permitir que os usuários acessem o portal AppFabric do usuário diretamente do seu aplicativo.
1. Navegue até as configurações do seu aplicativo e localize a seção para adicionar redirecionamento URLs.
1. Depois de encontrar a área apropriada, adicione o seguinte AppFabric URL como URL de redirecionamento para seu aplicativo:
```
https://userportal.appfabric..amazonaws.com/eup_login
```
Depois de adicionar a URL, seu aplicativo será configurado para direcionar os usuários ao portal do AppFabric usuário. Aqui, os usuários podem fazer login, conectar e gerenciar seus aplicativos usados AppFabric para gerar insights de produtividade.
## Etapa 4: Use AppFabric para revelar informações e ações entre aplicativos
Depois que os usuários conectarem seus aplicativos, você poderá trazer os insights do usuário para melhorar sua produtividade, ajudando a reduzir a troca de aplicativos e contextos. AppFabric só gera insights para um usuário com base no que o usuário tem permissão para acessar. AppFabric armazena dados do usuário em uma Conta da AWS propriedade de AppFabric. Para obter informações sobre como AppFabric usa seus dados, consulte[Processamento de dados em AppFabric](productivity-data-processing.md).
Você pode usar os seguintes recursos de inteligência artificial APIs para gerar e exibir informações e ações em nível de usuário em seus aplicativos:
+ `ListActionableInsights`: para obter mais informações, consulte [Informações acionáveis](#productivity-actionable-insights) abaixo.
+ `ListMeetingInsights`: para obter mais informações, consulte [Preparação da reunião](#productivity-meeting-insights) mais adiante neste guia.
### Informações acionáveis (`ListActionableInsights`)
A API `ListActionableInsights` ajuda os usuários a gerenciar melhor seu dia, revelando informações oportunas baseadas nas atividades de todas as aplicações, incluindo emails, calendário, mensagens, tarefas e muito mais. As informações retornadas também mostrarão links incorporados para artefatos usados para gerar a informação, ajudando os usuários a visualizar rapidamente quais dados foram usados para gerar a informação. Além disso, a API pode retornar ações sugeridas com base na informação e permitir que os usuários executem ações entre aplicações de dentro da sua aplicação. Especificamente, a API se integra a plataformas como Asana, Google Workspace, Microsoft 365 e Smartsheet para permitir que os usuários enviem emails, criem eventos de calendário e criem tarefas. Os modelos de linguagem grande (LLMs) podem pré-preencher detalhes dentro de uma ação recomendada (como corpo do e-mail ou nome da tarefa), que os usuários podem personalizar antes da execução, simplificando a tomada de decisões e aumentando a produtividade. Semelhante à experiência dos usuários finais de autorizar aplicativos, AppFabric usa o mesmo portal dedicado para que os usuários visualizem, editem e executem ações entre aplicativos. Para executar ações, é AppFabric necessário ISVs redirecionar os usuários para um portal AppFabric do usuário onde eles possam ver os detalhes das ações e executá-las. Cada ação gerada por AppFabric tem um URL exclusivo. Esse URL está disponível na resposta da resposta da API `ListActionableInsights`.
Abaixo há um resumo das ações entre aplicações com suporte e em quais aplicações:
+ Enviar email (Google Workspace, Microsoft 365)
+ Criar evento do calendário (Google Workspace, Microsoft 365)
+ Criar tarefa (Asana, Smartsheet)
**Campos de solicitação**
+ `nextToken` (opcional): o token de paginação para obter o próximo conjunto de informações.
+ `includeActionExecutionStatus`: um filtro que aceita uma lista de status de execução da ação. As ações são filtradas com base nos valores de status passados. Valores possíveis: `NOT_EXECUTED` \$1 `EXECUTED`
**Cabeçalho da solicitação**
+ O cabeçalho da autorização precisa ser passado com o valor `Bearer Token `.
**Campos de resposta**
+ `insightId`: o id exclusivo da informação gerada.
+ `insightContent`: retorna um resumo da informação e links incorporados aos artefatos usados para gerar a informação. Observação: isso seria um conteúdo HTML contendo links incorporados (tags ).
+ `insightTitle`: o título da informação gerada.
+ `createdAt`: quando a informação foi gerada.
+ `actions`: uma lista de ações recomendadas para a informação gerada. Objeto de ação:
+ `actionId`: o id exclusivo da ação gerada.
+ `actionIconUrl`: o URL do ícone da aplicação no qual a ação é sugerida para ser executada.
+ `actionTitle`: o título da ação gerada.
+ `actionUrl`- O URL exclusivo para o usuário final visualizar e executar a ação no portal AppFabric do usuário. Observação: para executar ações, os aplicativos ISV redirecionarão os usuários para o portal AppFabric do usuário (tela pop-up) usando essa URL.
+ `actionExecutionStatus`: uma enumeração que indica o status da ação. Os valores possíveis são: `EXECUTED` \$1 `NOT_EXECUTED`
+ `nextToken` (opcional): o token de paginação para obter o próximo conjunto de informações. É um campo opcional que, se retornado nulo, significa que não há mais informações a serem carregadas.
Para obter mais informações, consulte [ActionableInsights](API_ActionableInsights.md).
```
curl -v --location \
"https://productivity.appfabric..amazonaws.com"\
"/actionableInsights" \
--header "Authorization: Bearer "
```
Se a ação for bem-sucedida, o serviço retornará uma resposta 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
}
```
### Preparação da reunião (`ListMeetingInsights`)
A API `ListMeetingInsights` ajuda os usuários a se prepararem melhor para as reuniões vindouras, resumindo o objetivo da reunião e revelando artefatos relevantes entre aplicações, como emails, mensagens e muito mais. Os usuários podem se preparar rapidamente para as reuniões agora e não perder tempo alternando entre aplicações para localizar conteúdo.
**Campos de solicitação**
+ `nextToken` (opcional): o token de paginação para obter o próximo conjunto de informações.
**Cabeçalho da solicitação**
+ O cabeçalho da autorização precisa ser passado com o valor `Bearer Token`.
**Campos de resposta**
+ `insightId`: o id exclusivo da informação gerada.
+ `insightContent`: a descrição da informação, destacando os detalhes em um formato de string. Por exemplo, por que essa informação é importante.
+ `insightTitle`: o título da informação gerada.
+ `createdAt`: quando a informação foi gerada.
+ `calendarEvent`: o evento ou reunião importante do calendário em que o usuário deve se concentrar. Objeto Calendar Event:
+ `startTime`: a hora de início do evento.
+ `endTime`: a hora de término do evento.
+ `eventUrl`: o URL do evento do calendário na aplicação do ISV.
+ `resources`: a lista contendo os outros recursos relacionados à geração da informação. Objeto de recurso:
+ `appName`: o nome da aplicação à qual o recurso pertence.
+ `resourceTitle`: o título do recurso.
+ `resourceType`: o tipo do recurso. Os valores possíveis são: `EMAIL` \$1 `EVENT` \$1 `MESSAGE` \$1 `TASK`
+ `resourceUrl`: o URL do recurso na aplicação.
+ `appIconUrl`: o URL da imagem da aplicação à qual o recurso pertence.
+ `nextToken` (opcional): o token de paginação para obter o próximo conjunto de informações. É um campo opcional que, se retornado nulo, significa que não há mais informações a serem carregadas.
Para obter mais informações, consulte [MeetingInsights](API_MeetingInsights.md).
```
curl --location \
"https://productivity.appfabric..amazonaws.com"\
"/meetingContexts" \
--header "Authorization: Bearer "
```
Se a ação for bem-sucedida, o serviço retornará uma resposta 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
}
```
### Forneça comentários sobre suas informações ou ações
Use a operação AppFabric `PutFeedback` da API para fornecer feedback sobre as informações e ações geradas. Você pode incorporar esse recurso em seus aplicativos para fornecer uma forma de enviar uma avaliação de feedback (de 1 a 5, em que quanto maior a classificação, melhor) para um determinado InsightId ou ActionId.
**Campos de solicitação**
+ `id`: o identificador do objeto para o qual o comentário está sendo enviado. Isso pode ser o InsightId ou ActionId o.
+ `feedbackFor`: o tipo de recurso para o qual o comentário está sendo enviado. Valores possíveis: `ACTIONABLE_INSIGHT` \$1 `MEETING_INSIGHT` \$1 `ACTION`
+ `feedbackRating`: classificação do comentário de `1` a `5`. Quanto maior a classificação, melhor.
**Campos de resposta**
+ Não há campos de resposta.
Para obter mais informações, consulte [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 a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 201 com um corpo HTTP vazio.
## Etapa 5. Solicitação AppFabric para verificar sua inscrição
Até agora, você atualizou a interface do usuário do seu aplicativo para incorporar informações e ações AppFabric entre aplicativos e recebeu insights para um único usuário. Depois de ficar satisfeito com o teste e quiser estender sua experiência AppFabric aprimorada para mais usuários, você pode enviar sua inscrição AppFabric para análise e verificação. AppFabric verificará as informações do aplicativo antes de permitir uma ampla adoção para ajudar a proteger os desenvolvedores de aplicativos, os usuários finais e seus dados, abrindo caminho para expandir a adoção pelos usuários de forma responsável.
**Inicie o processo de verificação**
Comece o processo de verificação enviando um email para [appfabric-appverification@amazon.com](mailto:appfabric-appverification@amazon.com) e solicitando que sua aplicação seja verificada.
No email, inclua os detalhes a seguir:
+ Seu Conta da AWS ID
+ O nome da aplicação para a qual você está buscando verificação
+ Seu AppClient ID
+ Suas informações de contato
Além disso, forneça as seguintes informações, se disponíveis, para nos ajudar a avaliar a prioridade e o impacto:
+ Um número estimado de usuários aos quais você planeja conceder acesso
+ Sua data de lançamento prevista
**nota**
Se você tiver um Conta da AWS gerente ou gerente de desenvolvimento de AWS parceiros, copie-os em seu e-mail. Incluir esses contatos pode ajudar a agilizar o processo de verificação.
**Critérios de verificação**
Antes de usar esse processo de verificação, verifique se ele atende aos critérios a seguir.
+ Você deve usar um válido Conta da AWS para usar AppFabric para produtividade
Além disso, você deve atender a pelo menos um destes critérios:
+ Sua organização é AWS parceira AWS Partner Network com pelo menos um nível “AWS Selecionar”. Para obter mais informações, consulte [Níveis de serviços de parceiros da AWS](https://aws.amazon.com/partners/services-tiers/).
+ Sua organização deveria ter gasto pelo menos \$110.000 em AppFabric serviços nos últimos três anos.
+ Sua aplicação deve estar listada no AWS Marketplace. Para obter mais informações, consulte o [AWS Marketplace](https://aws.amazon.com/marketplace).
**Aguarde a atualização do status da verificação**
Depois que sua inscrição for analisada, responderemos por e-mail e o status de sua inscrição AppClient mudará de `pending_verification` para`verified`. Se a aplicação for rejeitada, você precisará reiniciar o processo de verificação.
# Gerencie AppFabric para aumentar a produtividade AppClients
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Você pode gerenciar sua produtividade AppFabric para garantir AppClients a operação e a manutenção sem problemas dos processos de autenticação e autorização.
## Obtenha detalhes de um AppClient
Use a operação AppFabric `GetAppClient` da API para ver detalhes sobre sua AppClient, incluindo verificar o AppClient status. Para obter mais informações, consulte [GetAppClient](API_GetAppClient.md).
Para obter detalhes de um AppClient, você deve ter, no mínimo, as permissões da política `"appfabric:GetAppClient"` do IAM. Para obter mais informações, consulte [Permita o acesso para obter detalhes de AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-get-appclient).
**Campos de solicitação**
+ `appClientId`- O AppClient ID.
**Campos de resposta**
+ `appName`- O nome do aplicativo que será exibido aos usuários na página de consentimento do portal do AppFabric usuário.
+ `customerManagedKeyIdentifier` (opcional): o ARN da chave gerenciada pelo cliente (gerada pelo KMS) a ser usada para criptografar os dados. Se não for especificado, a chave AWS AppFabric gerenciada será usada.
+ `description`: uma descrição da aplicação.
+ `redirectUrls`: o URI para o qual redirecionar os usuários finais após a autorização. É possível adicionar até 5 redirectUrls. Por exemplo, .`https://localhost:8080`
+ `starterUserEmails`: um endereço de email do usuário que terá acesso para receber as informações até que a aplicação seja verificada. Só é permitido um endereço de email. Por exemplo, .`anyuser@example.com`
+ `verificationStatus`- O status da AppClient verificação.
+ `pending_verification`- A verificação do ainda AppClient está em andamento com AppFabric. Até que AppClient seja verificado, somente um usuário (especificado em`starterUserEmails`) pode usar AppClient o.
+ `verified`- O processo de verificação foi concluído com sucesso AppFabric e agora AppClient está totalmente verificado.
+ `rejected`- O processo de verificação do AppClient foi rejeitado por AppFabric. Eles AppClient não podem ser usados por usuários adicionais até que o processo de verificação seja reiniciado e concluído com êxito.
```
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 a ação for bem-sucedida, o serviço retornará uma resposta 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"
}
}
}
```
## Lista AppClients
Use a operação de AppFabric `ListAppClients` API para ver uma lista de seus AppClients. AppFabric só permite um AppClient por Conta da AWS. Isso está sujeito a alterações no futuro. Para obter mais informações, consulte [ListAppClients](API_ListAppClients.md).
Para listar AppClients, você deve ter, no mínimo, as permissões da política `"appfabric:ListAppClients"` do IAM. Para obter mais informações, consulte [Permitir acesso à lista AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-list-appclient).
**Campos de solicitação**
+ Não há campos obrigatórios.
**Campos de resposta**
+ `appClientARN`- O nome de recurso da Amazon (ARN) que inclui o AppClient ID. Por exemplo, o AppClient ID é`a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+ `verificationStatus`- O status da AppClient verificação.
+ `pending_verification`- A verificação do ainda AppClient está em andamento com AppFabric. Até que AppClient seja verificado, somente um usuário (especificado em`starterUserEmails`) pode usar AppClient o.
+ `verified`- O processo de verificação foi concluído com sucesso AppFabric e agora AppClient está totalmente verificado.
+ `rejected`- O processo de verificação do AppClient foi rejeitado por AppFabric. Eles AppClient não podem ser usados por usuários adicionais até que o processo de verificação seja reiniciado e concluído com êxito.
```
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 a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
```
200 OK
{
"appClientList": [
{
"appClientArn": "arn:aws:appfabric::111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"verificationStatus": "pending_verification"
}
]
}
```
## Atualizar um AppClient
Use a operação da AppFabric `UpdateAppClient` API para atualizar os redirectUrls mapeados para o seu. AppClient Se precisar alterar qualquer outro parâmetro, como AppName starterUserEmails, ou outro, exclua o AppClient e crie um novo. Para obter mais informações, consulte [UpdateAppClient](API_UpdateAppClient.md).
Para atualizar um AppClient, você deve ter, no mínimo, as permissões da política `"appfabric:UpdateAppClient"` do IAM. Para obter mais informações, consulte [Permitir acesso à atualização AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient).
**Campos de solicitação**
+ `appClientId`(obrigatório) - O AppClient ID com o qual você está atualizando os RedirectUrls.
+ `redirectUrls` (obrigatório): a lista atualizada dos redirectUrls. É possível adicionar até 5 redirectUrls.
**Campos de resposta**
+ `appName`- O nome do aplicativo que será exibido aos usuários na página de consentimento do portal do AppFabric usuário.
+ `customerManagedKeyIdentifier` (opcional): o ARN da chave gerenciada pelo cliente (gerada pelo KMS) a ser usada para criptografar os dados. Se não for especificado, a chave AWS AppFabric gerenciada será usada.
+ `description`: uma descrição da aplicação.
+ `redirectUrls`: o URI para o qual redirecionar os usuários finais após a autorização. Por exemplo, .`https://localhost:8080`
+ `starterUserEmails`: um endereço de email do usuário que terá acesso para receber as informações até que a aplicação seja verificada. Só é permitido um endereço de email. Por exemplo, .`anyuser@example.com`
+ `verificationStatus`- O status da AppClient verificação.
+ `pending_verification`- A verificação do ainda AppClient está em andamento com AppFabric. Até que AppClient seja verificado, somente um usuário (especificado em`starterUserEmails`) pode usar AppClient o.
+ `verified`- O processo de verificação foi concluído com sucesso AppFabric e agora AppClient está totalmente verificado.
+ `rejected`- O processo de verificação do AppClient foi rejeitado por AppFabric. Eles AppClient não podem ser usados por usuários adicionais até que o processo de verificação seja reiniciado e concluído com êxito.
```
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 a ação for bem-sucedida, o serviço retornará uma resposta 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"
}
}
}
```
## Excluir um AppClient
Use a operação AppFabric `DeleteAppClient` da API para excluir as AppClients que você não precisa mais. Para obter mais informações, consulte [DeleteAppClient](API_DeleteAppClient.md).
Para excluir um AppClient, você deve ter, no mínimo, as permissões da política `"appfabric:DeleteAppClient"` do IAM. Para obter mais informações, consulte [Permitir acesso para excluir AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-delete-appclient).
**Campos de solicitação**
+ `appClientId`- O AppClient ID.
**Campos de resposta**
+ Não há campos de resposta.
```
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 a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.
## Atualizar tokens para usuários finais
Os tokens que você AppClient adquire para os usuários finais podem ser atualizados no vencimento. Isso pode ser feito usando a API [Token](API_Token.md) com o grant\$1type `refresh_token`. O `refresh_token` a ser usado é retornado como parte da resposta da API do token quando o grant\$1type for `authorization_code`. O tempo de expiração padrão é de 12 horas. Para chamar a API de atualização, você precisa ter a permissão da política do IAM `"appfabric:Token"`. Para obter mais informações, consulte [Token](API_Token.md) e [Permitir acesso à atualização AppClients](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient).
**Campos de solicitação**
+ `refresh_token` (obrigatório): o token de atualização recebido da solicitação `/token` inicial.
+ `app_client_id`(obrigatório) - O ID do AppClient recurso criado para Conta da AWS o.
+ `grant_type` (obrigatório): isso deve ser `refresh_token`.
**Campos de resposta**
+ `expires_in`: quanto tempo falta para o token expirar. O tempo de expiração padrão é de 12 horas.
+ `refresh_token`: o token de atualização recebido da solicitação inicial do token.
+ `token`: o token recebido da solicitação inicial do token.
+ `token_type`: o valor será `Bearer`.
+ `appfabric_user_id`- O ID AppFabric do usuário. Isso é retornado somente para solicitações que usem o tipo de concessão `authorization_code`.
```
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 a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
```
200 OK
{
"expires_in": 43200,
"token": "apkaeibaerjr2example",
"token_type": "Bearer",
"appfabric_user_id" : "${UserID}"
}
```
# Solucione problemas AppFabric para AppClients aumentar a produtividade
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Esta seção descreve erros comuns e soluções de problemas AppFabric para aumentar a produtividade.
## Aplicação não verificada
Os desenvolvedores de aplicativos que usam a produtividade AppFabric para enriquecer suas experiências de aplicativos passarão por um processo de verificação antes de lançar seus recursos para os usuários finais. Todas as aplicações começam como não verificadas e mudam para verificadas somente quando o processo de verificação é concluído. Isso significa que o que `starterUserEmails` você usou ao criar um AppClient verá essa mensagem.
![\[Warning message for an unverified application in AWS AppFabric, requesting data access.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-24.png)
## Erros do `CreateAppClient`
### ServiceQuotaExceededException
Se você receber a seguinte exceção ao criar um AppClient, você excedeu o número AppClients que pode ser criado por Conta da AWS. O limite é 1. Código de status HTTP: 402
```
ServiceQuotaExceededException / SERVICE_QUOTA_EXCEEDED
You have exceeded the number of AppClients that can be created per AWS Account. The limit is 1.
HTTP Status Code: 402
```
## Erros do `GetAppClient`
### ResourceNotFoundException
Se você receber a seguinte exceção ao obter detalhes de um AppClient, verifique se inseriu o AppClient identificador correto. Esse erro significa que o especificado não AppClient foi encontrado.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Erros do `DeleteAppClient`
### ConflictException
Se você receber a seguinte exceção ao excluir uma AppClient, outra solicitação de exclusão está em andamento. Espere até que seja concluída e tente novamente. Código de Status HTTP: 409
```
ConflictException
Another delete request is in progress. Wait until it completes then try again.
HTTP Status Code: 409
```
### ResourceNotFoundException
Se você receber a seguinte exceção ao excluir um AppClient, verifique se inseriu o AppClient identificador correto. Esse erro significa que o especificado não AppClient foi encontrado.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Erros do `UpdateAppClient`
### ResourceNotFoundException
Se você receber a seguinte exceção ao atualizar um AppClient, verifique se inseriu o AppClient identificador correto. Esse erro significa que o especificado não AppClient foi encontrado.
```
ResourceNotFoundException / APP_CLIENT_NOT_FOUND
The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier.
HTTP Status Code: 404
```
## Erros do `Authorize`
### ValidationException
Você poderá receber a exceção a seguir se algum dos parâmetros da API não atender às restrições definidas nas especificações da API.
```
ValidationException
HTTP Status Code: 400
```
**Razão 1: quando o AppClient ID não é especificado**
O `app_client_id` está ausente nos parâmetros da solicitação. Crie o AppClient se ainda não tiver sido criado ou use o existente `app_client_id` e tente novamente. Para encontrar o AppClient ID, use a operação [ListAppClient](manage-appclients.md#list_appclients)da API.
**Motivo 2: Quando AppFabric não tem acesso à chave gerenciada pelo cliente**
```
Message: AppFabric couldn't access the customer managed key configured for AppClient.
```
AppFabric atualmente não consegue acessar as chaves gerenciadas pelo cliente, provavelmente devido a mudanças recentes em suas permissões. Verifique se a chave especificada existe e garanta que AppFabric as permissões de acesso apropriadas sejam concedidas.
**Motivo 3: O URL de redirecionamento especificado não é válido**
```
Message: Redirect url invalid
```
Certifique-se de que o URL de redirecionamento em sua solicitação esteja correto. Ele deve corresponder a um dos redirecionamentos URLs especificados quando você criou ou atualizou o. AppClient Para ver a lista de redirecionamentos permitidos URLs, use a operação da [GetAppClient](manage-appclients.md#get_appclient_details)API.
## Erros do `Token`
### TokenException
Você poderá receber a exceção a seguir por alguns motivos.
```
TokenException
HTTP Status Code: 400
```
**Motivo 1: quando um email inválido é especificado**
```
Message: Invalid Email used
```
Verifique se o endereço de e-mail que você está usando corresponde ao listado para o `starterUserEmails` atributo quando você criou AppClient o. Se os emails não corresponderem, mude para o endereço de email correspondente e tente novamente. Para ver o e-mail usado, use a operação [GetAppClient](manage-appclients.md#get_appclient_details)da API.
**Motivo 2: Para grant\$1type como refresh\$1token quando o token não for especificado.**
```
Message: refresh_token must be non-null for Refresh Token Grant-type
```
O token de atualização especificado na solicitação é nulo ou está vazio. Especifique um `refresh_token` ativo recebido na resposta de chamada da API [Token](getting-started-appdeveloper-productivity.md#authorize_data_access).
### ThrottlingException
Você poderá receber a exceção a seguir se a API estiver sendo chamada a uma taxa maior do que a cota permitida.
```
ThrottlingException
HTTP Status Code: 429
```
## Erros `ListActionableInsights`, `ListMeetingInsights` e `PutFeedback`
### ValidationException
Você poderá receber a exceção a seguir se algum dos parâmetros da API não atender às restrições definidas nas especificações da API.
```
ValidationException
HTTP Status Code: 400
```
### ThrottlingException
Você poderá receber a exceção a seguir se a API estiver sendo chamada a uma taxa maior do que a cota permitida.
```
ThrottlingException
HTTP Status Code: 429
```
# Comece a usar AppFabric para aumentar a produtividade (versão prévia) para usuários finais
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Esta seção é destinada aos usuários finais de aplicativos SaaS que desejam aumentar a produtividade (versão prévia) AWS AppFabric para melhorar o gerenciamento de tarefas e a eficiência do fluxo de trabalho. Siga estas etapas para conectar seus aplicativos e AppFabric autorizar a revelar insights entre aplicativos e ajudá-lo a concluir ações (como enviar um e-mail ou agendar uma reunião) a partir de seus aplicativos preferidos. Você pode conectar aplicações como Asana, Atlassian Jira Suite, Google Workspace, Microsoft 365, Miro, Slack, Smartsheet e muito mais. Depois de autorizar AppFabric o acesso ao seu conteúdo, AppFabric traz insights e ações entre aplicativos diretamente para seus aplicativos preferidos, ajudando você a trabalhar com mais eficiência e a permanecer dentro dos fluxos de trabalho atuais.
AppFabric para produtividade, usa IA generativa que é alimentada pelo Amazon Bedrock. AppFabric gerará insights e ações somente após receber sua permissão explícita. Você autoriza cada aplicativo individual a manter o controle total de qual conteúdo é usado. AppFabric não usará seus dados para treinar ou melhorar os grandes modelos de linguagem subjacentes usados para gerar insights. Para obter mais informações, consulte [Amazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/).
**Topics**
+ [Pré-requisitos](#getting-started-prerequisites)
+ [Etapa 1. Faça login em AppFabric](#sign-in-appfabric)
+ [Etapa 2. Forneça consentimento para que a aplicação exiba informações](#provide-consent)
+ [Etapa 3. Conecte suas aplicações para gerar informações e ações](#connect-apps)
+ [Etapa 4: Comece a ver informações e execute ações entre aplicações em sua aplicação](#insights_in_app)
+ [Gerencie o AppFabric acesso aos recursos de produtividade (versão prévia) para administradores de TI e segurança](productivity-end-users-managing-access.md)
+ [Solucione erros do usuário final AppFabric para aumentar a produtividade](productivity-end-users-errors.md)
## Pré-requisitos
Antes de iniciar, verifique se você possui:
+ Credenciais para entrar AppFabric: Para começar a usar AppFabric para fins de produtividade, você precisará de credenciais de login federadas (nome de usuário e senha) para um dos seguintes provedores:Asana,,, ou. Google Workspace Microsoft 365 Slack Fazer login nos AppFabric ajuda a identificá-lo como usuário em cada aplicativo que você habilita AppFabric para produtividade. Depois de fazer login, você poderá conectar suas aplicações para começar a gerar informações.
+ Credenciais para conectar suas aplicações: informações e ações entre aplicações são geradas somente com base nas aplicações que você autorizar. Você precisará de credenciais de login (nome de usuário e senha) para cada uma das aplicações que desejar autorizar. As aplicações com suporte incluem Asana, Atlassian Jira Suite, Google Workspace, Microsoft 365, Miro, Slack e Smartsheet.
## Etapa 1. Faça login em AppFabric
Conecte aplicativos AppFabric para trazer seu conteúdo e insights diretamente para seus aplicativos preferidos.
1. Cada aplicativo será usado AppFabric para fins de produtividade de maneiras diferentes, proporcionando experiências de aplicativo mais ricas. Devido a isso, cada aplicativo terá um ponto de entrada diferente para acessar a AppFabric página inicial de produtividade abaixo. A página inicial define o contexto sobre o processo a ser ativado AppFabric e primeiro solicita que você faça login. Cada aplicativo que você deseja ativar AppFabric chegará a essa tela.
![\[Sign-in prompt for AWS AppFabric, highlighting AI-powered productivity features.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-01.png)
1. Faça login com suas credenciais de um destes provedores: Asana, Google Workspace, Microsoft 365 ou Slack. Para obter a melhor experiência, recomendamos fazer login usando o mesmo provedor para cada aplicativo AppFabric ativado. Por exemplo, se você escolher as credenciais do Google Workspace no App1, recomendamos escolher Google Workspace no App2, bem como todas as outras vezes em que precisar fazer login novamente. Se você fizer login com um provedor diferente, precisará reiniciar o processo de conexão das aplicações.
![\[AWS AppFabric sign-in page with options for Slack, Microsoft, Google, and Asana.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-02.png)
1. Se solicitado, insira suas credenciais de login e aceite o login AppFabric desse provedor.
![\[Slack sign-in page with options for Google, Apple, or email authentication.\]](http://docs.aws.amazon.com/pt_br/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/pt_br/appfabric/latest/adminguide/images/fabric-04.png)
## Etapa 2. Forneça consentimento para que a aplicação exiba informações
Depois de fazer login, AppFabric será exibida uma página de consentimento perguntando se você permite AppFabric a exibição de informações e ações entre aplicativos dentro do aplicativo em que você está ativando AppFabric a produtividade. Por exemplo, você permite AppFabric pegar seus Google Workspace e-mails e eventos do calendário e exibi-los emAsana. Você só precisa concluir essa etapa de consentimento uma vez por aplicativo AppFabric ativado.
![\[Dialog box requesting permission to display insights and artifacts within an application.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-05.png)
## Etapa 3. Conecte suas aplicações para gerar informações e ações
Depois de concluir a página de consentimento, você será direcionado para a página **Conectar aplicações**, onde poderá conectar, desconectar ou reconectar aplicações individuais que, em última análise, são usadas para gerar suas informações e ações entre aplicações. Na maioria dos casos, depois de fazer login e fornecer consentimento, você continuará usando esta página para gerenciar suas aplicações conectadas.
Para conectar uma aplicação, escolha o botão **Conectar** ao lado de qualquer aplicação que você usar.
![\[List of applications to connect, including Smartsheet, Slack, and Google Workspace, all showing as not connected.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-06.png)
Você precisará fornecer suas credenciais de login para o aplicativo e AppFabric permitir o acesso aos seus dados para gerar insights e concluir ações.
![\[Dialog box requesting permission for AWS AppFabric to access Slack workspace data.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-07.png)
Depois de conectar uma aplicação com êxito, o status dessa aplicação mudará de “Não conectada” para “Conectada”. Lembrete: você precisa concluir essa etapa de autorização para cada aplicação que desejar que seja usada para gerar informações e ações.
Depois de conectar uma aplicação, ela não ficará conectada para sempre. Você precisará reconectar as aplicações periodicamente. Fazemos isso para garantir que ainda tenhamos sua permissão para gerar informações.
Os possíveis status das aplicações são:
+ Conectado - AppFabric está autorizado e está gerando insights usando seus dados desse aplicativo.
+ Não conectado - AppFabric não está gerando insights usando dados desse aplicativo. Você pode se conectar para começar a gerar informações.
+ Falha na autorização. Reconecte. - Pode haver uma falha na autorização com uma aplicação específica. Se necessário, insira suas credenciais de login para acessar o **repositório**.
![\[Application connection status interface showing connected and unconnected apps.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-08.png)
A configuração está concluída e você pode retornar à sua aplicação. Pode levar pelo menos algumas horas para começar a ver informações em suas aplicações.
Conforme necessário, você pode voltar para esta página para gerenciar suas aplicações conectadas. Se você optar por **desconectar** um aplicativo, AppFabric deixará de usar dados desse aplicativo ou de coletar novos dados para gerar novos insights. Os dados de aplicações desconectadas serão excluídos automaticamente em 7 dias se você optar por não reconectar a aplicação nesse período.
## Etapa 4: Comece a ver informações e execute ações entre aplicações em sua aplicação
Depois de conectar seus aplicativos AppFabric, você terá acesso a informações valiosas e a capacidade de realizar ações entre aplicativos diretamente do seu aplicativo preferido. Observação: essa funcionalidade não é garantida em cada aplicativo e depende inteiramente AppFabric de quais recursos de produtividade o desenvolvedor do aplicativo escolheu ativar.
**Informações entre aplicações**
AppFabric para produtividade oferece dois tipos de insights:
+ Insights acionáveis: AppFabric analisa informações de seus e-mails, eventos do calendário, tarefas e mensagens em seus aplicativos conectados e gera insights importantes que podem ser importantes para você priorizar. Além disso, AppFabric pode gerar ações recomendadas (como enviar e-mail, agendar reuniões e criar tarefas) que você pode editar e executar enquanto permanece em seu aplicativo preferido. Por exemplo, você pode receber uma informação dizendo que há uma escalação de clientes a ser resolvida e uma próxima ação sugerida para agendar uma reunião com seu cliente.
+ Informações sobre a preparação de reuniões: esse recurso ajuda você a se preparar melhor para as próximas reuniões. AppFabric analisará suas próximas reuniões e gerará um resumo conciso sobre o objetivo da reunião. Além disso, ele exibirá artefatos relevantes (como emails, mensagens e tarefas) de suas aplicações conectadas que serão úteis para ajudá-lo a se preparar com eficiência para a reunião sem precisar alternar entre aplicações para encontrar conteúdo.
**Ações entre aplicações**
Para determinados insights, também AppFabric pode gerar ações recomendadas, como enviar um e-mail, agendar uma reunião ou criar uma tarefa. Ao gerar ações, AppFabric pode pré-preencher determinados campos com base no conteúdo e no contexto de seus aplicativos conectados. Por exemplo, AppFabric pode gerar uma resposta de e-mail sugerida ou um nome de tarefa com base no insight. Ao clicar em uma ação sugerida, você será direcionado para uma interface de usuário AppFabric própria, na qual poderá editar o conteúdo pré-preenchido antes de executar a ação. AppFabric não executará ações sem a análise e a entrada do usuário primeiro, pois a IA generativa e os modelos de linguagem grande (LLM) subjacentes podem alucinar de tempos em tempos.
**nota**
Você tem a responsabilidade de validar e confirmar os resultados do AppFabric LLM. AppFabric não garante a precisão ou a qualidade de suas saídas LLM. Para obter mais informações, consulte [Política de IA responsável da AWS](https://aws.amazon.com/machine-learning/responsible-ai/policy/).
### Criar emails (Google Workspace, Microsoft 365)
AppFabric permite que você edite e envie um e-mail de dentro do seu aplicativo preferido. Oferecemos suporte a campos básicos de e-mail, incluindo De, Para, Cc/Bcc, Linha de assunto do e-mail e Corpo da mensagem do e-mail. AppFabric pode gerar conteúdo nesses campos para ajudá-lo a reduzir o tempo de conclusão da tarefa. Depois de terminar de editar o email, escolha **Enviar** para enviar o email.
Os campos a seguir são obrigatórios para enviar um email:
+ Pelo menos um dos emails do destinatário (Para, CC e BCC) é obrigatório e deve ser um endereço de email válido.
+ Campos de linha de assunto e mensagem.
![\[Email form with From, To, CC, BCC, Subject line, and Message fields for sending.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-12.png)
Depois que o email for enviado, você verá uma confirmação de que o email foi enviado. Além disso, você verá um link para ver o email na aplicação designada. Você pode usar esse link para navegar rapidamente até a aplicação e verificar se o email foi enviado.
![\[Email sent confirmation with recipient details and message preview.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-13.png)
### Criar evento de calendário (Google Workspace, Microsoft 365)
AppFabric permite que você edite e crie um evento de calendário a partir do seu aplicativo preferido. Oferecemos suporte aos campos básicos de eventos do calendário, incluindo título do evento, local, Start/End hora e data, lista de convidados e detalhes do evento. AppFabric pode gerar conteúdo nesses campos para ajudá-lo a reduzir o tempo de conclusão da tarefa. Depois de terminar de editar o evento do calendário, escolha **Criar** para criar o evento.
Os campos a seguir são obrigatórios para criar um evento de calendário:
+ Campos Título, Início, Fim e Descrição.
+ A hora e a data de início não devem ser anteriores à hora e data de término.
+ O campo de convite é opcional, mas requer endereços de email válidos, se fornecidos.
![\[Calendar event creation form with title, time, location, invitees, and description fields.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-14.png)
Depois que o evento do calendário for enviado, você verá uma confirmação de que o evento foi criado. Além disso, você verá um link para ver o evento na aplicação designada. Você pode usar esse link para navegar rapidamente até a aplicação e verificar se o evento foi criado.
![\[Calendar event creation confirmation with event details and option to view in Google Calendar.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-15.png)
### Criar tarefas (Asana)
AppFabric permite que você edite e crie uma tarefa de dentro Asana do seu aplicativo preferido. Oferecemos suporte a campos básicos de tarefas, como nome da tarefa, proprietário da tarefa, data de vencimento e descrição da tarefa. AppFabric pode gerar conteúdo nesses campos para ajudá-lo a reduzir o tempo de criação da tarefa. Depois de terminar de editar a tarefa, escolha **Criar** para criar a tarefa. As tarefas são criadas no espaço de trabalho, projeto ou tarefa aplicável do Asana, conforme sugerido pelo LLM.
Os campos a seguir são obrigatórios para criar uma tarefa do Asana:
+ Campos Título e Descrição.
+ O destinatário deve ser um endereço de email válido se modificado.
![\[Create Task form with fields for title, assignee, due date, and description for a finance meeting task.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-16.png)
Depois que a tarefa for criada, você verá uma confirmação de que a tarefa foi criada no Asana. Além disso, você verá um link para visualizar a tarefa no Asana. É possível usar esse link para navegar rapidamente até a aplicação para verificar se a tarefa foi criada ou movê-la para o espaço de trabalho, projeto ou tarefa do Asana apropriados.
![\[Task creation confirmation with details and a link to view in Asana.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-17.png)
### Criar tarefas (Smartsheet)
AppFabric permite que você edite e crie uma tarefa de dentro Smartsheet do seu aplicativo preferido. Oferecemos suporte a campos básicos de tarefas, como nome da tarefa, proprietário da tarefa, data de vencimento e descrição da tarefa. AppFabric pode gerar conteúdo nesses campos para ajudá-lo a reduzir o tempo de criação da tarefa. Depois de terminar de editar a tarefa, escolha **Criar** para criar a tarefa. Para Smartsheet tarefas, AppFabric criará uma nova Smartsheet planilha privada e preencherá todas as tarefas criadas. Isso é feito para ajudar a centralizar as ações AppFabric geradas em um único local de forma estruturada.
Os campos a seguir são obrigatórios para criar uma tarefa do Smartsheet:
+ Campos Título e Descrição.
+ O destinatário deve ter um endereço de email válido, se fornecido.
![\[Create Task form with fields for title, assignees, due date, and description for an AWS AppFabric Action.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-18.png)
Depois que a tarefa for criada, você verá uma confirmação de que a tarefa foi criada no Smartsheet. Além disso, você verá um link para visualizar a tarefa no Smartsheet. É possível usar esse link para navegar rapidamente até a aplicação para visualizar a tarefa na planilha do Smartsheet criada. Todas as tarefas futuras do Smartsheet serão preenchidas nessa planilha. Se a planilha for excluída, AppFabric criará uma nova.
![\[AWS AppFabric Action interface showing a successfully created task with details.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-19.png)
# Gerencie o AppFabric acesso aos recursos de produtividade (versão prévia) para administradores de TI e segurança
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
O portal do usuário AppFabric para produtividade está acessível publicamente a todos os usuários de aplicativos SaaS que se integraram aos recursos AppFabric de produtividade (versão prévia). Se você é um administrador de TI e deseja gerenciar o acesso a esses recursos de IA generativa em sua organização, considere estas opções:
+ Restringir o login do provedor de identidades (IdP): você pode bloquear o acesso ao login por meio do seu provedor de identidades para controlar o acesso do usuário aos recursos de IA generativa.
+ Desativar OAuth para aplicativos específicos: implemente restrições posteriores OAuth desativando. Essa ação impede que os usuários conectem aplicativos que exigem OAuth autenticação ao espaço de trabalho da empresa.
# Solucione erros do usuário final AppFabric para aumentar a produtividade
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Esta seção descreve erros comuns e soluções de problemas AppFabric para aumentar a produtividade.
## Aplicação não verificada
Os aplicativos que usam a produtividade AppFabric para enriquecer suas experiências de aplicativos passarão por um processo de verificação antes de lançarem seus recursos para os usuários finais. Se você encontrar um banner “não verificado” ao tentar fazer login AppFabric, isso significa que o aplicativo não passou pelo processo de verificação que confirma a identidade AppFabric do desenvolvedor do aplicativo e a precisão das informações de registro do aplicativo. Todas as aplicações começam como não verificadas e mudam para verificadas somente quando o processo de verificação é concluído.
Tenha cuidado ao usar uma aplicação não verificada. Se você não tiver certeza sobre os desenvolvedores da aplicação, espere até que a aplicação atinja o status de verificada antes de continuar.
![\[Warning message for an unverified application in AWS AppFabric, advising caution before authorization.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-20.png)
## Algo deu errado. Tente novamente ou verifique com seu administrador (`InternalServerException`)
Você pode receber essa mensagem quando o portal AppFabric do usuário não consegue listar os aplicativos ou desconecta um aplicativo devido a um erro, exceção ou falha desconhecidos. Tente novamente mais tarde.
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-23.png)
## A solicitação foi negada devido à limitação da solicitação. Por favor, tente novamente daqui a algum tempo (`ThrottlingException`)
Você pode receber essa mensagem quando o portal AppFabric do usuário não consegue listar os aplicativos ou desconecta um aplicativo devido a um problema de limitação. Tente novamente mais tarde.
![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-22.png)
## Você não está autorizado a usar AppFabric. Por favor, faça login AppFabric novamente (`AccessDeniedException`)
Você pode receber essa mensagem quando o portal AppFabric do usuário não consegue listar os aplicativos ou desconecta um aplicativo devido a uma exceção de acesso negado. Faça login AppFabric novamente.
![\[Connect applications interface showing connected and unconnected apps with action buttons.\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/images/fabric-21.png)
# AppFabric para produtividade APIs (versão prévia)
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Esta seção fornece as operações de API, os tipos de dados e os erros comuns dos recursos de AWS AppFabric produtividade.
**nota**
Para todos os outros AppFabric APIs, consulte a [Referência AWS AppFabric da API](https://docs.aws.amazon.com/appfabric/latest/api/).
**Topics**
+ [Ações de API AppFabric para aumentar a produtividade (versão prévia)](productivity-actions.md)
+ [Tipos de dados de API AppFabric para aumentar a produtividade (versão prévia)](productivity-data-types.md)
+ [Erros comuns de API AppFabric para fins de produtividade (versão prévia)](productivity-common-errors.md)
# Ações de API AppFabric para aumentar a produtividade (versão prévia)
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
As ações a seguir são compatíveis com AppFabric os recursos de produtividade.
Para todas as outras ações de AppFabric API, consulte as [Ações de AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html).
**Topics**
+ [Autorizar](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)
# Autorizar
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Autoriza um AppClient.
**Topics**
+ [Corpo da solicitação](#API_Authorize_request)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **app\$1client\$1id** | O ID do a AppClient ser autorizado. |
| **redirect\$1uri** | O URI para o qual redirecionar os usuários finais após a autorização. |
| **estado** | Um valor exclusivo para manter o estado entre a solicitação e o retorno de chamada. |
# CreateAppClient
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Cria um AppClient.
**Topics**
+ [Corpo da solicitação](#API_CreateAppClient_request)
+ [Elementos de resposta](#API_CreateAppClient_response)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **appName** | O nome do app. Tipo: string Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255. Obrigatório: Sim |
| **clientToken** | Especifica um identificador exclusivo que diferencia maiúsculas e minúsculas fornecido para garantir a idempotência da solicitação. Isso permite que você repita a solicitação com segurança sem executar acidentalmente a mesma operação pela segunda vez. Passar o mesmo valor para uma chamada posterior para uma operação exige que você também passe o mesmo valor para todos os outros parâmetros. Recomendamos que você use um [tipo de valor UUID](https://wikipedia.org/wiki/Universally_unique_identifier). Se você não fornecer esse valor, AWS gerará um valor aleatório para você. Se você repetir a operação com o mesmo `ClientToken`, mas com parâmetros diferentes, a nova tentativa falhará com um erro `IdempotentParameterMismatch`. Tipo: sequência Padrão: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obrigatório: não |
| **customerManagedKeyIdentifier** | O ARN do chave gerenciada pelo cliente gerado por. AWS Key Management Service A chave é usada para criptografar os dados. Se nenhuma chave for especificada, um Chave gerenciada pela AWS será usado. Um mapa dos pares de chave-valor para a tag ou tags a atribuir ao recurso. Para obter mais informações sobre Chaves pertencentes à AWS chaves gerenciadas pelo cliente, consulte [Chaves e AWS chaves do cliente](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) no *Guia do AWS Key Management Service desenvolvedor*. Tipo: string Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 1011. Padrão: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obrigatório: não |
| **descrição** | Uma descrição para a aplicação. Tipo: String Obrigatório: Sim |
| **iconUrl** | O URL do ícone ou logotipo do AppClient. Tipo: string Obrigatório: não |
| **redirectUrls** | O URI para o qual redirecionar os usuários finais após a autorização. É possível adicionar até 5 redirectUrls. Por exemplo, .`https://localhost:8080` Tipo: matriz de strings Membros da Matriz: número mínimo de 1 item. Número máximo de 5 itens. Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 2.048. Padrão: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` Obrigatório: Sim |
| **starterUserEmails** | Endereços de e-mail iniciais para usuários que têm permissão para receber insights até que sejam verificados. AppClient Tipo: matriz de strings Membros da matriz: número fixo de 1 item. Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 320. Padrão: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` Obrigatório: Sim |
| **tags** | Um mapa dos pares de chave-valor para a tag ou tags a atribuir ao recurso. Tipo: matriz de objetos Tag Membros da Matriz: número mínimo de 0 itens. Número máximo de 50 itens. Obrigatório: não |
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.
Os dados a seguir são retornados no formato JSON pelo serviço.
| Parâmetro | Description |
| --- | --- |
| **appClientSummary** | Contém um resumo do AppClient. Tipo: objeto [AppClientSummary](API_AppClientSummary.md) |
# DeleteAppClient
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Exclui um cliente de aplicação.
**Topics**
+ [Corpo da solicitação](#API_DeleteAppClient_request)
+ [Elementos de resposta](#API_DeleteAppClient_response)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **appClientIdentifier** | O Amazon Resource Name (ARN) ou o Universal Unique Identifier (UUID) do a AppClient ser usado para a solicitação. Restrições de Tamanho: tamanho mínimo 1. O comprimento máximo é 1011. Padrão: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obrigatório: sim |
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.
# GetAppClient
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Retorna informações sobre um AppClient.
**Topics**
+ [Corpo da solicitação](#API_GetAppClient_request)
+ [Elementos de resposta](#API_GetAppClient_response)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **appClientIdentifier** | O Amazon Resource Name (ARN) ou o Universal Unique Identifier (UUID) do a AppClient ser usado para a solicitação. Restrições de Tamanho: tamanho mínimo 1. O comprimento máximo é 1011. Padrão: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obrigatório: sim |
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
| Parâmetro | Description |
| --- | --- |
| **appClient** | Contém informações sobre um AppClient. Tipo: objeto [AppClient](API_AppClient.md) |
# ListActionableInsights
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Lista as mensagens de email, tarefas e outras atualizações acionáveis mais importantes.
**Topics**
+ [Corpo da solicitação](#API_ListActionableInsights_request)
+ [Elementos de resposta](#API_ListActionableInsights_response)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **nextToken** | Se o `nextToken` for retornado, haverá mais resultados disponíveis. O valor de `nextToken` é um token de paginação exclusivo para cada página. Faça a chamada novamente usando o token retornado para recuperar a próxima página. Mantenha todos os outros argumentos inalterados. Cada token de paginação expira após 24 horas. Usar um token de paginação expirado retornará um erro *HTTP* 400. InvalidToken |
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.
Os dados a seguir são retornados no formato JSON pelo serviço.
| Parâmetro | Description |
| --- | --- |
| **ActionableInsightsList** | Lista as informações acionáveis, incluindo título, descrição, ações e timestamp de criação. Para obter mais informações, consulte [ActionableInsights](API_ActionableInsights.md). |
| **nextToken** | Se o `nextToken` for retornado, haverá mais resultados disponíveis. O valor de `nextToken` é um token de paginação exclusivo para cada página. Faça a chamada novamente usando o token retornado para recuperar a próxima página. Mantenha todos os outros argumentos inalterados. Cada token de paginação expira após 24 horas. Usar um token de paginação expirado retornará um erro *HTTP* 400. InvalidToken Tipo: string |
# ListAppClients
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Retorna uma lista de todos AppClients.
**Topics**
+ [Corpo da solicitação](#API_ListAppClients_request)
+ [Elementos de resposta](#API_ListAppClients_response)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **maxResults** | O número máximo de resultados a serem retornados por chamada. É possível usar `nextToken` para obter páginas de resultados adicionais. Esse é apenas um limite superior. O número real de resultados retornados por chamada pode ser menor que o máximo especificado. Faixa válida: valor mínimo de 1. Valor máximo de 100. |
| **nextToken** | Se o `nextToken` for retornado, haverá mais resultados disponíveis. O valor de `nextToken` é um token de paginação exclusivo para cada página. Faça a chamada novamente usando o token retornado para recuperar a próxima página. Mantenha todos os outros argumentos inalterados. Cada token de paginação expira após 24 horas. Usar um token de paginação expirado retornará um erro *HTTP* 400. InvalidToken |
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
| Parâmetro | Description |
| --- | --- |
| **appClientList** | Contém uma lista de AppClient resultados. Tipo: matriz de objetos [AppClientSummary](API_AppClientSummary.md) |
| **nextToken** | Se o `nextToken` for retornado, haverá mais resultados disponíveis. O valor de `nextToken` é um token de paginação exclusivo para cada página. Faça a chamada novamente usando o token retornado para recuperar a próxima página. Mantenha todos os outros argumentos inalterados. Cada token de paginação expira após 24 horas. Usar um token de paginação expirado retornará um erro *HTTP* 400. InvalidToken Tipo: string |
# ListMeetingInsights
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Lista os eventos acionáveis mais importantes do calendário.
**Topics**
+ [Corpo da solicitação](#API_ListMeetingInsights_request)
+ [Elementos de resposta](#API_ListMeetingInsights_response)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **nextToken** | Se o `nextToken` for retornado, haverá mais resultados disponíveis. O valor de `nextToken` é um token de paginação exclusivo para cada página. Faça a chamada novamente usando o token retornado para recuperar a próxima página. Mantenha todos os outros argumentos inalterados. Cada token de paginação expira após 24 horas. Usar um token de paginação expirado retornará um erro *HTTP* 400. InvalidToken |
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.
Os dados a seguir são retornados no formato JSON pelo serviço.
| Parâmetro | Description |
| --- | --- |
| **MeetingInsightList** | Lista as informações acionáveis da reunião. Para obter mais informações, consulte [MeetingInsights](API_MeetingInsights.md). |
| **nextToken** | Se o `nextToken` for retornado, haverá mais resultados disponíveis. O valor de `nextToken` é um token de paginação exclusivo para cada página. Faça a chamada novamente usando o token retornado para recuperar a próxima página. Mantenha todos os outros argumentos inalterados. Cada token de paginação expira após 24 horas. Usar um token de paginação expirado retornará um erro *HTTP* 400. InvalidToken Tipo: string |
# PutFeedback
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Permite que os usuários enviem comentários sobre determinada informação ou ação.
**Topics**
+ [Corpo da solicitação](#API_PutFeedback_request)
+ [Elementos de resposta](#API_PutFeedback_response)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **id** | O ID do objeto para o qual o comentário está sendo enviado. Isso pode ser o InsightId ou ActionId o. |
| **feedbackFor** | O tipo de informação para o qual o comentário está sendo enviado. Valores possíveis: `ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION` |
| **feedbackRating** | Classificação do comentário de `1` a `5`. Quanto maior a classificação, melhor. |
## Elementos de resposta
Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 201 com um corpo HTTP vazio.
# Token
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Contém informações que permitem AppClients trocar um código de autorização por um token de acesso.
**Topics**
+ [Corpo da solicitação](#API_Token_request)
+ [Elementos de resposta](#API_Token_response)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **Código ** | O código de autorização recebido do endpoint de autorização. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2.048. Obrigatório: não |
| **grant\$1type** | O tipo de concessão do token. Deve ser `authorization_code` ou `refresh_token`. Tipo: String Obrigatório: Sim |
| **app\$1client\$1id** | O ID da AppClient. Tipo: sequência Padrão: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obrigatório: Sim |
| **redirect\$1uri** | A URI de redirecionamento passada para o endpoint de autorização. Tipo: string Obrigatório: não |
| **refresh\$1token** | O token de atualização recebido da solicitação inicial do token. Tipo: string Restrições de comprimento: tamanho mínimo de 1. O tamanho máximo é 4.096. Obrigatório: não |
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
| Parâmetro | Description |
| --- | --- |
| **appfabric\$1user\$1id** | O ID do usuário para o token. Isso é retornado somente para solicitações que usem o tipo de concessão `authorization_code`. Tipo: string |
| **expires\$1in** | O número de segundos até a expiração do token. Tipo: longo |
| **refresh\$1token** | O token de atualização a ser usado em uma solicitação subsequente. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2.048. |
| **token** | O token de acesso. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2.048. |
| **token\$1type** | O tipo de token. Tipo: string |
# UpdateAppClient
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Atualiza um AppClient.
**Topics**
+ [Corpo da solicitação](#API_UpdateAppClient_request)
+ [Elementos de resposta](#API_UpdateAppClient_response)
## Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
| Parâmetro | Description |
| --- | --- |
| **appClientIdentifier** | O Amazon Resource Name (ARN) ou o Universal Unique Identifier (UUID) do a AppClient ser usado para a solicitação. Restrições de Tamanho: tamanho mínimo 1. O comprimento máximo é 1011. Padrão: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obrigatório: Sim |
| **redirectUrls** | O URI para o qual redirecionar os usuários finais após a autorização. É possível adicionar até 5 redirectUrls. Por exemplo, .`https://localhost:8080` Tipo: matriz de strings Membros da Matriz: número mínimo de 1 item. Número máximo de 5 itens. Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 2.048. Padrão: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` |
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
| Parâmetro | Description |
| --- | --- |
| **appClient** | Contém informações sobre um AppClient. Tipo: objeto [AppClient](API_AppClient.md) |
# Tipos de dados de API AppFabric para aumentar a produtividade (versão prévia)
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
A AppFabric API contém vários tipos de dados que várias ações usam. Esta seção descreve detalhadamente os tipos AppFabric de dados dos recursos de produtividade.
Para todos os outros tipos de dados AppFabric da API, consulte os [Tipos de dados AWS AppFabric da API](https://docs.aws.amazon.com/appfabric/latest/api/API_Types.html).
**Importante**
A ordem de cada elemento em uma estrutura de tipo de dados não é garantida. As aplicações não devem presumir uma ordem específica.
**Topics**
+ [ActionableInsights](API_ActionableInsights.md)
+ [AppClient](API_AppClient.md)
+ [AppClientSummary](API_AppClientSummary.md)
+ [MeetingInsights](API_MeetingInsights.md)
+ [VerificationDetails](API_VerificationDetails.md)
# ActionableInsights
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Contém um resumo das ações importantes e adequadas para um usuário com base em emails, convites de calendário, mensagens e tarefas do portfólio de aplicações. Os usuários podem ver informações proativas dentre todas as aplicações para ajudá-los a orientar melhor seu dia. Essas informações fornecem uma justificativa sobre por que um usuário deve se preocupar com o resumo da informação junto com referências, como links incorporados, a aplicações e artefatos individuais que geraram a informação.
| Parâmetro | Description |
| --- | --- |
| **insightId** | O id exclusivo da informação gerada. |
| **insightContent** | Retorna um resumo da informação e links incorporados aos artefatos usados para gerar a informação. Isso seria um conteúdo HTML contendo links incorporados (tags ``). |
| **insightTitle** | O título da informação gerada. |
| **createdAt** | Quando a informação foi gerada. |
| **actions** | Uma lista de ações recomendadas para a informação gerada. O objeto de ação contém os seguintes parâmetros: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/API_ActionableInsights.html) |
# AppClient
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Contém informações sobre um AppClient.
**Topics**
| Parâmetro | Description |
| --- | --- |
| **appName** | O nome da aplicação. Tipo: String Obrigatório: Sim |
| **arn** | O nome de recurso da Amazon (ARN) de AppClient. Tipo: string Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 1011. Padrão: `arn:.+` Obrigatório: Sim |
| **descrição** | Uma descrição da aplicação. Tipo: String Obrigatório: Sim |
| **iconUrl** | O URL do ícone ou logotipo do AppClient. Tipo: string Obrigatório: não |
| **redirectUrls** | O redirecionamento permitido URLs para o. AppClient Tipo: matriz de strings Membros da Matriz: número mínimo de 1 item. Número máximo de 5 itens. Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 2.048. Padrão: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` Obrigatório: Sim |
| **starterUserEmails** | Endereços de e-mail iniciais para usuários que têm permissão para receber insights até que sejam verificados. AppClient Tipo: matriz de strings Membros da matriz: número fixo de 1 item. Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 320. Padrão: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` Obrigatório: Sim |
| **verificationDetails** | Contém o status e o motivo da AppClient verificação. Tipo: objeto [VerificationDetails](API_VerificationDetails.md) Obrigatório: Sim |
| **customerManagedKeyArn** | O nome de recurso da Amazon (ARN) do chave gerenciada pelo cliente gerado por AWS Key Management Service para o. AppClient Tipo: string Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 1011. Padrão: `arn:.+` Obrigatório: não |
| **appClientId** | O ID da AppClient. Destinado a ser usado em fluxos o-auth para o cliente do aplicativo. Tipo: sequência Padrão: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obrigatório: não |
# AppClientSummary
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Contém informações sobre um AppClient.
**Topics**
| Parâmetro | Description |
| --- | --- |
| **arn** | O nome de recurso da Amazon (ARN) de AppClient. Tipo: string Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 1011. Padrão: `arn:.+` Obrigatório: Sim |
| **verificationStatus** | O status da AppClient verificação. Tipo: string Valores válidos: `pending_verification \| verified \| rejected` Obrigatório: Sim |
| **appClientId** | O ID da AppClient. Destinado a ser usado em fluxos o-auth para o cliente do aplicativo. Tipo: sequência Padrão: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Obrigatório: não |
# MeetingInsights
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Contém um resumo das três principais reuniões, juntamente com o objetivo da reunião, artefatos relacionados entre aplicações e atividades de tarefas, emails, mensagens e eventos do calendário.
| Parâmetro | Description |
| --- | --- |
| **insightId** | O id exclusivo da informação gerada. |
| **insightContent** | A descrição da informação, destacando os detalhes em um formato de string. Por exemplo, por que essa informação é importante. |
| **insightTitle** | O título da informação gerada. |
| **createdAt** | Quando a informação foi gerada. |
| **calendarEvent** | O evento ou reunião importante do calendário em que o usuário deve se concentrar. Objeto Calendar Event: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **recursos** | A lista contendo os outros recursos relacionados à geração da informação. Objeto de recurso: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appfabric/latest/adminguide/API_MeetingInsights.html) |
| **nextToken** | O token de paginação para obter o próximo conjunto de informações. É um campo opcional que, se retornado nulo, significa que não há mais informações a serem carregadas. |
# VerificationDetails
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Contém o status e o motivo da AppClient verificação.
**Topics**
| Parâmetro | Description |
| --- | --- |
| **verificationStatus** | O status da AppClient verificação. Tipo: string Valores válidos: `pending_verification \| verified \| rejected` Obrigatório: Sim |
| **statusReason** | O motivo do status da AppClient verificação. Tipo: string Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024. Obrigatório: não |
# Erros comuns de API AppFabric para fins de produtividade (versão prévia)
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
Esta seção lista os erros comuns às ações da API para os recursos de AWS AppFabric produtividade.
Para ver todos os outros erros AppFabric comuns da API, consulte [Solucione problemas AppFabric para AppClients aumentar a produtividade](ahead-app-dev-errors.md) “[Erros comuns da AWS AppFabric API](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html)” na *Referência da AWS AppFabric API*.
| Nome de exceção | Description |
| --- | --- |
| **TokenException** | A solicitação do token não é válida. Código de status HTTP: 400 |
# Processamento de dados em AppFabric
| |
| --- |
| O recurso AWS AppFabric de produtividade está em versão prévia e está sujeito a alterações. |
AppFabric adota medidas para armazenar o conteúdo do usuário individualmente, em um bucket do Amazon S3 gerenciado por AppFabric e separadamente; o que ajuda a garantir a geração de insights específicos do usuário. Usamos salvaguardas razoáveis para proteger seu conteúdo, o que pode incluir criptografia em repouso e em trânsito. Configuramos nossos sistemas para excluir automaticamente o conteúdo do cliente dentro de 30 dias a partir da ingestão. AppFabric não gera insights usando artefatos de dados aos quais o usuário não tem mais acesso. Por exemplo, quando um usuário desconecta uma fonte de dados (um aplicativo), AppFabric para de coletar dados desse aplicativo e não usa nenhum artefato remanescente dos aplicativos desconectados para gerar insights. AppFabricOs sistemas da são configurados para excluir esses dados em 30 dias.
AppFabric não usa o conteúdo do usuário para treinar ou melhorar os grandes modelos de linguagem subjacentes usados para gerar insights. Para obter mais informações sobre AppFabric o recurso generativo de IA, consulte [Amazon Bedrock FAQs](https://aws.amazon.com/bedrock/faqs/).
## Criptografia em repouso
AWS AppFabric oferece suporte à criptografia em repouso, um recurso de criptografia do lado do servidor que criptografa de AppFabric forma transparente todos os dados relacionados aos usuários quando eles são mantidos no disco e os descriptografa quando você acessa os dados.
## Criptografia em trânsito
AppFabric protege todo o conteúdo em trânsito usando o TLS 1.2 e assina solicitações de API para AWS serviços com o AWS Signature versão 4.