기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Quip
**참고**
Quip 커넥터는 2026년 5월 31일까지 기존 고객에게 완전히 지원됩니다. 이 커넥터는 더 이상 신규 사용자에게는 지원되지 않지만 기존 사용자는 중단 없이 계속 사용할 수 있습니다. 더 확장 가능하고 사용자 지정 가능한 솔루션을 제공하기 위해 커넥터 포트폴리오를 지속적으로 발전시키고 있습니다. 향후 통합을 위해 유연성이 향상된 광범위한 엔터프라이즈 사용 사례를 지원하도록 설계된 Amazon Kendra 사용자 지정 커넥터 프레임워크[1]를 살펴보는 것이 좋습니다.
Quip은 실시간 문서 작성 기능을 제공하는 협업 생산성 소프트웨어입니다. Amazon Kendra를 사용하여 Quip 폴더, 파일, 파일 설명, 채팅룸 및 첨부 파일을 인덱싱할 수 있습니다.
[Amazon Kendra콘솔](https://console.aws.amazon.com/kendra/) 및 [QuipConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html) API를 사용하여 Quip 데이터 소스에 연결할 수 Amazon Kendra있습니다.
Amazon KendraQuip 데이터 소스 커넥터의 문제 해결은 섹션을 참조하세요[데이터 소스 문제 해결](troubleshooting-data-sources.md).
**Topics**
+ [
## 지원되는 기능
](#supported-features-quip)
+ [
## 사전 조건
](#prerequisites-quip)
+ [
## 연결 지침
](#data-source-procedure-quip)
+ [
## 자세히 알아보기
](#quip-learn-more)
## 지원되는 기능
Amazon KendraQuip 데이터 소스 커넥터는 다음 기능을 지원합니다.
+ 필드 매핑
+ 사용자 액세스 제어
+ 포함/제외 필터
+ Virtual Private Cloud(VPC)
## 사전 조건
Amazon Kendra를 사용하여 Quip 데이터 소스를 인덱싱하려면 먼저 Quip 및 AWS계정에서 이러한 변경을 수행합니다.
**Quip에서 다음 사항을 갖추었는지 확인하세요.**
+ 관리자 권한이 있는 Quip 계정.
+ 개인용 액세스 토큰이 포함된 Quip 보안 인증을 생성했습니다. 토큰은 AWS Secrets Manager보안 암호에 저장된 인증 자격 증명으로 사용됩니다. 자세한 내용은 [인증에 대한 Quip 설명서](https://quip.com/dev/admin/documentation/current#section/Authentication)를 참조하세요.
**참고**
보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 **않는** 것이 좋습니다.
+ Quip 사이트 도메인을 복사했습니다. 예를 들어 *https://quip-company.quipdomain.com/browse*, 여기서 *quipdomain*은 도메인입니다.
+ Quip 및 동일한 인덱스에 사용할 다른 여러 데이터 소스에서 각 문서가 고유한지 확인했습니다. 인덱스에 사용하려는 각 데이터 소스에는 데이터 소스 전체에서 동일한 문서가 포함되어서는 안 됩니다. 문서 ID는 인덱스 전체에 적용되며 인덱스별로 고유해야 합니다.
**에 다음이 있는지 AWS 계정확인합니다.**
+ [Amazon Kendra인덱스를 생성하고](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) API를 사용하는 경우 인덱스 ID를 기록했습니다.
+ 데이터 소스에 대한 [IAM역할을 생성하고](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) API를 사용하는 경우 IAM역할의 ARN을 기록했습니다.
**참고**
인증 유형과 자격 증명을 변경하는 경우 올바른 AWS Secrets Manager보안 암호 ID에 액세스하도록 IAM역할을 업데이트해야 합니다.
+ Quip 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장했고 API를 사용하는 경우 보안 암호의 ARN을 기록했습니다.
**참고**
보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 **않는** 것이 좋습니다.
기존 IAM역할이나 보안 암호가 없는 경우 Quip 데이터 소스를 연결할 때 콘솔을 사용하여 새 IAM역할 및 Secrets Manager보안 암호를 생성할 수 있습니다Amazon Kendra. API를 사용하는 경우 기존 IAM역할 및 Secrets Manager보안 암호의 ARN과 인덱스 ID를 제공해야 합니다.
## 연결 지침
Quip 데이터 소스Amazon Kendra에 연결하려면가 데이터에 액세스할 Amazon Kendra수 있도록 Quip 데이터 소스에 필요한 세부 정보를 제공해야 합니다. Quip for를 아직 구성하지 않은 경우 Amazon Kendra섹션을 참조하세요[사전 조건](#prerequisites-quip).
------
#### [ Console ]
**QuipAmazon Kendra에 연결하려면**
1. 에 로그인AWS Management Console하고 [Amazon Kendra콘솔](https://console.aws.amazon.com/kendra/)을 엽니다.
1. 왼쪽 탐색 창에서 **인덱스**를 선택한 다음 인덱스 목록에서 사용할 인덱스를 선택합니다.
**참고**
**인덱스 설정**에서 **사용자 액세스 제어** 설정을 구성하거나 편집할 수 있습니다.
1. **시작하기** 페이지에서 **데이터 소스 추가**를 선택합니다.
1. **데이터 소스 추가** 페이지에서 **Quip 커넥터**를 선택한 다음 **커넥터 추가**를 선택합니다. 버전 2(해당하는 경우)를 사용하는 경우 'V2.0' 태그가 있는 **Quip 커넥터**를 선택합니다.
1. **데이터 소스 세부 정보 지정** 페이지에서 다음 정보를 입력합니다.
1. **이름 및 설명**에서 **데이터 소스 이름**에 데이터 소스의 이름을 입력합니다. 하이픈은 포함할 수 있지만 공백은 포함할 수 없습니다.
1. (선택 사항) **설명** - 데이터 소스에 대한 선택적 설명을 입력합니다.
1. **기본 언어** - 인덱스에 사용할 문서를 필터링할 언어를 선택합니다. 달리 지정하지 않는 한, 언어는 영어로 기본 설정됩니다. 문서 메타데이터에 지정된 언어가 선택한 언어보다 우선합니다.
1. **태그**에서 **새 태그 추가** - 리소스를 검색 및 필터링하거나 AWS비용을 추적하는 선택적 태그를 포함합니다.
1. **다음**을 선택합니다.
1. **액세스 및 보안 정의** 페이지에서 다음 정보를 입력합니다.
1. **Quip 도메인 이름** - Quip 계정에서 복사한 Quip을 입력합니다.
1. **AWS Secrets Manager보안** 암호 - 기존 보안 암호를 선택하거나 Quip 인증 자격 증명을 저장할 새 Secrets Manager보안 암호를 생성합니다. 새 암호를 만들기로 선택하면 AWS Secrets Manager 보안 암호 창이 열립니다.
1. **AWS Secrets Manager 보안 암호 생성 창**에 다음 정보를 입력합니다.
1. **보안 암호 이름** - 보안 암호의 이름. 'AmazonKendra-Quip-'라는 접두사가 보안 암호 이름에 자동으로 추가됩니다.
1. **Quip 토큰** - Quip 개인 액세스 구성 Quip을 입력합니다.
1. 보안 암호를 추가하고 저장합니다.
1. **Virtual Private Cloud(VPC)** - VPC를 사용하기로 선택할 수 있습니다. 그렇다면 **서브넷**과 **VPC 보안 그룹**을 추가해야 합니다.
1. **IAM역할** - 기존IAM 역할을 선택하거나 새 IAM역할을 생성하여 리포지토리 자격 증명 및 인덱스 콘텐츠에 액세스합니다.
**참고**
IAM인덱스에 사용되는 역할은 데이터 소스에 사용할 수 없습니다. 기존 역할을 인덱스나 FAQ에 사용하는지 확실하지 않은 경우 **새 역할 생성**을 선택하여 오류를 방지하세요.
1. **다음**을 선택합니다.
1. **동기화 설정 구성** 페이지에 다음 정보를 입력합니다.
1. **크롤링할 Quip 폴더 ID 추가** - 크롤링하려는 Quip 폴더 ID.
**참고**
모든 하위 폴더와 그 안에 있는 문서를 포함하여 루트 폴더를 크롤링하려면 루트 폴더 ID를 추가합니다. 특정 하위 폴더를 크롤링하려면 특정 하위 폴더 ID를 추가합니다.
1. **추가 구성 (콘텐츠 유형)** - 크롤링하려는 콘텐츠 유형을 입력합니다.
1. **정규식 패턴** - 특정 페이지 및 자산을 포함하거나 제외하기 위한 정규 표현식 패턴입니다. 최대 100개의 패턴을 추가할 수 있습니다.
1. **동기화 실행 일정**의 **빈도** - 데이터 소스 콘텐츠를 동기화하고 인덱스를 업데이트할 빈도를 선택합니다.
1. **다음**을 선택합니다.
1. **필드 매핑 설정** 페이지에 다음 정보를 입력합니다.
1. Amazon Kendra인덱스에 매핑하려는 생성된 기본 데이터 소스 필드 중에서 선택합니다.
1. **필드 추가** - 사용자 지정 데이터 소스 필드를 추가하려면 매핑할 인덱스 필드 이름과 필드 데이터 유형을 만듭니다.
1. **다음**을 선택합니다.
1. **검토 및 생성** 페이지에서 입력한 정보가 정확한지 확인한 다음 **데이터 소스 추가**를 선택합니다. 이 페이지에서 정보를 편집하도록 선택할 수도 있습니다. 데이터 소스가 성공적으로 추가된 후 **데이터 소스** 페이지에 데이터 소스가 표시됩니다.
------
#### [ API ]
**QuipAmazon Kendra에 연결하려면**
[QuipConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html) API를 사용하여 다음을 지정해야 합니다.
+ **Quip 사이트 도메인** - 예: *https://quip-company.quipdomain.com/browse* 여기에서 *quipdomain*은 도메인입니다.
+ **보안 암호 Amazon 리소스 이름(ARN)** - Quip 계정의 인증 자격 증명이 포함된 Secrets Manager보안 암호의 Amazon 리소스 이름(ARN)을 제공합니다. 보안 암호는 다음 키가 있는 JSON 구조로 저장됩니다.
```
{
"accessToken": "token"
}
```
+ **IAM역할** -를 호출`CreateDataSource`하여 Secrets Manager보안 암호에 액세스하고 Quip 커넥터 및에 필요한 퍼블릭 APIs를 호출할 수 있는 권한을 IAM역할에 제공할 `RoleArn` 때를 지정합니다Amazon Kendra. 자세한 내용은 [Quip 데이터 소스에 대한 IAM 역할](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)을 참조하세요.
다음 선택적 기능도 추가할 수 있습니다.
+ **Virtual Private Cloud(VPC)** - 데이터 소스 구성의 일부로 `VpcConfiguration`를 지정합니다. [VPC 사용을 위한 Amazon Kendra 구성](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html)을 참조하세요.
+ **포함 및 제외 필터** - 특정 파일을 포함할지 또는 제외할지 여부를 지정합니다.
**참고**
대부분의 데이터 소스는 필터라고 하는 포함 또는 제외 패턴인 정규 표현식 패턴을 사용합니다. 포함 필터를 지정하는 경우 포함 필터와 일치하는 콘텐츠만 인덱싱됩니다. 포함 필터와 일치하지 않는 문서는 인덱싱되지 않습니다. 포함 및 제외 필터를 지정하는 경우 제외 필터와 일치하는 문서는 포함 필터와 일치하더라도 인덱싱되지 않습니다.
+ **폴더** - 인덱싱하려는 Quip 폴더 및 하위 폴더를 지정합니다.
**참고**
모든 하위 폴더와 그 안에 있는 문서를 포함하여 루트 폴더를 크롤링하려면 루트 폴더 ID를 입력합니다. 특정 하위 폴더를 크롤링하려면 특정 하위 폴더 ID를 추가합니다.
+ **첨부 파일, 채팅룸, 파일 설명** - 첨부 파일, 채팅룸 콘텐츠 및 파일 설명의 크롤링을 포함할지를 선택합니다.
+ **사용자 컨텍스트 필터링 및 액세스 제어** - Amazon Kendra는 문서에 대한 액세스 제어 목록(ACL)이 있는 경우 문서의 ACL을 크롤링합니다. ACL 정보는 검색 결과를 문서에 대한 사용자 또는 그룹의 액세스 권한을 기준으로 필터링하는 데 사용됩니다. 자세한 내용은 [사용자 컨텍스트 필터링](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter)을 참조하세요.
+ **필드 매핑** - Quip 데이터 소스 필드를 Amazon Kendra 인덱스 필드에 매핑하기로 선택합니다. 자세한 내용을 알아보려면 [데이터 소스 필드 매핑](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html)을 참조하세요.
**참고**
가 문서를 Amazon Kendra검색하려면 문서 본문 필드 또는 해당 문서에 해당하는 문서 본문이 필요합니다. 데이터 소스의 문서 본문 필드 이름을 인덱스 필드 이름 `_document_body`에 매핑해야 합니다. 다른 모든 필드는 선택 사항입니다.
------
## 자세히 알아보기
Quip 데이터 소스Amazon Kendra와 통합하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [용 Quip 커넥터를 사용하여 지능형 검색으로 Quip 문서에서 지식 검색Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/)