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"
    }
  ]
}
  • Last updated on