다음을 통해 공유


Copilot Studio Kit 설치

Copilot Studio Kit는 Copilot Studio 에이전트를 테스트하고 평가하기 위한 오픈 소스 도구 키트입니다. 예를 들어 테스트 사례를 정의하고, 사용자 쿼리를 시뮬레이션하고, 에이전트 응답의 유효성을 검사할 수 있습니다. 이 문서에서는 배포 후 단계 및 구성 옵션과 함께 AppSource또는GitHub에서 키트를 설치하기 위한 단계별 지침을 제공합니다.

비고

Copilot Studio Kit를 다운로드하여 설치하기 전에 모든 필수 구성 요소가 충족되는지 확인합니다.

AppSource에서 Copilot Studio Kit 설치

GitHub에서 Copilot Studio Kit를 설치하려면 GitHub에서 Copilot Studio Kit 설치로 건너뜁니다.

AppSource에서 배포

AppSource에서 Copilot Studio Kit를 배포하려면 다음 단계를 수행합니다.

  1. AppSource에서 Copilot Studio 키트로 이동합니다.
  2. 지금 가져오기를 선택합니다.
  3. 필요한 경우 로그인합니다.
  4. Copilot Studio Kit 설치 보기에서 Copilot Studio Kit를 배포할 환경을 선택합니다.
  5. 사용 약관 및 진술을 검토합니다. 동의하면 확인란을 선택하고 설치를 선택합니다.

코필로트 스튜디오 키트 설치가 시작됩니다.

배포 후 단계(AppSource)

설치가 완료되면 다음 배포 후 단계를 수행합니다.

  1. Power Apps에 로그인합니다.
  2. 솔루션으로 이동합니다.
  3. 기본 솔루션을 선택합니다.
  4. 연결 참조를 선택합니다.
  5. Copilot Studio Kit - Dataverse를 찾아 편집용으로 엽니다.
  6. 모든 필수 필드가 채워지고 선택한 연결이 유효한지 확인합니다. 필요에 따라 Dataverse에 대한 새 연결을 만듭니다.
  7. 저장을 선택합니다.
  8. 추가 및 선택적 구성 단계를 따릅니다.

GitHub에서 Copilot Studio Kit 설치

GitHub에서 Copilot Studio Kit를 설치하려면 다음 단계를 수행합니다. AppSource에서 설치하려면 AppSource에서 Copilot Studio Kit 설치로 이동합니다.

최신 GitHub 릴리스 다운로드

Power CAT Copilot Studio Kit에 대한 관리되는 솔루션의 최신 버전을 다운로드합니다.

CopilotStudioKit 관리되는 zip 파일 설치

Copilot Studio Kit 관리 솔루션을 설치하려면 다음을 수행합니다.

  1. Power Apps에 로그인합니다.
  2. Copilot Studio Kit를 설치할 환경을 선택합니다.
  3. 솔루션으로 이동합니다.
  4. 솔루션 가져오기를 선택합니다.
  5. 찾아보기를 선택합니다.
  6. CopilotStudioKit*_managed.zip 파일을 선택합니다.
  7. 다음을 선택합니다.
  8. 솔루션 정보를 검토한 후 다음을 선택합니다.
  9. 메시지가 표시되면 필요한 연결을 만들고 가져오기를 선택합니다.
  10. 지금은 Conversation KPI 보고서 값을 그대로 두세요. 이러한 값은 나중에 업데이트할 수 있습니다.
  11. 가져오기 작업이 완료되기를 기다립니다.

기존 솔루션 업그레이드(GitHub)

이전 버전의 Copilot Studio Kit를 설치하고 최신 버전으로 업그레이드하려는 경우 다음 단계를 수행합니다.

  1. Power Apps에 로그인합니다.
  2. Copilot Studio Kit를 업그레이드할 환경을 선택합니다.
  3. 솔루션으로 이동합니다.
  4. 솔루션 가져오기를 선택합니다.
  5. 찾아보기를 선택합니다.
  6. CopilotStudioKit*_managed.zip선택합니다.
  7. 다음을 선택합니다. Power Apps는 이 업그레이드가 기존 관리형 솔루션임을 인식합니다.
  8. 다음을 선택하여 기존 솔루션을 업그레이드할지 확인합니다.
  9. 지금은 Conversation KPI 보고서 값을 그대로 두세요. 이러한 값은 나중에 업데이트할 수 있습니다.
  10. 가져오기를 선택합니다.

비고

Copilot Studio Kit를 업그레이드하는 동안 다음과 같은 오류가 발생할 수 있습니다. "솔루션 "Power CAT Copilot Studio Kit"를 가져오지 못했습니다. ImportAsHolding이 예외로 실패했습니다. 특성을 삭제할 수 없습니다. 엔터티에서 cat_copilottestrunid: 특성이 사용자 지정 필드가 아니므로 cat_CopilotTestRun."

이 문제는 알려져 있으며 조사 중입니다. 해결 방법으로 업그레이드를 적용하기 전에 준비 단계를 밟으십시오. 솔루션 업그레이드 또는 업데이트에 대해 자세히 알아보세요.

추가 및 선택적 구성 단계

이러한 구성 단계는 AppSource 또는 GitHub에서 Copilot Studio Kit를 설치했는지 여부에 따라 적용됩니다.

팁 (조언)

Copilot Studio Kit에는 연결 참조, 환경 변수, 클라우드 흐름을 구성할 수 있는 설정 마법사가 포함되어 있습니다. 설정 마법사 사용법에 대해 더 알아보세요.

SharePoint 동기화 구성

다음 단계는 선택 사항이며 SharePoint 동기화 기능을 사용하려는 경우에만 필요합니다. 기능을 사용하기 전에 언제든지 이러한 값을 설정할 수 있습니다.

SharePoint에 대한 연결을 원본 SharePoint 사이트로 가리킵니다. 콘텐츠가 동기화되는 대상 사용자 지정 에이전트에 대한 Dataverse URL을 Dataverse 인스턴스로 가리킵니다.

이 단계를 따라 하거나 설정 마법사 를 사용해 SharePoint 연결 참조를 설정할 수 있습니다.

SharePoint 동기화 기능을 사용하려면 다음을 수행합니다.

  1. 이 문서의 앞부분에서 설명한 Copilot Studio Kit를 설치합니다.
  2. Power Apps에 로그인합니다.
  3. 솔루션으로 이동합니다.
  4. 기본 솔루션을 선택합니다.
  5. 연결 참조를 선택합니다.
  6. Copilot Studio Kit - SharePoint 연결 참조를 찾아 편집용으로 엽니다.
  7. 모든 필수 필드가 채워지고 선택한 연결이 유효한지 확인합니다. 필요에 따라 SharePoint에 대한 새 연결을 만듭니다.
  8. 저장을 선택합니다.

자세한 정보: 파일 동기화를 위해 새에이전트를 구성하는 방법을 포함하여 Copilot Studio Kit에서 에이전트를 구성하는 방법에 대해 알아봅니다.

에이전트 인벤토리 구성

다음 단계는 선택 사항이며 에이전트 인벤토리 기능을 사용하려는 경우에만 필요합니다. 기능을 사용하기 전에 언제든지 이러한 값을 설정할 수 있습니다.

솔루션의 연결 참조는 에이전트의 가시성을 제어합니다. 다른 계정을 사용할 수 있지만 이러한 사용 권한을 사용하여 전체 가시성을 확보합니다.

  • Copilot Studio Kit - 관리자용 Power Platform 은 테넌트의 환경 목록을 가져옵니다. Power Platform 관리자 수준 권한이 필요합니다.
  • Copilot Studio Kit - Dataverse 는 환경에서 에이전트 정보를 수집합니다. 모든 환경에 대한 시스템 관리자 수준 권한이 필요합니다.

이 단계를 따르거나 설정 마법사 를 사용해 에이전트 인벤토리 연결 참조를 설정할 수 있습니다.

에이전트 인벤토리 기능을 사용하려면:

  1. 이 문서의 앞부분에서 설명한 Copilot Studio Kit를 설치합니다.
  2. Power Apps에 로그인합니다.
  3. 솔루션으로 이동합니다.
  4. 기본 솔루션을 선택합니다.
  5. 연결 참조를 선택합니다.
  6. Copilot Studio Kit - Power Platform for Admins 연결 참조를 찾아서 편집할 수 있도록 엽니다.
  7. 모든 필수 필드가 채워지고 선택한 연결이 유효한지 확인합니다.
  8. 저장을 선택합니다.
  9. Copilot Studio Kit - Dataverse 연결 참조를 찾아 편집용으로 엽니다.
  10. 모든 필수 필드가 채워지고 선택한 연결이 유효한지 확인합니다.
  11. 저장을 선택합니다.

사용 기록 메트릭 활성화

에이전트 인벤토리에서 선택적 사용 메트릭을 사용하도록 설정하려면 다음 단계를 완료합니다.

  1. 사용자 환경에서 Microsoft Entra ID(사전 인증된) 를 사용하는 커넥터 HTTP가 허용되는지 확인합니다.
  2. Power CAT Copilot Studio Kit GitHub 리포지토리에서 AgentInventoryUsage*_managed.zip 파일을 가져옵니다.
  3. 가져오기 프로세스 중에 라이선스 호스트 URL을 사용하여 연결을 만듭니다. https://licensing.powerplatform.microsoft.com/

Microsoft Entra ID 커넥터를 사용하여 HTTP에 대한 기본 리소스 URL로 라이선스 호스트 URL의 구성을 보여 주는 스크린샷

플로우 활성화

비고

SharePoint 동기화를 사용하려는 경우 관련 흐름을 사용하도록 설정하기 전에 SharePoint 동기화를 구성합니다(이름은 Sharepoint 동기화로 시작).

Copilot Studio Kit에 포함된 클라우드 흐름을 활성화하려면 다음 단계를 따르거나 설정 마법사를 사용하세요.

  1. 이 문서의 앞부분에서 설명한 Copilot Studio Kit를 설치합니다.
  2. Power Automate에 로그인합니다.
  3. Copilot Studio Kit가 있는 환경이 선택되어 있는지 확인합니다.
  4. 솔루션을 선택합니다.
  5. 코필로트 스튜디오 키트를 선택합니다.
  6. 클라우드 흐름을 선택합니다.
  7. 모든 프로세스가 활성화되어 있는지 확인합니다(상태 = 켜짐).
  8. 사용하도록 설정되지 않은 모든 흐름을 다음 순서대로 사용하도록 설정합니다.
    1. 손자로 끝나는 흐름.
    2. 자식으로 끝나는 흐름입니다.
    3. 필요에 따라 순서에 따라 흐름의 나머지 부분을 지정합니다.

컴플라이언스 허브 설정

컴플라이언스 허브를 설정하려면 Copilot Studio Kit 컴플라이언스 허브 설정 및 구성 단계를 따라주세요. 컴플라이언스 허브는 에이전트 인벤토리를 요구합니다.

포함된 Conversation KPI 대시보드 구성

이러한 단계는 포함된 Conversation KPI 대시보드를 사용하려는 경우에만 필요합니다.

이 단계에서는 다음 값을 기록해 둡다.

  • 작업 영역 이름
  • 작업 영역 GUID
  • 보고서 이름
  • 보고서 GUID

보고서 게시

대화 KPI 보고서를 게시하려면 다음을 수행합니다.

  1. 이 문서의 앞부분에서 설명한 Copilot Studio Kit를 설치합니다.

  2. Power CAT Copilot Studio Kit GitHub 리포지토리에서 Conversation.KPIs.zip 다운로드합니다.

  3. .zip 파일의 내용을 추출합니다.

  4. Power BI Desktop 애플리케이션에서 Conversation KPI.pbit 파일을 엽니다.

  5. 표시되는 대화 상자에서 Dataverse URL을 환경 URL로 활용하여 입력하고, 로드를 선택합니다 (예: 접두사 없이 org3c23948.crm.dynamics.comhttps://).

    대화 상자가 표시되지 않으면 >>에 환경 URL을 입력합니다.

  6. 데이터를 새로 고치고 필요에 따라 로그인합니다.

  7. 작업 영역에 저장하고 게시합니다.

  8. 보고서 이름작업 영역 이름을 기록해 둡다.

  9. Power BI에 로그인합니다.

  10. 게시한 보고서를 열고 URL에서 작업 영역 GUID보고서 GUID 를 기록해 둡다.

    "내 작업 영역"에 게시하는 경우 작업 영역 GUID는 .입니다 00000000-0000-0000-0000-000000000000.

  11. 세 개의 점을 선택한 후(...) 그리고 의미 모델 보기를 선택하세요.

  12. 파일>설정을 엽니다.

  13. 데이터 원본 자격 증명에 문제가 없는지 확인합니다. 로그인하여 문제를 해결합니다.

  14. 새로 고침으로 이동하여 새로 고침 일정을 설정합니다.

보고서 환경 변수 업데이트

포함된 Conversation KPI 대시보드를 설정하려면 관련 환경 변수를 올바른 식별자를 사용하여 업데이트합니다. 이 단계를 따르거나 설정 마법사를 사용할 수 있습니다.

  1. Power Apps에 로그인하고 Copilot Studio Kit를 설치한 환경을 선택합니다.
  2. 솔루션>기본 솔루션을 선택합니다.
  3. 환경 변수 선택
  4. 대화 KPI 보고서를 찾아 선택합니다.
  5. 기본값의 자리 표시자를 게시 프로세스 중에 적어 두는 작업 영역 이름, 작업 영역 GUID, 보고서 이름보고서 GUID 값으로 바꿉다.
  6. 저장을 선택합니다.

자세한 정보: Conversation KPI에 대한 새 에이전트를 구성하는 방법을 포함하여 Copilot Studio Kit에서 에이전트를 구성하는 방법에 대해 알아봅니다.

Copilot Studio Kit 앱에 액세스

Copilot Studio Kit 앱에 액세스하려면 다음을 수행합니다.

  1. Power Apps에 로그인하고 Copilot Studio Kit를 설치한 환경을 선택합니다.
  2. 으로 이동합니다.
  3. Power CAT 코필로트 스튜디오 키트를 찾아 선택합니다.
  4. 재생을 선택합니다.
  5. (선택 사항) 앱을 북마크합니다.

다음 단계