Skema metadata yang diperluas

Halaman ini menyediakan katalog skema yang didukung untuk properti metadata yang diperluas pada layanan dan beban kerja. Metadata yang diperluas menambahkan data terstruktur yang kaya ke komponen aplikasi App Hub, sehingga memberikan konteks untuk tata kelola, operasi, dan integrasi dengan sistem lain.

Setiap skema diidentifikasi oleh kunci unik dan menentukan struktur serta kolom untuk jenis metadata tertentu.

apphub.googleapis.com/AgentProperties

Skema ini digunakan untuk mendeskripsikan properti agen AI, sehingga sistem lain dapat menemukan dan memahaminya. Biasanya diterapkan pada beban kerja 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 kemampuan yang dimiliki agen.
skills.id string ID unik untuk kemampuan agen.
skills.name string Nama yang dapat dibaca manusia untuk kemampuan agen.
skills.description string Deskripsi kemampuan agen.
skills.tags array dari string Sekumpulan kata kunci yang menjelaskan kemampuan skill.
skills.examples array dari string Contoh perintah atau skenario yang dapat ditangani oleh kemampuan ini.