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.
Agent-Metadaten dienen als Grundlage für die Agent-Auffindbarkeit innerhalb der Microsoft Entra Agent Registry. Die von Ihnen bereitgestellten Metadaten bestimmen, wie andere Agents, Anwendungen und Benutzer mit Ihrem Agent suchen und interagieren können. Das Verständnis des Metadatenschemas und seiner Beziehung zum Auflistungsmodell stellt sicher, dass Ihre Agents von der vorgesehenen Zielgruppe auffindbar sind und gleichzeitig angemessene Sicherheitsgrenzen beibehalten werden.
Agent-Metadatenschema
Das Agentmetadatenschema definiert die Informationsstruktur, die für die Agent-Auffindbarkeit und Interaktion erforderlich ist. Dieses Schema ermöglicht die Zusammenarbeit von Agents über Standardprotokolle, während es mit Microsoft Entra-spezifischen Funktionen für erhöhte Sicherheit erweitert wird.
Grundlegende Agentinformationen
Die grundlegenden Metadaten umfassen wesentliche Identifikations- und Kontaktinformationen für Ihren Agenten.
| Feld | Description |
|---|---|
id |
Eindeutiger Bezeichner für das Agentmanifest. Erforderlich für alle Agentregistrierungen. |
displayName |
Menschlich lesbarer Bezeichner, der in Entdeckungsergebnissen angezeigt wird. Sollte eindeutig auf den Zweck des Agenten hinweisen, z. B. "Kundendienstassistent" oder "Rechnungsverarbeitungsmitarbeiter". |
description |
Umfassende Details über den Zweck und die Funktionen des Agenten. Fügen Sie relevante Schlüsselwörter hinzu, die Ihre Zielgruppe bei der Suche nach diesem Agenttyp natürlich verwenden würde, was sich direkt auf die Auffindbarkeit auswirkt. |
iconUrl |
DIE URL zum Symbolbild des Agents, das visuelle Identifikation in Ermittlungsergebnissen und Benutzeroberflächen bereitstellt. |
version |
Version der Agentimplementierung, die die Nachverfolgung von Agentupdates und Kompatibilitätsüberlegungen für Integrationsszenarien ermöglicht. |
documentationUrl |
URL zur Dokumentation des Agents. Fügen Sie Links zu detaillierten API-Dokumentationen, Verwendungsbeispielen und Anleitungen zur Problembehandlung ein, um die erfolgreiche Agentakzeptanz zu unterstützen. |
protocolVersion |
Die vom Agent unterstützte Protokollversion stellt die Kompatibilität mit Clients und anderen Agents während der Kommunikation sicher. |
provider |
Informationen zur Organisation, die den Agent bereitstellt, einschließlich Organisationsname und Kontakt-URL. Hilft bei der Identifizierung der Quelle von Agents während der Ermittlung und stellt Überprüfungspunkte für die Agent-Authentizität bereit. |
managedBy |
Der Anwendungsbezeichner, der dieses Manifest verwaltet, etabliert eindeutiges Eigentum und Zuständigkeit für den Lebenszyklus und die Konfiguration des Agents. |
originatingStore |
Name des Speichers oder Systems, von dem der Agent stammt, hilft dabei, die Herkunft und die Quellen des Agents innerhalb der Registrierung nachzuverfolgen. |
Metadaten zu Fähigkeiten und Funktionen
Die Kernfunktionen und Interaktionsfunktionen, die Ihr Agent bereitstellt.
| Feld | Description |
|---|---|
skills |
Kernfunktionen, die Ihr Agent bereitstellt. Jede Fähigkeit erfordert einen eindeutigen Bezeichner, einen beschreibenden Namen und eine detaillierte Beschreibung, die erklärt, was die Fähigkeiten erreichen. Bestimmt direkt die Auffindbarkeit in funktionsbasierten Suchvorgängen. |
defaultInputModes |
Vom Agent unterstützte Standardeingabemodi. Verwenden Sie konsistente MIME-Typspezifikationen wie "text/plain", "application/json" oder "image/png", um einen ordnungsgemäßen Abgleich mit Clientanwendungen sicherzustellen. |
defaultOutputModes |
Vom Agent unterstützte Standardausgabemodi. Geben Sie die von Ihrem Agenten erzeugten Datenformate an, um die automatische Kompatibilitätsprüfung bei der Agentenerkennung zu ermöglichen. |
capabilities |
Technische Features, die Ihr Agent für Integrationsprotokolle unterstützt. |
capabilities.extensions |
Erweiterungsfunktionen, die Eigenschaften wie URI, Beschreibung, erforderlicher Status und Parameter enthalten. Wirkt sich auf die Interaktion anderer Agents und Anwendungen mit Ihrem Agent in Verbundszenarien aus. |
Sicherheits- und Anbieterinformationen
Sicherheits- und Authentifizierungsanforderungen, die sich auf die Auffindbarkeit, Vertrauensstellung und Zugriffsrichtlinien auswirken. Sicherheits- und Anbieterinformationen wirken sich direkt darauf aus, wie die Microsoft Entra Agent-Registrierung Sammlungszuweisungs- und Ermittlungsrichtlinien auf Ihren Agent anwendet und diese Felder für die ordnungsgemäße Verwaltung und Compliance kritisch macht.
| Feld | Description |
|---|---|
securitySchemes |
Wörterbuch der Sicherheitsschemadefinitionen, die nach Schemanamen schlüsseliert sind und die Authentifizierungsmethoden angeben, die Ihr Agent unterstützt. Stellt sicher, dass Ihr Agent in Ermittlungsergebnissen nur für Clients angezeigt wird, die die Authentifizierungsanforderungen erfüllen können. |
security |
Array von Sicherheitsschemareferenzen, die für verschiedene Vorgänge geltend sind. Definiert Sicherheitsanforderungen, die fehlgeschlagene Integrationsversuche verhindern und die Benutzererfahrung verbessern, indem inkompatible Übereinstimmungen während der Ermittlung gefiltert werden. |
signatures |
Digitale Signaturen für das Manifest, einschließlich geschützter Inhalte, Signaturwerte und Headerinformationen zur Überprüfung der Manifestintegrität und Authentizität. |
supportsAuthenticatedExtendedCard |
Gibt an, ob Ihr Agent weitere Metadaten für authentifizierte Anrufer bereitstellt. Ermöglicht die progressive Offenlegung von Informationen, bei denen grundlegende Funktionen öffentlich auffindbar sind, während detaillierte betriebstechnische Informationen eine Authentifizierung erfordern. |
ownerIds |
Liste der Besitzer-IDs, die über die Autorität für das Agentmanifest verfügen. |
Sammlungen und Auffindbarkeit
Sammlungen bestimmen, welche Agenten einander entdecken und Kommunikationskanäle einrichten können. Agents müssen von Administratoren oder durch definierte Organisationsrichtlinien explizit Sammlungen zugewiesen werden. Es gibt keine automatischen Zuordnungen, die auf Metadatentags oder Agentmerkmalen basieren. Dieses explizite Zuweisungsmodell stellt eine ordnungsgemäße Governance und Sicherheitskontrollen über die Erkennungs- und Interaktionsmuster des Agents sicher.
Umfassende Informationen zu Sammlungstypen, Zuordnungsregeln und Ermittlungsrichtlinien finden Sie unter Agent-Registrierungssammlungen.