Schémas de métadonnées étendus

Cette page fournit un catalogue des schémas compatibles pour la propriété de métadonnées étendues sur les services et les charges de travail. Les métadonnées étendues ajoutent des données structurées et enrichies aux composants d'application App Hub, ce qui fournit du contexte pour la gouvernance, les opérations et l'intégration à d'autres systèmes.

Chaque schéma est identifié par une clé unique et définit la structure et les champs d'un type de métadonnées spécifique.

apphub.googleapis.com/AgentProperties

Ce schéma permet de décrire les propriétés d'un agent d'IA, ce qui permet à d'autres systèmes de le trouver et de le comprendre. Il est généralement appliqué aux charges de travail dont la propriété de type fonctionnel est définie sur AGENT. Le schéma est compatible avec la carte d'agent Agent2Agent (A2A).

Définition du schéma

Vous trouverez ci-dessous le schéma de ce type de métadonnées au format JSON.

{
  "$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"
            }
          }
        }
      }
    }
  }
}

Descriptions de champs

Champ Type Description
displayName string Nom à afficher de l'agent.
description string Description de l'agent.
version string Version de l'agent.
framework string Framework utilisé pour développer l'agent.
agentCardUri string URI de la fiche de l'agent.
skills array Liste des compétences de l'agent.
skills.id string Identifiant unique de la compétence de l'agent.
skills.name string Nom lisible de la compétence de l'agent.
skills.description string Description de la compétence de l'agent.
skills.tags array sur string Ensemble de mots clés décrivant les capacités de la skill.
skills.examples array sur string Exemples de requêtes ou de scénarios que cette compétence peut gérer.