spis agentów Microsoft Copilot Studio

Spis agentów Copilot Studio zapewnia administratorom IT i administratorom zabezpieczeń scentralizowany widok wszystkich agentów utworzonych przy użyciu Copilot Studio lub Agent Builder w dzierżawie. Inwentarz obejmuje zarówno nieopublikowanych agentów (wersje robocze), jak i opublikowanych agentów. Dla każdego agenta lista wyświetla kluczowe metadane, takie jak kto utworzył agenta, kiedy został on ostatnio opublikowany, na jakich kanałach został wdrożony, jak uwierzytelnia użytkowników, jakie ma możliwości i nie tylko. Dane inwentaryzacji są automatycznie odświeżane, a zmiany dotyczące agenta zwykle pojawiają się w ciągu 20 minut.

Administratorzy mogą korzystać z danych spisu za pomocą wielu metod, w tym centrum administracyjnego platformy Power Platform, interfejsu API platformy Power Platform i Azure Resource Graph. Aby uzyskać pełną listę metod dostępu i wymaganych ról, zobacz Spis platformy Power Platform.

W tym artykule opisano pola specyficzne dla agentów programu Copilot Studio (microsoft.copilotstudio/agents) w spisie platformy Power Platform. Aby uzyskać informacje o polach udostępnionych dostępnych dla wszystkich typów zasobów, zobacz dokumentację schematów zasobów Power Platform.

Właściwości agenta

Spis zawiera następujące właściwości dla każdego agenta.

Właściwości podstawowe

Właściwości tożsamości usługi Entra

Dowiedz się więcej w Tożsamości agentów i uwierzytelnianiu w Copilot Studio.

Właściwości konfiguracji

Tryby orkiestracji

Pole properties.orchestration akceptuje następujące wartości:

Tryby uwierzytelniania

Pole properties.authentication akceptuje następujące wartości:

Możliwości agenta

W tej sekcji wymieniono możliwości (narzędzia i wiedzę) agenta. Obecnie wyświetla tylko szczegółowe dane dotyczące łączników używanych przez agenta i konfigurację wiedzy zgodnie z opisem w poniższych sekcjach.

Inwentarz jest ograniczony do maksymalnie 200 zasobów każdego typu dla każdego agenta. Dowiedz się więcej w artykule Znane ograniczenia.

Inwentaryzacja automatycznie usuwa zduplikowane zasoby, takie jak łącznik usługi Power Platform, który został dwukrotnie skonfigurowany w agencie z tą samą konfiguracją.

Właściwości łącznika

Spis zawiera tablicę o nazwie powerPlatformConnectors, która zawiera łączniki platformy Power Platform skonfigurowane w agencie. Każdy łącznik jest identyfikowany przez swoje connectorId (ciąg zawierający identyfikator zasobu łącznika; na przykład shared_excelonlinebusiness). Dla każdego skonfigurowanego łącznika istnieje lista skonfigurowanych elementów operations. Lista zawiera następujące właściwości:

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
    }
  }
}

Właściwości wiedzy

Inwentarz zawiera następującą właściwość dla wiedzy:

Znane ograniczenia

• Agenci V1 nie są monitorowani — spis zasobów nie obejmuje agentów utworzonych w oryginalnym środowisku uruchomieniowym Power Virtual Agents V1. Śledzi tylko agentów V2 (Copilot Studio).
• Właściwości tożsamości mogą nie być dostępne dla wszystkich agentów – pola entraAgentId i entraAgentBlueprintId są uzupełniane tylko dla agentów skonfigurowanych z użyciem nowszego modelu identyfikatora agenta Entra. Starsze agenty mogą mieć tylko identyfikator entraAppId, a agenty konstruktora agentów funkcji Microsoft 365 Copilot nie mają żadnej z tych właściwości tożsamości.
• Liczba funkcji — spis jest ograniczony do maksymalnie 200 zasobów każdego typu na agenta. Jeśli agent ma więcej niż 200 skonfigurowanych zasobów danego typu (na przykład konektory Power Platform), spis zasobów wyświetla losowo wybrane 200. Administratorzy mogą użyć pola capabilitiesCounts, aby sprawdzić, ile zasobów skonfigurowano w agencie, z podziałem na typy.

Treści powiązane

• Inwentarz Power Platform
• Odwołanie do schematu inwentaryzacji Power Platform
• Interfejs API inwentarza platformy Power Platform