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 Agent-Registrierungs-APIs

Ab Mai 2026 werden die Agent-Registrierungs-APIs in Microsoft Graph durch die Agent-Registrierungs-APIs ersetzt, die von Microsoft Agent 365 unterstützt werden. Durch diese Änderung wird die Agentverwaltung konsolidiert, um die Beobachtung, Steuerung und Sicherung aller Agents in Ihrem Mandanten zu vereinfachen. Es wird empfohlen, die Migration zu den neuen Agent 365-basierten APIs zu planen, wenn diese veröffentlicht werden. Erfahren Sie mehr über die Konvergenz der Agentregistrierung mit Microsoft Agent 365.

Stellt einen bestimmten bereitgestellten instance eines KI-Agents in der Microsoft Entra-Agent-Registrierung dar. Ein Agent instance einem agentCardManifest zugeordnet ist, der seine Funktionen, Fähigkeiten und Metadaten definiert. Agent-Instanzen können in Sammlungen organisiert werden und werden über agentRegistry verwaltet.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List agentInstance-Sammlung Ruft eine Liste der agentInstance-Objekte und deren Eigenschaften ab.
Create agentInstance Erstellen Sie ein neues agentInstance-Objekt.
Get agentInstance Liest 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 den Agent instance erstellt hat. Schreibgeschützt.
createdDateTime DateTimeOffset Zeitstempel beim Erstellen instance des Agents. Schreibgeschützt.
displayName Zeichenfolge Anzeigename für den Agent-instance.
id Zeichenfolge Eindeutiger Bezeichner für den Agent-instance. Key. Geerbt von entity.
lastModifiedDateTime DateTimeOffset Zeitstempel der letzten Änderung.
Managedby Zeichenfolge appId (auf der Microsoft Entra Admin Center als Anwendungs-ID (Client-ID) bezeichnet) der Anwendung, die diesen Agent verwaltet.
originatingStore Zeichenfolge Name des Speichers/Systems, aus dem/dem der Agent stammt. Beispiel: Copilot Studio.
ownerIds String collection Liste der Objekt-IDs für die Besitzer des Agent-instance.
preferredTransport Zeichenfolge Bevorzugtes Transportprotokoll. Die gültigen Werte sind JSONRPC, GRPC und HTTP+JSON.
Signaturen agentCardSignature-Sammlung Digitale Signaturen für den Agent instance.
sourceAgentId Zeichenfolge Bezeichner des Agents im ursprünglichen Quellsystem.
url Zeichenfolge Endpunkt-URL für den Agent-instance.

Beziehungen

Beziehung Typ Beschreibung
agentCardManifest agentCardManifest Der Agent Karte Manifest des Agent-instance.
Sammlungen agentCollection-Sammlung Die Agentsammlungen, in denen der 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"
    }
  ]
}
  • Last updated on