재사용 가능한 컴포넌트 컬렉션을 생성하고 공유합니다

컴포넌트 컬렉션은 제작자가 에이전트 간에 재사용 가능한 컴포넌트를 생성하고 공유할 수 있게 해줍니다.

컬렉션을 사용하면 다음을 수행할 수 있습니다.

• 에이전트를 열지 않고도 Copilot Studio의 사이드 바에서 컴포넌트 컬렉션을 관리, 검색, 생성할 수 있어 공유 빌딩 블록을 더 쉽게 찾고 재사용할 수 있습니다.
• 원클릭 내보내기 및 단순화된 가져오기를 사용합니다. Copilot Studio는 컬렉션을 버전 관리 솔루션으로 패키징하고, 에이전트 설정에서 직접 가져올 수 있어 메이커 경험을 간소화합니다.
• 편집 액세스를 제어하면서 팀원과 컬렉션을 공유하여 안전한 협업을 가능하게 하고 핵심 자산을 보호하세요.
• 의도한 에이전트(기본 에이전트)만 사용할 수 있도록 컬렉션을 제한하여 팀이 의도하지 않은 재사용 없이 크거나 민감한 Copilot을 모듈화할 수 있도록 지원합니다.
• 구성 요소 컬렉션 작업 영역에서 직접 컬렉션이 다른 에이전트에서 어떻게 작동하는지 테스트하여 반복 속도를 높이고 일관된 결과를 보장합니다.
• 하위 에이전트, 모델 컨텍스트 프로토콜, 커넥터 및 흐름을 포함한 최신 커넥터 유형을 수집하고 공유합니다.
• 종속성을 제거하거나 조정하여 자산을 분리하고 팀 전체에서 독립적인 릴리스 주기를 지원합니다.

에이전트 구성 요소에는 다음이 포함됩니다.

• topics
• 지식
• 도구들
• 하위 에이전트
• 모델 컨텍스트 프로토콜
• connectors
• flows
• entities

구성 요소 컬렉션을 편집하거나 에이전트에 구성 요소 컬렉션을 추가하려면 컬렉션을 만든 사람이거나 시스템 사용자 지정자 또는 시스템 관리자 역할이 있는 사용자여야 합니다. 에이전트가 구성 요소 컬렉션을 사용할 수 있게 되면 모든 에이전트 작성자가 컬렉션을 보고 사용할 수 있지만 컬렉션 내의 구성 요소를 변경할 수는 없습니다. 환경에서 사용자 보안 구성에 대해 알아보세요.

구성 요소 컬렉션 만들기

에이전트의 설정 페이지 또는 구성 요소 컬렉션 페이지에서 직접 구성 요소 컬렉션을 만듭니다. 에이전트에서 컬렉션으로 구성 요소를 추가하면 구성 요소가 컬렉션으로 이동되고 에이전트는 컬렉션 내의 구성 요소를 참조합니다.

콜렉션을 사용자 환경의 다른 에이전트와 공유하거나 내보내 다른 환경으로 가져올 수 있습니다.

에이전트에서 구성 요소 컬렉션 만들기

1. 구성 요소 컬렉션으로 사용할 수 있도록 하려는 구성 요소가 포함된 에이전트를 엽니다.

2. 설정으로 이동하여 구성 요소 컬렉션을 선택합니다.

3. 환경에서 첫 번째 구성 요소 컬렉션을 만들려는 경우 만들기를 선택합니다. 그렇지 않으면 새로 만들기를 선택합니다.

4. 구성 요소 컬렉션에 대한 이름과 설명을 입력합니다.

5. 다음을 선택합니다.

6. 구성 요소 컬렉션에 추가할 구성 요소를 선택합니다. 범주 및 검색 필드를 사용하여 구성 요소 목록의 범위를 좁힐 수 있습니다. 컬렉션을 검토할 때 하위 에이전트를 연결할 수 있습니다.

   모든 구성 요소 종속성이 자동으로 선택되어 컬렉션에 추가됩니다. 구성 요소 컬렉션에 대한 기본 에이전트를 설정한 경우에만 종속성을 제외할 수 있습니다.

   기본 에이전트는 컬렉션의 구성 요소를 소유하는 에이전트입니다. 기본 에이전트를 설정하지 않으면 구성 요소 컬렉션이 환경에 의해 소유되므로 종속성에 대한 액세스 권한이 있어야 합니다.

   팁 (조언)

   에이전트에 대한 참조 자료 원본으로 파일을 업로드한 경우 이러한 파일을 구성 요소 컬렉션에 추가하면 원래 에이전트에서 해당 파일이 제거됩니다.
   해결 방법으로, 이러한 파일을 구성 요소 컬렉션에서 원래 에이전트로 다시 이동할 수 있습니다.

7. 다음을 선택합니다.

8. 컬렉션의 콘텐츠를 검토하고 만들기를 선택합니다.

환경 수준에서 구성 요소 컬렉션 만들기

1. 사이드 바에서 세 개의 점(...)을 선택한 후 컴포넌트 컬렉션을 선택하세요.

2. 새로 추가를 선택한 다음, 구성 요소 컬렉션을 선택합니다.

3. 구성 요소 컬렉션에 대한 이름과 설명을 입력합니다.

4. 마침을 선택합니다.

5. 공유 하려는 구성 요소가 포함된 에이전트를 새 구성 요소 컬렉션에 연결합니다.

6. 선택한 에이전트의 구성 요소를 컬렉션에 추가합니다.

구성 요소 컬렉션에 에이전트 연결

1. 사이드 바에서 세 개의 점(...)을 선택한 후 컴포넌트 컬렉션을 선택하세요.

2. 에이전트에 연결하려는 컬렉션을 선택합니다.

3. 연결된 에이전트 섹션에서 에이전트 추가를 선택합니다. 연결하려는 에이전트를 선택한 다음 추가를 선택합니다.

   연결된 에이전트의 모든 구성 요소를 구성 요소 컬렉션에 추가할 수 있습니다. 연결된 모든 에이전트는 해당 컬렉션의 모든 구성 요소를 사용할 수도 있습니다.

에이전트의 구성 요소를 컬렉션에 추가

1. 사이드 바에서 세 개의 점(...)을 선택한 후 컴포넌트 컬렉션을 선택하세요.

2. 구성 요소를 추가할 컬렉션을 선택합니다.

3. 컬렉션에서 재사용할 구성 요소가 포함된 에이전트를 아직 연결하지 않은 경우 연결합니다.

4. 구성 요소 추가 섹션에서 에이전트에서 추가를 선택합니다.

   비고

   구성 요소 컬렉션에 에이전트를 연결하지 않은 경우 에이전트에서 구성 요소를 추가하는 옵션을 사용할 수 없습니다.

5. 원하는 에이전트를 선택하고 다음을 선택합니다.

6. 구성 요소 컬렉션에 추가할 구성 요소를 선택합니다. 범주 레이블 및 구성 요소 검색 필드를 사용하여 구성 요소 목록의 범위를 좁힐 수 있습니다.

7. 다음을 선택합니다.

8. 컬렉션의 콘텐츠를 검토하고 컬렉션에 추가를 선택합니다.

구성 요소 컬렉션에 대한 기본 에이전트 설정 및 종속성 제외

단일 에이전트를 구성 요소 컬렉션의 기본 에이전트로 설정할 수 있습니다. 제작자는 하나의 특정 에이전트만 구성 요소 컬렉션을 사용하려는 경우 기본 에이전트를 선택할 수 있습니다.

컬렉션에 연결된 에이전트가 여러 개 있는 경우 기본 에이전트를 설정할 수 없습니다. 먼저 다른 모든 에이전트의 연결을 끊어야 합니다.

기본 에이전트를 설정할 때 해당 에이전트에서 구성 요소를 추가할 때 종속성을 제외할 수도 있습니다. 이를 통해 모든 종속성을 포함하지 않는 더 작은 구성 요소 컬렉션을 만들 수 있으며, 이는 특정 구성 요소만 공유하려는 경우에 유용할 수 있습니다.

1. 사이드 바에서 세 개의 점(...)을 선택한 후 컴포넌트 컬렉션을 선택하세요.

2. 기본 에이전트를 설정할 컬렉션을 선택합니다.

3. 연결된 에이전트 섹션에서 에이전트 옆에 있는 세 개의 점을 선택한 후 Set primary agent를 선택하세요.

   

   중요합니다

   컬렉션에 연결된 에이전트가 여러 개 있는 경우 기본 에이전트를 설정하는 옵션을 사용할 수 없습니다. 기본으로 설정하려는 에이전트 이외의 각 에이전트에 대해 에이전트에서 연결 끊기를 선택합니다.

기본 에이전트에서 구성 요소를 추가할 때 종속성을 제외하려면:

1. 구성 요소 컬렉션의 에이전트에서 추가 를 선택합니다.

2. 기본 에이전트를 선택하고 다음을 선택합니다.

3. 구성 요소 컬렉션에 추가할 구성 요소를 선택합니다. 구성 요소 종속성 포함을 선택 취소합니다.

4. 다음을 선택합니다.

5. 컬렉션의 콘텐츠를 검토하고 컬렉션에 추가를 선택합니다.

구성 요소 컬렉션 공유

구성 요소 컬렉션을 조직의 다른 사용자와 공유하고 뷰어 또는 편집자 권한이 있는지 여부를 지정할 수 있습니다. Copilot Studio 사용자의 권한 역할에 대한 자세한 내용은 에이전트 공유 방법 제어를 참조하세요.

1. 사이드 바에서 세 개의 점(...)을 선택한 후 컴포넌트 컬렉션을 선택하세요.

2. 공유하려는 컬렉션을 선택합니다.

3. 위쪽 메뉴 모음에서 공유를 선택합니다.

4. 공유 패널에서 구성 요소 컬렉션을 공유할 다른 사용자의 이름이나 이메일 주소를 입력합니다. 각 사용자에 대해 권한 역할(뷰어 또는 편집자)을 지정합니다.

컬렉션 가져오기 및 내보내기

컬렉션을 내보내 다른 환경으로 가져올 수 있습니다. 컬렉션을 내보내면 관리됩니다. 컬렉션을 관리하지 않고 내보내려면 복잡한 컬렉션에 솔루션 사용을 참조하세요.

컬렉션을 내보내려면:

1. 사이드 바에서 세 개의 점(...)을 선택한 후 컴포넌트 컬렉션을 선택하세요.

2. 내보낼 컬렉션을 엽니다.

3. 위쪽 메뉴 모음에서 내보내기를 선택합니다.

내보내기가 시작되고 알림 표시줄이 나타납니다. 내보내기가 준비되면 콜렉션을 .zip 파일로 다운로드할 수 있는 링크를 포함하도록 알림이 변경됩니다.

컬렉션을 가져오려면:

1. Copilot Studio에서 컬렉션을 가져올 환경이 선택되어 있는지 확인합니다.

   

2. 컬렉션에 연결하려는 에이전트를 연 다음 위쪽 표시줄에서 설정을 선택합니다.

3. 사이드 메뉴에서 구성 요소 컬렉션을 선택한 다음 솔루션 가져오기를 선택합니다.

4. 표시되는 패널에서 파일 찾아보기 를 선택한 다음 내보낸 컬렉션을 선택합니다.

5. 컬렉션의 세부 정보가 표시됩니다. 고급 설정 섹션에서 플러그인 단계 및 흐름을 제외할 수 있습니다.

   팁 (조언)

   컬렉션을 내보낸 것과 동일한 환경으로 컬렉션을 가져오려고 하면 오류 메시지가 표시됩니다. 컬렉션이 포함되지 않은 대상 환경에 있는지 확인합니다.

6. 다음을 선택합니다. 가져오기 패널이 닫히고, 컬렉션이 성공적으로 가져오기 완료되었다는 메시지가 뜹니다.

복잡한 컬렉션에 솔루션 사용

솔루션을 사용하여 한 환경에서 에이전트 구성 요소를 내보내고 다른 환경으로 가져올 수도 있습니다. 솔루션은 구성 요소의 캐리어 역할을 합니다. 하나의 솔루션에서 여러 에이전트 구성 요소를 내보내고 가져올 수 있습니다.

일반적으로 복잡한 구성 요소 컬렉션에 솔루션을 사용합니다. 예를 들어 컬렉션에 커넥터 또는 환경 변수가 있는 경우입니다.

솔루션 만들기

1. 솔루션 페이지로 이동합니다.

2. 새 솔루션을 선택합니다.

3. 새 솔루션에 대해 다음 정보를 입력하세요.

   • 표시 이름: 솔루션 목록에 표시할 이름입니다. 나중에 변경할 수 있습니다.
   • 이름: 표시 이름에서 생성된 솔루션의 고유 이름입니다. 솔루션을 저장하기 전에만 변경할 수 있습니다.
   • 게시자: 기본 게시자를 선택하거나 새 게시자를 만드세요. 단일 게시자를 만들어 솔루션의 모든 환경에서 일관되게 사용하는 것이 좋습니다. 솔루션 게시자에 대해 자세히 알아보세요.
   • 버전: 솔루션의 버전 번호를 입력합니다. 버전 번호는 솔루션을 내보낼 때 파일 이름에 포함됩니다.

4. 만들기를 선택합니다.

솔루션에 구성 요소 컬렉션 추가

1. 솔루션 페이지로 이동하고, 아직 열지 않은 원하는 솔루션을 엽니다.

2. 기존 항목 추가를 선택하고, 에이전트를 가리키고, 구성 요소 컬렉션을 선택합니다.

   사용 가능한 모든 구성 요소 컬렉션을 보여주는 패널이 나타납니다.

3. 패널 아래쪽에서 추가를 선택한 다음, 내보낼 구성 요소 컬렉션을 선택합니다.

솔루션을 내보내 다른 환경에서 구성 요소 컬렉션을 공유합니다

구성 요소 컬렉션을 내보내고 가져오는 방법은 해당 컬렉션을 포함하는 솔루션을 한 환경에서 다른 환경으로 내보내는 것입니다.

1. 솔루션 페이지로 이동합니다.

2. 내보내고 싶은 컴포넌트 컬렉션이 포함된 솔루션의 점(⋮)을 선택한 후, 솔루션 내보내기를 선택하세요.

3. 다음 옵션을 입력하거나 선택합니다.

   • 버전 번호: Copilot Studio는 솔루션 버전을 자동으로 증가시킵니다. 기본 버전을 그대로 사용하거나 직접 입력할 수 있습니다.
   • 다음으로 내보내기: 관리형 또는 비관리형으로 패키지 유형을 선택합니다. 관리형 및 비관리형 솔루션에 대해 자세히 알아보세요.

4. 내보내기를 선택합니다. 내보내기를 완료하는 데 몇 분이 걸릴 수 있습니다. 솔루션 페이지 상단에 있는 상태 메시지를 확인하세요.

5. .zip 파일을 다운로드하기 위해 다운로드 버튼을 선택합니다.

   파일 이름의 형식은 SolutionName_Version_SolutionType.zip(예: ContosoSolution_1_0_0_1_managed.zip)입니다.

환경에 구성 요소 컬렉션을 추가하는 솔루션 가져오기

1. 솔루션 페이지로 이동합니다.

2. 구성 요소 컬렉션을 가져올 환경을 선택합니다.

3. 솔루션 가져오기를 선택합니다.

4. 가져오기 패널에서 찾아보기를 선택하고, 구성 요소 컬렉션이 있는 솔루션이 포함된 .zip 파일을 선택한 다음, 다음을 선택합니다.

5. 가져오기를 선택합니다. 가져오기를 완료하는 데 몇 분이 걸릴 수 있습니다. 솔루션 페이지 상단에 있는 상태 메시지를 확인하세요.

6. 가져오기를 완료하는 동안 잠시 기다립니다.

가져오기에 실패하면 로그 파일 다운로드를 선택하여 가져오기 실패 원인에 대한 세부 정보가 포함된 XML 파일을 다운로드합니다. 가져오기가 실패하는 가장 일반적인 이유는 솔루션에 일부 필수 구성 요소가 포함되어 있지 않기 때문입니다.

에이전트에 가져온 구성 요소 컬렉션 추가

구성 요소 컬렉션을 가져온 후 에이전트에서 사용할 수 있습니다.

1. 구성 요소 컬렉션을 사용할 에이전트를 엽니다.

2. 설정 페이지로 이동하여 구성 요소 컬렉션을 선택합니다.

3. 가져온 구성 요소 컬렉션 옆에 있는 세 개의 점(...)을 선택하고 에이전트에 추가를 선택합니다.

   확인을 요청하는 메시지가 나타납니다.

4. 에이전트에 추가를 선택합니다.

   에이전트의 이름이 이 구성 요소 컬렉션의 활성 대상 아래에 나타납니다.

5. 가져온 컬렉션에서 구성 요소를 검토하고 에이전트를 게시하여 고객이 변경 내용을 사용할 수 있도록 합니다.

사용자 지정 솔루션의 구성 요소 컬렉션에 구성 요소 추가

Copilot Studio의 구성 요소 컬렉션에 새 에이전트 구성 요소를 추가하는 경우 이 구성 요소 컬렉션을 참조하는 관리되지 않는 솔루션에도 추가해야 합니다.

1. 솔루션 페이지로 이동하여 업데이트할 구성 요소 컬렉션이 포함된 비관리형 솔루션을 엽니다.

2. 개체 창에서 에이전트 구성 요소 컬렉션을 선택합니다.

3. 업데이트하고 싶은 컬렉션의 세 점(⋮)을 선택하고 Advanced를 가리킨 후 Add required Objects를 선택하세요.

4. 확인을 선택합니다.

   개체 창에서 에이전트 구성 요소를 선택하여 필요한 구성 요소가 이제 나타나는지 확인할 수 있습니다.

솔루션 탐색기 열기

Copilot Studio에서 사이드 바의 세 점(...)을 선택한 후 솔루션(Solutions)을 선택하세요.

솔루션 페이지가 새 브라우저 탭에 열립니다.