Zasoby agenta w funkcji Microsoft Copilot Studio

Dowiedz się więcej o rejestrze agentów Copilot Studio, który zapewnia administratorom IT i bezpieczeństwa scentralizowany widok wszystkich agentów utworzonych w Copilot Studio lub Agent Builder w dzierżawcy. Inwentarz obejmuje zarówno agentów w wersji roboczej (nieopublikowanych), jak i opublikowanych. Dla każdego agenta rejestr wyświetla kluczowe metadane, takie jak: kto utworzył agenta, kiedy został ostatnio opublikowany, do jakich kanałów został wdrożony, w jaki sposób uwierzytelnia użytkowników, jakie posiada możliwości i inne informacje. Dane inwentarza są odświeżane automatycznie, a zmiany dotyczące agenta zazwyczaj pojawiają się w ciągu 20 minut.

Administratorzy mają dostęp do danych inwentarza za pośrednictwem różnych metod, w tym centrum administracyjnego Power Platform, interfejsu API Power Platform oraz Azure Resource Graph. Pełną listę metod dostępu i wymaganych ról znajdziesz w inwentarzu Power Platform.

Ten artykuł opisuje pola specyficzne dla agentów Copilot Studio (microsoft.copilotstudio/agents) w inwentarzu 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.

Notatka

Inwentarz nie obejmuje agentów utworzonych przy użyciu wersji V1 Copilot Studio (znanych również jako klasyczne boty lub Power Virtual Agents). Możesz jednak nadal przejść do centrum administratora Power Platform i wybrać Zarządzaj>Copilot Studio>Klasyczne czatboty, aby zobaczyć tych agentów.

Ważne

Ten artykuł zawiera dokumentację usługi Microsoft Copilot Studio w wersji zapoznawczej i może ulec zmianie.

Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu można szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Jeśli kompilowany jest agent gotowy do użycia w środowiskach produkcyjnych, zobacz temat Omówienie usługi Microsoft Copilot Studio (produkcja).

Właściwości agenta

Inwentarz zawiera następujące nieruchomości dla każdego agenta.

Notatka

  • Spis odzwierciedla strukturę opublikowanej wersji każdego agenta. Jeśli agent ma nieopublikowane zmiany (nowszą wersję roboczą), spis zasobów nie zawiera tych zmian, dopóki agent nie zostanie opublikowany.

  • Konfiguracja agenta wpływa na to, które pola są wypełniane. Niektóre właściwości mogą być null w zależności od konfiguracji agenta. Na przykład, isManaged to null dla agentów utworzonych w Agent Builder.

Właściwości podstawowe

Ścieżka pola interfejsu API Typ danych Podpis Przykład Stan
properties.displayName string Nazwa wyświetlana agenta. Customer support agent Ogólnie dostępne
properties.name GUID Identyfikator agenta w konkretnym środowisku Dataverse (identyfikator bota CDS). aaaa0000-bb11-2222-33cc-444444dddddd Ogólnie dostępne
properties.createdAt datetime Data i godzina utworzenia agenta. 2024-12-13T04:00:00Z Ogólnie dostępne
properties.createdBy GUID Identyfikator użytkownika Entra, który utworzył agenta. aaaa0000-bb11-2222-33cc-444444dddddd Ogólnie dostępne
properties.ownerId string Identyfikator obiektu (Entra ID) aktualnego właściciela agenta. aaaa0000-bb11-2222-33cc-444444dddddd Ogólnie dostępne
properties.environmentId string Identyfikator środowiska Power Platform, w którym znajduje się ten zasób. aaaa0000-bb11-2222-33cc-444444dddddd Ogólnie dostępne
properties.lastPublishedAt datetime Data i godzina opublikowania agenta. Wartość pusta/null, jeśli agent jest nadal w wersji roboczej. 2026-01-15T10:30:00Z Ogólnie dostępne
properties.createdIn string Narzędzie autorskie, w którym utworzono agenta: Copilot Studio lub Microsoft 365 Copilot Agent Builder. Copilot Studio Ogólnie dostępne
properties.schemaName string Nazwa schematu usługi Dataverse. Dostępne dla agentów Copilot Studio oraz agentów Microsoft 365 Copilot Agent Builder. cr5e3_agentName Ogólnie dostępne
properties.isQuarantined wartość logiczna Czy agent jest obecnie objęty kwarantanną. false Wersja zapoznawcza
properties.quarantinedAt datetime Data i godzina objęcia agenta kwarantanną. 2026-02-01T08:00:00Z Wersja zapoznawcza
properties.isManaged wartość logiczna Wskazuje, czy agent jest częścią rozwiązania zarządzanego Dataverse. Null dla agentów utworzonych w Agent Builder. false Wersja zapoznawcza

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

Ścieżka pola interfejsu API Typ danych Podpis Przykład Stan
properties.botId string Identyfikator bota usługi CDS w środowisku. aaaa0000-bb11-2222-33cc-444444dddddd Ogólnie dostępne
properties.entraAppId string Identyfikator rejestracji aplikacji Entra powiązany z agentem, jeśli istnieje. aaaa0000-bb11-2222-33cc-444444dddddd Ogólnie dostępne
properties.entraAgentId string Identyfikator strategii agenta usługi Entra, jeśli istnieje. aaaa0000-bb11-2222-33cc-444444dddddd Ogólnie dostępne
properties.entraAgentBlueprintId string Identyfikator strategii agenta usługi Entra, jeśli istnieje. aaaa0000-bb11-2222-33cc-444444dddddd Ogólnie dostępne

Notatka

Nie wszystkie właściwości tożsamości są dostępne dla wszystkich typów agentów: entraAppId to identyfikator dziedziczny, nowsze agenty używają entraAgentId oraz entraAgentBlueprintId. Pola te są wypełniane tylko wtedy, gdy mają zastosowanie do konkretnego agenta. Żadna z tych właściwości tożsamości nie dotyczy agentów Microsoft 365 Copilot Agent Builder.

Aby dowiedzieć się więcej o koncepcjach tożsamości Entra, zobacz Rejestracja aplikacji, tożsamości agentów i uwierzytelnianie w Copilot Studio.

Konfiguracja właściwości

Ścieżka pola interfejsu API Typ danych Podpis Przykład Stan
properties.orchestration string Tryb orkiestracji agenta (dowiedz się więcej w części Tryby orkiestracji). Generative Wersja zapoznawcza
properties.model string Model AI używany przez agenta. gpt-4o Wersja zapoznawcza
properties.authentication string Tryb uwierzytelniania skonfigurowany dla agenta (więcej informacji w Tryby uwierzytelniania). Microsoft Entra Wersja zapoznawcza
properties.channels tablica Nazwy wyświetlane kanałów, na których agent jest publikowany. ["Teams","SharePoint"] Wersja zapoznawcza
properties.sharedWithViewers obiekt Liczba indywidualnych użytkowników z uprawnieniami do wyświetlania (userCount) oraz grup z uprawnieniami do wyświetlania (groupCount), z którymi agent został udostępniony Jeśli twórca udostępnił agenta całej dzierżawie, entireTenant ma wartość true, nawet jeśli administrator nie zatwierdził tego udostępnienia. "groupCount": 0, "userCount": 0, "entireTenant": false Wersja zapoznawcza
properties.sharedWithEditors obiekt Liczba użytkowników z uprawnieniami edytora (userCount) oraz grup edytorów (groupCount), z którymi agent został udostępniony. "groupCount": 0, "userCount": 0 Wersja zapoznawcza
properties.capabilitiesCounts obiekt Łączna liczba unikatowych funkcji każdego typu skonfigurowanych możliwości "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Wersja zapoznawcza

Orkiestracja modułów

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

Value Podpis
Klasyczny Agent wykorzystuje klasyczną orkiestrację tematyczną z autorskimi drzewami dialogowymi.
Generatywna Agent używa orkiestracji generatywnej, w której model AI dynamicznie wybiera tematy i działania.

Modele uwierzytelniania

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

Value Podpis
None Nie jest wymagane uwierzytelnianie.
Microsoft Entra Uwierzytelnianie za pomocą identyfikatora Microsoft Entra ID.
Ogólne uwierzytelnianie OAuth 2.0 Uwierzytelnianie za pośrednictwem ogólnego dostawcy OAuth 2.0.

Możliwości agenta

Ta sekcja wymienia możliwości (narzędzia i wiedzę) agenta. Obecnie wyświetla tylko szczegółowe dane dotyczące złącz używanych przez agenta oraz konfigurację wiedzy, jak opisano w poniższych sekcjach.

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

Inwentarz automatycznie usuwa zduplikowane zasoby, takie jak złącze Power Platform, które skonfigurowałeś dwukrotnie w agencie z tą samą konfiguracją.

Właściwości łącznika

Inwentarz obejmuje tablicę o nazwie powerPlatformConnectors, w której znajdują się złącza Power Platform skonfigurowane w agencie. Każde złącze jest identyfikowane przez jego connectorId (ciąg znaków zawierający identyfikator zasobu złącza; na przykład shared_excelonlinebusiness). Dla każdego skonfigurowanego łącznika istnieje lista skonfigurowanych elementów operations. Lista następujące właściwości:

Właściwość Typ danych Podpis Stan
OperationId string ID konkretnej operacji w złączu; na przykład AddRowV2 Wersja zapoznawcza
createdBy GUID Użytkownik, który skonfigurował operację Wersja zapoznawcza
isEnabled wartość logiczna Czy działanie złącza jest obecnie włączone Wersja zapoznawcza
usedAs string Sposób wykorzystania operacji:
  • Tool jeśli jest skonfigurowany jako ogólne narzędzie
  • Topic Tool jeśli jest skonfigurowane jako narzędzie w określonym temacie
  • Knowledge jeśli złącze zostało skonfigurowane jako źródło wiedzy
 Wersja zapoznawcza
requiresEndUserConsent wartość logiczna Czy użytkownicy końcowi muszą uzyskać zgodę, zanim agent będzie mógł użyć operacji Wersja zapoznawcza
whenCanBeUsed string Gdy operacja może być wywołana:
  • Anytime jeśli narzędzie jest dostępne dla agenta bez ograniczeń
  • ViaDirectReferenceOnly, jeśli agent używa narzędzia tylko wtedy, gdy twórca wyraźnie skonfigurował to w określonych tematach
  • Conditional jeśli agent może korzystać z narzędzia według z góry określonej logiki twórcy
 Wersja zapoznawcza
connectionProvider string Kto zapewnia połączenie dla operacji:
  • User jeśli użytkownik końcowy podaje dane uwierzytelniające podczas działania
  • Maker jeśli twórca konfiguruje połączenie na etapie tworzenia
 Wersja zapoznawcza
connectionIdSharedByMaker GUID ID połączenia, wypełniany tylko wtedy, gdy connectionProvider = Maker Wersja zapoznawcza
Przykład
{
  "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 dotyczące wiedzy

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

Właściwość Typ danych Podpis Stan
IsWebSearchEnabledForKnowledge wartość logiczna Wartość jest prawdą, jeśli agent może wykorzystywać wyszukiwanie internetowe jako źródło wiedzy Wersja zapoznawcza

Znane ograniczenia

  • Agenci V1 nie są śledzeni – inwentarz nie obejmuje agentów utworzonych w oryginalnym środowisku uruchomieniowym Power Virtual Agents V1. Inwentarz ś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 tożsamości agenta Entra. Starsze agenty mogą mieć tylko identyfikator entraAppId, a agenty kreatora 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 konektorów Power Platform), inwentarz wyświetla losowo wybrane 200 zasobów. Administratorzy mogą użyć capabilitiesCounts tego pola, aby zrozumieć, ile zasobów jest skonfigurowanych w agencie na typ.

Powiązana zawartość

  • Last updated on