Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
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"
}
]
}