Erste Schritte mit AppFabric Produktivitätssteigerung (Vorschau) für Anwendungsentwickler

Die Funktion AWS AppFabric zur Steigerung der Produktivität befindet sich in der Vorschauversion und kann sich ändern.

Dieser Abschnitt unterstützt App-Entwickler bei der Integration von „ AWS AppFabric For Productivity“ (Vorschauversion) in ihre Anwendungen. AWS AppFabric For Productivity ermöglicht es Entwicklern, ihren Benutzern umfassendere App-Erlebnisse zu bieten, indem sie KI-gestützte Erkenntnisse und Aktionen aus E-Mails, Kalenderereignissen, Aufgaben, Nachrichten und mehr für mehrere Anwendungen generieren. Eine Liste der unterstützten Anwendungen finden Sie unter AWS AppFabric Unterstützte Anwendungen.

AppFabric For Productivity bietet Entwicklern die Möglichkeit, Apps in einer sicheren und kontrollierten Umgebung zu entwickeln und zu experimentieren. Wenn Sie For Productivity AppFabric zum ersten Mal verwenden, erstellen Sie einen einzelnen Testbenutzer AppClient und registrieren ihn. Dieser Ansatz soll Ihnen helfen, den Authentifizierungs- und Kommunikationsfluss zwischen Ihrer Anwendung und zu testen und zu testen AppFabric. Nachdem Sie den Test mit einem einzelnen Benutzer durchgeführt haben, können Sie Ihre Anwendung AppFabric zur Überprüfung einreichen, bevor Sie den Zugriff auf weitere Benutzer ausweiten (sieheSchritt 5. Bitte AppFabric um Überprüfung Ihrer Bewerbung). AppFabric überprüft die Anwendungsinformationen, bevor eine breite Akzeptanz ermöglicht wird, um Anwendungsentwickler, Endbenutzer und deren Daten zu schützen und so den Weg für eine verantwortungsvolle Ausweitung der Benutzerakzeptanz zu ebnen.

Themen

• Voraussetzungen
• Schritt 1. Erstellen Sie einen AppFabric für mehr Produktivität AppClient
• Schritt 2. Authentifizieren und autorisieren Sie Ihre Anwendung
• Schritt 3. Fügen Sie die URL des AppFabric Benutzerportals zu Ihrer Anwendung hinzu
• Schritt 4. Wird verwendet AppFabric , um anwendungsübergreifende Einblicke und Aktionen zu erhalten
• Schritt 5. Bitte AppFabric um Überprüfung Ihrer Bewerbung
• Verwaltung im AppFabric Hinblick auf Produktivität AppClients
• Fehlerbehebung

Voraussetzungen

Bevor Sie beginnen, müssen Sie eine AWS-Konto erstellen. Weitere Informationen finden Sie unter Melden Sie sich an für ein AWS-Konto. Sie müssen außerdem mindestens einen Benutzer mit Zugriff auf die unten aufgeführte "appfabric:CreateAppClient" IAM-Richtlinie erstellen, mit AppFabric der der Benutzer Ihre Anwendung registrieren kann. Weitere Informationen zur Gewährung von Berechtigungen AppFabric für die Produktivitätsfunktionen finden Sie unterAppFabric für Beispiele für Produktivitätspolitik IAM. Ein Administratorbenutzer ist zwar von Vorteil, aber für die Ersteinrichtung nicht zwingend erforderlich. Weitere Informationen finden Sie unter Erstellen Sie einen Benutzer mit Administratorzugriff.

AppFabric zur Produktivitätssteigerung ist während der Vorschauphase nur in der Region USA Ost (Nord-Virginia) verfügbar. Stellen Sie sicher, dass Sie sich in dieser Region befinden, bevor Sie mit den folgenden Schritten beginnen.

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

Schritt 1. Erstellen Sie einen AppFabric für mehr Produktivität AppClient

Bevor Sie mit der Suche nach Erkenntnissen AppFabric zur Produktivität in Ihrer Anwendung beginnen können, müssen Sie eine AppFabric AppClient erstellen. Ein AppClient ist im Grunde Ihr Tor zu mehr AppFabric Produktivität. Er fungiert als sicherer OAuth-Anwendungsclient, der eine sichere Kommunikation zwischen Ihrer Anwendung und ermöglicht. AppFabric Wenn Sie einen erstellen AppClient, erhalten Sie eine AppClient ID, eine eindeutige Kennung, die entscheidend dafür ist, dass dieser AppFabric weiß, ob er mit Ihrer und Ihrer Anwendung funktioniert. AWS-Konto

AppFabric For Productivity bietet Entwicklern die Möglichkeit, Apps in einer sicheren und kontrollierten Umgebung zu entwickeln und zu experimentieren. Wenn Sie For Productivity AppFabric zum ersten Mal verwenden, erstellen Sie einen einzelnen Testbenutzer AppClient und registrieren ihn. Dieser Ansatz soll Ihnen helfen, den Authentifizierungs- und Kommunikationsfluss zwischen Ihrer Anwendung und zu testen und zu testen AppFabric. Nachdem Sie den Test mit einem einzelnen Benutzer durchgeführt haben, können Sie Ihre Anwendung AppFabric zur Überprüfung einreichen, bevor Sie den Zugriff auf weitere Benutzer ausweiten (sieheSchritt 5. Bitte AppFabric um Überprüfung Ihrer Bewerbung). AppFabric überprüft die Anwendungsinformationen, bevor eine breite Akzeptanz ermöglicht wird, um Anwendungsentwickler, Endbenutzer und deren Daten zu schützen und so den Weg für eine verantwortungsvolle Ausweitung der Benutzerakzeptanz zu ebnen.

Verwenden Sie die AWS AppFabric CreateAppClient API-Operation AppClient, um eine zu erstellen. Wenn Sie AppClient danach aktualisieren müssen, können Sie den UpdateAppClient API-Vorgang verwenden, um nur die RedirectUrls zu ändern. Wenn Sie einen der anderen mit Ihnen verknüpften Parameter AppClient wie AppName oder Beschreibung ändern müssen, müssen Sie den löschen AppClient und einen neuen erstellen. Weitere Informationen finden Sie unter CreateAppClient.

Sie können Ihre Anwendung mithilfe der CreateAppClient API bei AWS Diensten registrieren, indem Sie verschiedene Programmiersprachen verwenden, darunter Python, Node.js, Java, C#, Go und Rust. Weitere Informationen finden Sie im IAM-Benutzerhandbuch unter Beispiele für Anforderungssignaturen. Um diesen API-Vorgang durchzuführen, müssen Sie Ihre Kontosignaturdaten der Version 4 verwenden. Weitere Informationen zur Signaturversion 4 finden Sie im IAM-Benutzerhandbuch unter Signieren von AWS API-Anfragen.

Felder anfordern

• appName- Der Name der Anwendung, der den Benutzern auf der Zustimmungsseite des AppFabric Benutzerportals angezeigt wird. Auf der Einwilligungsseite werden Endbenutzer um Erlaubnis gebeten, AppFabric Einblicke in Ihre Anwendung anzuzeigen. Einzelheiten zur Einwilligungsseite finden Sie unterSchritt 2. Erteilen Sie Ihre Zustimmung zur Anzeige von Erkenntnissen durch die App.

• description- Eine Beschreibung der Anwendung.

• redirectUrls— Der URI, zu dem Endbenutzer nach der Autorisierung weitergeleitet werden sollen. Sie können bis zu 5 Weiterleitungs-URLs hinzufügen. z. B. https://localhost:8080.

• starterUserEmails- Eine Benutzer-E-Mail-Adresse, der Zugriff auf die Erkenntnisse gewährt wird, bis die Anwendung verifiziert ist. Es ist nur eine E-Mail-Adresse zulässig. Beispiel: [e-mail]

• customerManagedKeyIdentifier(optional) — Der ARN des vom Kunden verwalteten Schlüssels (generiert von KMS), der zur Verschlüsselung der Daten verwendet werden soll. Wenn nicht angegeben, wird der AWS AppFabric verwaltete Schlüssel verwendet. Weitere Informationen zu AWS-eigene Schlüssel und vom Kunden verwalteten Schlüsseln finden Sie unter Kundenschlüssel und AWS Schlüssel im AWS Key Management Service Entwicklerhandbuch.

Felder für Antworten

• appClientArn- Der Amazon-Ressourcenname (ARN), der die AppClient ID enthält. Die AppClient ID lautet beispielsweisea1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

• verificationStatus- Der AppClient Bestätigungsstatus.

  • pending_verification- Die Überprüfung von AppClient ist noch im Gange AppFabric. Bis zur AppClient Überprüfung von kann nur ein Benutzer (angegeben unterstarterUserEmails) den verwenden AppClient. Dem Benutzer wird im AppFabric Benutzerportal eine Benachrichtigung angezeigt, die in eingeführt wurde und darauf hinweistSchritt 3. Fügen Sie die URL des AppFabric Benutzerportals zu Ihrer Anwendung hinzu, dass die Anwendung nicht verifiziert wurde.

  • verified- Der Überprüfungsprozess wurde erfolgreich abgeschlossen AppFabric und AppClient ist nun vollständig verifiziert.

  • rejected- Der Überprüfungsprozess für AppClient wurde von abgelehnt AppFabric. Der AppClient kann erst dann von weiteren Benutzern verwendet werden, wenn der Überprüfungsprozess erneut initiiert und erfolgreich abgeschlossen wurde.

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": ["[e-mail]"],
    "customerManagedKeyIdentifier": "arn:aws:kms:<region>:<account>:key/<key>"
}'

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

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

Schritt 2. Authentifizieren und autorisieren Sie Ihre Anwendung

Ermöglichen Sie Ihrer Anwendung die sichere Integration von AppFabric Erkenntnissen, indem Sie einen OAuth 2.0-Autorisierungsablauf einrichten. Zunächst müssen Sie einen Autorisierungscode erstellen, der Ihre Anwendungsidentität verifiziert. Weitere Informationen finden Sie unter Autorisieren. Anschließend tauschen Sie diesen Autorisierungscode gegen ein Zugriffstoken aus, das Ihrer Anwendung die Berechtigungen zum Abrufen und Anzeigen von AppFabric Erkenntnissen innerhalb Ihrer Anwendung gewährt. Weitere Informationen finden Sie unter Token.

Weitere Informationen zur Erteilung der Genehmigung zur Autorisierung einer Anwendung finden Sie unter. Erlauben Sie den Zugriff, um Anwendungen zu autorisieren

1. Verwenden Sie den AWS AppFabric oauth2/authorize API-Vorgang, um einen Autorisierungscode zu erstellen.

   Felder anfordern

   • app_client_id(erforderlich) — Die AppClient ID für die in Schritt 1 AWS-Konto erstellte. Erstellen Sie eine AppClient. z. B. a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

   • redirect_uri(erforderlich) — Der URI, zu dem Endbenutzer nach der Autorisierung, die Sie in Schritt 1 verwendet haben, umgeleitet werden sollen. Erstellen Sie eine AppClient. z. B. https://localhost:8080.

   • state(erforderlich) — Ein eindeutiger Wert, um den Status zwischen der Anfrage und dem Rückruf beizubehalten. z. B. a8904edc-890c-1005-1996-29a757272a44.

   GET https://productivity.appfabric.<region>.amazonaws.com/oauth2/authorize?app_client_id=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\
   redirect_uri=https://localhost:8080&state=a8904edc-890c-1005-1996-29a757272a44

2. Nach der Authentifizierung werden Sie mit einem Autorisierungscode, der als Abfrageparameter zurückgegeben wird, zur angegebenen URI weitergeleitet. Zum Beispiel wocode=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc.

   https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44

3. Tauschen Sie diesen Autorisierungscode mithilfe der AppFabric oauth2/token API-Operation gegen ein Zugriffstoken aus.

   Dieses Token wird für API-Anfragen verwendet und ist zunächst gültig, starterUserEmails bis das verifiziert AppClient ist. Nach AppClient der Überprüfung kann dieses Token für jeden Benutzer verwendet werden. Sie müssen die Anmeldeinformationen für Version 4 Ihrer Kontosignatur verwenden, um diesen API-Vorgang auszuführen. Weitere Informationen zur Signaturversion 4 finden Sie im IAM-Benutzerhandbuch unter Signieren von AWS API-Anfragen.

   Felder anfordern

   • code(erforderlich) — Der Autorisierungscode, den Sie nach der Authentifizierung im letzten Schritt erhalten haben. z. B. mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc.

   • app_client_id(erforderlich) — Die in Schritt 1 AWS-Konto erstellte AppClient ID. Erstellen Sie eine AppClient. z. B. a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.

   • grant_type(erforderlich) — Der Wert muss seinauthorization_code.

   • redirect_uri(erforderlich) — Der URI, zu dem Benutzer nach der Autorisierung weitergeleitet werden sollen, die Sie in Schritt 1 verwendet haben. Erstellen Sie eine AppClient. Dies muss derselbe Umleitungs-URI sein, der zum Erstellen eines Autorisierungscodes verwendet wurde. z. B. https://localhost:8080.

   Antwortfelder

   • expires_in- Wie lange dauert es, bis das Token abläuft. Die Standardablaufzeit beträgt 12 Stunden.

   • refresh_token— Das Aktualisierungstoken, das von der ersten /token-Anforderung empfangen wurde.

   • token— Das Token, das von der ersten /token-Anforderung empfangen wurde.

   • token_type- Der Wert wird sein. Bearer

   • appfabric_user_id- Die AppFabric Benutzer-ID. Dies wird nur für Anfragen zurückgegeben, die den authorization_code Grant-Typ verwenden.

   curl --location \
   "https://appfabric.<region>.amazonaws.com/oauth2/token" \
   --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 ..." \
   --data "{
       \"code\": \"mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc",
       \"app_client_id\": \"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\",
       \"grant_type\": \"authorization_code\",
       \"redirect_uri\": \"https://localhost:8080\"
   }"

   Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

   {
       "expires_in": 43200,
       "refresh_token": "apkaeibaerjr2example",
       "token": "apkaeibaerjr2example",
       "token_type": "Bearer", 
       "appfabric_user_id" : "<userId>"
   }

Schritt 3. Fügen Sie die URL des AppFabric Benutzerportals zu Ihrer Anwendung hinzu

Endbenutzer müssen autorisiert werden, AppFabric auf Daten aus ihren Anwendungen zuzugreifen, die zur Generierung von Erkenntnissen verwendet werden. AppFabric beseitigt die Komplexität für App-Entwickler, diesen Prozess selbst in die Hand zu nehmen, indem ein spezielles Benutzerportal (ein Popup-Bildschirm) eingerichtet wird, über das Endbenutzer ihre Apps autorisieren können. Wenn Benutzer bereit sind, produktiver zu AppFabric arbeiten, werden sie zum Benutzerportal weitergeleitet, über das sie Anwendungen verbinden und verwalten können, die zur Generierung von Erkenntnissen und anwendungsübergreifenden Aktionen verwendet werden. Wenn sie angemeldet sind, können Benutzer aus AppFabric Produktivitätsgründen eine Verbindung zu Anwendungen herstellen und dann zu Ihrer Anwendung zurückkehren, um die Erkenntnisse und Aktionen zu erkunden. Um Ihre Anwendung in AppFabric for productivity zu integrieren, müssen Sie Ihrer Anwendung eine bestimmte AppFabric URL hinzufügen. Dieser Schritt ist entscheidend, damit Benutzer direkt von Ihrer Anwendung aus auf das AppFabric Benutzerportal zugreifen können.

1. Navigieren Sie zu den Einstellungen Ihrer Anwendung und suchen Sie den Abschnitt zum Hinzufügen von Weiterleitungs-URLs.

2. Nachdem Sie den entsprechenden Bereich gefunden haben, fügen Sie Ihrer Anwendung die folgende AppFabric URL als Weiterleitungs-URL hinzu:

   https://userportal.appfabric.<region>.amazonaws.com/eup_login

Nachdem Sie die URL hinzugefügt haben, wird Ihre Anwendung so eingerichtet, dass sie Benutzer zum AppFabric Benutzerportal weiterleitet. Hier können sich Benutzer anmelden, eine Verbindung herstellen und ihre Anwendungen verwalten, die AppFabric zur Generierung von Produktivitätseinblicken verwendet werden.

Schritt 4. Wird verwendet AppFabric , um anwendungsübergreifende Einblicke und Aktionen zu erhalten

Nachdem Benutzer ihre Anwendungen miteinander verbunden haben, können Sie die Erkenntnisse Ihrer Benutzer nutzen, um deren Produktivität zu verbessern, indem Sie dazu beitragen, das Wechseln zwischen Anwendungen und Kontexten zu reduzieren. AppFabric generiert nur Erkenntnisse für einen Benutzer auf der Grundlage dessen, wofür der Benutzer Zugriffsrechte besitzt. AppFabric speichert Benutzerdaten in einem AWS-Konto Eigentum von AppFabric. Informationen darüber, wie Ihre Daten AppFabric verwendet werden, finden Sie unterDatenverarbeitung.

Sie können die folgenden KI-gestützten APIs verwenden, um Erkenntnisse und Aktionen auf Benutzerebene in Ihren Apps zu generieren und aufzudecken:

• ListActionableInsights— Weitere Informationen finden Sie weiter unten im Abschnitt „Umsetzbare Erkenntnisse“.

• ListMeetingInsights— Weitere Informationen finden Sie im Abschnitt zur Vorbereitung von Besprechungen weiter unten in diesem Handbuch.

Umsetzbare Erkenntnisse () ListActionableInsights

Die ListActionableInsights API hilft Benutzern dabei, ihren Tag am besten zu verwalten und liefert umsetzbare Erkenntnisse auf der Grundlage der Aktivitäten in ihren Anwendungen, einschließlich E-Mails, Kalendern, Nachrichten, Aufgaben und mehr. Bei zurückgegebenen Erkenntnissen werden auch eingebettete Links zu Artefakten angezeigt, die zur Generierung der Erkenntnisse verwendet wurden. So können Benutzer schnell erkennen, welche Daten zur Generierung der Erkenntnisse verwendet wurden. Darüber hinaus kann die API basierend auf den Erkenntnissen vorgeschlagene Aktionen zurückgeben und es Benutzern ermöglichen, anwendungsübergreifende Aktionen von Ihrer Anwendung aus auszuführen. Insbesondere lässt sich die API in Plattformen wieAsana,, und integrieren Google WorkspaceMicrosoft 365, Smartsheet um Benutzern das Senden von E-Mails, das Erstellen von Kalenderereignissen und das Erstellen von Aufgaben zu ermöglichen. Die Large Language Models (LLMs) können Details im Rahmen einer empfohlenen Aktion (wie E-Mail-Text oder Aufgabenname) vorab ausfüllen, die Benutzer vor der Ausführung anpassen können, was die Entscheidungsfindung vereinfacht und die Produktivität steigert. Ähnlich wie bei der Autorisierung von Anwendungen durch Endbenutzer wird dasselbe spezielle Portal AppFabric verwendet, über das Benutzer anwendungsübergreifende Aktionen anzeigen, bearbeiten und ausführen können. Für die Ausführung von Aktionen AppFabric müssen ISVs Benutzer zu einem AppFabric Benutzerportal weiterleiten, wo sie die Aktionsdetails einsehen und diese ausführen können. Jede von generierte Aktion AppFabric hat eine eindeutige URL. Diese URL ist in der Antwort auf die ListActionableInsights API-Antwort verfügbar.

Im Folgenden finden Sie eine Zusammenfassung der unterstützten anwendungsübergreifenden Aktionen und der Apps, in denen:

• E-Mail senden (Google Workspace,Microsoft 365)

• Kalenderereignis erstellen (Google Workspace,Microsoft 365)

• Aufgabe erstellen (Asana,Smartsheet)

Felder anfordern

• nextToken(optional) — Das Paginierungstoken zum Abrufen der nächsten Reihe von Erkenntnissen.

• includeActionExecutionStatus— Ein Filter, der eine Liste von Statusangaben bei der Ausführung von Aktionen akzeptiert. Die Aktionen werden auf der Grundlage der übergebenen Statuswerte gefiltert. Mögliche Werte: NOT_EXECUTED | EXECUTED

Header der Anfrage

• Der Autorisierungsheader muss zusammen mit dem Bearer Token Wert übergeben werden.

Antwortfelder

• insightId- Die eindeutige ID für den generierten Einblick.

• insightContent- Dies gibt eine Zusammenfassung der Erkenntnisse und eingebettete Links zu Artefakten zurück, die zur Generierung der Erkenntnisse verwendet wurden. Hinweis: Dies wäre ein HTML-Inhalt, der eingebettete Links (<a>Tags) enthält.

• insightTitle- Der Titel des generierten Einblicks.

• createdAt- Wann der Insight generiert wurde.

• actions- Eine Liste von Aktionen, die für den generierten Einblick empfohlen werden. Aktionsobjekt:

  • actionId- Die eindeutige ID für die generierte Aktion.

  • actionIconUrl- Die Symbol-URL für die App, in der die Aktion ausgeführt werden soll.

  • actionTitle- Der Titel der generierten Aktion.

  • actionUrl- Die eindeutige URL, über die der Endbenutzer die Aktion im AppFabric Benutzerportal anzeigen und ausführen kann. Hinweis: Für die Ausführung von Aktionen leiten ISV-Apps Benutzer mithilfe dieser URL zum AppFabric Benutzerportal (Popup-Bildschirm) weiter.

  • actionExecutionStatus- Eine Aufzählung, die den Status der Aktion angibt. Die möglichen Werte sind: | EXECUTED NOT_EXECUTED

• nextToken(optional) — Das Paginierungstoken zum Abrufen der nächsten Reihe von Erkenntnissen. Es ist ein optionales Feld, das, wenn es Null zurückgegeben wird, bedeutet, dass keine weiteren Erkenntnisse geladen werden müssen.

Weitere Informationen finden Sie unter ActionableInsights.

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

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

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
}

Vorbereitung des Treffens (ListMeetingInsights)

Die ListMeetingInsights API hilft Benutzern dabei, sich optimal auf bevorstehende Besprechungen vorzubereiten, indem sie den Zweck der Besprechung zusammenfasst und relevante anwendungsübergreifende Artefakte wie E-Mails, Nachrichten und mehr anzeigt. Benutzer können sich jetzt schnell auf Besprechungen vorbereiten und müssen keine Zeit damit verschwenden, zwischen Apps zu wechseln, um Inhalte zu finden.

Felder anfordern

• nextToken(optional) — Das Paginierungstoken zum Abrufen der nächsten Reihe von Erkenntnissen.

Header anfordern

• Der Autorisierungsheader muss zusammen mit dem Bearer Token Wert übergeben werden.

Antwortfelder

• insightId- Die eindeutige ID für den generierten Einblick.

• insightContent- Die Beschreibung der Einsicht, in der die Details in einem Zeichenkettenformat hervorgehoben werden. Zum Beispiel, warum diese Einsicht wichtig ist.

• insightTitle- Der Titel des generierten Einblicks.

• createdAt- Wann der Insight generiert wurde.

• calendarEvent- Das wichtige Kalenderereignis oder die wichtige Besprechung, auf die sich der Benutzer konzentrieren sollte. Objekt „Kalenderereignis“:

  • startTime- Die Startzeit des Ereignisses.

  • endTime- Die Endzeit der Veranstaltung.

  • eventUrl— Die URL für das Kalenderereignis in der ISV-App.

• resources- Die Liste mit den anderen Ressourcen, die sich auf die Generierung der Erkenntnisse beziehen. Ressourcenobjekt:

  • appName- Der Name der App, zu der die Ressource gehört.

  • resourceTitle- Der Titel der Ressource.

  • resourceType- Der Typ der Ressource. Die möglichen Werte sind: EMAIL | EVENT | MESSAGE | TASK

  • resourceUrl- Die Ressourcen-URL in der App.

  • appIconUrl- Die Bild-URL der App, zu der die Ressource gehört.

• nextToken(optional) — Das Paginierungstoken zum Abrufen der nächsten Reihe von Erkenntnissen. Es ist ein optionales Feld, das, wenn es Null zurückgegeben wird, bedeutet, dass keine weiteren Erkenntnisse geladen werden müssen.

Weitere Informationen finden Sie unter MeetingInsights.

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

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP-201-Antwort zurück.

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
}

Geben Sie Feedback zu Ihren Erkenntnissen oder Aktionen

Verwenden Sie den AppFabric PutFeedback API-Vorgang, um Feedback zu den generierten Erkenntnissen und Aktionen zu geben. Sie können diese Funktion in Ihre Apps einbetten, um die Möglichkeit zu bieten, eine Feedback-Bewertung (1 bis 5, wobei je höher die Bewertung desto besser) für ein bestimmtes InsightId oder abzugeben ActionId.

Felder anfordern

• id- Die Kennung des Objekts, für das Feedback eingereicht wird. Dies kann entweder der InsightId oder der sein ActionId.

• feedbackFor- Der Ressourcentyp, für den Feedback eingereicht wird. Mögliche Werte: ACTIONABLE_INSIGHT | MEETING_INSIGHT | ACTION

• feedbackRating- Feedback-Bewertung von 1 bis5. Je höher die Bewertung, desto besser.

Antwortfelder

• Es gibt keine Antwortfelder.

Weitere Informationen finden Sie unter 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
}'

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP-201-Antwort mit leerem HTTP-Textinhalt zurück.

Schritt 5. Bitte AppFabric um Überprüfung Ihrer Bewerbung

Bis jetzt haben Sie die Benutzeroberfläche Ihrer Anwendung aktualisiert, um AppFabric anwendungsübergreifende Einblicke und Aktionen einzubetten, und Sie haben Erkenntnisse für einen einzelnen Benutzer erhalten. Wenn Sie mit den Tests zufrieden sind und Ihr AppFabric erweitertes Nutzererlebnis auf weitere Nutzer ausweiten möchten, können Sie Ihren Antrag AppFabric zur Prüfung und Überprüfung bei uns einreichen. AppFabric überprüft die Anwendungsinformationen, bevor eine breite Akzeptanz ermöglicht wird, um Anwendungsentwickler, Endbenutzer und deren Daten zu schützen und so den Weg für eine verantwortungsvolle Ausweitung der Benutzerakzeptanz zu ebnen.

Leitet den Überprüfungsprozess ein

Beginnen Sie den Überprüfungsprozess, indem Sie eine E-Mail an [e-mail] senden und darum bitten, dass Ihre App verifiziert wird.

Geben Sie in Ihrer E-Mail die folgenden Informationen an:

• Deine AWS-Konto ID

• Der Name der Anwendung, für die Sie eine Bestätigung beantragen

• Ihr AppClient Ausweis

• Deine Kontaktinformationen

Geben Sie außerdem, falls verfügbar, die folgenden Informationen an, damit wir Prioritäten und Auswirkungen beurteilen können:

• Eine geschätzte Anzahl von Benutzern, denen Sie Zugriff gewähren möchten

• Ihr angestrebter Starttermin

Anmerkung

Wenn Sie einen AWS-Konto Manager oder AWS Partner Development Manager haben, kopieren Sie ihn bitte in Ihre E-Mail. Die Angabe dieser Kontakte kann dazu beitragen, den Überprüfungsprozess zu beschleunigen.

Kriterien für die Überprüfung

Bevor Sie den Überprüfungsprozess einleiten können, müssen Sie die folgenden Kriterien erfüllen:

• Aus Produktivitätsgründen müssen Sie ein gültiges AWS-Konto Passwort verwenden AppFabric

Darüber hinaus erfüllen Sie mindestens eines der folgenden Kriterien:

• Ihre Organisation ist ein AWS Partner auf der Stufe AWS Partner Network mit mindestens der Stufe „AWS Select“. Weitere Informationen finden Sie unter Stufen der AWS Partnerservices.

• Ihr Unternehmen sollte in den letzten drei Jahren mindestens 10.000$ für AppFabric Dienstleistungen ausgegeben haben.

• Ihre Bewerbung sollte auf der AWS Marketplace aufgeführt sein. Weitere Informationen finden Sie im AWS Marketplace.

Warten Sie auf die Aktualisierung des Bestätigungsstatus

Nachdem Ihre Bewerbung geprüft wurde, antworten wir per E-Mail und der Status Ihrer Bewerbung AppClient ändert sich von pending_verification zuverified. Wenn Ihre Bewerbung abgelehnt wird, müssen Sie den Überprüfungsprozess erneut einleiten.