Update agentRegistration

Wichtig

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

Aktualisieren eines agentRegistration-Objekts .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) AgentRegistration.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application AgentRegistration.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

PATCH https://graph.microsoft.com/beta/copilot/agentRegistrations/{id}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der Eigenschaften an, die für das agentRegistration-Objekt aktualisiert werden sollen.

Eigenschaft Typ Beschreibung
agentCard Json Flexibles JSON-Manifest mit Agent-Karte Informationen. Optional.
agentIdentityBlueprintId Zeichenfolge Agent-Identitäts-Blaupausenbezeichner. Optional.
agentIdentityId Zeichenfolge Entra Agent-Identitätsbezeichner. Optional.
description Zeichenfolge Die Agentbeschreibung. Optional.
displayName Zeichenfolge Anzeigename für den Agent-instance. Optional.
lastPublishedBy Zeichenfolge Der eindeutige Bezeichner der letzten Person, die den Agent veröffentlicht hat. Optional.
managedByAppId Zeichenfolge Anwendungsbezeichner, der diesen Agent verwaltet. Optional.
originatingStore Zeichenfolge Name des Speichers oder Systems, aus dem bzw. dem der Agent stammt. Optional.
ownerIds String collection Liste der Besitzerbezeichner für den Agent. Optional.
sourceAgentId Zeichenfolge Ursprünglicher Agentbezeichner aus dem Quellsystem. Optional.
sourceLastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu dem der Agent instance zuletzt aus der Quelle geändert wurde. Optional.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 200 OK zurückgegeben. Es gibt nichts im Antworttext zurück.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/beta/copilot/agentRegistrations/550e8400-e29b-41d4-a716-446655440000
Content-Type: application/json

{
  "displayName": "Contoso Sales Assistant",
  "description": "AI-powered sales assistant that integrates with Contoso CRM",
  "ownerIds": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
  • Last updated on