copilotPackage-Ressourcentyp

Wichtig

APIs unter der /beta Version können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.

Entität, die ein Copilot-Paket darstellt, das in einem Mandanten verfügbar ist und grundlegende Metadaten und Konfigurationsinformationen für die Paketverwaltung enthält.

Wichtig

Für den Zugriff auf die Paketverwaltungs-API ist eine Microsoft Agent 365-Lizenz erforderlich.

Eigenschaften

Eigenschaft Typ Beschreibung
agentIdentityId Zeichenfolge Die Microsoft Entra-Agent-ID des Agents.
appId Zeichenfolge Zugeordnete Registrierungs-ID der Microsoft Entra AD-Anwendung für dieses Paket.
assetId Zeichenfolge Bezeichner, der verwendet wird, um auf dieses Paket im Asset Store zu verweisen.
availableTo packageAllowStatus Enumerationswert, der angibt, welche Benutzer oder Gruppen innerhalb des Mandanten auf dieses Paket zugreifen können (allowedForAll, allowedForSome, allowedForNone).
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der das Agentpaket erstellt wurde.
deployedTo packageAcquireStatus Enumerationswert, der den aktuellen Bereitstellungsumfang des Pakets innerhalb des Mandanten angibt (acquiredForAll, acquiredForSome, acquiredForNone).
displayName Zeichenfolge Für Menschen lesbarer Name des Pakets, der Benutzern und Administratoren angezeigt wird.
elementTypes String collection Auflistung der in diesem Paket enthaltenen Elementtypen (z. B. bot, declarativeAgent).
governanceMetadata Zeichenfolge Die agentische Klassifizierung des Agents. Mögliche Werte sind: PromptAgent, HostedAgent, WorkflowAgent, ManagedAgentUnmanaged, und AIApp.
id Zeichenfolge Eindeutiger Bezeichner für das Copilot-Paket innerhalb des Mandanten.
isBlocked Boolean Boolesches Flag, das angibt, ob die Verwendung des Pakets innerhalb des Mandanten administrativ blockiert ist.
lastModifiedDateTime DateTimeOffset Zeitstempel der letzten Änderung der Paketkonfiguration oder der Metadaten.
manifestId Zeichenfolge Eindeutiger Bezeichner, der im Paketmanifest deklariert ist. Nach der Erstellung nicht aktualisierbar.
manifestVersion Zeichenfolge Version des Manifestschemas, das zum Definieren dieses Pakets verwendet wird. Nach der Erstellung nicht aktualisierbar.
platform Zeichenfolge Die Hostplattform, auf die dieses Paket abzielt (z. B. teams, outlook, web). Unterstützt $filter mit EQ.
publisher Zeichenfolge Name der organization oder Entität, die dieses Paket veröffentlicht hat.
requestStatus copilotPackageRequestStatus Nullwerte zulassend. Status der diesem Paket zugeordneten Anforderung. Unterstützt $filter mit eqon List-Paketen.
requestType copilotPackageRequestType Nullwerte zulassend. Die Art der Anforderung, die diesem Paket zugeordnet ist. Unterstützt $filter mit eqon List-Paketen.
shortDescription Zeichenfolge Kurze Beschreibung mit einem Überblick über Funktionalität und Zweck des Pakets.
supportedHosts String collection Sammlung von Hostanwendungen, in denen dieses Paket verwendet werden kann (z. B. teams, outlook, sharePoint).
type packageType Die Typklassifizierung des Pakets, die angibt, ob es sich um ein Erstanbieter-, Drittanbieter-, freigegebenes oder branchenspezifisches Paket handelt.
version Zeichenfolge Versionszeichenfolge des Pakets (z. B 1.2.3. ). Nach der Erstellung nicht aktualisierbar.
zipFile Stream Die Copilot-Paketdatei.

copilotPackageRequestStatus-Enumeration

Wert Beschreibung
pending Die Anfrage ist geöffnet und wartet darauf, dass ein Administrator darauf reagiert.
approved Ein Administrator hat die Anforderung genehmigt.
rejected Ein Administrator hat die Anfrage abgelehnt.
unknownFutureValue Evolvierbarer Sentinelwert.

copilotPackageRequestType-Enumeration

Wert Beschreibung
publish Ein Benutzer bat darum, dass ein neues Paket im Katalog der organization veröffentlicht werden soll.
activate Ein Benutzer hat darum gebeten, ein Paket, das im Katalog vorhanden ist, für die Verwendung zu aktivieren.
access Ein Benutzer hat Zugriff auf ein Paket angefordert, das bereits in der organization aktiv ist.
update Ein Benutzer bat darum, ein bereits veröffentlichtes Paket auf eine neuere Version zu aktualisieren.
unknownFutureValue Evolvierbarer Sentinelwert.

packageAllowStatus-Enumeration

Wert Beschreibung
allowedForNone Nicht für Benutzer verfügbar.
allowedForSome Für einige Benutzer/Gruppen verfügbar.
allowedForAll Für alle Benutzer verfügbar.
unknownFutureValue Evolvierbarer Sentinelwert.

packageAcquireStatus-Enumeration

Wert Beschreibung
acquiredForNone Keinem Benutzer bereitgestellt.
acquiredForSome Für einige Benutzer/Gruppen bereitgestellt.
acquiredForAll Für alle Benutzer bereitgestellt.
unknownFutureValue Evolvierbarer Sentinelwert.

packageType-Enumeration

Wert Beschreibung
microsoft Erstellt von Microsoft.
external Gebaut von Partnern.
shared In Ihrer organization freigegeben.
custom Erstellt von Ihrer organization.
unknownFutureValue Evolvierbarer Sentinelwert.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.copilotPackage",
  "agentIdentityId": "String",
  "appId": "String",
  "assetId": "String",
  "availableTo": "String",
  "createdDateTime": "DateTimeOffset",
  "deployedTo": "String",
  "displayName": "String",
  "elementTypes": ["String"],
  "governanceMetadata": "String",
  "id": "String",
  "isBlocked": "Boolean",
  "lastModifiedDateTime": "DateTimeOffset",
  "manifestId": "String",
  "manifestVersion": "String",
  "platform": "String",
  "publisher": "String",
  "requestStatus": "String",
  "requestType": "String",
  "shortDescription": "String",
  "supportedHosts": ["String"],
  "type": "String",
  "version": "String",
  "zipFile": "Stream"
}