agentInstance-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Wichtig

Bevorstehende Änderung an den Agent-Registrierungs-APIs

Ab Mai 2026 werden die Agent-Registrierungs-APIs in Microsoft Graph durch die von Microsoft Agent 365 unterstützten Agent-Registrierungs-APIs ersetzt. Diese Änderung konsolidiert die Agent-Verwaltungsfunktionen, um die Beobachtung, Steuerung und Sicherung aller Agents in Ihrem Mandanten zu vereinfachen. Wir empfehlen, die Migration zu den neuen Agent 365-basierten APIs zu planen, sobald sie veröffentlicht werden. Erfahren Sie mehr über die Konvergenz der Agent-Registrierung mit Microsoft Agent 365.

Stellt eine bestimmte bereitgestellte Instanz eines KI-Agenten in der Microsoft Entra Agent-Registrierung dar. Eine Agent-Instance ist einem agentCardManifest zugeordnet, das ihre Fähigkeiten, Fähigkeiten und Metadaten definiert. Agent-Instanzen können in Sammlungen organisiert werden und werden über die agentRegistry verwaltet.

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
List	agentInstance-Auflistung	Rufen Sie eine Liste der agentInstance-Objekte und ihrer Eigenschaften ab.
Create	agentInstance	Erstellen Sie ein neues agentInstance-Objekt.
Get	agentInstance	Lesen Sie die Eigenschaften und Beziehungen des agentInstance-Objekts .
Update	agentInstance	Aktualisieren Sie die Eigenschaften eines agentInstance-Objekts.
Löschen	Keine	Löschen Sie ein agentInstance-Objekt.

Eigenschaften

Eigenschaft	Typ	Beschreibung
additionalInterfaces	agentInterface-Sammlung	Zusätzliche Schnittstellen/Transporte, die vom Agent unterstützt werden.
agentIdentityBlueprintId	Zeichenfolge	Objekt-ID des agentIdentityBlueprint-Objekts .
agentIdentityId	Zeichenfolge	Objekt-ID des agentIdentity-Objekts .
agentUserId	Zeichenfolge	Objekt-ID des agentUser , der dem Agent zugeordnet ist. Schreibgeschützt.
createdBy	Zeichenfolge	Objekt-ID des Benutzers oder der Anwendung, der bzw. der die Agent-Instance erstellt hat. Schreibgeschützt.
createdDateTime	DateTimeOffset	Zeitstempel, wann die Agent-Instance erstellt wurde. Schreibgeschützt.
displayName	Zeichenfolge	Anzeigename für die Agent-Instance.
id	Zeichenfolge	Eindeutiger Bezeichner für die Agent-instance. Key. Geerbt von entity.
lastModifiedDateTime	DateTimeOffset	Zeitstempel der letzten Änderung.
managedBy	Zeichenfolge	appId (im Microsoft Entra Admin Center als Anwendungs-ID (Client)-ID bezeichnet) der Anwendung, die diesen Agent verwaltet.
originatingStore	Zeichenfolge	Name des Speichers/Systems, aus dem der Agent stammt. Beispiel: Copilot Studio.
ownerIds	Zeichenfolgensammlung	Liste der Objekt-IDs für die Besitzer der Agent-Instance.
preferredTransport	Zeichenfolge	Bevorzugtes Transportprotokoll. Die gültigen Werte sind JSONRPC, GRPC und HTTP+JSON.
Signaturen	agentCardSignature-Sammlung	Digitale Signaturen für die Agent-Instance.
sourceAgentId	Zeichenfolge	Bezeichner des Agents im ursprünglichen Quellsystem.
url	Zeichenfolge	Endpoint URL for the agent instance.

Beziehungen

Beziehung	Typ	Beschreibung
agentCardManifest	agentCardManifest	Das Manifest der Agent-Karte der Agent-Instance.
Sammlungen	agentCollection-Sammlung	Die Agentsammlungen, in denen die Agent-Instance Mitglied ist.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.agentInstance",
  "id": "String (identifier)",
  "ownerIds": [
    "String"
  ],
  "managedBy": "String",
  "originatingStore": "String",
  "createdBy": "String",
  "displayName": "String",
  "sourceAgentId": "String",
  "agentIdentityBlueprintId": "String",
  "agentIdentityId": "String",
  "agentUserId": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "url": "String",
  "preferredTransport": "String",
  "additionalInterfaces": [
    {
      "@odata.type": "microsoft.graph.agentInterface"
    }
  ],
  "signatures": [
    {
      "@odata.type": "microsoft.graph.agentCardSignature"
    }
  ]
}