Microsoft Copilot Studio 에이전트 인벤토리

Copilot Studio 에이전트 인벤토리는 IT 및 보안 관리자에게 테넌트에서 Copilot Studio 또는 에이전트 작성기를 사용하여 만든 모든 에이전트의 중앙 집중식 보기를 제공합니다. 인벤토리에는 게시되지 않은(초안) 및 게시된 에이전트가 모두 포함됩니다. 각 에이전트에 대해 인벤토리에는 에이전트를 만든 사람, 마지막으로 게시된 시간, 배포된 채널, 사용자를 인증하는 방법, 기능 등과 같은 주요 메타데이터가 표시됩니다. 인벤토리 데이터는 자동으로 새로 고쳐지고 에이전트에 대한 변경 내용은 일반적으로 20분 내에 표시됩니다.

관리자는 Power Platform 관리 센터, Power Platform API 및 Azure Resource Graph 비롯한 여러 방법을 통해 인벤토리 데이터를 사용할 수 있습니다. 액세스 방법 및 필수 역할의 전체 목록은 Power Platform 인벤토리를 참조하세요.

이 문서에서는 Power Platform 인벤토리의 Copilot Studio 에이전트(microsoft.copilotstudio/agents)와 관련된 필드를 설명합니다. 모든 리소스 종류에서 사용할 수 있는 공유 필드는 Power Platform 인벤토리 스키마 참조를 참조하세요.

메모

인벤토리에는 Copilot Studio V1로 만든 에이전트(클래식 봇 또는 Power Virtual Agents라고도 함)가 포함되지 않습니다. 그러나 Power Platform 관리 센터로 이동하여 Manage>Copilot Studio>Classic 챗봇을 선택하여 해당 에이전트를 볼 수 있습니다.

Important

이 문서에는 Microsoft Copilot Studio 미리 보기 설명서가 포함되어 있으며 변경될 수 있습니다.

미리 보기 기능은 프로덕션용이 아니며 기능이 제한되었을 수 있습니다. 이러한 기능은 공식 릴리스 이전에 제공되므로 사용자가 조기에 액세스하고 피드백을 제공할 수 있습니다.

프로덕션이 가능한 에이전트를 빌드하는 경우 Microsoft Copilot Studio 개요를 참조하세요.

에이전트 속성

인벤토리는 각 에이전트에 대해 다음 속성을 제공합니다.

메모

인벤토리는 각 에이전트의 게시된 버전의 구조를 반영합니다. 에이전트에 게시되지 않은 변경 사항(새로운 초안)이 있으면 에이전트가 게시될 때까지 인벤토리에는 해당 변경 사항이 표시되지 않습니다.
에이전트의 구성은 채워지는 필드에 영향을 줍니다. 일부 속성은 에이전트 설정 방법에 따라 달라질 수 있습니다 null . 예를 들어 Agent Builder에서 생성된 에이전트의 경우 isManaged은(는) null입니다.

핵심 속성

API 필드 경로	데이터 형식	Description	Example	상태
`properties.harness`	string	요원의 하네스 종류. Copilot Studio의 Harnesses에서 자세히 알아보세요.	`Standard`	일반적으로 사용 가능
`properties.displayName`	string	에이전트의 표시 이름입니다.	`Customer support agent`	일반적으로 사용 가능
`properties.name`	GUID	특정 Dataverse 환경의 에이전트 ID(CDS 봇 ID)입니다.	`aaaa0000-bb11-2222-33cc-444444dddddd`	일반적으로 사용 가능
`properties.createdAt`	datetime	에이전트가 생성된 날짜 및 시간입니다.	`2024-12-13T04:00:00Z`	일반적으로 사용 가능
`properties.createdBy`	GUID	에이전트를 만든 사용자의 Entra ID.	`aaaa0000-bb11-2222-33cc-444444dddddd`	일반적으로 사용 가능
`properties.ownerId`	string	에이전트의 현재 소유자의 개체 ID(Entra ID)입니다.	`aaaa0000-bb11-2222-33cc-444444dddddd`	일반 공급
`properties.environmentId`	string	리소스를 포함하는 Power Platform 환경의 식별자입니다.	`aaaa0000-bb11-2222-33cc-444444dddddd`	일반적으로 사용 가능
`properties.lastPublishedAt`	datetime	에이전트가 마지막으로 게시된 날짜와 시간입니다. 에이전트가 아직 초안 상태이면 null이거나 비어 있습니다.	`2026-01-15T10:30:00Z`	일반적으로 사용 가능
`properties.createdIn`	string	에이전트가 만들어진 제작 도구: Copilot Studio 또는 Microsoft 365 Copilot 에이전트 작성기.	`Copilot Studio`	일반적으로 사용 가능
`properties.schemaName`	string	Dataverse 스키마 이름입니다. Copilot Studio 에이전트 및 Microsoft 365 Copilot 에이전트 작성기 에이전트에 사용할 수 있습니다.	`cr5e3_agentName`	일반적으로 사용 가능
`properties.isQuarantined`	boolean	에이전트가 현재 격리되었는지 여부입니다.	`false`	Preview
`properties.quarantinedAt`	datetime	에이전트가 마지막으로 격리된 날짜와 시간입니다.	`2026-02-01T08:00:00Z`	Preview
`properties.isManaged`	boolean	에이전트가 관리되는 Dataverse 솔루션의 일부인지 여부입니다. 에이전트 작성기에서 만든 에이전트의 경우 Null입니다.	`false`	Preview

Entra ID 속성

API 필드 경로	데이터 형식	Description	Example	상태
`properties.botId`	string	환경의 CDS 봇 ID입니다.	`aaaa0000-bb11-2222-33cc-444444dddddd`	일반적으로 사용 가능
`properties.entraAppId`	string	에이전트와 연결된 Entra 앱 등록 ID(있는 경우)입니다.	`aaaa0000-bb11-2222-33cc-444444dddddd`	일반적으로 사용 가능
`properties.entraAgentId`	string	Entra 에이전트 ID(존재하는 경우)	`aaaa0000-bb11-2222-33cc-444444dddddd`	일반적으로 사용 가능
`properties.entraAgentBlueprintId`	string	Entra 에이전트 블루프린트 ID(있는 경우)	`aaaa0000-bb11-2222-33cc-444444dddddd`	일반적으로 사용 가능

메모

모든 에이전트 유형에서 모든 ID 속성을 사용할 수 있는 것은 아닙니다. entraAppId는 레거시 식별자이며, 최신 에이전트는 entraAgentId 및 entraAgentBlueprintId를 사용합니다. 이러한 필드는 특정 에이전트에 적용할 수 있는 경우에만 채워집니다. 이러한 ID 속성은 Microsoft 365 Copilot 에이전트 작성기 에이전트에 적용되지 않습니다.

Copilot Studio에서 에이전트 신원 및 인증에 대해 더 알아보세요.

구성 속성

API 필드 경로	데이터 형식	Description	Example	상태
`properties.orchestration`	string	에이전트의 오케스트레이션 모드입니다( 오케스트레이션 모드에서 자세히 알아보기).	`Generative`	Preview
`properties.model`	string	에이전트에서 사용하는 AI 모델입니다.	`gpt-4o`	Preview
`properties.authentication`	string	에이전트에 대해 구성된 인증 모드입니다( 인증 모드에서 자세히 알아보기).	`Microsoft Entra`	Preview
`properties.channels`	배열	에이전트가 게시된 채널의 표시 이름입니다.	`["Teams","SharePoint"]`	Preview
`properties.sharedWithViewers`	object	에이전트가 공유되는 개별 뷰어 사용자(`userCount`) 및 뷰어 그룹(`groupCount`)의 수입니다. 작성자가 에이전트를 전체 테넌트와 공유한 경우, 관리자가 해당 공유를 승인하지 않았더라도 `entireTenant`는 `true`(으)로 설정됩니다.	`"groupCount": 0, "userCount": 0, "entireTenant": false`	Preview
`properties.sharedWithEditors`	object	에이전트가 공유되는 개별 편집기 사용자(`userCount`) 및 편집기 그룹(`groupCount`)의 수입니다.	`"groupCount": 0, "userCount": 0`	Preview
`properties.capabilitiesCounts`	object	구성된 각 기능 유형의 총 고유 개수	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Preview

오케스트레이션 모드

properties.orchestration 필드는 다음 값을 허용합니다.

Value	Description
Classic	에이전트는 만든 대화 트리와 함께 클래식 토픽 기반 오케스트레이션을 사용합니다.
생성적	에이전트는 생성형 오케스트레이션을 사용하며, AI 모델이 토픽과 도구를 동적으로 선택합니다.

인증 모드

properties.authentication 필드는 다음 값을 허용합니다.

Value	Description
None	인증이 필요하지 않습니다.
Microsoft Entra	Microsoft Entra ID를 통한 인증
제네릭 OAuth 2.0	일반 OAuth 2.0 공급자를 통한 인증

에이전트 기능

이 섹션에서는 에이전트의 기능(도구 및 지식)을 나열합니다. 현재는 다음 섹션에 설명된 대로 에이전트에서 사용하는 커넥터 및 기술 구성에 대한 자세한 데이터만 표시합니다.

인벤토리에는 에이전트당 각 유형의 리소스가 최대 200개까지 제한됩니다. 알려진 제한 사항에 대해 자세히 알아보세요.

인벤토리는 동일한 구성을 사용하여 에이전트에서 두 번 구성한 Power Platform 커넥터와 같은 중복 리소스를 자동으로 제거합니다.

커넥터 속성

인벤토리에는 에이전트에 구성된 Power Platform 커넥터가 포함된 배열이 powerPlatformConnectors포함되어 있습니다. 각 커넥터는 해당 connectorId(커넥터의 리소스 ID를 포함하는 문자열, 예: shared_excelonlinebusiness)로 식별됩니다. 구성된 각 커넥터마다 구성된 operations 목록이 있습니다. 목록에는 다음 속성이 포함됩니다.

Property	데이터 형식	Description	상태
`OperationId`	string	커넥터 내의 특정 작업의 ID입니다. 예를 들어 `AddRowV2`	Preview
`createdBy`	GUID	작업을 구성한 사용자	Preview
`isEnabled`	boolean	커넥터 작업이 현재 활성화되어 있는지 여부	Preview
`usedAs`	string	작업 사용 방법: `Tool` 일반 도구로 구성된 경우 `Topic Tool` 특정 항목에서 도구로 구성된 경우 `Knowledge` 커넥터가 지식 소스로 구성된 경우	Preview
`requiresEndUserConsent`	boolean	에이전트가 작업을 사용하기 전에 최종 사용자가 동의해야 하는지 여부	Preview
`whenCanBeUsed`	string	작업을 호출할 수 있는 경우: `Anytime` 제한 없이 에이전트에서 도구를 사용할 수 있는 경우 `ViaDirectReferenceOnly` 작성자가 특정 항목에서 명시적으로 구성한 경우에만 에이전트가 도구를 사용하는 경우 `Conditional` 에이전트가 작성자의 미리 정의된 논리에 따라 도구를 사용할 수 있는 경우	Preview
`connectionProvider`	string	작업에 대한 연결을 제공하는 사람: `User` 최종 사용자가 런타임에 자격 증명을 제공하는 경우 `Maker` 작성자가 작성 시 연결을 설정하는 경우	Preview
`connectionIdSharedByMaker`	GUID	연결 ID, `connectionProvider = Maker`인 경우에만 채워집니다	Preview

Example

{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

지식 속성

인벤토리에는 다음 지식 속성이 포함됩니다.

Property	데이터 형식	Description	상태
`IsWebSearchEnabledForKnowledge`	boolean	에이전트가 웹 검색을 지식 원본으로 사용할 수 있으면 True입니다.	Preview

알려진 제한 사항

V1 에이전트는 추적되지 않습니다. 인벤토리에는 원래 Power Virtual Agents V1 런타임으로 만든 에이전트가 포함되지 않습니다. V2(Copilot Studio) 에이전트만 추적합니다.
모든 에이전트에 신원 속성이 제공되지 않을 수 있음 - entraAgentId 및 entraAgentBlueprintId 필드는 최신 Entra 에이전트 ID 모델로 프로비저닝된 에이전트에만 채워집니다. 이전 에이전트에는 entraAppId만 있을 수 있으며 Microsoft 365 Copilot Agent Builder 에이전트에는 이러한 ID 속성이 없습니다.
기능 수 - 인벤토리에는 에이전트당 각 유형의 리소스가 최대 200개까지 제한됩니다. 에이전트에 특정 형식(예: Power Platform 커넥터)에서 구성된 리소스가 200개 이상 있는 경우 인벤토리에 임의 200이 표시됩니다. 관리자는 필드를 capabilitiesCounts 사용하여 유형별로 에이전트에 구성된 리소스 수를 이해할 수 있습니다.

피드백

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

2026-10-05 에 마지막으로 업데이트됨