기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 상자 작업 통합
Box 작업 커넥터를 사용하면 Box AI 기능에 액세스하고, 파일 및 폴더를 관리하고, 자연어를 통해 Amazon Quick에서 직접 허브의 콘텐츠를 구성할 수 있습니다.
Amazon Quick은 Box Agent에 대해 다음과 같은 인증 방법을 지원합니다.
+ **기본 OAuth 앱** AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. Box 계정으로 직접 인증합니다.
+ **사용자 지정 OAuth 앱** - Box 개발자 콘솔에 등록된 고객 관리형 OAuth 2.0 애플리케이션을 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다.
Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요[인증 방법](quick-action-auth.md).
## 시작하기 전 준비 사항
통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
+ 파일 및 폴더에 액세스할 수 있는 Box 계정입니다.
+ **사용자 지정 OAuth 앱**의 경우: Box 개발자 콘솔에 액세스하여 사용자 지정 앱을 생성합니다. 자세한 내용은 Box 설명서의 [OAuth 2.0 설정을](https://developer.box.com/guides/authentication/oauth2/oauth2-setup) 참조하세요.
+ Amazon Quick 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md).
## Amazon Quick에서 커넥터 설정
### 사용 가능 탭에서 연결
기본 OAuth 앱 인증을 사용하려면 추가 구성 없이 **사용 가능** 탭에서 직접 연결할 수 있습니다.
1. Amazon Quick 콘솔에서 **커넥터를** 선택합니다.
1. **사용 가능** 탭에서 **Box Agent**를 찾아 **연결을** 선택합니다.
1. Box 로그인 흐름을 완료하고 요청된 권한을 부여합니다.
대신 사용자 지정 OAuth 앱으로 커넥터를 구성하려면 아래 설명과 같이 **팀에 대해 생성** 탭을 사용합니다.
### 팀에 대해 생성 탭에서 생성
사용자 지정 OAuth 앱 인증을 사용하는 경우 Amazon Quick을 구성하기 전에 Box 개발자 콘솔에서 사용자 지정 앱을 생성합니다. 설정 지침은 Box 설명서의 [OAuth 2.0 설정을](https://developer.box.com/guides/authentication/oauth2/oauth2-setup) 참조하세요.
1. Amazon Quick 콘솔에서 **커넥터를** 선택합니다.
1. **팀에 대해 생성** 탭을 선택합니다.
1. **Box Agent**를 찾아 선택합니다.
**참고**
Box Agent 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 해당 커넥터를 선택합니다. 새로 생성하려면 **아니요, 새로 생성을** 선택합니다.
1. 커넥터의 **이름을** 입력합니다. 선택적으로 **\+ 설명 추가**를 선택하여 설명을 추가합니다.
1. **연결 유형**에서 **퍼블릭 네트워크를** 선택합니다.
1. **OAuth 구성**에서 다음 중 하나를 선택합니다.
1. **기본 OAuth 앱**의 경우:
추가 자격 증명은 필요하지 않습니다. **다음**을 선택하여 계속 진행합니다.
1. **사용자 지정 OAuth 앱**의 경우 다음 필드를 구성합니다.
+ **기본 URL**(선택 사항) - Box API 기본 URL입니다. 예시: `https://mcp.box.com`
+ **클라이언트 ID** - Box 앱의 클라이언트 ID입니다.
+ **클라이언트 보안 암호** - Box 앱의 클라이언트 보안 암호입니다.
1. **다음**을 선택합니다.
1. 상자 권한 부여 창이 열립니다. 요청된 권한을 검토하고 **Box에 대한 액세스 권한 부여를** 선택합니다.
1. **검토** 페이지에서 커넥터에 사용할 수 있는 작업을 검토합니다. **다음**을 선택합니다.
1. **게시** 페이지에서 커넥터에 액세스할 수 있는 사용자를 선택합니다. 조직의 모든 사용자에 대해 액세스를 활성화하거나 특정 팀 또는 그룹을 검색할 수 있습니다.
1. **게시**를 선택합니다.
## 사용 가능한 작업
커넥터를 설정한 후 다음 작업을 사용할 수 있습니다.
**Box Agent 사용 가능한 작업**
| 카테고리 | 작업 | 설명 |
| --- | --- | --- |
| AI | AI Q&A(Hub) | Box AI를 사용하여 Box Hub에 질문합니다. |
| AI | AI Q&A(단일 파일) | Box AI를 사용하여 단일 파일에 질문합니다. |
| AI | AI Q&A(여러 파일) | Box AI를 사용하여 여러 파일에 질문합니다. |
| AI | AI 추출(Freeform) | Box AI를 자유 형식 형식으로 사용하여 파일에서 메타데이터를 추출합니다. |
| AI | AI 추출(구조화됨) | 사용자 지정 필드 또는 메타데이터 템플릿을 기반으로 Box AI를 사용하여 파일에서 구조화된 메타데이터를 추출합니다. |
| 파일 | 파일 콘텐츠 가져오기 | 50MB 미만의 파일에 대해 텍스트 형식으로 파일 콘텐츠를 추출하고 반환합니다. |
| 파일 | 파일 세부 정보 가져오기 | 메타데이터, 권한 및 버전 세부 정보를 포함한 포괄적인 파일 정보를 가져옵니다. |
| 파일 | 파일 속성 업데이트 | 이름, 설명, 태그 및 컬렉션을 포함한 파일 메타데이터를 업데이트합니다. |
| 파일 | 파일 업로드 | Box에 새 파일을 업로드합니다. |
| 파일 | 파일 버전 업로드 | 기존 파일의 새 버전을 업로드합니다. |
| 파일 | 파일 검색 | 메타데이터 필터 및 파일 확장자 필터링을 지원하는 키워드를 사용하여 파일을 검색합니다. |
| 폴더 | Create Folder | Box에서 새 폴더를 생성합니다. |
| 폴더 | 폴더 세부 정보 가져오기 | 메타데이터 및 공동 작업 설정을 포함한 포괄적인 폴더 정보를 검색합니다. |
| 폴더 | 폴더 콘텐츠 나열 | 폴더의 파일, 폴더 및 웹 링크를 나열합니다. |
| 폴더 | 폴더 속성 업데이트 | 이름, 설명, 태그 및 컬렉션을 포함한 폴더 메타데이터를 업데이트합니다. |
| 폴더 | 검색 폴더 | 키워드 일치를 사용하여 이름으로 폴더를 검색합니다. |
| 허브 | 허브 생성 | 콘텐츠를 구성하기 위한 새 허브를 생성합니다. |
| 허브 | Get Hub 세부 정보 | 특정 허브에 대한 정보를 검색합니다. |
| 허브 | Get Hub 항목 | 허브 내에서 파일, 폴더 및 웹 링크를 포함한 항목을 검색합니다. |
| 허브 | 허브 나열 | 현재 사용자가 액세스할 수 있는 모든 허브를 나열합니다. |
| 허브 | 허브 업데이트 | 허브의 제목 또는 설명을 업데이트합니다. |
| 허브 | Hub에 항목 추가 | 허브에 파일, 폴더 또는 웹 링크를 추가합니다. |
| 설명 및 작업 | 파일 설명 생성 | 파일에 새 주석을 생성합니다. |
| 설명 및 작업 | 파일 설명 나열 | 파일에 대한 모든 설명을 나열합니다. |
| 설명 및 작업 | 작업 나열 | 파일과 연결된 모든 작업을 나열합니다. |
| Users | 내가 누구인가 | 현재 인증된 사용자에 대한 정보를 반환합니다. |
## 관리 및 문제 해결
커넥터 편집, 공유 또는 삭제에 대한 지침은 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).
+ **인증 팝업 실패** - 브라우저가 Amazon Quick 콘솔 도메인의 팝업을 허용하는지 확인합니다.
+ **잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱)** - 클라이언트 ID와 클라이언트 보안 암호가 Box 개발자 콘솔 앱의 값과 일치하는지 확인합니다.
+ **권한 부족 **- Box 계정이 액세스하려는 파일, 폴더 또는 허브에 액세스할 수 있는지 확인합니다.