애플리케이션 개발자를 AppFabric 위한 생산성 향상 (미리 보기) 시작하기 - AWS AppFabric
필수 조건단계 1. 생산성을 AppFabric 위한 광고 만들기 AppClient단계 2. 애플리케이션 인증 및 권한 부여단계 3. 애플리케이션에 AppFabric 사용자 포털 URL 추가4단계. 앱 간 AppFabric 인사이트와 액션을 파악하는 데 사용합니다.5단계. 신청서 확인 요청 AppFabric

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

애플리케이션 개발자를 AppFabric 위한 생산성 향상 (미리 보기) 시작하기

생산성 향상 기능은 미리 보기 상태이며 변경될 수 있습니다. AWS AppFabric

이 섹션은 앱 개발자가 생산성 향상 (미리 보기) 을 AWS AppFabric 애플리케이션에 통합하는 데 도움이 됩니다. AWS AppFabric for Producity를 사용하면 개발자가 여러 애플리케이션에서 이메일, 캘린더 이벤트, 작업, 메시지 등을 통해 AI 기반 인사이트와 작업을 생성하여 사용자를 위해 더 풍부한 앱 경험을 구축할 수 있습니다. 지원되는 애플리케이션 목록은 지원되는 애플리케이션을 참조하십시오AWS AppFabric .

AppFabric 생산성 향상을 통해 앱 개발자는 안전하고 통제된 환경에서 빌드하고 실험할 수 있습니다. 생산성 향상을 AppFabric 위해 처음 사용하기 시작하면 테스트 사용자 한 명을 AppClient 만들어 등록합니다. 이 접근 방식은 애플리케이션과 애플리케이션 간의 인증 및 통신 흐름을 이해하고 테스트하는 데 도움이 되도록 설계되었습니다 AppFabric. 단일 사용자를 대상으로 테스트한 후 추가 사용자에게 액세스를 확대하기 전에 인증을 AppFabric 위해 신청서를 제출할 수 있습니다 (참조5단계. 신청서 확인 요청 AppFabric ). AppFabric 앱 개발자, 최종 사용자 및 데이터를 보호하기 위해 광범위한 채택을 가능하게 하기 전에 애플리케이션 정보를 검증하여 책임감 있는 방식으로 사용자 채택을 확대할 수 있는 기반을 마련합니다.

주제

필수 조건

시작하기 전에 먼저 앱을 AWS 계정만들어야 합니다. 자세한 정보는 가입하여 다음을 수행하십시오. AWS 계정을 참조하세요. 또한 아래 나열된 "appfabric:CreateAppClient" IAM 정책에 액세스할 수 있는 사용자를 한 명 이상 생성해야 합니다. 그러면 사용자가 애플리케이션을 등록할 수 있습니다. AppFabric 생산성 향상 기능에 대한 권한 부여에 AppFabric 대한 자세한 내용은 을 참조하십시오. AppFabric 생산성을 위한 IAM 정책 예제 관리 사용자가 있으면 유용하지만 초기 설정에 필수는 아닙니다. 자세한 정보는 관리자 액세스 권한이 있는 사용자 생성을 참조하세요.

AppFabric 평가판 기간 중 생산성은 미국 동부 (버지니아 북부) 에서만 확인할 수 있습니다. 아래 단계를 시작하기 전에 이 리전에 있는지 확인합니다.

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

단계 1. 생산성을 높이기 AppFabric 위한 광고 만들기 AppClient

애플리케이션 내에서 생산성 인사이트를 얻기 AppFabric 위해 서피싱을 시작하려면 먼저 애플리케이션을 만들어야 합니다. AppFabric AppClient AppClient An은 기본적으로 생산성을 AppFabric 위한 관문으로, 애플리케이션과 애플리케이션 간의 보안 통신을 가능하게 하는 안전한 OAuth 애플리케이션 클라이언트 역할을 합니다. AppFabric 앱을 만들면 ID가 AppClient 제공됩니다. ID는 해당 AppClient ID가 애플리케이션 및 사용자 애플리케이션과 함께 작동하고 있음을 AppFabric 알 수 있도록 하는 데 중요한 고유 식별자입니다. AWS 계정

AppFabric 생산성 향상을 위해 앱 개발자는 안전하고 통제된 환경에서 빌드하고 실험할 수 있습니다. 생산성 향상을 AppFabric 위해 처음 사용하기 시작하면 테스트 사용자 한 명을 AppClient 만들어 등록합니다. 이 접근 방식은 애플리케이션과 애플리케이션 간의 인증 및 통신 흐름을 이해하고 테스트하는 데 도움이 되도록 설계되었습니다 AppFabric. 단일 사용자를 대상으로 테스트한 후 추가 사용자에게 액세스를 확대하기 전에 인증을 AppFabric 위해 신청서를 제출할 수 있습니다 (참조5단계. 신청서 확인 요청 AppFabric ). AppFabric 앱 개발자, 최종 사용자 및 데이터를 보호하기 위해 광범위한 채택을 가능하게 하기 전에 애플리케이션 정보를 검증하여 책임감 있는 방식으로 사용자 채택을 확대할 수 있는 기반을 마련합니다.

생성하려면 AWS AppFabric CreateAppClient API 작업을 사용하세요. AppClient AppClient 이후를 업데이트해야 하는 경우 UpdateAppClient API 작업을 사용하여 리디렉션 URL만 변경할 수 있습니다. AppName 또는 설명과 AppClient 같이 자신과 관련된 다른 매개변수를 변경해야 하는 경우 를 AppClient 삭제하고 새 매개변수를 생성해야 합니다. 자세한 정보는 CreateAppClient을 참조하세요.

Python, Node.js, Java, C#, Go 및 Rust를 비롯한 여러 프로그래밍 언어를 사용하여 CreateAppClient API를 사용하여 AWS 서비스에 애플리케이션을 등록할 수 있습니다. 자세한 내용은 IAM 사용 설명서의 서명 요청 예를 참조하세요. 이 API 작업을 수행하려면 계정의 Signature Version 4 자격 증명을 사용해야 합니다. 서명 버전 4에 대한 자세한 내용은 IAM 사용 설명서의 AWS API 요청 서명을 참조하십시오.

요청 필드

  • appName- AppFabric 사용자 포털의 동의 페이지에 사용자에게 표시될 애플리케이션의 이름. 동의 페이지에서는 최종 사용자에게 애플리케이션 내에 AppFabric 통찰력을 표시할 수 있는 권한을 요청합니다. 동의 페이지에 대한 자세한 내용은 단계 2. 앱에 인사이트가 표시되도록 동의 섹션을 참조하세요.

  • description - 애플리케이션에 대한 설명입니다.

  • redirectUrls - 인증 후 최종 사용자를 리디렉션할 URI입니다. redirectUrl을 최대 5개 추가할 수 있습니다. 예를 들어 https://localhost:8080입니다.

  • starterUserEmails - 애플리케이션이 검증될 때까지 인사이트를 수신할 수 있는 액세스가 허용되는 사용자 이메일 주소입니다. 이메일 주소는 하나만 사용할 수 있습니다. 예제: anyuser@example.com

  • customerManagedKeyIdentifier(선택 사항) - 데이터를 암호화하는 데 사용할 고객 관리형 키(KMS에서 생성)의 ARN입니다. 지정하지 않으면 AWS AppFabric 관리 키가 사용됩니다. AWS 소유 키 및 고객 관리형 키에 대한 자세한 내용은 AWS Key Management Service 개발자 안내서의 고객 키 및 AWS 키를 참조하세요.

응답 필드

  • appClientArn- ID가 포함된 Amazon 리소스 이름 (ARN). AppClient 예를 들어 AppClient ID는 다음과 같습니다. a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

  • verificationStatus- AppClient 검증 상태.

    • pending_verification- AppClient 인증이 아직 진행 중입니다 AppFabric. 확인되기 AppClient 전까지는 한 명의 사용자 (지정된 사용자starterUserEmails) 만 사용할 수 있습니다 AppClient. 에 소개된 AppFabric 사용자 포털에서 애플리케이션이 검증되지 않았음을 알리는 알림이 사용자에게 표시됩니다. 단계 3. 애플리케이션에 AppFabric 사용자 포털 URL을 추가합니다.

    • verified- 까지 인증 프로세스가 성공적으로 완료되었으며 이제 AppClient 완전히 확인되었습니다. AppFabric

    • rejected- 에서 에 대한 확인 프로세스를 AppClient 거부했습니다 AppFabric. 확인 프로세스를 다시 시작하고 성공적으로 완료하기 전까지는 추가 사용자가 사용할 수 AppClient 없습니다.

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>"
}'

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

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

단계 2. 애플리케이션 인증 및 권한 부여

OAuth 2.0 인증 흐름을 설정하여 애플리케이션이 AppFabric 인사이트를 안전하게 통합할 수 있도록 하세요. 먼저 애플리케이션 ID를 확인하는 인증 코드를 생성해야 합니다. 자세한 정보는 인증을 참조하세요. 그런 다음 이 인증 코드를 액세스 토큰으로 교환합니다. 액세스 토큰은 애플리케이션에 애플리케이션 내에서 AppFabric 통찰력을 가져오고 표시할 수 있는 권한을 애플리케이션에 부여합니다. 자세한 정보는 토큰을 참조하세요.

애플리케이션 인증에 대한 자세한 내용은 애플리케이션 승인 액세스 허용 섹션을 참조하세요.

  1. 인증 코드를 생성하려면 AWS AppFabric oauth2/authorize API 작업을 사용하세요.

    요청 필드

    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. 인증 후에는 쿼리 파라미터로 반환되는 인증 코드와 함께 지정된 URI로 리디렉션됩니다. 예를 들면 code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc로 입니다.

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

  3. AppFabricoauth2/tokenAPI 작업을 사용하여 이 인증 코드를 액세스 토큰으로 교환하십시오.

    이 토큰은 API 요청에 사용되며 처음에는 starterUserEmails 확인될 때까지 유효합니다. AppClient 이 AppClient 확인되면 모든 사용자가 이 토큰을 사용할 수 있습니다. 이 API 작업을 수행하려면 계정의 Signature Version 4 자격 증명을 사용해야 합니다. 서명 버전 4에 대한 자세한 내용은 IAM 사용 설명서의 AWS API 요청 서명을 참조하십시오.

    요청 필드

    응답 필드

    • expires_in - 토큰이 만료되기까지 남은 기간입니다. 기본 만료 시간은 12시간입니다.

    • refresh_token - 초기 요청과 토큰 요청에서 받은 새로 고침 토큰입니다.

    • token - 초기 요청과 토큰 요청에서 받은 토큰입니다.

    • token_type - 값은 Bearer입니다.

    • appfabric_user_id- AppFabric 사용자 ID. authorization_code 권한 부여 유형을 사용하는 요청의 경우에만 반환됩니다.

    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\"
}"

    작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

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

단계 3. 애플리케이션에 AppFabric 사용자 포털 URL을 추가합니다.

최종 사용자는 통찰력을 생성하는 데 사용되는 애플리케이션의 데이터에 액세스할 수 있는 권한을 AppFabric 부여해야 합니다. AppFabric 최종 사용자가 앱을 인증할 수 있는 전용 사용자 포털 (팝업 화면) 을 구축하여 앱 개발자가 이 프로세스를 소유해야 하는 복잡성을 없애줍니다. 사용자가 생산성을 높일 준비가 되면 사용자 포털로 이동하게 됩니다. 사용자 포털을 통해 인사이트와 앱 간 작업을 생성하는 데 사용되는 애플리케이션을 연결하고 관리할 수 있습니다. AppFabric 로그인하면 사용자는 생산성을 AppFabric 위해 애플리케이션을 연결한 다음 애플리케이션으로 돌아가 인사이트와 조치를 탐색할 수 있습니다. 생산성을 높이기 AppFabric 위해 애플리케이션을 통합하려면 애플리케이션에 특정 AppFabric URL을 추가해야 합니다. 이 단계는 사용자가 애플리케이션에서 직접 AppFabric 사용자 포털에 액세스할 수 있도록 하는 데 매우 중요합니다.

  1. 애플리케이션 설정으로 이동하여 리디렉션 URL을 추가하기 위한 섹션을 찾습니다.

  2. 적절한 영역을 찾은 후 다음 AppFabric URL을 애플리케이션에 리디렉션 URL로 추가하십시오.

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

URL을 추가하면 애플리케이션이 사용자를 AppFabric 사용자 포털로 안내하도록 설정됩니다. 여기서 사용자는 로그인하여 생산성 통찰력을 생성하는 AppFabric 데 사용되는 애플리케이션을 연결하고 관리할 수 있습니다.

4단계. 앱 간 인사이트 및 조치를 AppFabric 파악하는 데 사용합니다.

사용자가 애플리케이션을 연결한 후에는 앱 및 컨텍스트 전환을 줄임으로써 사용자의 통찰력을 가져와 생산성을 높일 수 있습니다. AppFabric 사용자에게 액세스 권한이 있는 대상을 기반으로 사용자에게 인사이트만 제공합니다. AppFabric 사용자 데이터를 AWS 계정 소유자에 저장합니다 AppFabric. 데이터 AppFabric 사용 방법에 대한 자세한 내용은 을 참조하십시오데이터 처리.

다음과 같은 AI 기반 API를 사용하여 앱 내에서 사용자 수준의 인사이트와 작업을 생성하고 표시할 수 있습니다.

  • ListActionableInsights - 자세한 내용은 아래의 실행 가능한 인사이트 섹션을 참조하세요.

  • ListMeetingInsights - 자세한 내용은 이 설명서 후반부의 회의 준비 섹션을 참조하세요.

실행 가능한 인사이트(ListActionableInsights)

ListActionableInsights API는 사용자가 이메일, 캘린더, 메시지, 작업 등 애플리케이션 전반의 활동을 기반으로 실행 가능한 인사이트를 표시하여 하루를 가장 잘 관리할 수 있도록 도와줍니다. 반환된 인사이트에는 인사이트를 생성하는 데 사용한 아티팩트에 대한 링크도 포함되어 있어 사용자가 인사이트를 생성하는 데 사용한 데이터를 빠르게 확인할 수 있습니다. 또한 API는 인사이트를 기반으로 제안된 작업을 반환하고 사용자가 애플리케이션 내에서 앱 간 작업을 실행하도록 할 수 있습니다. 특히, API는 Asana, Google Workspace, Microsoft 365, Smartsheet와 같은 플랫폼과 통합하여 사용자가 이메일을 보내고 캘린더 이벤트를 만들며 작업을 생성할 수 있도록 합니다. 대형 언어 모델(LLM)은 권장 작업(예: 이메일 본문 또는 작업 이름)에 세부 정보를 미리 채울 수 있으며, 사용자는 실행 전에 이를 사용자 지정할 수 있으므로 의사 결정을 단순화하고 생산성을 높일 수 있습니다. 최종 사용자가 애플리케이션을 승인하는 것과 마찬가지로, AppFabric 는 동일한 전용 포털을 사용하여 앱 간 작업을 보고, 편집하고, 실행합니다. 작업을 AppFabric 실행하려면 ISV가 사용자를 AppFabric 사용자 포털로 리디렉션하여 작업 세부 정보를 보고 실행할 수 있도록 해야 합니다. 에서 생성되는 모든 AppFabric 액션에는 고유한 URL이 있습니다. 이 URL은 ListActionableInsights API 응답의 응답에서 사용할 수 있습니다.

다음은 지원하는 앱 간 작업과 앱의 요약입니다.

  • 이메일(Google Workspace, Microsoft 365) 보내기

  • 캘린더 이벤트(Google Workspace, Microsoft 365) 생성

  • 작업(Asana, Smartsheet) 생성

요청 필드

  • nextToken(선택 사항) - 다음 인사이트 세트를 가져오기 위한 페이지 매김 토큰입니다.

  • includeActionExecutionStatus - 작업 실행 상태 목록을 허용하는 필터입니다. 작업은 전달된 상태 값을 기준으로 필터링됩니다. 가능한 값: NOT_EXECUTED | EXECUTED

요청 헤더

  • 인증 헤더를 Bearer Token 값과 함께 전달해야 합니다.

응답 필드

  • insightId - 생성된 인사이트의 고유 ID입니다.

  • insightContent - 이렇게 하면 인사이트의 요약과 인사이트를 생성하는 데 사용된 아티팩트로 연결하는 포함된 링크가 반환됩니다. 참고: 이는 포함된 링크(<a>태그)가 포함된 HTML 콘텐츠입니다.

  • insightTitle - 생성된 인사이트의 제목입니다.

  • createdAt - 인사이트가 생성된 시점입니다.

  • actions - 생성된 인사이트에 대한 권장 작업 목록입니다. 작업 객체:

    • actionId - 생성된 작업의 고유 ID입니다.

    • actionIconUrl - 작업을 실행하도록 제안한 앱의 아이콘 URL입니다.

    • actionTitle - 생성된 작업의 제목입니다.

    • actionUrl- 최종 사용자가 사용자 포털에서 AppFabric 작업을 보고 실행할 수 있는 고유한 URL입니다. 참고: ISV 앱은 작업을 실행할 때 이 URL을 사용하여 사용자를 AppFabric 사용자 포털 (팝업 화면) 으로 리디렉션합니다.

    • actionExecutionStatus - 작업 상태를 나타내는 열거형입니다. 가능한 값은 EXECUTED | NOT_EXECUTED입니다.

  • nextToken(선택 사항) - 다음 인사이트 세트를 가져오기 위한 페이지 매김 토큰입니다. 이 필드는 선택 사항 필드이며, null을 반환하면 로드할 인사이트가 더 이상 없음을 의미합니다.

자세한 정보는 ActionableInsights을 참조하세요.

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

작업이 성공하면 서비스가 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
}

회의 준비(ListMeetingInsights)

ListMeetingInsights API는 회의 목적을 요약하고 이메일, 메시지 등과 같은 관련 앱 간 아티팩트를 표시하여 사용자가 예정된 회의를 가장 잘 준비할 수 있도록 도와줍니다. 이제 사용자는 빠르게 회의를 준비할 수 있고 콘텐츠를 찾기 위해 여러 앱을 오가며 시간을 낭비하지 않아도 됩니다.

요청 필드

  • nextToken(선택 사항) - 다음 인사이트 세트를 가져오기 위한 페이지 매김 토큰입니다.

요청 헤더

  • 인증 헤더를 Bearer Token 값과 함께 전달해야 합니다.

응답 필드

  • insightId - 생성된 인사이트의 고유 ID입니다.

  • insightContent - 세부 정보를 문자열 형식으로 강조 표시하는 인사이트에 대한 설명입니다. 즉, 이 인사이트가 왜 중요한지에 대한 것입니다.

  • insightTitle - 생성된 인사이트의 제목입니다.

  • createdAt - 인사이트가 생성된 시점입니다.

  • calendarEvent - 사용자가 집중해야 하는 중요한 캘린더 이벤트 또는 회의입니다. 캘린더 이벤트 객체:

    • startTime - 이벤트의 시작 시간입니다.

    • endTime - 이벤트의 종료 시간입니다.

    • eventUrl - ISV 앱의 캘린더 이벤트 URL입니다.

  • resources - 인사이트 생성과 관련된 다른 리소스가 포함된 목록입니다. 리소스 객체:

    • appName - 리소스가 속한 앱 이름입니다.

    • resourceTitle - 리소스 제목입니다.

    • resourceType - 리소스의 유형입니다. 가능한 값은 EMAIL | EVENT | MESSAGE | TASK입니다.

    • resourceUrl - 앱의 리소스 URL입니다.

    • appIconUrl - 리소스가 속한 앱의 이미지 URL입니다.

  • nextToken(선택 사항) - 다음 인사이트 세트를 가져오기 위한 페이지 매김 토큰입니다. 이 필드는 선택 사항 필드이며, null을 반환하면 로드할 인사이트가 더 이상 없음을 의미합니다.

자세한 정보는 MeetingInsights을 참조하세요.

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

작업이 성공하면 서비스가 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
}

인사이트나 작업에 대한 피드백 제공

AppFabric PutFeedbackAPI 작업을 사용하여 생성된 인사이트 및 조치에 대한 피드백을 제공하세요. 이 기능을 앱에 내장하여 특정 InsightId 또는 ActionId 등급에 대한 피드백 평점 (1~5, 등급이 높을수록 좋음) 을 제출할 수 있는 방법을 제공할 수 있습니다.

요청 필드

  • id - 피드백을 받는 객체의 식별자입니다. 이것은 같거나 일 수 InsightId 있습니다. ActionId

  • feedbackFor - 피드백을 받는 리소스 유형입니다. 가능한 값: ACTIONABLE_INSIGHT | MEETING_INSIGHT | ACTION

  • feedbackRating - 피드백 평점은 1에서 5까지입니다. 평점이 높을수록 좋습니다.

응답 필드

  • 응답 필드가 없습니다.

자세한 정보는 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
}'

작업이 성공하면 서비스가 비어있는 HTTP 본문과 함께 HTTP 201 응답을 다시 전송합니다.

5단계. 신청서 확인 요청 AppFabric

지금까지 AppFabric 앱 간 인사이트 및 작업을 포함하도록 애플리케이션 UI를 업데이트하고 단일 사용자에 대한 통찰력을 얻었습니다. 테스트에 만족하고 AppFabric -enriched 경험을 추가 사용자에게 확장하고 싶다면 신청서를 제출하여 검토 및 검증을 받을 수 있습니다. AppFabric AppFabric 앱 개발자, 최종 사용자 및 데이터를 보호하기 위해 광범위한 채택을 가능하게 하기 전에 애플리케이션 정보를 검증하여 책임감 있는 방식으로 사용자 채택을 확대할 수 있는 기반을 마련합니다.

확인 프로세스 시작

appfabric-appverification@amazon.com으로 이메일을 보내고 앱 확인을 요청하여 확인 프로세스를 시작합니다.

사용자의 이메일에 다음 세부 정보를 포함합니다.

  • 귀하의 ID AWS 계정

  • 확인하고자 하는 애플리케이션의 이름

  • 내 AppClient 아이디

  • 연락처 정보

또한 우선순위와 영향을 평가하는 데 도움이 되도록 가능한 경우 다음 정보를 제공합니다.

  • 액세스 권한을 부여하려는 예상 사용자 수

  • 목표 출시일

참고

AWS 계정 관리자 또는 AWS 파트너 개발 관리자가 있는 경우 이메일에 복사해 주세요. 이러한 연락처를 포함하면 확인 프로세스를 신속하게 처리할 수 있습니다.

확인 기준

확인 프로세스를 사용하기 전에 다음 기준을 충족하는지 확인합니다.

  • 생산성을 AWS 계정 높이려면 유효한 문자를 사용해야 AppFabric 합니다.

또한 다음 기준 중 하나 이상을 충족합니다.

  • 귀하의 조직은 최소한 “AWS Select” 등급을 AWS Partner Network 보유한 AWS 파트너입니다. 자세한 내용은 AWS 파트너 서비스 티어를 참조하세요.

  • 조직은 지난 3년 이내에 AppFabric 서비스에 최소 1만 달러를 지출했어야 합니다.

  • 애플리케이션은 AWS Marketplace에 등록되어 있어야 합니다. 자세한 내용은 AWS Marketplace를 참조하세요.

확인 상태 업데이트 대기

신청서가 검토되면 이메일을 통해 회신해 드리며, 신청 상태는 에서 pending_verification 로 AppClient verified 변경됩니다. 애플리케이션이 거부된 경우 확인 프로세스를 다시 시작해야 합니다.