View a markdown version of this page

Box Agent 통합 - Amazon Quick
시작하기 전 준비 사항Amazon Quick에서 커넥터 설정사용 가능한 작업관리 및 문제 해결

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

Box Agent 통합

Box Agent 커넥터를 사용하면 Box AI 기능에 액세스하고, 파일 및 폴더를 관리하고, 자연어를 통해 Amazon Quick에서 직접 허브의 콘텐츠를 구성할 수 있습니다.

Amazon Quick은 Box Agent에 대해 다음과 같은 인증 방법을 지원합니다.

  • 기본 OAuth 앱 AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. Box 계정으로 직접 인증합니다.

  • 사용자 지정 OAuth 앱 - Box 개발자 콘솔에 등록된 고객 관리형 OAuth 2.0 애플리케이션을 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다.

Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.

시작하기 전 준비 사항

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.

  • 파일 및 폴더에 액세스할 수 있는 Box 계정입니다.

  • 사용자 지정 OAuth 앱의 경우: Box 개발자 콘솔에 액세스하여 사용자 지정 앱을 생성합니다. 자세한 내용은 Box 설명서의 OAuth 2.0 설정을 참조하세요.

  • Amazon Quick 구독 요구 사항은 섹션을 참조하세요콘솔에서 통합 설정.

Amazon Quick에서 커넥터 설정

사용 가능 탭에서 연결

기본 OAuth 앱 인증을 사용하려면 추가 구성 없이 사용 가능 탭에서 직접 연결할 수 있습니다.

  1. Amazon Quick 콘솔에서 커넥터를 선택합니다.

  2. 사용 가능 탭에서 Box Agent를 찾아 연결을 선택합니다.

  3. Box 로그인 흐름을 완료하고 요청된 권한을 부여합니다.

대신 사용자 지정 OAuth 앱으로 커넥터를 구성하려면 아래 설명과 같이 팀에 대해 생성 탭을 사용합니다.

팀에 대해 생성 탭에서 생성

사용자 지정 OAuth 앱 인증을 사용하는 경우 Amazon Quick을 구성하기 전에 Box 개발자 콘솔에서 사용자 지정 앱을 생성합니다. 설정 지침은 Box 설명서의 OAuth 2.0 설정을 참조하세요.

  1. Amazon Quick 콘솔에서 커넥터를 선택합니다.

  2. 팀에 대해 생성 탭을 선택합니다.

  3. Box Agent를 찾아 선택합니다.

    참고

    Box Agent 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 선택합니다. 새로 생성하려면 아니요, 새로 생성을 선택합니다.

  4. 커넥터의 이름을 입력합니다. 선택적으로 + 설명 추가를 선택하여 설명을 추가합니다.

  5. 연결 유형에서 퍼블릭 네트워크를 선택합니다.

  6. OAuth 구성에서 다음 중 하나를 선택합니다.

    1. 기본 OAuth 앱의 경우:

      추가 자격 증명은 필요하지 않습니다. 다음을 선택하여 계속 진행합니다.

    2. 사용자 지정 OAuth 앱의 경우 다음 필드를 구성합니다.

      • 기본 URL(선택 사항) - Box API 기본 URL입니다. 예시: https://mcp.box.com

      • 클라이언트 ID - Box 앱의 클라이언트 ID입니다.

      • 클라이언트 보안 암호 - Box 앱의 클라이언트 보안 암호입니다.

  7. 다음을 선택합니다.

  8. 상자 권한 부여 창이 열립니다. 요청된 권한을 검토하고 Box에 대한 액세스 권한 부여를 선택합니다.

  9. 검토 페이지에서 커넥터에 사용할 수 있는 작업을 검토합니다. 다음을 선택합니다.

  10. 게시 페이지에서 커넥터에 액세스할 수 있는 사용자를 선택합니다. 조직의 모든 사람에 대해 액세스를 활성화하거나 특정 팀 또는 그룹을 검색할 수 있습니다.

  11. 게시를 선택합니다.

사용 가능한 작업

커넥터를 설정한 후 다음 작업을 사용할 수 있습니다.

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 내가 누구인가 현재 인증된 사용자에 대한 정보를 반환합니다.

관리 및 문제 해결

커넥터 편집, 공유 또는 삭제에 대한 지침은 섹션을 참조하세요기존 통합 관리.

  • 인증 팝업 실패 - 브라우저가 Amazon Quick 콘솔 도메인의 팝업을 허용하는지 확인합니다.

  • 잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱) - 클라이언트 ID와 클라이언트 보안 암호가 Box Developer Console 앱의 값과 일치하는지 확인합니다.

  • 권한 부족 - Box 계정에 액세스하려는 파일, 폴더 또는 허브에 대한 액세스 권한이 있는지 확인합니다.