미션 04: 에이전트를 위한 솔루션 만들기

🎥 실습 영상

미션 브리프

Agent Maker, 다음 작전에 오신 것을 환영합니다. 이번 미션에서는 Microsoft Copilot Studio로 만든 IT Helpdesk Agent를 위한 공식 배포 단위인 Solution을 구성합니다. 솔루션은 에이전트와 관련 아티팩트를 담는 디지털 서류 가방이라고 생각하면 됩니다.

모든 에이전트에는 구조화된 집이 필요하며, Power Platform solution이 바로 그 역할을 합니다. 정리, 이동성, 운영 준비 상태를 모두 제공합니다.

이제 패키징을 시작해 봅시다.

목표

이번 미션에서 배우는 내용은 다음과 같습니다.

1. Power Platform solutions가 무엇이며 에이전트 개발에서 어떤 역할을 하는지 이해하기
2. 솔루션을 사용해 에이전트를 구성하고 배포하는 장점 이해하기
3. solution publisher와 컴포넌트 관리에서의 중요성 이해하기
4. 개발부터 운영까지 이어지는 Power Platform solution lifecycle 이해하기
5. IT Helpdesk Agent용 custom publisher와 custom solution 만들기

솔루션이란 무엇인가요?

Microsoft Power Platform에서 solution은 앱이나 에이전트를 구성하는 모든 요소를 담는 컨테이너 또는 패키지입니다. 예를 들어 tables, forms, flows, custom logic이 포함될 수 있습니다. 솔루션은 Application Lifecycle Management (ALM)의 핵심이며, 아이디어에서 개발, 테스트, 배포, 업데이트까지 전체 흐름을 관리할 수 있게 해줍니다.

Copilot Studio에서 만드는 모든 에이전트는 Power Platform solution 안에 저장됩니다. 기본적으로는 Default solution에 저장되지만, 원하는 경우 새 custom solution을 만들어 그 안에서 에이전트를 구축할 수 있습니다.

전통적으로 솔루션은 Power Apps maker portal에서 만들었습니다. 이 웹 기반 인터페이스에서 앱을 만들고, Dataverse와 flows를 구성하고, AI 구성 요소도 탐색할 수 있습니다.

이제 Copilot Studio에는 Solution Explorer가 있어 솔루션을 직접 관리할 수 있습니다. Power Apps maker portal로 이동하지 않고도 Copilot Studio 안에서 솔루션 작업을 수행할 수 있습니다.

즉, 다음과 같은 일반적인 솔루션 작업을 Copilot Studio 안에서 처리할 수 있습니다.

• 새 솔루션 만들기 - custom solution을 만들면 에이전트를 환경 간 export/import할 수 있습니다.
• 기본 솔루션 설정 - agents, apps 등이 기본으로 생성될 솔루션을 지정할 수 있습니다.
• 구성 요소 추가/제거 - 에이전트가 environment variables나 cloud flows 같은 다른 구성 요소를 참조할 때 같은 솔루션에 포함할 수 있습니다.
• 솔루션 내보내기 - 다른 대상 환경으로 이동할 수 있습니다.
• 솔루션 가져오기 - 다른 곳에서 만든 솔루션을 가져오고 업그레이드/업데이트할 수 있습니다.
• 솔루션 파이프라인 만들기 및 관리 - 환경 간 배포를 자동화할 수 있습니다.
• Git 통합 - 개발 환경에서 솔루션을 Git 리포지토리와 연결해 버전 관리와 협업을 수행할 수 있습니다.

솔루션에는 두 가지 유형이 있습니다.

• Unmanaged solutions - 개발 단계에서 사용하며 자유롭게 편집하고 사용자 지정할 수 있습니다.
• Managed solutions - 테스트나 프로덕션 배포 시 사용하며, 실수로 변경되지 않도록 잠금에 가깝게 관리됩니다.

왜 에이전트에 솔루션을 써야 할까요?

솔루션은 _도구 상자_와 같습니다. 다른 위치(환경)에서 무언가를 만들거나 고치려면 필요한 도구(구성 요소)를 상자(솔루션)에 담아 옮겨야 합니다. 새 환경으로 가져간 뒤 그대로 쓰거나, 새로운 구성 요소를 더해 에이전트를 확장할 수 있습니다.

개발자 환경(source environment)에서는 에이전트를 전용 솔루션 안에 만드는 것이 좋은 습관입니다. 이유는 다음과 같습니다.

체계적인 개발

• Default solution의 다른 자산과 섞이지 않고, 에이전트 관련 구성 요소를 한곳에 모을 수 있습니다.
• 필요한 모든 요소가 하나의 솔루션에 있으므로 대상 환경으로 export/import하기 쉽고, 이는 ALM의 좋은 습관입니다.

안전한 배포

• 앱이나 에이전트를 managed solution으로 내보내 테스트나 프로덕션 환경에 배포할 수 있으며, 실수로 편집될 위험을 줄일 수 있습니다.

버전 관리

• patches(목표 수정), updates(보다 넓은 범위의 변경), upgrades(기능 추가나 대규모 변경을 포함한 교체)를 만들 수 있습니다.
• 변경 사항을 통제된 방식으로 배포하는 데 도움이 됩니다.

종속성 관리

• 어떤 구성 요소가 다른 구성 요소에 의존하는지 추적해, 변경으로 인해 예기치 않게 깨지는 일을 줄일 수 있습니다.

팀 협업

• 개발 단계에서는 unmanaged solution으로 함께 작업하고, 배포 단계에서는 managed solution을 넘기는 방식으로 makers와 developers가 협업할 수 있습니다.

Solution Publisher 이해하기

Power Platform의 Solution Publisher는 솔루션을 만든 주체를 식별하는 라벨 또는 브랜드와 같습니다. 팀 단위 개발이나 여러 환경에서 작업할 때 특히 중요합니다.

솔루션을 만들 때 publisher를 선택해야 하며, publisher는 다음을 정의합니다.

• 모든 custom component에 붙는 prefix
• 솔루션 소유 조직 또는 담당자의 이름과 연락처 정보

왜 중요할까요?

1. 식별이 쉽다 - new_, abc_ 같은 prefix를 보면 어떤 솔루션/팀의 구성 요소인지 빠르게 구분할 수 있습니다.
2. 충돌을 막는다 - 두 팀이 같은 이름의 column을 만들더라도 teamA_status, teamB_status처럼 충돌을 피할 수 있습니다.
3. ALM을 지원한다 - Dev → Test → Prod로 솔루션을 이동할 때 소유권과 일관성을 유지하는 데 도움이 됩니다.

Power Platform solution lifecycle

이제 솔루션의 목적을 이해했으니 lifecycle을 살펴보겠습니다.

1. 개발 환경에서 솔루션 만들기 - Development 환경에서 새 솔루션을 만듭니다.
2. 구성 요소 추가 - apps, flows, tables 등 필요한 요소를 추가합니다.
3. Managed solution으로 내보내기 - 배포용으로 패키징합니다.
4. Test 환경으로 가져오기 - Test 환경에서 동작을 검증합니다.
5. Production 환경으로 가져오기 - 검증이 끝난 솔루션을 운영 환경에 배포합니다.
6. Patch, Update, Upgrade 적용 - 수정과 개선을 적용하고 이 주기를 반복합니다.

실습 04: 새 솔루션 만들기

이제 다음 두 가지를 배웁니다.

• Solution publisher 만들기
• Solution 만들기

앞에서 이어진 예시대로, 전용 Copilot Studio 환경 안에서 IT helpdesk agent를 구축할 솔루션을 만들어 보겠습니다.

시작해 보겠습니다.

사전 준비

보안 역할

Copilot Studio에서 Solution Explorer로 할 수 있는 작업은 사용자 security role에 따라 달라집니다. Power Apps admin center에서 솔루션을 관리할 권한이 없다면, Copilot Studio 안에서도 같은 작업을 수행할 수 없습니다.

원활한 진행을 위해 적절한 security roles와 permissions가 있는지 확인하세요. 조직에서 직접 환경을 관리하지 않는다면 tenant/environment를 관리하는 IT 관리자에게 문의하세요.

다음 security role이 있으면 환경에서 솔루션을 만들 수 있습니다.

보안 역할	설명
Environment Maker	특정 환경에서 solutions를 포함한 리소스를 만들고 사용자 지정하고 관리하는 데 필요한 권한을 제공합니다.
System Customizer	Environment Maker보다 넓은 권한을 제공하며, 환경 사용자 지정과 security roles 관리를 포함합니다.
System Administrator	최고 수준의 권한으로 security roles 생성 및 할당을 포함해 환경 전반을 관리할 수 있습니다.

개발자 환경

1. 오른쪽 위의 gear (settings) 아이콘을 선택한 뒤 기본 환경에서 자신의 환경(예: Adele Vance’s environment)으로 전환합니다.

4.1 Solution publisher 만들기

1. 왼쪽 탐색 아래쪽의 ellipsis 아이콘을 선택하고, Explore 아래의 Solutions를 선택합니다.

1. Copilot Studio의 Solution Explorer가 열리면 + New solution을 선택합니다.

1. New solution pane에서 먼저 새 publisher를 만듭니다. + New publisher를 선택합니다.

1. New publisher pane의 Properties 탭에서 다음 필드를 채웁니다.

   Property	Description	Required
   Display name	publisher의 표시 이름	Yes
   Name	publisher의 고유 이름 및 schema name	Yes
   Description	솔루션 목적 설명	No
   Prefix	새 구성 요소에 적용될 publisher prefix	Yes
   Choice value prefix	choices 옵션에 사용되는 숫자 접두 값	Yes

   Display name

   Contoso Solutions
   

   Name

   ContosoSolutions
   

   Description

   Copilot Studio Agent Academy
   

   Prefix

   cts
   

   기본 Choice value prefix는 정수로 표시됩니다. 이 값을 가장 가까운 천 단위로 바꿉니다. 예를 들어 77074였다면 77000으로 바꿉니다.

1. 필요하면 Contact 탭에서 솔루션 연락처 정보를 입력합니다.

1. 다시 Properties 탭으로 돌아가 Save를 선택해 publisher를 생성합니다.

1. New publisher pane이 닫히고, New solution pane으로 돌아오면 방금 만든 Publisher가 선택된 상태로 표시됩니다.

잘하셨습니다. 이제 Solution Publisher를 만들었습니다. 다음으로 새 custom solution을 만듭니다.

4.2 새 Solution 만들기

1. 이제 New solution pane의 나머지 필드를 채웁니다.

   Display name

   Contoso Helpdesk Agent
   

   Name

   ContosoHelpdeskAgent
   

   새 솔루션이므로 Version number는 기본적으로 1.0.0.0입니다.

   그리고 Set as your preferred solution 체크박스를 선택합니다.

1. More options를 펼쳐 추가로 입력할 수 있는 정보를 확인합니다.

1. 여기에는 다음 항목이 있습니다.

   • Installed on - 솔루션이 설치된 날짜
   • Configuration page - 사용자에게 앱/에이전트/도구 사용을 안내하는 HTML web resource
   • Description - 솔루션 또는 configuration page에 대한 설명

   이번 실습에서는 모두 비워 둡니다.

   마지막으로 Create를 선택합니다.

1. Contoso Helpdesk Agent 솔루션이 생성됩니다. 아직 Copilot Studio에서 에이전트를 만들지 않았으므로 구성 요소 수는 0입니다.

   back arrow 아이콘을 선택해 Solution Explorer로 돌아갑니다.

1. 앞서 Set as your preferred solution를 선택했기 때문에, Contoso Helpdesk Agent가 이제 Current preferred solution으로 표시됩니다.

미션 완료

축하합니다. Publisher를 만들고, 그 Publisher를 사용해 에이전트 구축용 새 Solution을 만들었습니다.

이제 여러분은 규모 있는 운영을 위한 첫걸음인 깔끔한 디지털 기반을 마련했습니다. 정리된 구조와 배포 가능한 패키징 방식은 엔터프라이즈급 에이전트 개발의 핵심입니다.

이로써 Lab 04 - Creating a Solution를 마칩니다. 다음 학습은 사전 구축 에이전트 빠르게 시작하기에서 이어집니다. 이번 실습에서 만든 솔루션은 다음 실습에서도 사용됩니다.

참고 자료

• Create a solution
• Create and manage solutions in Copilot Studio
• Share agents with other users
• Summary of resources available to predefined security roles
• Upgrade or update a solution
• Overview of pipelines in Power Platform
• Overview of Git integration in Power Platform