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á.

Comece a usar AppFabric para produtividade (versão prévia) para desenvolvedores de aplicativos

Esta seção ajuda os desenvolvedores de aplicativos a integrarem AWS AppFabric para produtividade (pré-visualização) em seus aplicativos. 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 AWS AppFabric Aplicativos compatíveis.

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 (consulteEtapa 5. Solicitação AppFabric para verificar sua inscriçã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.

Pré-requisitos

Antes de começar, você precisa criar um Conta da AWS. Para obter mais informações, consulteInscreva-se para um Conta da AWS. Você também precisa criar pelo menos um usuário com acesso à "appfabric:CreateAppClient" IAM política 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, consulteAppFabric para exemplos de IAM políticas de produtividade. 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.

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.

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

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 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 (consulteEtapa 5. Solicitação AppFabric para verificar sua inscriçã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.

Para criar um AppClient, use o AWS AppFabric CreateAppClientAPIoperação. Se precisar atualizar o AppClient depois, você pode usar a UpdateAppClient API operação para alterar somente redirectUrls o. Se você precisar alterar qualquer um dos outros parâmetros associados à sua AppClient descrição, exclua o AppClient e crie um novo. appName Para obter mais informações, consulte CreateAppClient.

Você pode registrar sua inscrição com AWS serviços CreateAppClient API usando o uso de várias linguagens de programação, incluindo Python, Node.js, Java, C#, Go e Rust. Para obter mais informações, consulte Exemplos de solicitações de assinatura no Guia IAM do usuário. Você precisa usar suas credenciais de assinatura de conta versão 4 para realizar essa API operação. Para obter mais informações sobre a assinatura versão 4, consulte Assinatura AWS APIsolicitações no Guia do IAM usuário.

Campos de solicitação

Campos de resposta

curl --request POST \
  --header "Content-Type: application/json" \
  --header "X-Amz-Content-Sha256: <sha256_payload>" \
  --header "X-Amz-Security-Token: <security_token>" \
  --header "X-Amz-Date: 20230922T172215Z" \
  --header "Authorization: AWS4-HMAC-SHA256 ..." \
  --url https://appfabric.<region>.amazonaws.com/appclients/ \
  --data '{
    "appName": "Test App",
    "description": "This is a test app",
    "redirectUrls": ["https://localhost:8080"],
    "starterUserEmails": ["anyuser@example.com"],
    "customerManagedKeyIdentifier": "arn:aws:kms:<region>:<account>:key/<key>"
}'

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.

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

Para obter mais informações sobre como conceder permissão para autorizar uma aplicação, consulte Permitir acesso para autorizar aplicações.

Etapa 3. Adicione o portal AppFabric do usuário URL 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 específico AppFabric URL ao seu aplicativo. Essa etapa é crucial para permitir que os usuários acessem o portal AppFabric do usuário diretamente do seu aplicativo.

Depois de adicionar oURL, 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 um Conta da AWS de propriedade de AppFabric. Para obter informações sobre como AppFabric usa seus dados, consulteProcessamento de dados em AppFabric.

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:

Informações acionáveis (ListActionableInsights)

ListActionableInsightsAPIIsso ajuda os usuários a gerenciar melhor seu dia, apresentando insights acionáveis com base na atividade em seus aplicativos, incluindo e-mails, 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, eles API podem retornar ações sugeridas com base no insight e permitir que os usuários executem ações entre aplicativos de dentro do seu aplicativo. Especificamente, ele API se integra a plataformas como Asana, Google Workspace, Microsoft 365 e Smartsheet para permitir que os usuários enviem e-mails, 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 uma únicaURL. Isso URL está disponível na resposta da ListActionableInsights API resposta.

Abaixo há um resumo das ações entre aplicações com suporte e em quais aplicações:

Campos de solicitação

Cabeçalho da solicitação

Campos de resposta

Para obter mais informações, consulte ActionableInsights.

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 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)

ListMeetingInsightsAPIIsso ajuda os usuários a se prepararem melhor para as próximas reuniões, resumindo o objetivo da reunião e revelando artefatos relevantes entre aplicativos, como e-mails, 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

Campos de resposta

Para obter mais informações, consulte MeetingInsights.

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

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 AppFabric PutFeedback API operação para fornecer feedback sobre os insights e ações gerados. 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

Campos de resposta

Para obter mais informações, consulte PutFeedback.

curl --request POST \
  --url "https://productivity.appfabric.<region>.amazonaws.com"\
"/feedback" \
  --header "Authorization: Bearer <token>" \
  --header "Content-Type: application/json" \
  --data '{
    "id": "1234-5678-9012",
    "feedbackFor": "ACTIONABLE_INSIGHT"
    "feedbackRating": 3
}'

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201 com o HTTP corpo 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 e solicitando que sua aplicação seja verificada.

No email, inclua os detalhes a seguir:

Além disso, forneça as seguintes informações, se disponíveis, para nos ajudar a avaliar a prioridade e o impacto:

Critérios de verificação

Antes de usar esse processo de verificação, verifique se ele atende aos critérios a seguir.

Além disso, você deve atender a pelo menos um destes critérios:

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 paraverified. Se a aplicação for rejeitada, você precisará reiniciar o processo de verificação.