기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 생산성을 위한 AWS AppFabric이란 무엇입니까? | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | **참고** Amazon Bedrock: AWS implements 자동 침해 [탐지](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html)로 구동됩니다. 생산성을 위한 AWS AppFabric은 Amazon Bedrock을 기반으로 구축되었으므로 사용자는 Amazon Bedrock에 구현된 제어를 상속하여 AI의 안전, 보안 및 책임 있는 사용을 강화합니다. 생산성을 위한AWS AppFabric(미리 보기)은 여러 애플리케이션의 컨텍스트로 인사이트와 작업을 생성하여 타사 애플리케이션의 최종 사용자 생산성을 재구상하는 데 도움이 됩니다. 앱 개발자는 다른 앱의 사용자 데이터에 액세스하는 것이 더 생산적인 앱 경험을 만드는 데 중요하다는 것을 알고 있지만 각 애플리케이션을 통합하여 구축하고 관리하기를 원하지 않습니다. 생산성을 위한 AppFabric을 사용하면 애플리케이션 개발자는 앱 간 데이터 인사이트와 작업을 생성하는 생성형 AI 기반 API에 액세스하여 신규 또는 기존 생성형 AI 어시스턴트를 통해 보다 풍부한 최종 사용자 경험을 제공할 수 있습니다. 생산성을 위한 AppFabric은 여러 애플리케이션의 데이터를 통합하므로 개발자가 지점 간 통합을 구축하거나 유지할 필요가 없습니다. 애플리케이션 개발자는 생산성을 위한 AppFabric을 애플리케이션 UI에 직접 내장하여 최종 사용자에게 일관된 경험을 제공하는 동시에 다른 애플리케이션의 관련 컨텍스트를 표시할 수 있습니다. 생산성을 위한 AppFabric은 Asana, Atlassian Jira Suite, Google Workspace, Microsoft 365, Miro, Slack, Smartsheet 등과 같이 일반적으로 사용하는 애플리케이션의 데이터를 연결합니다. 생산성을 위한 AppFabric은 앱 개발자가 사용자 채택, 만족도 및 충성도를 높이는 보다 개인화된 앱 경험을 구축할 수 있는 더 쉬운 방법을 제공합니다. 한편, 최종 사용자는 작업 흐름을 방해하지 않고 애플리케이션 전반에서 필요한 인사이트에 액세스할 수 있다는 이점을 누릴 수 있습니다. **Topics** + [이점](#benefits) + [사용 사례](#use-cases) + [생산성을 위한 AppFabric에 액세스](#acessing-appfabric) + [애플리케이션 개발자를 위한 생산성을 위한 AppFabric(미리 보기) 시작하기](getting-started-appdeveloper-productivity.md) + [최종 사용자를 위한 생산성을 위한 AppFabric(미리 보기) 시작하기](getting-started-users-productivity.md) + [생산성을 위한 AppFabric APIs(미리 보기)](productivity-apis.md) + [AppFabric의 데이터 처리](productivity-data-processing.md) ## 이점 생산성을 위한 AppFabric을 사용하면 애플리케이션 개발자는 앱 간 데이터 인사이트와 작업을 생성하는 API에 액세스하여 신규 또는 기존 생성형 AI 어시스턴트를 통해 보다 풍부한 최종 사용자 경험을 제공할 수 있습니다. + **앱 간 사용자 데이터의 단일 소스**: 생산성을 위한 AppFabric은 여러 애플리케이션의 데이터를 통합하므로 개발자가 지점 간 통합을 구축하거나 유지할 필요가 없습니다. SaaS 앱 데이터는 서로 다른 데이터 유형을 모든 애플리케이션에서 이해할 수 있는 형식으로 자동 정규화하여 다른 애플리케이션에서 사용할 수 있도록 처리되므로 앱 개발자가 더 많은 데이터를 통합하여 최종 사용자의 생산성을 실제로 개선할 수 있습니다. + **사용자 경험을 완전히 제어**: 개발자는 생산성을 위한 AppFabric을 애플리케이션 UI에 직접 내장하여 사용자 경험을 완전히 제어하는 동시에 애플리케이션 전반의 컨텍스트를 통해 최종 사용자에게 개인화된 인사이트와 권장 작업을 제공합니다. 이를 통해 최종 사용자가 선호하는 SaaS 애플리케이션에서 생산성을 위한 AppFabric을 사용할 수 있고 작업을 완료하기 위해 선호하는 앱에서 액세스할 수 있습니다. 최종 사용자는 앱 간 전환에 소요되는 시간을 줄이고 작업 흐름을 유지할 수 있습니다. + **출시 시간 단축**: 앱 개발자는 단 한 번의 API 직접 호출로 모델을 미세 조정하거나, 사용자 지정 프롬프트를 작성하거나 여러 애플리케이션에 통합을 구축할 필요 없이 생성된 사용자 데이터에 대한 사용자 수준의 인사이트를 얻을 수 있습니다. AppFabric은 이러한 복잡성을 추상화하여 앱 개발자가 생성형 AI 기능을 더 빠르게 구축, 내장 또는 강화할 수 있도록 합니다. 이를 통해 앱 개발자는 가장 중요한 작업에 리소스를 집중할 수 있습니다. + **사용자 신뢰 구축을 위한 아티팩트 참조**: 결과의 일부로, 생산성을 위한 AppFabric은 인사이트를 생성하는 데 사용한 관련 아티팩트 또는 소스 파일을 표시하여 LLM 결과에 대한 최종 사용자 신뢰를 구축합니다. + **간소화된 사용자 권한**: 인사이트를 생성하는 데 사용한 사용자 아티팩트는 사용자가 액세스할 수 있는 것에 기반합니다. 생산성을 위한 AppFabric은 ISV의 권한 및 액세스 제어를 신뢰할 수 있는 소스로 사용합니다. ## 사용 사례 앱 개발자는 생산성을 위한 AppFabric을 사용하여 애플리케이션 내부의 생산성을 재구상할 수 있습니다. 생산성을 위한 AppFabric은 최종 사용자의 생산성 향상을 돕기 위해 다음 사용 사례에 초점을 맞춘 두 가지 API를 제공합니다. + 하루의 우선순위 설정 + 실행 가능한 인사이트 API는 이메일, 캘린더, 메시지, 작업 등을 포함한 애플리케이션 전반에서 시기적절한 인사이트를 표시하여 사용자가 하루를 가장 잘 관리할 수 있도록 도와줍니다. 또한 사용자는 선호하는 애플리케이션에서 이메일 작성, 회의 예약, 작업 항목 생성과 같은 앱 간 작업을 실행할 수 있습니다. 예를 들어 하룻밤 사이에 고객 에스컬레이션을 수행한 직원은 야간 대화의 요약을 볼 수 있을 뿐만 아니라 고객 계정 관리자와의 회의를 예약하기 위한 권장 작업도 확인할 수 있습니다. 작업에는 필수 필드(예: 작업 이름 및 소유자 또는 이메일 발신자/수신자)가 미리 채워져 있으며, 작업을 실행하기 전에 미리 채워진 콘텐츠를 편집할 수 있습니다. + 예정된 회의 준비 + 회의 준비 API는 사용자가 회의 목적을 요약하고 이메일, 메시지 등과 같은 관련 앱 간 아티팩트를 표시하여 회의를 가장 잘 준비할 수 있도록 도와줍니다. 이제 사용자는 빠르게 회의를 준비할 수 있고 콘텐츠를 찾기 위해 여러 앱을 오가며 시간을 낭비하지 않아도 됩니다. ## 생산성을 위한 AppFabric에 액세스 생산성을 위한 AppFabric은 현재 평가판으로 출시되었으며 미국 동부(버지니아 북부) AWS 리전에서 사용할 수 있습니다. 에 대한 자세한 내용은의 AppFabric 엔드포인트 및 할당량을 AWS 리전참조하세요*AWS 일반 참조*. [AWS AppFabric ](https://docs.aws.amazon.com/general/latest/gr/appfabric.html) 각 리전에서 다음 방법 중 하나를 사용하여 생산성을 위한 AppFabric에 액세스할 수 있습니다. + 앱 개발자로서 + [애플리케이션 개발자를 위한 생산성을 위한 AppFabric(미리 보기) 시작하기](getting-started-appdeveloper-productivity.md) + 최종 사용자로서 + [최종 사용자를 위한 생산성을 위한 AppFabric(미리 보기) 시작하기](getting-started-users-productivity.md) # 애플리케이션 개발자를 위한 생산성을 위한 AppFabric(미리 보기) 시작하기 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 이 섹션에서는 앱 개발자가 생산성을 위한 AWS AppFabric(미리 보기)을 애플리케이션에 통합하는 데 도움이 됩니다. 생산성을 위한 AWS AppFabric을 사용하면 여러 애플리케이션에서 이메일, 일정 이벤트, 작업, 메시지 등을 통해 AI 기반 인사이트와 작업을 생성하여 개발자가 사용자를 위해 더 풍부한 앱 경험을 구축할 수 있습니다. 지원되는 애플리케이션 목록은 [AWS AppFabric 지원 애플리케이션](https://aws.amazon.com/appfabric/supported-applications/)을 참조하세요. 생산성을 위한 AppFabric은 앱 개발자에게 안전하고 통제된 환경에서 빌드하고 실험할 수 있는 액세스 권한을 제공합니다. 생산성을 위한 AppFabric을 처음 사용하기 시작하면 AppClient를 생성하고 테스트 사용자 한 명을 등록해야 합니다. 이 접근 방식은 애플리케이션과 AppFabric 간의 인증 및 통신 흐름을 이해하고 테스트하는 데 도움이 되도록 설계되었습니다. 단일 사용자를 대상으로 테스트한 후 추가 사용자([5단계. AppFabric을 요청하여 애플리케이션 확인](#request_verification) 참조)에게 액세스를 확대하기 전에 AppFabric에 애플리케이션을 제출하여 확인을 받을 수 있습니다. AppFabric은 광범위하게 도입할 수 있도록 하기 전에 애플리케이션 정보를 확인하여 앱 개발자, 최종 사용자 및 데이터를 보호함으로써 책임감 있는 방식으로 사용자 도입을 확대할 수 있는 기반을 마련합니다. **Topics** + [사전 조건](#getting-started-prerequisites) + [1단계. 생산성을 위한 AppFabric AppClient 생성](#create_appclient) + [2단계. 애플리케이션 인증 및 권한 부여](#authorize_data_access) + [3단계. AppFabric 사용자 포털 URL을 애플리케이션에 추가](#end_user_portal) + [4단계. AppFabric을 사용하여 앱 간 인사이트 및 작업 표시](#surface_insights_actions) + [5단계. AppFabric을 요청하여 애플리케이션 확인](#request_verification) + [생산성을 위한 AppFabric AppClients](manage-appclients.md) + [생산성을 위한 AppFabric AppClients 문제 해결](ahead-app-dev-errors.md) ## 사전 조건 시작하기 전에를 생성해야 합니다 AWS 계정. 자세한 내용은 [에 가입 AWS 계정](prerequisites.md#sign-up-for-aws) 단원을 참조하십시오. 또한 아래 나열된 `"appfabric:CreateAppClient"` IAM 정책에 액세스할 수 있는 사용자를 최소 한 명 생성해야 합니다. 그러면 사용자가 AppFabric에 애플리케이션을 등록할 수 있습니다. 생산성을 위한 AppFabric 기능의 권한 부여에 대한 자세한 내용은 [생산성을 위한 AppFabric IAM 정책 예제](security_iam_id-based-policy-examples.md#appfabric-for-productivity-policy-examples) 섹션을 참조하세요. 관리 사용자가 있으면 유용하지만 초기 설정에 필수는 아닙니다. 자세한 내용은 [관리자 액세스 권한이 있는 사용자 생성](prerequisites.md#create-an-admin) 단원을 참조하십시오. 생산성을 위한 AppFabric은 평가판 기간 동안 미국 동부(버지니아 북부)에서만 사용할 수 있습니다. 아래 단계를 시작하기 전에 이 리전에 있는지 확인합니다. ## 1단계. 생산성을 위한 AppFabric AppClient 생성 애플리케이션 내에서 AppFabric for prodectivity 인사이트를 표시하려면 먼저 AppFabric AppClient를 생성해야 합니다. AppClient는 기본적으로 생산성을 위한 AppFabric의 게이트웨이로, 애플리케이션과 AppFabric 간의 보안 통신을 지원하는 안전한 OAuth 애플리케이션 클라이언트 역할을 합니다. AppClient를 생성하면 AppClient ID가 제공됩니다. AppClient ID는 AppFabric이 애플리케이션 및 AWS 계정과 함께 작업하고 있음을 AppFabric이 인식하는 데 중요한 고유 식별자입니다. 생산성을 위한 AppFabric은 앱 개발자에게 안전하고 통제된 환경에서 빌드하고 실험할 수 있는 액세스 권한을 제공합니다. 생산성을 위한 AppFabric을 처음 사용하기 시작하면 AppClient를 생성하고 테스트 사용자 한 명을 등록해야 합니다. 이 접근 방식은 애플리케이션과 AppFabric 간의 인증 및 통신 흐름을 이해하고 테스트하는 데 도움이 되도록 설계되었습니다. 단일 사용자를 대상으로 테스트한 후 추가 사용자([5단계. AppFabric을 요청하여 애플리케이션 확인](#request_verification) 참조)에게 액세스를 확대하기 전에 AppFabric에 애플리케이션을 제출하여 확인을 받을 수 있습니다. AppFabric은 광범위하게 도입할 수 있도록 하기 전에 애플리케이션 정보를 확인하여 앱 개발자, 최종 사용자 및 데이터를 보호함으로써 책임감 있는 방식으로 사용자 도입을 확대할 수 있는 기반을 마련합니다. AppClient를 생성하려면 AWS AppFabric `CreateAppClient` API 작업을 사용합니다. 이후에 AppClient를 업데이트해야 하는 경우 `UpdateAppClient` API 작업을 사용하여 redirectUrls만 변경할 수 있습니다. appName 또는 설명과 같은 AppClient와 관련된 다른 파라미터를 변경해야 하는 경우 AppClient를 삭제하고 새 파라미터를 생성해야 합니다. 자세한 내용은 [CreateAppClient](API_CreateAppClient.md) 단원을 참조하십시오. Python, Node.js, Java, C\$1, Go, Rust 등 여러 프로그래밍 언어를 사용하여 `CreateAppClient` API를 사용하여 AWS 서비스에 애플리케이션을 등록할 수 있습니다. 자세한 내용은 IAM 사용 설명서의 [서명 요청 예](https://docs.aws.amazon.com/IAM/latest/UserGuide/signature-v4-examples.html)를 참조하세요. 이 API 작업을 수행하려면 계정의 Signature Version 4 자격 증명을 사용해야 합니다. 서명 버전 4에 대한 자세한 내용은 *IAM 사용 설명서*의 [AWS API 요청 서명을](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 참조하세요. **요청 필드** + `appName` - AppFabric 사용자 포털의 동의 페이지에 사용자에게 표시될 애플리케이션의 이름입니다. 동의 페이지에서는 최종 사용자에게 애플리케이션 내에 AppFabric 인사이트를 표시할 수 있는 권한을 요청합니다. 동의 페이지에 대한 자세한 내용은 [2단계. 앱에 인사이트가 표시되도록 동의](getting-started-users-productivity.md#provide-consent) 섹션을 참조하세요. + `description` - 애플리케이션에 대한 설명입니다. + `redirectUrls` - 인증 후 최종 사용자를 리디렉션할 URI입니다. redirectUrl을 최대 5개 추가할 수 있습니다. 예를 들어 `https://localhost:8080`입니다. + `starterUserEmails` - 애플리케이션이 검증될 때까지 인사이트를 수신할 수 있는 액세스가 허용되는 사용자 이메일 주소입니다. 이메일 주소는 하나만 사용할 수 있습니다. 예: `anyuser@example.com` + `customerManagedKeyIdentifier`(선택 사항) - 데이터를 암호화하는 데 사용할 고객 관리형 키(KMS에서 생성)의 ARN입니다. 지정하지 않으면 AWS AppFabric 관리형 키가 사용됩니다. AWS 소유 키 및 고객 관리형 키에 대한 자세한 내용은 *AWS Key Management Service 개발자 안내서*의 [고객 키 및 AWS 키](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt)를 참조하세요. **응답 필드** + `appClientArn` - AppClient ID를 포함하는 Amazon 리소스 이름(ARN)입니다. 예를 들어 AppClient ID는 `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`입니다. + `verificationStatus` - AppClient 확인 상태입니다. + `pending_verification` - AppFabric에서 AppClient 확인이 아직 진행 중입니다. AppClient가 확인되기 전까지는 한 명의 사용자(`starterUserEmails`에서 지정된 사용자)만 AppClient를 사용할 수 있습니다. [3단계. AppFabric 사용자 포털 URL을 애플리케이션에 추가](#end_user_portal)에 소개된 AppFabric 사용자 포털에서 애플리케이션이 확인되지 않았음을 알리는 알림이 사용자에게 표시됩니다. + `verified` - AppFabric에서 확인 프로세스를 성공적으로 완료했으며 이제 AppClient가 완전히 확인되었습니다. + `rejected` - AppClient에 대한 확인 프로세스를 AppFabric에서 거부했습니다. 확인 프로세스를 다시 시작하고 성공적으로 완료하기 전까지는 추가 사용자가 AppClient를 사용할 수 없습니다. ``` 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/" }' ``` 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. ``` { "appClientConfigSummary": { "appClientArn": "arn:aws:appfabric:::appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "verificationStatus": "pending_verification" } } ``` ## 2단계. 애플리케이션 인증 및 권한 부여 OAuth 2.0 권한 부여 흐름을 설정하여 애플리케이션이 AppFabric 인사이트를 안전하게 통합할 수 있도록 합니다. 먼저 애플리케이션 ID를 확인하는 인증 코드를 생성해야 합니다. 자세한 내용은 [인증](API_Authorize.md) 단원을 참조하십시오. 그런 다음 이 인증 코드를 액세스 토큰으로 교환합니다. 액세스 토큰은 애플리케이션 내에서 AppFabric 인사이트를 가져오고 표시할 수 있는 권한을 애플리케이션에 권한을 부여합니다. 자세한 내용은 [토큰](API_Token.md) 단원을 참조하십시오. 애플리케이션 인증에 대한 자세한 내용은 [애플리케이션 승인 액세스 허용](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-token) 섹션을 참조하세요. 1. 권한 부여 코드를 생성하려면 AWS AppFabric `oauth2/authorize` API 작업을 사용합니다. **요청 필드** + `app_client_id`(필수) - [1단계에서 생성한 AWS 계정 AppClient ID입니다. AppClient 생성](#create_appclient) 예를 들어 `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`입니다. + `redirect_uri`(필수) - [1단계에서 사용한 인증 후 최종 사용자를 리디렉션할 URI입니다. AppClient 생성](#create_appclient) 예를 들어 `https://localhost:8080`입니다. + `state`(필수) - 요청과 콜백 사이의 상태를 유지하기 위한 고유 값입니다. 예를 들어 `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. 인증 후에는 쿼리 파라미터로 반환되는 인증 코드와 함께 지정된 URI로 리디렉션됩니다. 예를 들면 `code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`로 입니다. ``` https://localhost:8080/?code=mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc&state=a8904edc-890c-1005-1996-29a757272a44 ``` 1. AppFabric `oauth2/token` API 작업을 사용하여 이 인증 코드를 액세스 토큰으로 교환합니다. 이 토큰은 API 요청에 사용되며 처음에는 AppClient가 확인될 때까지 `starterUserEmails`에 유효합니다. AppClient가 확인된 후 모든 사용자가 이 토큰을 사용할 수 있습니다. 이 API 작업을 수행하려면 계정의 Signature Version 4 자격 증명을 사용해야 합니다. 서명 버전 4에 대한 자세한 내용은 *IAM 사용 설명서*의 [AWS API 요청 서명을](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 참조하세요. **요청 필드** + `code`(필수) - 마지막 단계에서 인증한 후 받은 인증 코드입니다. 예를 들어 `mM0NyJ9.MEUCIHQQgV3ChXGs2LRwxLtpsgya3ybfPYXfX-sxTAdRF-gDAiEAxX7BYKlD9krG3J2VtprOjVXZ0FSUX9whdekqJ-oampc`입니다. + `app_client_id`(필수) - [1단계에서 생성한 AWS 계정 AppClient ID입니다. AppClient 생성](#create_appclient) 예를 들어 `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`입니다. + `grant_type`(필수) - 값은 `authorization_code`와 같아야 합니다. + `redirect_uri`(필수) - [1단계에서 사용한 인증 후 사용자를 리디렉션할 URI입니다. AppClient 생성](#create_appclient) 인증 코드를 생성할 때 사용한 것과 동일한 리디렉션 URI여야 합니다. 예를 들어 `https://localhost:8080`입니다. **응답 필드** + `expires_in` - 토큰이 만료되기까지 남은 기간입니다. 기본 만료 시간은 12시간입니다. + `refresh_token` - 초기 요청과 토큰 요청에서 받은 새로 고침 토큰입니다. + `token` - 초기 요청과 토큰 요청에서 받은 토큰입니다. + `token_type` - 값은 `Bearer`입니다. + `appfabric_user_id` - AppFabric 사용자 ID입니다. `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\" }" ``` 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. ``` { "expires_in": 43200, "refresh_token": "apkaeibaerjr2example", "token": "apkaeibaerjr2example", "token_type": "Bearer", "appfabric_user_id" : "" } ``` ## 3단계. AppFabric 사용자 포털 URL을 애플리케이션에 추가 최종 사용자는 AppFabric이 인사이트를 생성하는 데 사용한 애플리케이션의 데이터에 액세스할 수 있도록 권한을 부여해야 합니다. AppFabric은 최종 사용자가 앱에 권한을 부여할 수 있는 전용 사용자 포털(팝업 화면)을 구축하여 앱 개발자가 이 프로세스를 소유해야 하는 복잡성을 없애줍니다. 생산성을 위한 AppFabric을 사용할 준비가 되면 사용자는 사용자 포털로 이동하여 인사이트 및 앱 간 작업을 생성하는 데 사용하는 애플리케이션을 연결하고 관리할 수 있습니다. 로그인하면 사용자는 애플리케이션을 생산성을 위한 AppFabric에 연결한 다음 애플리케이션으로 돌아가 인사이트와 작업을 탐색할 수 있습니다. 애플리케이션을 생산성을 위한 AppFabric과 통합하려면 애플리케이션에 특정 AppFabric URL을 추가해야 합니다. 이 단계는 사용자가 애플리케이션에서 직접 AppFabric 사용자 포털에 액세스할 수 있도록 하는 데 매우 중요합니다. 1. 애플리케이션 설정으로 이동하여 리디렉션 URL을 추가하기 위한 섹션을 찾습니다. 1. 적절한 영역을 찾은 후 다음 AppFabric URL을 애플리케이션에 대한 리디렉션 URL로 추가합니다. ``` https://userportal.appfabric..amazonaws.com/eup_login ``` URL을 추가하면 애플리케이션이 사용자를 AppFabric 사용자 포털로 안내하도록 설정됩니다. 여기서 사용자는 생산성을 위한 AppFabric 인사이트를 생성하는 데 사용되는 애플리케이션에 로그인하고 연결하며 관리할 수 있습니다. ## 4단계. AppFabric을 사용하여 앱 간 인사이트 및 작업 표시 사용자가 애플리케이션을 연결한 후에는 앱 및 컨텍스트 전환을 줄임으로써 사용자의 인사이트를 가져와 생산성을 높일 수 있습니다. AppFabric은 사용자가 액세스 권한이 있는 것을 기반으로 사용자에게만 인사이트를 생성합니다. AppFabric은 AppFabric이 AWS 계정 소유한에 사용자 데이터를 저장합니다. AppFabric이 데이터를 사용하는 방법에 대한 자세한 내용은 [AppFabric의 데이터 처리](productivity-data-processing.md)를 참조하세요. 다음과 같은 AI 기반 API를 사용하여 앱 내에서 사용자 수준의 인사이트와 작업을 생성하고 표시할 수 있습니다. + `ListActionableInsights` - 자세한 내용은 아래의 [실행 가능한 인사이트](#productivity-actionable-insights) 섹션을 참조하세요. + `ListMeetingInsights` - 자세한 내용은 이 설명서 후반부의 [회의 준비](#productivity-meeting-insights) 섹션을 참조하세요. ### 실행 가능한 인사이트(`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` \$1 `EXECUTED` **요청 헤더** + 인증 헤더를 `Bearer Token ` 값과 함께 전달해야 합니다. **응답 필드** + `insightId` - 생성된 인사이트의 고유 ID입니다. + `insightContent` - 이렇게 하면 인사이트의 요약과 인사이트를 생성하는 데 사용된 아티팩트로 연결하는 포함된 링크가 반환됩니다. 참고: 이는 포함된 링크(태그)가 포함된 HTML 콘텐츠입니다. + `insightTitle` - 생성된 인사이트의 제목입니다. + `createdAt` - 인사이트가 생성된 시점입니다. + `actions` - 생성된 인사이트에 대한 권장 작업 목록입니다. 작업 객체: + `actionId` - 생성된 작업의 고유 ID입니다. + `actionIconUrl` - 작업을 실행하도록 제안한 앱의 아이콘 URL입니다. + `actionTitle` - 생성된 작업의 제목입니다. + `actionUrl` - 최종 사용자가 AppFabric의 사용자 포털에서 작업을 보고 실행할 수 있는 고유한 URL입니다. 참고: ISV 앱은 작업을 실행할 때 이 URL을 사용하여 사용자를 AppFabric 사용자 포털(팝업 화면)로 리디렉션합니다. + `actionExecutionStatus` - 작업 상태를 나타내는 열거형입니다. 가능한 값은 `EXECUTED` \$1 `NOT_EXECUTED`입니다. + `nextToken`(선택 사항) - 다음 인사이트 세트를 가져오기 위한 페이지 매김 토큰입니다. 이 필드는 선택 사항 필드이며, null을 반환하면 로드할 인사이트가 더 이상 없음을 의미합니다. 자세한 내용은 [ActionableInsights](API_ActionableInsights.md) 단원을 참조하십시오. ``` curl -v --location \ "https://productivity.appfabric..amazonaws.com"\ "/actionableInsights" \ --header "Authorization: Bearer " ``` 작업이 성공하면 서비스가 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` \$1 `EVENT` \$1 `MESSAGE` \$1 `TASK`입니다. + `resourceUrl` - 앱의 리소스 URL입니다. + `appIconUrl` - 리소스가 속한 앱의 이미지 URL입니다. + `nextToken`(선택 사항) - 다음 인사이트 세트를 가져오기 위한 페이지 매김 토큰입니다. 이 필드는 선택 사항 필드이며, null을 반환하면 로드할 인사이트가 더 이상 없음을 의미합니다. 자세한 내용은 [MeetingInsights](API_MeetingInsights.md) 단원을 참조하십시오. ``` curl --location \ "https://productivity.appfabric..amazonaws.com"\ "/meetingContexts" \ --header "Authorization: Bearer " ``` 작업이 성공하면 서비스가 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 `PutFeedback` API 작업을 사용하여 생성된 인사이트와 작업에 대한 피드백을 제공합니다. 이 기능을 앱에 내장하여 특정 InsightId 또는 ActionId에 대한 피드백 평점(1\$15, 등급이 높을수록 좋음)을 제출할 수 있는 방법을 제공할 수 있습니다. **요청 필드** + `id` - 피드백을 받는 객체의 식별자입니다. 이는 InsightId 또는 ActionId일 수 있습니다. + `feedbackFor` - 피드백을 받는 리소스 유형입니다. 가능한 값: `ACTIONABLE_INSIGHT` \$1 `MEETING_INSIGHT` \$1 `ACTION` + `feedbackRating` - 피드백 평점은 `1`에서 `5`까지입니다. 평점이 높을수록 좋습니다. **응답 필드** + 응답 필드가 없습니다. 자세한 내용은 [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 }' ``` 작업이 성공하면 서비스가 비어있는 HTTP 본문과 함께 HTTP 201 응답을 다시 전송합니다. ## 5단계. AppFabric을 요청하여 애플리케이션 확인 지금까지 AppFabric 앱 간 인사이트 및 작업을 포함하도록 애플리케이션 UI를 업데이트하고 단일 사용자에 대한 인사이트를 얻었습니다. 테스트에 만족하고 AppFabric이 풍부한 경험을 추가 사용자에게 확장하고 싶다면 AppFabric에 애플리케이션를 제출하여 검토 및 확인을 받을 수 있습니다. AppFabric은 광범위하게 도입할 수 있도록 하기 전에 애플리케이션 정보를 확인하여 앱 개발자, 최종 사용자 및 데이터를 보호함으로써 책임감 있는 방식으로 사용자 도입을 확대할 수 있는 기반을 마련합니다. **확인 프로세스 시작** [appfabric-appverification@amazon.com](mailto:appfabric-appverification@amazon.com)으로 이메일을 보내고 앱 확인을 요청하여 확인 프로세스를 시작합니다. 사용자의 이메일에 다음 세부 정보를 포함합니다. + AWS 계정 ID + 확인하고자 하는 애플리케이션의 이름 + AppClient ID + 연락처 정보 또한 우선순위와 영향을 평가하는 데 도움이 되도록 가능한 경우 다음 정보를 제공합니다. + 액세스 권한을 부여하려는 예상 사용자 수 + 목표 출시일 **참고** AWS 계정 관리자 또는 AWS 파트너 개발 관리자가 있는 경우 이메일에 복사하십시오. 이러한 연락처를 포함하면 확인 프로세스를 신속하게 처리할 수 있습니다. **확인 기준** 확인 프로세스를 사용하기 전에 다음 기준을 충족하는지 확인합니다. + 생산성을 위한 AppFabric을 사용하려면 유효한 AWS 계정 를 사용해야 합니다. 또한 다음 기준 중 하나 이상을 충족합니다. + 조직은 최소한 “AWS 선택” 티어가 AWS Partner Network 있는의 AWS 파트너입니다. 자세한 내용은 [AWS 파트너 서비스 티어](https://aws.amazon.com/partners/services-tiers/)를 참조하세요. + 조직이 지난 3년 이내에 AppFabric 서비스에 최소 1만 USD를 지출했어야 합니다. + 애플리케이션은 AWS Marketplace에 등록되어 있어야 합니다. 자세한 내용은 [AWS Marketplace](https://aws.amazon.com/marketplace)를 참조하세요. **확인 상태 업데이트 대기** 애플리케이션이 검토받은 후 이메일을 통해 답변을 드리며 AppClient의 상태는 `pending_verification`에서 `verified`으로 변경됩니다. 애플리케이션이 거부된 경우 확인 프로세스를 다시 시작해야 합니다. # 생산성을 위한 AppFabric AppClients | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 생산성을 위한 AppFabric AppClient를 관리하여 인증 및 인증 프로세스의 원활한 운영 및 유지 관리를 보장할 수 있습니다. ## AppClient의 세부 정보 가져오기 AppFabric `GetAppClient` API 작업을 사용하여 AppClient 상태 확인을 포함하여 AppClient에 대한 세부 정보를 볼 수 있습니다. 자세한 내용은 [GetAppClient](API_GetAppClient.md) 단원을 참조하십시오. AppClient의 세부 정보를 가져오려면 최소한 `"appfabric:GetAppClient"` IAM 정책 권한이 있어야 합니다. 자세한 내용은 [AppClient의 세부 정보를 가져오는 액세스 허용](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-get-appclient) 단원을 참조하십시오. **요청 필드** + `appClientId` - AppClient ID입니다. **응답 필드** + `appName` - AppFabric 사용자 포털의 동의 페이지에 사용자에게 표시될 애플리케이션의 이름입니다. + `customerManagedKeyIdentifier`(선택 사항) - 데이터를 암호화하는 데 사용할 고객 관리형 키(KMS에서 생성)의 ARN입니다. 지정하지 않으면 AWS AppFabric 관리형 키가 사용됩니다. + `description` - 애플리케이션에 대한 설명입니다. + `redirectUrls` - 인증 후 최종 사용자를 리디렉션할 URI입니다. redirectUrl을 최대 5개 추가할 수 있습니다. 예를 들어 `https://localhost:8080`입니다. + `starterUserEmails` - 애플리케이션이 검증될 때까지 인사이트를 수신할 수 있는 액세스가 허용되는 사용자 이메일 주소입니다. 이메일 주소는 하나만 사용할 수 있습니다. 예를 들어 `anyuser@example.com`입니다. + `verificationStatus` - AppClient 확인 상태입니다. + `pending_verification` - AppFabric에서 AppClient 확인이 아직 진행 중입니다. AppClient가 확인되기 전까지는 한 명의 사용자(`starterUserEmails`에서 지정된 사용자)만 AppClient를 사용할 수 있습니다. + `verified` - AppFabric에서 확인 프로세스를 성공적으로 완료했으며 이제 AppClient가 완전히 확인되었습니다. + `rejected` - AppClient에 대한 확인 프로세스를 AppFabric에서 거부했습니다. 확인 프로세스를 다시 시작하고 성공적으로 완료하기 전까지는 추가 사용자가 AppClient를 사용할 수 없습니다. ``` 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 ``` 작업이 성공하면 서비스가 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" } } } ``` ## AppClient 목록 AppFabric `ListAppClients` API 작업을 사용하여 AppClient 목록을 봅니다. AppFabric은 당 하나의 AppClient만 허용합니다 AWS 계정. 향후 변경될 수 있습니다. 자세한 내용은 [ListAppClients](API_ListAppClients.md) 단원을 참조하십시오. AppClients를 나열하려면 최소한 `"appfabric:ListAppClients"` IAM 정책 권한이 있어야 합니다. 자세한 내용은 [AppClient 목록에 대한 액세스 허용](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-list-appclient) 단원을 참조하십시오. **요청 필드** + 필수 필드가 없습니다. **응답 필드** + `appClientARN` - AppClient ID를 포함하는 Amazon 리소스 이름(ARN)입니다. 예를 들어 AppClient ID는 `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`입니다. + `verificationStatus` - AppClient 확인 상태입니다. + `pending_verification` - AppFabric에서 AppClient 확인이 아직 진행 중입니다. AppClient가 확인되기 전까지는 한 명의 사용자(`starterUserEmails`에서 지정된 사용자)만 AppClient를 사용할 수 있습니다. + `verified` - AppFabric에서 확인 프로세스를 성공적으로 완료했으며 이제 AppClient가 완전히 확인되었습니다. + `rejected` - AppClient에 대한 확인 프로세스를 AppFabric에서 거부했습니다. 확인 프로세스를 다시 시작하고 성공적으로 완료하기 전까지는 추가 사용자가 AppClient를 사용할 수 없습니다. ``` 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 ``` 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. ``` 200 OK { "appClientList": [ { "appClientArn": "arn:aws:appfabric::111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "verificationStatus": "pending_verification" } ] } ``` ## AppClient 업데이트 AppFabric `UpdateAppClient` API 작업을 사용하여 AppClient에 매핑된 redirectUrls을 업데이트합니다. AppName, StarterUserEmail 등과 같은 다른 파라미터를 변경해야 하는 경우 AppClient를 삭제하고 새 파라미터를 생성해야 합니다. 자세한 내용은 [UpdateAppClient](API_UpdateAppClient.md) 단원을 참조하십시오. AppClient를 업데이트하려면 최소한 `"appfabric:UpdateAppClient"` IAM 정책 권한이 있어야 합니다. 자세한 내용은 [AppClient 업데이트 액세스 허용](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient) 단원을 참조하십시오. **요청 필드** + `appClientId`(필수) - 리디렉션 URL을 업데이트하려는 AppClient ID입니다. + `redirectUrls`(필수) - 업데이트된 리디렉션 URL 목록입니다. redirectUrl을 최대 5개 추가할 수 있습니다. **응답 필드** + `appName` - AppFabric 사용자 포털의 동의 페이지에 사용자에게 표시될 애플리케이션의 이름입니다. + `customerManagedKeyIdentifier`(선택 사항) - 데이터를 암호화하는 데 사용할 고객 관리형 키(KMS에서 생성)의 ARN입니다. 지정하지 않으면 AWS AppFabric 관리형 키가 사용됩니다. + `description` - 애플리케이션에 대한 설명입니다. + `redirectUrls` - 인증 후 최종 사용자를 리디렉션할 URI입니다. 예를 들어 `https://localhost:8080`입니다. + `starterUserEmails` - 애플리케이션이 검증될 때까지 인사이트를 수신할 수 있는 액세스가 허용되는 사용자 이메일 주소입니다. 이메일 주소는 하나만 사용할 수 있습니다. 예를 들어 `anyuser@example.com`입니다. + `verificationStatus` - AppClient 확인 상태입니다. + `pending_verification` - AppFabric에서 AppClient 확인이 아직 진행 중입니다. AppClient가 확인되기 전까지는 한 명의 사용자(`starterUserEmails`에서 지정된 사용자)만 AppClient를 사용할 수 있습니다. + `verified` - AppFabric에서 확인 프로세스를 성공적으로 완료했으며 이제 AppClient가 완전히 확인되었습니다. + `rejected` - AppClient에 대한 확인 프로세스를 AppFabric에서 거부했습니다. 확인 프로세스를 다시 시작하고 성공적으로 완료하기 전까지는 추가 사용자가 AppClient를 사용할 수 없습니다. ``` 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"] }' ``` 작업이 성공하면 서비스가 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" } } } ``` ## AppClient 삭제 AppFabric `DeleteAppClient` API 작업을 사용하여 더 이상 필요하지 않은 AppClient를 삭제합니다. 자세한 내용은 [DeleteAppClient](API_DeleteAppClient.md) 단원을 참조하십시오. AppClient를 삭제하려면 최소한 `"appfabric:DeleteAppClient"` IAM 정책 권한이 있어야 합니다. 자세한 내용은 [AppClient 삭제 액세스 허용](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-delete-appclient) 단원을 참조하십시오. **요청 필드** + `appClientId` - AppClient ID입니다. **응답 필드** + 응답 필드가 없습니다. ``` 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 ``` 액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다. ## 최종 사용자를 위한 새로 고침 토큰 AppClient가 최종 사용자를 위해 획득한 토큰은 만료 시 새로 고침할 수 있습니다. 이는 grant\$1type `refresh_token`과 함께 [토큰](API_Token.md) API를 사용하여 수행할 수 있습니다. grant\$1type이 `authorization_code`면 사용할 `refresh_token`이 토큰 API 응답의 일부로 반환됩니다. 기본 만료는 12시간입니다. 새로 고침 API를 직접적으로 호출하려면 `"appfabric:Token"` IAM 정책 권한이 있어야 합니다. 자세한 내용은 [토큰](API_Token.md) 및 [AppClient 업데이트 액세스 허용](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-productivity-update-appclient) 섹션을 참조하세요. **요청 필드** + `refresh_token`(필수) - 초기 `/token` 요청에서 받은 새로 고침 토큰입니다. + `app_client_id`(필수) - AWS 계정를 위해 생성된 AppClient 리소스의 ID입니다. + `grant_type`(필수) - `refresh_token`이어야 합니다. **응답 필드** + `expires_in` - 토큰이 만료되기까지 남은 기간입니다. 기본 만료 시간은 12시간입니다. + `refresh_token` - 초기 요청과 토큰 요청에서 받은 새로 고침 토큰입니다. + `token` - 초기 요청과 토큰 요청에서 받은 토큰입니다. + `token_type` - 값은 `Bearer`입니다. + `appfabric_user_id` - AppFabric 사용자 ID입니다. `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\" }" ``` 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. ``` 200 OK { "expires_in": 43200, "token": "apkaeibaerjr2example", "token_type": "Bearer", "appfabric_user_id" : "${UserID}" } ``` # 생산성을 위한 AppFabric AppClients 문제 해결 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 이 섹션에서는 생산성을 위한 AppFabric의 일반적인 오류와 문제 해결에 대해 설명합니다. ## 확인되지 않은 애플리케이션 생산성을 위한 AppFabric을 사용하여 앱 경험을 강화하는 앱 개발자는 최종 사용자에게 기능을 출시하기 전에 확인 프로세스를 거칩니다. 모든 애플리케이션은 확인되지 않은 상태로 시작하다가 확인 프로세스가 완료되어야만 확인된 것으로 변경됩니다. 즉, AppClient를 생성할 때 사용한 `starterUserEmails`에 사용자에게 이 메시지가 표시됩니다. ![\[Warning message for an unverified application in AWS AppFabric, requesting data access.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-24.png) ## `CreateAppClient` 오류 ### ServiceQuotaExceededException AppClient를 생성할 때 다음 예외가 발생하면 AWS 계정당 생성할 수 있는 AppClient의 수를 초과한 것입니다. 한도는 1입니다. 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 ``` ## `GetAppClient` 오류 ### ResourceNotFoundException AppClient에 대한 세부 정보를 가져올 때 다음과 같은 예외가 발생하면 올바른 AppClient 식별자를 입력했는지 확인합니다. 이 오류는 지정된 AppClient를 찾을 수 없음을 나타냅니다. ``` ResourceNotFoundException / APP_CLIENT_NOT_FOUND The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier. HTTP Status Code: 404 ``` ## `DeleteAppClient` 오류 ### ConflictException AppClient를 삭제할 때 다음과 같은 예외가 발생하면 다른 삭제 요청이 진행 중인 것입니다. 완료될 때까지 잠시 기다렸다가 다시 시도하세요. HTTP 상태 코드: 409 ``` ConflictException Another delete request is in progress. Wait until it completes then try again. HTTP Status Code: 409 ``` ### ResourceNotFoundException AppClient를 삭제할 때 다음과 같은 예외가 발생하면 올바른 AppClient 식별자를 입력했는지 확인합니다. 이 오류는 지정된 AppClient를 찾을 수 없음을 나타냅니다. ``` ResourceNotFoundException / APP_CLIENT_NOT_FOUND The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier. HTTP Status Code: 404 ``` ## `UpdateAppClient` 오류 ### ResourceNotFoundException AppClient를 업데이트할 때 다음과 같은 예외가 발생하면 올바른 AppClient 식별자를 입력했는지 확인합니다. 이 오류는 지정된 AppClient를 찾을 수 없음을 나타냅니다. ``` ResourceNotFoundException / APP_CLIENT_NOT_FOUND The specified AppClient is not found. Ensure you’ve entered the correct AppClient identifier. HTTP Status Code: 404 ``` ## `Authorize` 오류 ### ValidationException API 파라미터 중 하나라도 API 사양에 정의된 제약 조건을 충족하지 않는 경우 다음과 같은 예외가 발생할 수 있습니다. ``` ValidationException HTTP Status Code: 400 ``` **이유 1: AppClient ID가 지정되지 않은 경우** 요청 파라미터에 `app_client_id`가 없습니다. AppClient가 아직 생성되지 않은 경우 AppClient를 생성하거나 기존 `app_client_id`를 사용하여 다시 시도하세요. AppClient ID를 찾으려면 [ListAppClient](manage-appclients.md#list_appclients) API 작업을 사용합니다. **이유 2: AppFabric이 고객 관리형 키에 액세스할 수 없는 경우** ``` Message: AppFabric couldn't access the customer managed key configured for AppClient. ``` AppFabric은 현재 고객 관리형 키에 액세스할 수 없습니다. 이는 최근에 권한이 변경되었기 때문일 수 있습니다. 지정된 키가 존재하는지 확인하고 AppFabric에 적절한 액세스 권한이 부여되었는지 확인합니다. **이유 3: 지정된 리디렉션 URL이 유효하지 않은 경우** ``` Message: Redirect url invalid ``` 요청의 리디렉션 URL이 정확한지 확인합니다. AppClient를 생성하거나 업데이트할 때 지정한 리디렉션 URL 중 하나와 일치해야 합니다. 허용된 리디렉션 URL 목록을 보려면 [GetAppClient](manage-appclients.md#get_appclient_details) API 작업을 사용합니다. ## `Token` 오류 ### TokenException 몇 가지 이유로 다음과 같은 예외가 발생할 수 있습니다. ``` TokenException HTTP Status Code: 400 ``` **이유 1: 유효하지 않은 이메일이 지정된 경우** ``` Message: Invalid Email used ``` 사용 중인 이메일 주소가 AppClient를 생성할 때 `starterUserEmails` 속성에 나열한 주소와 일치하는지 확인합니다. 이메일이 일치하지 않으면 일치하는 이메일 주소로 변경한 후 다시 시도하세요. 사용된 이메일을 보려면 [GetAppClient](manage-appclients.md#get_appclient_details) API 작업을 사용합니다. **이유 2: grant\$1type이 refresh\$1token일 때 토큰이 지정되지 않았을 경우** ``` Message: refresh_token must be non-null for Refresh Token Grant-type ``` 요청에 지정된 새로 고침 토큰이 null이거나 비어있습니다. [토큰](getting-started-appdeveloper-productivity.md#authorize_data_access) API 직접 호출 응답에서 수신한 활성 `refresh_token`을 지정합니다. ### ThrottlingException 허용된 할당량을 초과하는 속도로 API를 호출하는 경우 다음과 같은 예외가 발생할 수 있습니다. ``` ThrottlingException HTTP Status Code: 429 ``` ## `ListActionableInsights`, `ListMeetingInsights`, `PutFeedback` 오류 ### ValidationException API 파라미터 중 하나라도 API 사양에 정의된 제약 조건을 충족하지 않는 경우 다음과 같은 예외가 발생할 수 있습니다. ``` ValidationException HTTP Status Code: 400 ``` ### ThrottlingException 허용된 할당량을 초과하는 속도로 API를 호출하는 경우 다음과 같은 예외가 발생할 수 있습니다. ``` ThrottlingException HTTP Status Code: 429 ``` # 최종 사용자를 위한 생산성을 위한 AppFabric(미리 보기) 시작하기 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 이 섹션은 생산성을 위한 AWS AppFabric(미리 보기)을 활성화하여 작업 관리 및 워크플로 효율성을 개선하려는 SaaS 애플리케이션의 최종 사용자를 대상으로 합니다. 다음 단계에 따라 애플리케이션을 연결하고 AppFabric이 앱 간 인사이트를 표시하여 선호하는 애플리케이션에서 작업(예: 이메일 전송 또는 회의 예약)을 완료할 수 있도록 권한을 부여합니다. Asana, Atlassian Jira Suite, Google Workspace, Microsoft 365, Miro, Slack, Smartsheet 등과 같은 애플리케이션을 연결할 수 있습니다. AppFabric이 콘텐츠에 액세스할 수 있도록 권한을 부여한 후 AppFabric은 선호하는 앱 내에서 앱 간 인사이트와 작업을 직접 가져와 더 효율적으로 작업하고 현재 워크플로를 유지할 수 있도록 지원합니다. 생산성을 위한 AppFabric은 Amazon Bedrock에서 제공하는 생성형 AI를 사용합니다. AppFabric은 명시적인 허가를 받은 후에만 인사이트와 작업를 생성합니다. 각 개별 애플리케이션이 어떤 콘텐츠를 사용할지 완전히 제어할 수 있도록 권한을 부여합니다. AppFabric은 인사이트를 생성하는 데 사용되는 기본 대규모 언어 모델을 학습하거나 개선하는 데 데이터를 사용하지 않습니다. 자세한 내용은 [Amazon Bedrock FAQ](https://aws.amazon.com/bedrock/faqs/)를 참조하세요. **Topics** + [사전 조건](#getting-started-prerequisites) + [1단계. AppFabric 로그인](#sign-in-appfabric) + [2단계. 앱에 인사이트가 표시되도록 동의](#provide-consent) + [3단계. 애플리케이션을 연결하여 인사이트와 작업 생성](#connect-apps) + [4단계. 인사이트를 확인 시작 및 애플리케이션에서 앱 간 작업 실행](#insights_in_app) + [IT 및 보안 관리자를 위한 생산성을 위한 AppFabric(미리 보기) 기능에 대한 액세스 관리](productivity-end-users-managing-access.md) + [생산성을 위한 AppFabric의 최종 사용자 오류 문제 해결](productivity-end-users-errors.md) ## 사전 조건 시작하기 전에 다음이 있는지 확인합니다. + AppFabric에 로그인하기 위한 보안 인증 정보: 생산성을 위한 AppFabric을 사용하려면 Asana, Google Workspace, Microsoft 365 또는 Slack 공급업체 중 하나에 대한 페더레이션된 로그인 보안 인증 정보(사용자 이름과 암호)가 필요합니다. AppFabric에 로그인하면 생산성을 위한 AppFabric을 활성화하는 각 애플리케이션에서 사용자로 식별할 수 있습니다. 로그인한 후 애플리케이션을 연결하여 인사이트 생성을 시작할 수 있습니다. + 애플리케이션 연결을 위한 보안 인증 정보: 앱 간 인사이트와 작업은 인증한 애플리케이션을 기반으로만 생성됩니다. 인증하려는 각 애플리케이션에 대한 로그인 보안 인증 정보(사용자 이름 및 암호)가 필요합니다. Asana, Atlassian Jira Suite, Google Workspace, Microsoft 365, Miro, Slack, Smartsheet와 같은 애플리케이션이 지원됩니다. ## 1단계. AppFabric 로그인 애플리케이션을 AppFabric에 연결하여 원하는 애플리케이션 내에서 콘텐츠와 인사이트를 직접 가져올 수 있습니다. 1. 모든 애플리케이션은 다양한 방식으로 생산성을 위한 AppFabric을 사용하여 더 풍부한 앱 경험을 제공합니다. 따라서 모든 애플리케이션마다 생산성을 위한 AppFabric 홈 페이지에 접속할 수 있는 진입점이 달라집니다. 홈 페이지는 AppFabric을 활성화하는 프로세스에 대한 컨텍스트를 설정하고 먼저 로그인하라는 메시지를 표시합니다. AppFabric을 활성화하려는 모든 애플리케이션이 이 화면에 표시됩니다. ![\[Sign-in prompt for AWS AppFabric, highlighting AI-powered productivity features.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-01.png) 1. Asana, Google Workspace, Microsoft 365, 또는 Slack 공급업체 중 한 곳의 보안 인증 정보를 사용하여 로그인합니다. 최상의 경험을 위해 AppFabric을 활성화한 각 애플리케이션에 대해 동일한 공급업체를 사용하여 로그인하는 것이 좋습니다. 예를 들어, App1에서 Google Workspace 보안 인증 정보를 선택하면 App2에서 Google Workspace 선택을 권장하며, 이후에 다시 로그인해야 할 때도 마찬가지입니다. 다른 공급업체로 로그인하는 경우 애플리케이션 연결 프로세스를 다시 시작해야 합니다. ![\[AWS AppFabric sign-in page with options for Slack, Microsoft, Google, and Asana.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-02.png) 1. 메세지가 표시되면 로그인 보안 인증 정보를 입력하고 공급업체에서 AppFabric에 로그인하는 것을 수락합니다. ![\[Slack sign-in page with options for Google, Apple, or email authentication.\]](http://docs.aws.amazon.com/ko_kr/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/ko_kr/appfabric/latest/adminguide/images/fabric-04.png) ## 2단계. 앱에 인사이트가 표시되도록 동의 로그인한 후 AppFabric은 생산성을 위한 AppFabric을 활성화하는 애플리케이션 내에서 앱 간 인사이트 및 작업을 AppFabric이 표시할 수 있도록 허용할지 묻는 동의 페이지를 표시합니다. 예를 들면, AppFabric이 Google Workspace 이메일과 캘린더 이벤트를 가져와서 Asana에 표시하도록 허용합니까? 이 동의 단계는 AppFabric을 활성화하는 애플리케이션 당 한 번만 완료하면 됩니다. ![\[Dialog box requesting permission to display insights and artifacts within an application.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-05.png) ## 3단계. 애플리케이션을 연결하여 인사이트와 작업 생성 동의 페이지를 완료하면 **애플리케이션 연결** 페이지로 이동합니다. 여기서 개별 애플리케이션을 연결, 연결 해제 또는 재연결할 수 있으며 이 페이지는 궁극적으로 앱 간 인사이트 및 작업을 생성하는 데 사용됩니다. 대부분의 경우 로그인하고 동의한 후에 이 페이지를 사용하여 연결된 애플리케이션을 관리하게 됩니다. 애플리케이션을 연결하려면 사용하는 애플리케이션 옆에 있는 **연결** 버튼을 선택합니다. ![\[List of applications to connect, including Smartsheet, Slack, and Google Workspace, all showing as not connected.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-06.png) 애플리케이션에 대한 로그인 보안 인증 정보를 제공하고 AppFabric이 데이터에 액세스할 수 있는 권한을 허용하여 인사이트를 생성하고 작업을 완료해야 합니다. ![\[Dialog box requesting permission for AWS AppFabric to access Slack workspace data.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-07.png) 애플리케이션을 성공적으로 연결하면 해당 애플리케이션의 상태가 “연결되지 않음”에서 “연결됨”으로 변경됩니다. 알림: 인사이트와 작업을 생성하는 데 사용하려는 모든 애플리케이션에 대해 이 인증 단계를 완료해야 합니다. 애플리케이션 연결은 영구적이지 않습니다. 애플리케이션을 주기적으로 다시 연결해야 합니다. 이렇게 하는 이유는 인사이트를 생성할 수 있는 허가를 계속 받을 수 있도록 하기 위함입니다. 가능한 상태는 다음과 같습니다. + 연결됨 - AppFabric에 권한이 부여되었으며 이 애플리케이션의 데이터를 사용하여 인사이트를 생성하고 있습니다. + 연결되지 않음 - AppFabric이 이 애플리케이션의 데이터를 사용하여 인사이트를 생성하고 있지 않습니다. 연결하여 인사이트 생성을 시작할 수 있습니다. + 인증에 실패했습니다. 다시 연결해 주세요. - 특정 애플리케이션에서 인증 실패가 있을 수 있습니다. 이 오류를 확인하려면 **연결**을 사용하여 애플리케이션 재연결을 시도합니다. ![\[Application connection status interface showing connected and unconnected apps.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-08.png) 설정을 완료했으며 애플리케이션으로 돌아갈 수 있습니다. 애플리케이션에서 인사이트 확인을 시작하는 데 최소 몇 시간이 걸릴 수 있습니다. 필요한 경우 이 페이지로 이동하여 연결된 애플리케이션을 관리할 수 있습니다. 애플리케이션 **연결 해제**를 선택하면 AppFabric은 새로운 인사이트를 생성하기 위해 해당 애플리케이션의 데이터 사용 또는 새 데이터 수집을 중단합니다. 해당 기간 내에 애플리케이션을 다시 연결하지 않도록 선택하면 연결이 끊긴 애플리케이션의 데이터는 7일 이내에 자동으로 삭제됩니다. ## 4단계. 인사이트를 확인 시작 및 애플리케이션에서 앱 간 작업 실행 애플리케이션을 AppFabric과 연결한 후 중요한 인사이트에 액세스하고 선호하는 애플리케이션에서 직접 앱 간 작업을 수행할 수 있습니다. 참고: 각 앱에서 이 기능이 보장되는 것은 아니며, 애플리케이션 개발자가 어떤 생산성을 위한 AppFabric 기능을 활성화하기로 선택했는지에 따라 전적으로 달라집니다. **앱 간 인사이트** 생산성을 위한 AppFabric은 다음과 같은 두 가지 유형의 인사이트를 제공합니다. + 실행 가능한 인사이트: AppFabric은 연결된 앱 전반의 이메일, 캘린더 이벤트, 작업 및 메시지의 정보를 분석하고 우선순위를 정하는 데 중요할 수 있는 주요 인사이트를 생성합니다. 또한 AppFabric은 선호하는 애플리케이션 내에서 편집 및 실행할 수 있는 권장 작업(예: 이메일 전송, 회의 예약, 작업 생성)을 생성할 수 있습니다. 예를 들어, 처리해야 할 고객 에스컬레이션이 있다는 인사이트와 고객과의 회의 일정을 잡기 위한 다음 작업을 제안 받을 수 있습니다. + 회의 준비 인사이트: 이 기능을 사용하면 예정된 회의를 가장 잘 준비할 수 있습니다. AppFabric은 예정된 회의를 분석하고 회의 목적에 대한 간략한 요약을 생성합니다. 또한 콘텐츠를 찾기 위해 앱을 전환하지 않고도 회의를 효율적으로 준비하는 데 도움이 되는 연결된 애플리케이션에서 관련 아티팩트(예: 이메일, 메시지, 작업)를 표시합니다. **앱 간 작업** 특정 인사이트를 위해 AppFabric은 이메일 전송, 회의 예약, 작업 생성과 같은 권장 작업을 생성할 수도 있습니다. 작업을 생성할 때 AppFabric은 연결된 애플리케이션의 콘텐츠 및 컨텍스트를 기반으로 특정 필드를 미리 채울 수 있습니다. 예를 들어 AppFabric은 인사이트를 기반으로 제안된 이메일 응답 또는 작업 이름을 생성할 수 있습니다. 제안된 작업을 클릭하면 작업을 실행하기 전에 미리 채워진 콘텐츠를 편집할 수 있는 AppFabric 소유의 사용자 인터페이스로 이동합니다. 생성형 AI와 기본 대규모 언어 모델(LLM)이 때때로 착각할 수 있으므로 AppFabric은 사용자가 먼저 검토하고 입력하지 않으면 작업을 실행하지 않습니다. **참고** AppFabric LLM 출력을 검증하고 확인할 책임은 귀하에게 있습니다. AppFabric은 LLM 출력의 정확성이나 품질을 보장하지 않습니다. 자세한 내용은 [AWS 책임감 있는 AI 정책](https://aws.amazon.com/machine-learning/responsible-ai/policy/)을 참조하세요. ### 이메일(Google Workspace, Microsoft 365) 생성 AppFabric을 사용하면 원하는 애플리케이션 내에서 이메일을 편집하고 전송할 수 있습니다. 보낸 사람, 받는 사람, 참조/숨은 참조, 이메일 제목줄 및 이메일 본문 메시지를 포함한 기본 전자 메일 필드를 지원합니다. AppFabric은 이러한 필드에 콘텐츠를 생성하여 작업 완료 시간을 단축할 수 있습니다. 이메일 편집을 완료한 후 **전송**을 선택하여 이메일을 보냅니다. 이메일을 보내려면 다음 필드가 필요합니다. + 수신자 이메일(받는 사람, 참조, 숨은 참조) 중 하나 이상이 필요하며 유효한 이메일 주소여야 합니다. + 제목줄 및 메시지 필드입니다. ![\[Email form with From, To, CC, BCC, Subject line, and Message fields for sending.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-12.png) 이메일이 전송된 후 이메일이 전송되었다는 확인 메시지가 표시됩니다. 또한 지정된 애플리케이션에서 이메일을 볼 수 있는 링크가 표시됩니다. 이 링크를 사용하여 애플리케이션으로 빠르게 이동하여 이메일이 전송되었는지 확인할 수 있습니다. ![\[Email sent confirmation with recipient details and message preview.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-13.png) ### 캘린더 이벤트(Google Workspace, Microsoft 365) 생성 AppFabric을 사용하면 원하는 애플리케이션 내에서 캘린더 이벤트를 편집하고 생성할 수 있습니다. 이벤트 제목, 위치, 시작 시간, 종료 시간, 시작 날짜, 종료 날짜, 초대받는 사람 목록, 이벤트 세부 정보를 포함한 기본 캘린더 이벤트 필드를 지원합니다. AppFabric은 이러한 필드에 콘텐츠를 생성하여 작업 완료 시간을 단축할 수 있습니다. 캘린더 이벤트 편집을 완료한 후 **생성**을 선택하여 이벤트를 생성합니다. 캘린더 이벤트를 만들려면 다음 필드가 필요합니다. + 제목, 시작, 종료 및 설명 필드입니다. + 시작 시간 및 날짜는 종료 시간 및 날짜보다 이전이 아니어야 합니다. + 초대 필드는 선택 사항이지만 제공된 경우 유효한 이메일 주소가 필요합니다. ![\[Calendar event creation form with title, time, location, invitees, and description fields.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-14.png) 캘린더 이벤트가 전송된 후 이벤트가 생성되었다는 확인 메시지가 표시됩니다. 또한 지정된 애플리케이션에서 이벤트를 볼 수 있는 링크가 표시됩니다. 이 링크를 사용하여 애플리케이션으로 빠르게 이동하여 이벤트가 생성되었는지 확인할 수 있습니다. ![\[Calendar event creation confirmation with event details and option to view in Google Calendar.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-15.png) ### 작업(Asana) 생성 AppFabric을 사용하면 원하는 애플리케이션 내에서 Asana의 작업을 편집하고 생성할 수 있습니다. 작업 이름, 작업 소유자, 기한, 작업 설명과 같은 기본 작업 필드를 지원합니다. AppFabric은 이러한 필드에 콘텐츠를 생성하여 작업 생성 시간을 단축할 수 있습니다. 작업 편집을 완료한 후 **생성**을 선택하여 작업을 생성합니다. 작업은 LLM에서 제안한 대로 해당 Asana 워크스페이스나 프로젝트 또는 작업에 생성됩니다. Asana 작업을 생성하려면 다음 필드가 필요합니다. + 제목 및 설명 필드입니다. + 담당자는 유효한 이메일 주소로 수정해야 합니다. ![\[Create Task form with fields for title, assignee, due date, and description for a finance meeting task.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-16.png) 작업이 생성되고 나면 작업이 Asana에서 생성되었다는 확인 메시지가 표시됩니다. 또한 Asana의 작업을 볼 수 있는 링크도 표시됩니다. 이 링크를 사용하면 애플리케이션으로 빠르게 이동하여 작업이 생성되었는지 확인하거나 적절한 Asana 작업 공간이나 프로젝트 또는 작업으로 이동할 수 있습니다. ![\[Task creation confirmation with details and a link to view in Asana.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-17.png) ### 작업(Smartsheet) 생성 AppFabric을 사용하면 원하는 애플리케이션 내에서 Smartsheet의 작업을 편집하고 생성할 수 있습니다. 작업 이름, 작업 소유자, 기한, 작업 설명과 같은 기본 작업 필드를 지원합니다. AppFabric은 이러한 필드에 콘텐츠를 생성하여 작업 생성 시간을 단축할 수 있습니다. 작업 편집을 완료한 후 **생성**을 선택하여 작업을 생성합니다. Smartsheet 작업의 경우 AppFabric은 새 비공개 Smartsheet 시트를 생성하고 생성된 모든 작업을 채웁니다. 이는 AppFabric에서 생성한 작업을 구조화된 방식으로 한 곳에서 중앙 집중화하는 데 도움이 됩니다. Smartsheet 작업을 생성하려면 다음 필드가 필요합니다. + 제목 및 설명 필드입니다. + 담당자는 유효한 이메일 주소를 제공해야 합니다. ![\[Create Task form with fields for title, assignees, due date, and description for an AWS AppFabric Action.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-18.png) 작업이 생성되고 나면 작업이 Smartsheet에서 생성되었다는 확인 메시지가 표시됩니다. 또한 Smartsheet의 작업을 볼 수 있는 링크도 표시됩니다. 이 링크를 사용하면 애플리케이션으로 빠르게 이동하여 생성된 Smartsheet 시트에서 작업을 볼 수 있습니다. 향후의 모든 Smartsheet 작업이 이 시트에 입력됩니다. 시트가 삭제되면 AppFabric은 새 시트를 생성합니다. ![\[AWS AppFabric Action interface showing a successfully created task with details.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-19.png) # IT 및 보안 관리자를 위한 생산성을 위한 AppFabric(미리 보기) 기능에 대한 액세스 관리 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 생산성을 위한 AppFabric 사용자 포털은 생산성을 위한 AppFabric(평가판) 기능과 통합한 모든 SaaS 애플리케이션의 사용자가 공개적으로 액세스할 수 있습니다. 조직 내에서 이러한 생성형 AI 기능에 대한 액세스를 관리하려는 IT 관리자라면 다음 옵션을 고려해 보세요. + ID 제공업체(IdP) 로그인 제한: ID 제공업체를 통한 로그인 액세스를 차단하여 생성형 AI 기능에 대한 사용자 액세스를 제어할 수 있습니다. + 특정 애플리케이션에 대한 OAuth 비활성화: OAuth를 비활성화하여 다운스트림 제한을 구현합니다. 이렇게 하면 사용자가 OAuth 인증이 필요한 애플리케이션을 회사의 작업 영역에 연결할 수 없습니다. # 생산성을 위한 AppFabric의 최종 사용자 오류 문제 해결 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 이 섹션에서는 생산성을 위한 AppFabric의 일반적인 오류와 문제 해결에 대해 설명합니다. ## 확인되지 않은 애플리케이션 생산성을 위한 AppFabric을 사용하여 앱 경험을 강화하는 애플리케이션은 최종 사용자에게 기능을 출시하기 전에 확인 프로세스를 거칩니다. AppFabric에 로그인하려고 할 때 “확인되지 않음” 배너가 표시되는 경우 이는 애플리케이션이 앱 개발자의 ID 및 애플리케이션 등록 정보의 정확성을 확인하는 AppFabric의 확인 프로세스를 거치지 않았음을 의미합니다. 모든 애플리케이션은 확인되지 않은 상태로 시작하다가 확인 프로세스가 완료되어야만 확인된 것으로 변경됩니다. 확인되지 않은 애플리케이션을 사용할 때는 주의해야 합니다. 앱 개발자가 확실하지 않은 경우 애플리케이션이 확인 상태가 될 때까지 기다렸다가 계속 진행해도 됩니다. ![\[Warning message for an unverified application in AWS AppFabric, advising caution before authorization.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-20.png) ## 문제가 발생했습니다. 다시 시도하거나 관리자에게 확인해 주세요(`InternalServerException`). 알 수 없는 오류, 예외 또는 실패로 인해 AppFabric 사용자 포털에서 애플리케이션을 나열하지 못하거나 애플리케이션 연결에 실패했을 때 이 메시지가 표시될 수 있습니다. 나중에 다시 시도해 주세요. ![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-23.png) ## 요청 스로틀링으로 인해 요청이 거부되었습니다. 잠시 후 다시 시도해 주세요(`ThrottlingException`). 제한 문제로 인해 AppFabric 사용자 포털에서 애플리케이션을 나열하지 못하거나 애플리케이션 연결에 실패했을 때 이 메시지가 표시될 수 있습니다. 나중에 다시 시도해 주세요. ![\[Connect applications interface showing connected and not connected apps with action buttons.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-22.png) ## AppFabric을 사용할 권한이 없습니다. AppFabric에 다시 로그인하세요(`AccessDeniedException`). 액세스 거부 예외로 인해 AppFabric 사용자 포털에서 애플리케이션을 나열하지 못하거나 애플리케이션 연결에 실패했을 때 이 메시지가 표시될 수 있습니다. AppFabric에 다시 로그인하세요. ![\[Connect applications interface showing connected and unconnected apps with action buttons.\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/images/fabric-21.png) # 생산성을 위한 AppFabric APIs(미리 보기) | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 이 섹션에서는 AWS AppFabric 생산성 기능에 대한 API 작업, 데이터 유형 및 일반적인 오류를 제공합니다. **참고** 다른 모든 AppFabric API에 대해서는 [AWS AppFabric API 참조](https://docs.aws.amazon.com/appfabric/latest/api/)를 참조하세요. **Topics** + [생산성을 위한 AppFabric API 작업(미리 보기)](productivity-actions.md) + [생산성을 위한 AppFabric의 API 데이터 형식(미리 보기)](productivity-data-types.md) + [생산성을 위한 AppFabric의 일반적인 API 오류(미리 보기)](productivity-common-errors.md) # 생산성을 위한 AppFabric API 작업(미리 보기) | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 생산성을 위한 AppFabric 기능에는 다음 작업이 지원됩니다. 다른 모든 AppFabric API 작업에 대해서는 [AWS AppFabric API 작업](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html)을 참조하세요. **Topics** + [인증](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) + [토큰](API_Token.md) + [UpdateAppClient](API_UpdateAppClient.md) # 인증 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient를 인증합니다. **Topics** + [요청 본문](#API_Authorize_request) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **app\$1client\$1id** | 인증할 AppClient의 ID입니다. | | **redirect\$1uri** | 인증 후 최종 사용자를 리디렉션할 URI입니다. | | **state** | 요청과 콜백 사이의 상태를 유지하기 위한 고유 값입니다. | # CreateAppClient | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient를 생성합니다. **Topics** + [요청 본문](#API_CreateAppClient_request) + [응답 요소](#API_CreateAppClient_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **appName** | 앱의 이름입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 255입니다. 필수 항목 여부: 예 | | **clientToken** | 요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자를 지정합니다. 이렇게 하면 실수로 같은 작업을 두 번 수행하지 않고 요청을 안전하게 재시도할 수 있습니다. 나중에 작업을 호출할 때 동일한 값을 전달하려면 다른 모든 파라미터에도 동일한 값을 전달해야 합니다. [UUID 유형의 값](https://wikipedia.org/wiki/Universally_unique_identifier)을 사용하는 것이 좋습니다. 이 값을 제공하지 않으면가 임의의 값을 AWS 생성합니다. 다른 파라미터를 사용하여 `ClientToken`과 같은 작업을 재시도하면 `IdempotentParameterMismatch` 오류가 발생하며 재시도가 실패합니다. 유형: String 패턴: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 아니요 | | **customerManagedKeyIdentifier** | 에서 고객 관리형 키 생성된의 ARN입니다 AWS Key Management Service. 키는 데이터 암호화에 사용합니다. 키가 지정되지 않은 경우 AWS 관리형 키 가 사용됩니다. 리소스에 할당할 태그의 키-값 페어 맵입니다. AWS 소유 키 및 고객 관리형 키에 대한 자세한 내용은 *AWS Key Management Service 개발자 안내서*의 [고객 키 및 AWS 키를](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) 참조하세요. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 항목 여부: 아니요 | | **description** | 앱에 대한 설명입니다. 유형: 문자열 필수 항목 여부: 예 | | **iconUrl** | AppClient의 아이콘 또는 로고 URL입니다. 유형: 문자열 필수 항목 여부: 아니요 | | **redirectUrls** | 인증 후 최종 사용자를 리디렉션할 URI입니다. redirectUrl을 최대 5개 추가할 수 있습니다. 예를 들어 `https://localhost:8080`입니다. 타입: 문자열 배열 배열 구성원: 최소수는 1개입니다. 최대 항목 수는 5개. 길이 제약: 최소 길이 1. 최대 길이는 2,048. 패턴: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` 필수 여부: 예 | | **starterUserEmails** | AppClient가 확인될 때까지 인사이트를 받을 수 있도록 액세스가 허용된 사용자의 스타터 이메일 주소입니다. 유형: 문자열 배열 배열 멤버: 고정된 항목 수는 1개입니다. 길이 제한: 최소 길이는 0. 최대 길이는 320입니다. 패턴: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` 필수 여부: 예 | | **tags** | 리소스에 할당할 태그의 키-값 페어 맵입니다. 유형: 태그 객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 | ## 응답 요소 작업이 성공하면 서비스가 HTTP 201 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appClientSummary** | AppClient의 요약을 포함합니다. 유형: [AppClientSummary](API_AppClientSummary.md) 객체 | # DeleteAppClient | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 애플리케이션 클라이언트를 삭제합니다. **Topics** + [요청 본문](#API_DeleteAppClient_request) + [응답 요소](#API_DeleteAppClient_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **appClientIdentifier** | 요청에 사용할 AppClient의 Amazon 리소스 이름(ARN) 또는 범용 고유 식별자(UUID)입니다. 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 예 | ## 응답 요소 액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다. # GetAppClient | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient에 대한 정보를 반환합니다. **Topics** + [요청 본문](#API_GetAppClient_request) + [응답 요소](#API_GetAppClient_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **appClientIdentifier** | 요청에 사용할 AppClient의 Amazon 리소스 이름(ARN) 또는 범용 고유 식별자(UUID)입니다. 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 예 | ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appClient** | AppClient에 대한 정보가 들어 있습니다. 유형: [AppClient](API_AppClient.md) 객체 | # ListActionableInsights | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 가장 중요한 실행 가능 이메일 메시지, 작업 및 기타 업데이트를 나열합니다. **Topics** + [요청 본문](#API_ListActionableInsights_request) + [응답 요소](#API_ListActionableInsights_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. | ## 응답 요소 작업이 성공하면 서비스가 HTTP 201 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **ActionableInsightsList** | 제목, 설명, 작업, 생성된 타임스탬프 등 실행 가능한 인사이트를 나열합니다. 자세한 내용은 [ActionableInsights](API_ActionableInsights.md) 단원을 참조하십시오. | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. 유형: 문자열 | # ListAppClients | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 모든 AppClient의 목록을 반환합니다. **Topics** + [요청 본문](#API_ListAppClients_request) + [응답 요소](#API_ListAppClients_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **maxResults** | 호출 한 개당 반환되는 결과의 최대 수입니다. `nextToken`을 사용하여 추가 결과 페이지를 얻을 수 있습니다. 이는 상한선일 뿐입니다. 호출당 반환되는 실제 결과 수는 지정된 최대값보다 적을 수 있습니다. 유효 범위: 최소값 1. 최댓값은 100입니다. | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. | ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appClientList** | AppClient 결과 목록을 포함합니다. 유형: [AppClientSummary](API_AppClientSummary.md) 객체의 배열 | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. 유형: 문자열 | # ListMeetingInsights | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 가장 중요한 실행 가능 캘린더 이벤트를 나열합니다. **Topics** + [요청 본문](#API_ListMeetingInsights_request) + [응답 요소](#API_ListMeetingInsights_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. | ## 응답 요소 작업이 성공하면 서비스가 HTTP 201 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **MeetingInsightList** | 실행 가능한 회의 인사이트를 나열합니다. 자세한 내용은 [MeetingInsights](API_MeetingInsights.md) 단원을 참조하십시오. | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. 유형: 문자열 | # PutFeedback | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 사용자가 주어진 인사이트나 작업에 대한 피드백을 제출할 수 있습니다. **Topics** + [요청 본문](#API_PutFeedback_request) + [응답 요소](#API_PutFeedback_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **id** | 피드백을 제출받는 객체의 ID입니다. 이는 InsightId 또는 ActionId일 수 있습니다. | | **feedbackFor** | 피드백을 받는 인사이트 유형입니다. 가능한 값: `ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION` | | **feedbackRating** | 피드백 평점: `1`\$1`5` 평점이 높을수록 좋습니다. | ## 응답 요소 작업이 성공하면 서비스가 비어있는 HTTP 본문과 함께 HTTP 201 응답을 다시 전송합니다. # 토큰 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient가 인증 코드를 액세스 토큰으로 교환할 수 있도록 허용하는 정보를 포함합니다. **Topics** + [요청 본문](#API_Token_request) + [응답 요소](#API_Token_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **code** | 인증 엔드포인트에서 받은 인증 코드입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 | | **grant\$1type** | 토큰의 권한 부여 유형입니다. `authorization_code` 또는 `refresh_token`여야 합니다. 유형: 문자열 필수 항목 여부: 예 | | **app\$1client\$1id** | AppClient의 ID입니다. 유형: String 패턴: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 예 | | **redirect\$1uri** | 권한 부여 엔드포인트에 전달된 리디렉션 URI입니다. 유형: 문자열 필수 항목 여부: 아니요 | | **refresh\$1token** | 초기 토큰 요청에서 받은 새로 고침 토큰입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 4096. 필수 여부: 아니요 | ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appfabric\$1user\$1id** | 토큰 사용자의 ID입니다. `authorization_code` 권한 부여 유형을 사용하는 요청의 경우에만 반환됩니다. 유형: 문자열 | | **expires\$1in** | 토큰큰이 만료될 때까지의 시간(초)입니다. 타입: Long | | **refresh\$1token** | 후속 요청에 사용할 새로 고침 토큰입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. | | **token** | 액세스 토큰 입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. | | **token\$1type** | 토큰 유형입니다. 유형: 문자열 | # UpdateAppClient | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient를 업데이트합니다. **Topics** + [요청 본문](#API_UpdateAppClient_request) + [응답 요소](#API_UpdateAppClient_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **appClientIdentifier** | 요청에 사용할 AppClient의 Amazon 리소스 이름(ARN) 또는 범용 고유 식별자(UUID)입니다. 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 예 | | **redirectUrls** | 인증 후 최종 사용자를 리디렉션할 URI입니다. redirectUrl을 최대 5개 추가할 수 있습니다. 예를 들어 `https://localhost:8080`입니다. 타입: 문자열 배열 배열 구성원: 최소수는 1개입니다. 최대 항목 수는 5개. 길이 제약: 최소 길이 1. 최대 길이는 2,048. 패턴: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` | ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appClient** | AppClient에 대한 정보가 들어 있습니다. 유형: [AppClient](API_AppClient.md) 객체 | # 생산성을 위한 AppFabric의 API 데이터 형식(미리 보기) | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppFabric API에는 다양한 작업에 사용되는 여러 데이터 유형이 포함되어 있습니다. 이 섹션에서는 생산성을 위한 AppFabric 기능의 데이터 유형에 대해 자세히 설명합니다. 다른 모든 AppFabric API 데이터 유형에 대해서는 [AWS AppFabric API 데이터 유형](https://docs.aws.amazon.com/appfabric/latest/api/API_Types.html)을 참조하세요. **중요** 데이터 유형 구조에서 각 요소의 순서는 보장되지 않습니다. 애플리케이션은 특정 순서를 가정해서는 안 됩니다. **Topics** + [ActionableInsights](API_ActionableInsights.md) + [AppClient](API_AppClient.md) + [AppClientSummary](API_AppClientSummary.md) + [MeetingInsights](API_MeetingInsights.md) + [VerificationDetails](API_VerificationDetails.md) # ActionableInsights | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 앱 포트폴리오의 이메일, 캘린더 초대, 메시지 및 작업을 기반으로 사용자에게 필요하고 중요하며 적합한 작업을 요약하여 제공합니다. 사용자는 애플리케이션 전반에서 하루의 방향을 가장 잘 잡을 수 있도록 돕는 사전 예방형 인사이트를 확인할 수 있습니다. 이 인사이트는 사용자가 인사이트를 생성한 개별 앱 및 아티팩트에 대한 참조(예: 포함된 링크)와 함께 인사이트 요약에 관심을 가져야 하는 이유에 대한 근거가 됩니다. | 파라미터 | 설명 | | --- | --- | | **insightId** | 생성된 인사이트의 고유 ID입니다. | | **insightContent** | 이렇게 하면 인사이트 요약과 인사이트 생성에 사용된 아티팩트에 대한 포함된 링크가 반환됩니다. 이는 포함된 링크(`` 태그)가 포함된 HTML 콘텐츠입니다. | | **insightTitle** | 생성된 인사이트의 제목입니다. | | **createdAt** | 인사이트가 생성된 시점입니다. | | **actions** | 생성된 인사이트에 대한 권장 작업 목록입니다. 작업 객체는 다음 파라미터를 포함합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/API_ActionableInsights.html) | # AppClient | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient에 대한 정보가 들어 있습니다. **Topics** | 파라미터 | 설명 | | --- | --- | | **appName** | 애플리케이션의 이름입니다. 유형: 문자열 필수 항목 여부: 예 | | **arn** | AppClient의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+` 필수 여부: 예 | | **description** | 애플리케이션에 대한 설명입니다. 유형: 문자열 필수 항목 여부: 예 | | **iconUrl** | AppClient의 아이콘 또는 로고 URL입니다. 유형: 문자열 필수 항목 여부: 아니요 | | **redirectUrls** | AppClient에 허용된 리디렉션 URL입니다. 타입: 문자열 배열 배열 구성원: 최소수는 1개입니다. 최대 항목 수는 5개. 길이 제약: 최소 길이 1. 최대 길이는 2,048. 패턴: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` 필수 여부: 예 | | **starterUserEmails** | AppClient가 확인될 때까지 인사이트를 받을 수 있도록 액세스가 허용된 사용자의 스타터 이메일 주소입니다. 유형: 문자열 배열 배열 멤버: 고정된 항목 수는 1개입니다. 길이 제한: 최소 길이는 0. 최대 길이는 320입니다. 패턴: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` 필수 여부: 예 | | **verificationDetails** | AppClient 확인의 상태 및 이유를 포함합니다. 유형: [VerificationDetails](API_VerificationDetails.md) 객체 필수 항목 여부: 예 | | **customerManagedKeyArn** | AppClient에 고객 관리형 키 AWS Key Management Service 대해에서 생성된의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+` 필수 여부: 아니요 | | **appClientId** | AppClient의 ID입니다. 앱 클라이언트의 인증 흐름에 사용됩니다. 유형: String 패턴: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 아니요 | # AppClientSummary | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient에 대한 정보가 들어 있습니다. **Topics** | 파라미터 | 설명 | | --- | --- | | **arn** | AppClient의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+` 필수 여부: 예 | | **verificationStatus** | AppClient 확인 상태입니다. 타입: 문자열 유효 값: `pending_verification \| verified \| rejected` 필수 사항 여부: 예 | | **appClientId** | AppClient의 ID입니다. 앱 클라이언트의 인증 흐름에 사용됩니다. 유형: String 패턴: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 아니요 | # MeetingInsights | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 회의 목적, 관련 앱 간 아티팩트, 작업 활동, 이메일에서의 활동, 메시지에서의 활동, 캘린더 이벤트에서의 활동과 함께 상위 3개 미팅에 대한 요약이 포함되어 있습니다. | 파라미터 | 설명 | | --- | --- | | **insightId** | 생성된 인사이트의 고유 ID입니다. | | **insightContent** | 세부 정보를 문자열 형식으로 강조 표시하는 인사이트에 대한 설명입니다. 즉, 이 인사이트가 왜 중요한지에 대한 것입니다. | | **insightTitle** | 생성된 인사이트의 제목입니다. | | **createdAt** | 인사이트가 생성된 시점입니다. | | **calendarEvent** | 사용자가 집중해야 하는 중요한 캘린더 이벤트 또는 회의입니다. 캘린더 이벤트 객체: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/API_MeetingInsights.html) | | **resources** | 인사이트 생성과 관련된 다른 리소스가 포함된 목록입니다. 리소스 객체: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/API_MeetingInsights.html) | | **nextToken** | 다음 인사이트 세트를 가져오기 위한 페이지 매김 토큰입니다. 이 필드는 선택 사항 필드이며, null을 반환하면 로드할 인사이트가 더 이상 없음을 의미합니다. | # VerificationDetails | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient 확인의 상태 및 이유를 포함합니다. **Topics** | 파라미터 | 설명 | | --- | --- | | **verificationStatus** | AppClient 확인 상태입니다. 타입: 문자열 유효 값: `pending_verification \| verified \| rejected` 필수 사항 여부: 예 | | **statusReason** | AppClient 확인 상태 이유입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 1024. 필수 여부: 아니요 | # 생산성을 위한 AppFabric의 일반적인 API 오류(미리 보기) | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 이 섹션에서는 AWS AppFabric 생산성 기능의 API 작업에 공통적인 오류를 나열합니다. 다른 모든 AppFabric 일반 API 오류에 대해서는 [생산성을 위한 AppFabric AppClients 문제 해결](ahead-app-dev-errors.md) 및AWS AppFabric API 참조의 [AWS AppFabric API 일반 오류](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html)를 참조하세요. | 예외 이름 | 설명 | | --- | --- | | **TokenException** | 토큰 요청이 유효하지 않습니다. HTTP 상태 코드: 400 | # AppFabric의 데이터 처리 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppFabric은 사용자 콘텐츠를 AppFabric에서 관리하는 Amazon S3 버킷에 개별적으로 저장하는 단계를 거치며, 이를 통해 사용자별 인사이트를 확보할 수 있습니다. 저장 데이터 암호화 및 전송 중 암호화 등 합리적인 보호 장치를 사용하여 콘텐츠를 보호합니다. 고객 콘텐츠를 수집 후 30일 이내에 자동으로 삭제되도록 시스템을 구성했습니다. AppFabric은 사용자가 더 이상 액세스할 수 없는 데이터 아티팩트를 사용하여 인사이트를 생성하지 않습니다. 예를 들어 사용자가 데이터 소스(앱)의 연결을 끊으면 AppFabric은 해당 앱에서 데이터 수집을 중단하고 인사이트 생성에 연결이 끊긴 앱에서 남아 있는 아티팩트를 사용하지 않습니다. AppFabric의 시스템은 30일 이내에 이러한 데이터를 삭제하도록 구성되어 있습니다. AppFabric은 인사이트를 생성하는 데 사용하는 기본 대규모 언어 모델을 교육하거나 개선하는 데 사용자 콘텐츠를 사용하지 않습니다. AppFabric의 생성형 AI 기능에 대한 자세한 내용은 [Amazon Bedrock FAQ](https://aws.amazon.com/bedrock/faqs/)를 참조하세요. ## 저장 시 암호화 AWS AppFabric은 AppFabric이 디스크에 보관될 때 사용자와 관련된 모든 데이터를 투명하게 암호화하고 데이터에 액세스할 때 복호화하는 서버 측 암호화 기능인 저장 데이터 암호화를 지원합니다. ## 전송 중 암호화 AppFabric은 TLS 1.2를 사용하여 전송 중인 모든 콘텐츠를 보호하고 AWS 서명 버전 4가 있는 AWS 서비스에 대한 API 요청에 서명합니다.