agentCardManifest-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 die Manifestdefinition für einen KI-Agent dar, einschließlich seiner Funktionen, Fähigkeiten, Sicherheitsanforderungen und Metadaten. Ein Agent Karte Manifest definiert, wie sich ein Agent benutzern und Systemen präsentiert. Diese Ressource wird Agentinstanzen über die Agent-Registrierung zugeordnet.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List agentCardManifest-Sammlung Ruft eine Liste der agentCardManifest-Objekte und deren Eigenschaften ab.
Get agentCardManifest Liest die Eigenschaften und Beziehungen des agentCardManifest-Objekts .
Update agentCardManifest Aktualisieren sie die Eigenschaften eines agentCardManifest-Objekts.

Eigenschaften

Eigenschaft Typ Beschreibung
Fähigkeiten agentCapabilities Eine Deklaration optionaler Funktionen, die vom Agent unterstützt werden.
createdBy Zeichenfolge Objekt-ID des Benutzers oder der Anwendung, der den Agent erstellt hat, Karte Manifest. Schreibgeschützt.
createdDateTime DateTimeOffset Als dieser Agent Karte Manifest erstellt wurde.
defaultInputModes Zeichenfolgensammlung Standardsatz unterstützter Eingabe-MIME-Typen für alle Skills, die pro Skill überschrieben werden können.
defaultOutputModes String collection Standardsatz unterstützter AUSGABE-MIME-Typen für alle Skills, die pro Skill überschrieben werden können.
description Zeichenfolge Eine lesbare Beschreibung des Agents.
displayName Zeichenfolge Ein lesbarer Anzeigename des Agents.
documentationUrl Zeichenfolge URL zur Dokumentation des Agents.
iconUrl Zeichenfolge URL zum Symbolbild des Agents.
id Zeichenfolge ID des Agent-Karte Manifests. Geerbt von entity. Key.
lastModifiedDateTime DateTimeOffset Als dieser Agent Karte Manifest zuletzt geändert wurde.
Managedby Zeichenfolge appId (im Microsoft Entra Admin Center als Anwendungs-ID (Client-ID) bezeichnet) der Anwendung, die dieses Agentmanifest 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-Karte Manifests.
protocolVersion Zeichenfolge Vom Agent unterstützte Protokollversion.
Anbieter agentProvider Informationen zum organization, der den Agent bereitstellt.
Sicherheit securityRequirement-Sammlung Sicherheitsanforderungen: Array von Sicherheitsschemaverweisen.
securitySchemes securitySchemes Wörterbuch der Sicherheitsschemadefinitionen, die anhand des Schemanamens schlüsselt werden.
skills agentSkill-Sammlung Fähigkeiten/Funktionen, die der Agent ausführen kann
supportsAuthenticatedExtendedCard Boolean Gibt an, ob der Agent authentifizierte erweiterte Karte Abruf unterstützt.
Version Zeichenfolge Version der Agent-Implementierung

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.agentCardManifest",
  "id": "String (identifier)",
  "ownerIds": [
    "String"
  ],
  "managedBy": "String",
  "originatingStore": "String",
  "createdBy": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "protocolVersion": "String",
  "displayName": "String",
  "description": "String",
  "iconUrl": "String",
  "provider": {
    "@odata.type": "microsoft.graph.agentProvider"
  },
  "version": "String",
  "documentationUrl": "String",
  "capabilities": {
    "@odata.type": "microsoft.graph.agentCapabilities"
  },
  "securitySchemes": {
    "@odata.type": "microsoft.graph.securitySchemes"
  },
  "security": [
    {
      "@odata.type": "microsoft.graph.securityRequirement"
    }
  ],
  "defaultInputModes": [
    "String"
  ],
  "defaultOutputModes": [
    "String"
  ],
  "skills": [
    {
      "@odata.type": "microsoft.graph.agentSkill"
    }
  ],
  "supportsAuthenticatedExtendedCard": "Boolean"
}
  • Last updated on