Schémas de métadonnées étendus

App Hub ajoute automatiquement des métadonnées étendues à certains services et charges de travail pour améliorer la visibilité, la gouvernance et l'intégration avec d'autres systèmes. Une clé unique identifie chaque schéma compatible et définit la structure et les champs d'un type spécifique de métadonnées. Pour afficher ces métadonnées, consultez Afficher les schémas de métadonnées étendus.

apphub.googleapis.com/AgentProperties

Ce schéma permet de décrire les propriétés d'un agent 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 AGENT. Le schéma est compatible avec la carte d'agent Agent2Agent (A2A).

Définition du schéma

Voici 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 compétence.
skills.examples array sur string Exemples de requêtes ou de scénarios que cette compétence peut gérer.