솔루션을 사용하여 에이전트 내보내기 및 가져오기

솔루션을 사용하여 에이전트를 내보내고 가져올 수 있으므로 여러 환경에서 에이전트를 이동할 수 있습니다.

먼저 사용자 지정 솔루션을 만들고 에이전트를 추가합니다. 그런 다음 에이전트를 사용하여 솔루션을 내보내고 다른 환경으로 가져옵니다. 에이전트를 사용하여 솔루션을 업그레이드 또는 업데이트하고 관리되는 에이전트에서 비관리형 레이어를 제거할 수도 있습니다.

Copilot Studio 솔루션 탐색기에 대한 자세한 내용은 Copilot Studio 참조하세요.

참고

에이전트를 내보낼 때 토픽 수준 또는 노드 수준 댓글을 내보낼 수 없습니다.

필수 구성 요소

알아야 할 사항

  • 에이전트를 내보낼 때 토픽 수준 또는 노드 수준 댓글을 내보낼 수 없습니다.

    참고

    솔루션을 사용하여 에이전트를 내보내고 가져올 때 모든 에이전트 구성 요소가 포함되지는 않습니다.

    에이전트 지침(기본 프롬프트)이 포함됩니다. 그러나 사용자 지정 토픽 및 기술 자료 원본과 같은 일부 구성 요소는 생성 또는 연결 방법에 따라 별도의 리소스 또는 Dataverse 테이블로 저장되는 경우 포함되지 않을 수 있습니다.

  • 솔루션에서 에이전트를 제거해도 솔루션에서 해당 구성 요소가 제거되지 않습니다. 구성 요소를 별도로 제거해야 합니다.

    경고

    에이전트 토픽과 같은 비관리형 에이전트 구성 요소를 솔루션에서 직접 제거하지 마십시오. 단, 솔루션에서 에이전트를 제거하는 경우는 예외입니다.

    Copilot Studio UI에서 표준 작성 프로세스의 일부로만 토픽을 변경해야 합니다. 솔루션에서 에이전트 구성 요소를 직접 제거하거나 변경하면 내보내기 및 가져오기가 실패합니다.

  • 관리형 솔루션은 내보낼 수 없습니다. 솔루션을 생성하면 기본적으로 관리되지 않습니다. 관리형 솔루션으로 변경하면 내보낼 수 없습니다. 새 솔루션을 만들어야 합니다.

  • 토픽 이름에 마침표(.)가 있는 에이전트가 포함된 솔루션은 내보낼 수 없습니다.

사용자 지정 솔루션 만들기 및 에이전트 추가

  1. Copilot Studio 솔루션 탐색기에서 새 솔루션을 만들려면 Copilot Studio 솔루션 만들기 및 관리의 단계를 수행합니다.

  2. 만든 솔루션이 자동으로 열립니다. 그렇지 않다면 솔루션을 목록에서 선택합니다.

  3. 기존 항목 추가를 선택한 다음 에이전트를 선택한 다음 에이전트를 다시 선택합니다.

  4. 기존 에이전트 추가 목록에서 내보낼 에이전트를 선택한 다음 추가를 선택합니다.

참고

클래식 챗봇의 경우:

스킬을 사용하는 경우, 현재 값 환경 변수를 이 솔루션에서 제거를 선택하여 삭제합니다.

이 솔루션에서 제거 버튼을 보여주는 스크린샷.

솔루션에서 에이전트를 제거해도 솔루션에서 해당 구성 요소가 제거되지 않습니다. 구성 요소를 별도로 제거해야 합니다.

사용자 지정 솔루션의 에이전트에 구성 요소 추가

토픽 또는 흐름과 같은 구성 요소를 Copilot Studio 에이전트에 추가하는 경우 내보내기 전에 관리되지 않는 솔루션의 에이전트에도 추가해야 합니다.

  1. Copilot Studio 솔루션 탐색기를 사용합니다.

  2. 에이전트가 포함된 솔루션을 선택합니다.

  3. 개체 창에서 에이전트 아래에 있는 에이전트를 찾습니다.

  4. 세 개의 점()을 선택하고, 고급을 선택한 다음 필수 객체 추가를 선택하세요.

Power Apps 설명서의 지침 및 요구 사항을 검토하여 기존 구성 요소를 솔루션에 추가합니다.

맞춤형 커넥터를 솔루션에 추가하세요

만약 귀하의 에이전트가 커스텀 커넥터를 사용한다면, 솔루션 내 커스텀 커넥터 만들기 단계에 따라 알고 있는 제한 사항을 알아보세요.

중요

먼저 커스텀 커넥터를 가져오고, 그 다음 에이전트 솔루션과 연결된 참조를 가져와야 합니다.

Power Automate 흐름 추가

흐름 및 환경 변수를 사용하는 경우 흐름 및 환경 변수에 필요한 개체를 추가합니다.

  1. Copilot Studio 솔루션 탐색기를 사용합니다.

  2. 에이전트가 포함된 솔루션을 선택합니다.

  3. 객체 창에서 작업 흐름을 찾으세요.

  4. 세 개의 점()을 선택하고, 고급을 선택한 다음 필수 객체 추가를 선택하세요.

환경 변수 추가

환경 변수를 추가하려면 다음 단계를 따르세요:

  1. Copilot Studio 솔루션 탐색기를 사용합니다.

  2. 에이전트가 포함된 솔루션을 선택합니다.

  3. 솔루션에 환경 변수가 없는 경우 기존 변수 추가를 선택하고 자세히를 선택한 다음 환경 변수를 선택합니다.

    1. 필요한 환경 변수를 선택하세요.

    2. 다음을 선택한 후 추가를 선택하세요.

  4. 솔루션에 이미 모든 환경 변수가 있는 경우 세 개의 점()을 선택하고 고급을 선택한 다음 필요한 개체 추가 를 선택하여 솔루션에 모든 종속성이 있는지 확인합니다.

관리 솔루션에 맞는 구성 요소를 맞춤화하기

관리되는 솔루션에서 구성 요소를 사용자 지정할 수 있도록 하려면 테이블 관리 속성 보기 및 편집을 참조하세요.

관리형 솔루션을 가져오기 전에 환경이 맞춤화를 허용하는지 확인하세요. 환경이 커스터마이징이나 관리되지 않은 솔루션을 차단하지 않는지 확인하세요. Dataverse의 차단된 비관리 커스터마이징에서 더 알아보세요.

에이전트로 솔루션 내보내기

에이전트를 내보내거나 가져오려면 해당 에이전트가 포함된 솔루션을 한 환경에서 다른 환경으로 내보내고 가져오면 됩니다.

에이전트를 사용하여 솔루션을 내보내려면 다음 단계를 수행합니다.

  1. Copilot Studio 솔루션 탐색기를 사용합니다.

  2. 비관리형 솔루션 목록에서 에이전트가 포함된 솔루션을 선택합니다.

  3. 솔루션 내보내기를 선택합니다. Power Apps export solutions 환경과 마찬가지로 내보내기 전에 오른쪽 창이 나타납니다.

  4. 나머지 단계는 Power Apps 솔루션을 내보내는 경우와 동일합니다. 솔루션을 내보내기를 완료하려면 Power Apps 설명서의 지침과 요구 사항을 따릅니다.

중요

에이전트에 구성 요소가 많은 경우(예: 토픽이 250개가 넘거나 엔터티가 100개가 넘는 경우), 클래식 환경을 사용하여 내보내기를 참조하세요.

에이전트로 솔루션 가져오기

에이전트를 사용하여 솔루션을 다른 환경으로 가져오려면 다음 단계를 수행합니다.

  1. 대상 환경에서 Copilot Studio의 솔루션 탐색기를 엽니다.

  2. 솔루션 가져오기를 선택합니다. Power Apps 임포트 솔루션 환경과 마찬가지로 솔루션 가져오기 오른쪽 창이 나타납니다.

  3. 나머지 단계는 Power Apps 솔루션을 가져오는 경우와 동일합니다. 솔루션 가져오기를 마치려면, Power Apps 설명서의 지침과 요구 사항을 따르십시오.

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

  1. 솔루션 탐색기의 목록에서 가져온 새 솔루션을 선택합니다.

  2. 개체 창에서 에이전트를 선택합니다. 그런 다음 에이전트의 이름을 선택하여 새 탭의 Copilot Studio 에이전트를 엽니다.

  3. 에이전트에 대한 사용자 인증을 다시 구성합니다.

중요

  • 공유하기 전에 가져온 에이전트를 게시해야 합니다.
  • 에이전트의 아이콘이 모든 곳에 나타나는 데 최대 24시간이 걸릴 수 있습니다.

Teams에서 에이전트 내보내기 및 가져오기

Microsoft Teams Power Apps Teams 앱을 사용하여 개별 팀 간에 에이전트를 내보내고 가져올 수 있습니다.

예를 들어 Teams 팀(팀 A)에서 작업 에이전트를 내보낸 다음 팀 B로 가져오는 경우 팀 B를 위해 처음부터 빌드할 필요가 없습니다.

Dataverse for Teams에서 사용자 지정 내보내기의 지침을 따릅니다.

내보낼 사용자 지정을 선택할 때 내보낼 에이전트를 선택합니다. 측면 창의 필터를 사용하여 특정 팀에 대한 에이전트만 표시합니다.

에이전트가 컴퓨터의 다운로드 폴더에 저장됩니다.

Teams로 가져오려면 Dataverse for Teams로 사용자 지정 항목 가져오기의 지침을 따르세요.

당신의 에이전트는 당신이 가져온 팀의 아래에 있는 Teams의 Copilot Studio 앱에 표시됩니다.