Skema metadata yang diperluas

App Hub otomatis menambahkan metadata yang diperluas ke beberapa layanan dan workload untuk meningkatkan visibilitas, tata kelola, dan integrasi dengan sistem lain. Kunci unik mengidentifikasi setiap skema yang didukung dan menentukan struktur serta kolom untuk jenis metadata tertentu. Untuk melihat metadata ini, lihat Melihat skema metadata yang diperluas.

apphub.googleapis.com/AgentProperties

Skema ini digunakan untuk mendeskripsikan properti agen AI, sehingga sistem lain dapat menemukan dan memahaminya. Biasanya, ini diterapkan ke workload yang memiliki properti jenis fungsional AGENT. Skema ini kompatibel dengan Kartu Agen Agent2Agent (A2A).

Definisi skema

Berikut adalah skema untuk jenis metadata ini dalam 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"
            }
          }
        }
      }
    }
  }
}

Deskripsi kolom

Kolom Jenis Deskripsi
displayName string Nama tampilan agen.
description string Deskripsi agen.
version string Versi agen.
framework string Framework yang digunakan untuk mengembangkan agen.
agentCardUri string URI kartu agen untuk agen.
skills array Daftar keterampilan yang dimiliki agen.
skills.id string ID unik untuk keterampilan agen.
skills.name string Nama yang dapat dibaca manusia untuk keterampilan agen.
skills.description string Deskripsi keahlian agen.
skills.tags array dari string Serangkaian kata kunci yang menjelaskan kemampuan keahlian.
skills.examples array dari string Contoh perintah atau skenario yang dapat ditangani oleh keterampilan ini.