Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Introducción a la AppFabric productividad (versión preliminar) para desarrolladores de aplicaciones

Esta sección ayuda a los desarrolladores de aplicaciones AWS AppFabric a integrar la productividad (vista previa) en sus aplicaciones. AWS AppFabric for productivity permite a los desarrolladores crear experiencias de aplicaciones más sofisticadas para sus usuarios al generar información y acciones impulsadas por la IA a partir de correos electrónicos, eventos del calendario, tareas, mensajes y más en múltiples aplicaciones. Para ver una lista de las aplicaciones compatibles, consulte Aplicaciones AWS AppFabric compatibles.

AppFabric for productivity ofrece a los desarrolladores de aplicaciones el acceso a crear y experimentar en un entorno seguro y controlado. Al empezar a utilizarla AppFabric para fines de productividad, se crea un único usuario de prueba AppClient y se registra uno. Este enfoque está diseñado para ayudarlo a comprender y probar el flujo de autenticación y comunicación entre su aplicación y AppFabric. Después de realizar la prueba con un solo usuario, puede enviar su solicitud AppFabric para su verificación antes de ampliar el acceso a otros usuarios (consultePaso 5. Solicitud AppFabric para verificar su solicitud). AppFabric verificará la información de la aplicación antes de permitir una adopción generalizada para ayudar a proteger a los desarrolladores de aplicaciones, a los usuarios finales y sus datos, lo que allanará el camino para ampliar la adopción por parte de los usuarios de manera responsable.

Requisitos previos

Antes de empezar, necesitas crear un Cuenta de AWS. Para obtener más información, consulte Inscríbase en una Cuenta de AWS. También debe crear al menos un usuario con acceso a la política de "appfabric:CreateAppClient" IAM que se indica a continuación, con AppFabric la que el usuario podrá registrar su solicitud. Para obtener más información sobre la concesión de permisos AppFabric para las funciones de productividad, consulteAppFabric para ver ejemplos de políticas de IAM de productividad. Si bien disponer de un usuario administrativo es útil, no es obligatorio para la configuración inicial. Para obtener más información, consulte Creación de un usuario con acceso administrativo.

AppFabric para la productividad solo está disponible en EE. UU. Este (Norte de Virginia) durante la versión preliminar. Asegúrese de estar en esta región antes de iniciar los pasos que se indican a continuación.

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

Paso 1. Cree una AppFabric para la productividad AppClient

Antes de poder empezar a AppFabric buscar información sobre la productividad de su aplicación, debe crear una AppFabric AppClient. Básicamente, An AppClient es su puerta de entrada a AppFabric la productividad, ya que funciona como un cliente de aplicaciones OAuth seguro que permite una comunicación segura entre su aplicación y. AppFabric Cuando crees una AppClient, recibirás un AppClient ID, un identificador único crucial para asegurarte de que AppFabric funciona con tu aplicación y la tuya. Cuenta de AWS

AppFabric for productivity ofrece a los desarrolladores de aplicaciones el acceso a crear y experimentar en un entorno seguro y controlado. Al empezar a utilizarla AppFabric para fines de productividad, se crea un único usuario de prueba AppClient y se registra uno. Este enfoque está diseñado para ayudarlo a comprender y probar el flujo de autenticación y comunicación entre su aplicación y AppFabric. Después de realizar la prueba con un solo usuario, puede enviar su solicitud AppFabric para su verificación antes de ampliar el acceso a otros usuarios (consultePaso 5. Solicitud AppFabric para verificar su solicitud). AppFabric verificará la información de la aplicación antes de permitir una adopción generalizada para ayudar a proteger a los desarrolladores de aplicaciones, a los usuarios finales y sus datos, lo que allanará el camino para ampliar la adopción por parte de los usuarios de manera responsable.

Para crear una AppClient, utilice la operación de la AWS AppFabric CreateAppClient API. Si necesitas actualizar la versión AppClient posterior, puedes usar la operación de UpdateAppClient API para cambiar solo las URL de redireccionamiento. Si necesitas cambiar alguno de los demás parámetros asociados a tu aplicación, AppClient como el nombre de la aplicación o la descripción, debes eliminarlo AppClient y crear uno nuevo. Para obtener más información, consulte CreateAppClient.

Puede registrar su aplicación en los AWS servicios mediante la CreateAppClient API mediante varios lenguajes de programación, incluidos Python, Node.js, Java, C#, Go y Rust. Para obtener más información, consulte Ejemplos de firma de solicitudes en la Guía del usuario de IAM. Debe utilizar las credenciales de su cuenta de Signature versión 4 para realizar esta operación de la API. Para obtener más información sobre la versión 4 de la firma, consulte Firmar las solicitudes de la AWS API en la Guía del usuario de IAM.

Campos requeridos

Campos de respuesta

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

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

Paso 2. Autenticación y autorización de su aplicación

Permite que tu aplicación integre AppFabric información de forma segura mediante el establecimiento de un flujo de autorización de OAuth 2.0. En primer lugar, debe crear un código de autorización que verifique la identidad de su aplicación. Para obtener más información, consulte Autorizar. Luego, cambiarás este código de autorización por un token de acceso, que otorga a tu aplicación los permisos necesarios para obtener y mostrar AppFabric información dentro de ella. Para obtener más información, consulte Token.

Para obtener más información sobre cómo conceder permisos para autorizar una aplicación, consulte Permitir el acceso para autorizar aplicaciones.

Paso 3. Añada la URL del portal de AppFabric usuario a su aplicación

Los usuarios finales deben autorizarse AppFabric a acceder a los datos de sus aplicaciones que se utilizan para generar información. AppFabric elimina la complejidad que supone para los desarrolladores de aplicaciones la responsabilidad de este proceso mediante la creación de un portal de usuario dedicado (una pantalla emergente) para que los usuarios finales autoricen sus aplicaciones. Cuando los usuarios estén preparados AppFabric para aumentar la productividad, accederán al portal de usuarios que les permitirá conectar y gestionar las aplicaciones que se utilizan para generar información y realizar acciones entre aplicaciones. Al iniciar sesión, los usuarios pueden conectar las aplicaciones AppFabric para aumentar la productividad y, después, volver a la aplicación para explorar los conocimientos y las acciones. Para integrar la aplicación con AppFabric fines de productividad, debe añadir una AppFabric URL específica a la aplicación. Este paso es crucial para permitir a los usuarios acceder al portal de AppFabric usuarios directamente desde la aplicación.

Tras añadir la URL, la aplicación se configurará para dirigir a los usuarios al portal AppFabric de usuarios. Aquí, los usuarios pueden iniciar sesión, conectarse y gestionar las aplicaciones que utilizan AppFabric para generar información sobre la productividad.

Paso 4. AppFabric Úselo para mostrar información y acciones entre aplicaciones

Una vez que los usuarios conecten sus aplicaciones, puedes aprovechar la información de tus usuarios para mejorar su productividad y reducir el cambio de contexto y aplicación. AppFabric solo genera información para un usuario en función de lo que el usuario tiene permiso para acceder. AppFabric almacena los datos del usuario en una Cuenta de AWS propiedad de AppFabric. Para obtener información sobre cómo AppFabric utiliza sus datos, consulteProcesamiento de datos.

Puede usar las siguientes API con tecnología de inteligencia artificial para generar y mostrar información y acciones a nivel de usuario en sus aplicaciones:

Conocimientos prácticos (ListActionableInsights)

La API ListActionableInsights ayuda a los usuarios a administrar mejor su día a día y obtener información útil basada en la actividad de sus aplicaciones, como el correo electrónico, el calendario, los mensajes, las tareas y mucho más. La información devuelta también mostrará enlaces insertados a los artefactos utilizados para generar la información, lo que ayudará a los usuarios a ver rápidamente qué datos se utilizaron para generar la información. Además, la API puede mostrar acciones sugeridas en función de la información y permitir a los usuarios ejecutar acciones entre aplicaciones desde su aplicación. En concreto, la API se integra con plataformas como Asana, Google Workspace, Microsoft 365 y Smartsheet para que los usuarios envíen correos electrónicos, creen eventos de calendario y tareas. Los modelos de lenguaje grande (LLM) pueden completar previamente los detalles de una acción recomendada (como el cuerpo del correo electrónico o el nombre de la tarea), que los usuarios pueden personalizar antes de ejecutarla, lo que simplifica la toma de decisiones y mejora la productividad. Al igual que ocurre con los usuarios finales al autorizar aplicaciones, AppFabric utiliza el mismo portal dedicado para que los usuarios vean, editen y ejecuten acciones entre aplicaciones. Para ejecutar acciones, AppFabric requiere que los ISV redirijan a los usuarios a un portal de AppFabric usuarios donde puedan ver los detalles de las acciones y ejecutarlas. Cada acción generada por AppFabric tiene una URL única. Esta URL está disponible en la respuesta a la respuesta de la API ListActionableInsights.

A continuación, se muestra un resumen de las acciones entre aplicaciones compatibles y en qué aplicaciones:

Campos requeridos

Encabezado de la solicitud

Campos de respuesta

Para obtener más información, consulte ActionableInsights.

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta 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
}

Preparación para la reunión (ListMeetingInsights)

La API ListMeetingInsights ayuda a los usuarios a prepararse mejor para las próximas reuniones al resumir el propósito de la reunión y mostrar artefactos pertinentes entre aplicaciones, como correos electrónicos, mensajes y más. Ahora los usuarios pueden prepararse rápidamente para las reuniones y no perder el tiempo al cambiar de una aplicación a otra para buscar contenido.

Campos requeridos

Campos de respuesta

Para obtener más información, consulte MeetingInsights.

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta 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
}

Proporcione comentarios sobre sus información o acciones

Utilice la operación de la AppFabric PutFeedback API para proporcionar comentarios sobre la información y las acciones generadas. Puedes integrar esta función en tus aplicaciones para proporcionar una forma de enviar una valoración (del 1 al 5, donde cuanto más alta sea, mejor) para una InsightId o más ActionId.

Campos requeridos

Campos de respuesta

Para obtener más información, 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
}'

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201 con un cuerpo HTTP vacío.

Paso 5. Solicitud AppFabric para verificar su solicitud

Hasta este punto, has actualizado la interfaz de usuario de la aplicación para incluir AppFabric información y acciones entre aplicaciones, y has recibido información para un solo usuario. Cuando estés satisfecho con las pruebas y desees extender tu experiencia AppFabric enriquecida a más usuarios, puedes enviar tu solicitud AppFabric para que la revisen y verifiquen. AppFabric verificará la información de la aplicación antes de permitir una adopción generalizada para ayudar a proteger a los desarrolladores de aplicaciones, los usuarios finales y sus datos, lo que allanará el camino para ampliar la adopción por parte de los usuarios de manera responsable.

Inicie el proceso de verificación

Comience el proceso de verificación al enviar un correo electrónico a appfabric-appverification@amazon.com y solicitar que se verifique su aplicación.

En el correo electrónico, incluya los siguientes detalles:

Además, proporcione la siguiente información, si está disponible, para ayudarnos a evaluar la prioridad y el impacto:

Criterios de verificación

Antes de iniciar el proceso de verificación, asegúrese de que cumple los siguientes criterios:

Además, cumple al menos uno de estos criterios:

Actualización del estado de verificación en espera

Tras revisar tu solicitud, te responderemos por correo electrónico y el estado de tu solicitud AppClient cambiará de pending_verification averified. Si su aplicación es rechazada, tendrá que volver a iniciar el proceso de verificación.