Copilot 에이전트 키트 설치

Copilot 에이전트 키트는 Copilot Studio 에이전트를 테스트하고 평가하기 위한 오픈 소스 도구 키트입니다. 예를 들어 테스트 사례를 정의하고, 사용자 쿼리를 시뮬레이션하고, 에이전트 응답의 유효성을 검사하는 데 도움이 됩니다. 이 문서에서는 마켓플레이스 또는GitHub에서 키트를 설치하는 단계별 안내와 배포 후 단계 및 구성 옵션을 제공합니다.

메모

Copilot 에이전트 키트를 다운로드하고 설치하기 전에 모든 전제 조건을 충족하는지 확인하세요.

마켓플레이스에서 Copilot 에이전트 키트 설치

GitHub에서 Copilot 에이전트 키트 설치를 선호한다면, GitHub에서 Copilot 에이전트 키트 설치로 건너뛰세요.

마켓플레이스에서 배포하기

Copilot 에이전트 키트를 마켓플레이스에서 배포하려면 아래 단계를 따르세요.

마켓플레이스에서 Copilot 에이전트 키트로 이동합니다.
지금 가져오기를 선택합니다.
필요한 경우 로그인합니다.
Copilot 에이전트 키트 설치 화면에서 Copilot 에이전트 키트를 배포할 환경을 선택하세요.
사용 약관 및 진술을 검토합니다. 동의하면 확인란을 선택하고 설치를 선택합니다.

Copilot 에이전트 키트 설치가 시작됩니다.

배포 후 단계 (마켓플레이스)

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

Power Apps에 로그인하세요.
솔루션으로 이동합니다.
기본 솔루션을 선택합니다.
연결 참조를 선택합니다.
Copilot Agent Kit - Dataverse를 찾아서 편집을 위해 열어보세요.
모든 필수 필드가 채워지고 선택한 연결이 유효한지 확인합니다. 필요에 따라 Dataverse에 대한 새 연결을 만듭니다.
저장을 선택합니다.
추가 및 선택적 구성 단계를 따릅니다.

GitHub에서 Copilot 에이전트 키트 설치

GitHub에서 Copilot 에이전트 키트를 설치하려면 다음 단계를 따르세요. 마켓플레이스에서 설치하려면, Copilot 에이전트 키트를 마켓플레이스에서 설치로 이동하세요.

Copilot 에이전트 키트 관리형 zip 파일 설치

Copilot 에이전트 키트 관리형 솔루션을 설치하려면:

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

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

최신 버전의 Copilot 에이전트 키트로 업그레이드하려면 다음 단계를 따라 하세요:

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

메모

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

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

추가 및 선택적 구성 단계

이러한 구성 단계는 Copilot 에이전트 키트를 마켓플레이스 또는 GitHub에서 설치했는지와 관계없이 적용됩니다.

Tip

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

SharePoint 동기화 구성

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

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

이 단계를 수행하거나 Setup 마법사를 사용하여 SharePoint 연결 참조를 구성할 수 있습니다.

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

이 문서 앞부분에서 설명한 Copilot 에이전트 키트를 설치하세요.
Power Apps에 로그인하세요.
솔루션으로 이동합니다.
기본 솔루션을 선택합니다.
연결 참조를 선택합니다.
Copilot 에이전트 키트 - SharePoint 연결 참조를 찾아서 편집을 위해 열어보세요.
모든 필수 필드가 채워지고 선택한 연결이 유효한지 확인합니다. 필요에 따라 SharePoint에 대한 새 연결을 만듭니다.
저장을 선택합니다.

추가 정보: Copilot 에이전트 키트에서 에이전트 구성 방법 및 파일 동기화를 위한 새 에이전트 구성 방법에 대해 알아보세요.

에이전트 인벤토리 구성

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

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

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

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

연결 참조가 설정된 후에는 Agent Inventory 내에서 환경 범위, 에이전트 유형, 환경 그룹, 인벤토리 옵션, 동기화 일정을 설정하면 됩니다. 에이전트 인벤토리 구성에 대해 자세히 알아보세요.

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

이 문서 앞부분에서 설명한 Copilot 에이전트 키트를 설치하세요.
Power Apps에 로그인하세요.
솔루션으로 이동합니다.
기본 솔루션을 선택합니다.
연결 참조를 선택합니다.
Copilot 에이전트 킷 - Power Platform for Admins 연결 참조를 찾아서 편집을 위해 열어보세요.
모든 필수 필드가 채워지고 선택한 연결이 유효한지 확인합니다.
저장을 선택합니다.
Copilot 에이전트 킷 - Dataverse 연결 참조를 찾아서 편집을 위해 열어보세요.
모든 필수 필드가 채워지고 선택한 연결이 유효한지 확인합니다.
저장을 선택합니다.

플로우 활성화

메모

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

Copilot 에이전트 키트에 포함된 클라우드 흐름을 활성화하려면, 다음 단계들을 따르거나 설치 마법사를 사용하세요.

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

컴플라이언스 허브 설정

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

포함된 Conversation KPI 대시보드 구성

포함된 Conversation KPI 대시보드를 사용하려는 경우에만 다음 단계를 수행합니다.

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

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

보고서 게시

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

이 문서 앞부분에서 설명한 Copilot 에이전트 키트를 설치하세요.
Power CAT Copilot 에이전트 킷 GitHub 저장소에서 Conversation.KPIs.zip 을 다운로드하세요.
.zip 파일의 내용을 추출합니다.
Power BI Desktop 애플리케이션에서 Conversation KPI.pbit 파일을 엽니다.
표시되는 대화 상자에서 Dataverse URL을 환경 URL로 활용하여 입력하고, 로드를 선택합니다 (예: 접두사 없이 org3c23948.crm.dynamics.comhttps://).

대화 상자가 표시되지 않으면 홈>>에 환경 URL을 입력합니다.
데이터를 새로 고치고 필요에 따라 로그인합니다.
작업 영역에 저장하고 게시합니다.
보고서 이름 및 작업 영역 이름을 기록해 둡다.
Power BI에 로그인합니다.
게시한 보고서를 열고 URL에서 작업 영역 GUID 및 보고서 GUID 를 기록해 둡다.

"내 작업 영역"에 게시하는 경우 작업 영역 GUID는 .입니다 00000000-0000-0000-0000-000000000000.
세 개의 점을 선택한 후(...) 그리고 의미 모델 보기를 선택하세요.
파일>설정을 엽니다.
데이터 원본 자격 증명에 문제가 없는지 확인합니다. 로그인하여 문제를 해결합니다.
새로 고침으로 이동하여 새로 고침 일정을 설정합니다.

보고서 환경 변수 업데이트

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

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

Copilot 에이전트 키트에서 에이전트 구성하기에 대해 알아보세요. 여기에는 대화 KPI를 위한 새 에이전트 구성 방법도 포함됩니다.

Copilot 에이전트 키트 앱에 액세스

Copilot 에이전트 키트 앱에 액세스하려면:

Power Apps에 로그인하고 Copilot 에이전트 키트를 설치한 환경을 선택하세요.
앱으로 이동합니다.
Power CAT Copilot 에이전트 키트를 찾아 선택하세요.
재생을 선택합니다.
(선택 사항) 앱을 북마크합니다.

앱이 성공적으로 실행되는지 확인한 후, 소유자(또는 키트를 설치한 시스템 관리자)는 Copilot 에이전트 키트 앱을 팀과 공유해야 합니다.

Power Apps에 로그인하세요.
앱을 선택합니다:
"Copilot 에이전트 키트"를 검색한 다음, 유형이 코드로 표시된 앱(모델 기반 앱이 아닌 앱)을 선택하세요.
세 개의 점(...)을 선택한 다음, 앱 이름 옆에 있는 공유 를 선택합니다.
액세스가 필요한 사용자 또는 보안 그룹을 검색하고 추가합니다.
공유를 선택하여 확인합니다.

캔버스 앱을 조직과 공유에서 자세히 알아보세요.

다음 단계:

사용자 및 팀 구성

피드백

이 페이지가 도움이 되었나요?

Last updated on 2026-09-11