Erweiterte Metadatenschemas

Auf dieser Seite finden Sie einen Katalog der unterstützten Schemas für die Eigenschaft für erweiterte Metadaten für Dienste und Arbeitslasten. Erweiterte Metadaten fügen App Hub-Anwendungskomponenten umfangreiche, strukturierte Daten hinzu und bieten Kontext für Governance, Vorgänge und die Integration in andere Systeme.

Jedes Schema wird durch einen eindeutigen Schlüssel identifiziert und definiert die Struktur und die Felder für einen bestimmten Metadatentyp.

apphub.googleapis.com/AgentProperties

Dieses Schema wird verwendet, um die Eigenschaften eines KI-Agents zu beschreiben, damit andere Systeme ihn finden und verstehen können. Sie wird in der Regel auf Arbeitslasten angewendet, deren property den funktionalen Typ AGENT hat. Das Schema ist mit der Agent2Agent-Agentenkarte (A2A) kompatibel.

Schemadefinition

Im Folgenden finden Sie das Schema für diesen Metadatentyp im JSON-Format.

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "apphub.googleapis.com/AgentProperties",
  "description": "The schema for apphub.googleapis.com/AgentProperties. Except for framework, the properties are derived from the A2A Agent Card.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "displayName": {
      "type": "string",
      "description": "The display name of the agent."
    },
    "description": {
      "type": "string",
      "description": "The description of the agent."
    },
    "version": {
      "type": "string",
      "description": "Contains the version of the Agent."
    },
    "framework": {
      "type": "string",
      "description": "The agent framework used to develop the agent."
    },
    "agentCardUri": {
      "type": "string",
      "description": "The URI of the agent card for the agent."
    },
    "skills": {
      "type": "array",
      "description": "A list of skills the agent possesses.",
      "items": {
        "type": "object",
        "title": "Skills",
        "description": "Defines a skill for an agent.",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "description": "A unique identifier for the agent's skill."
          },
          "name": {
            "type": "string",
            "description": "A human readable name for the agent's skill."
          },
          "description": {
            "type": "string",
            "description": "A description of the agent's skill."
          },
          "tags": {
            "type": "array",
            "description": "A set of keywords describing the skill's capabilities.",
            "items": {
              "type": "string"
            }
          },
          "examples": {
            "type": "array",
            "description": "Example prompts or scenarios that this skill can handle.",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}

Feldbeschreibungen

Feld Typ Beschreibung
displayName string Der Anzeigename des Agents.
description string Die Beschreibung des Agents.
version string Die Version des Agents.
framework string Das Framework, das zum Entwickeln des KI-Agenten verwendet wurde.
agentCardUri string Der URI der Agentenkarte für den Agenten.
skills array Eine Liste der Fähigkeiten des Agents.
skills.id string Eine eindeutige Kennung für die Fähigkeit des Agents.
skills.name string Ein für Menschen lesbarer Name für die Fähigkeit des Agenten.
skills.description string Eine Beschreibung der Fähigkeit des Agents.
skills.tags array von string Eine Reihe von Keywords, die die Funktionen des Skills beschreiben.
skills.examples array von string Beispielhafte Prompts oder Szenarien, die diese Skill verarbeiten kann.