סכימות מטא-נתונים מורחבות

בדף הזה מפורט קטלוג של הסכימות הנתמכות של המאפיין של המטא-נתונים המורחבים בשירותים ובעומסי עבודה. מטא-נתונים מורחבים מוסיפים נתונים מובְנים ועשירים לרכיבי אפליקציות ב-App Hub, ומספקים הקשר לניהול, לתפעול ולשילוב עם מערכות אחרות.

כל סכימה מזוהה באמצעות מפתח ייחודי, ומגדירה את המבנה והשדות של סוג מסוים של מטא-נתונים.

במאמר הצגת סכימות מורחבות של מטא-נתונים מוסבר איך להציג את המטא-נתונים האלה.

apphub.googleapis.com/AgentProperties

הסכימה הזו משמשת לתיאור המאפיינים של סוכן AI, ומאפשרת למערכות אחרות למצוא ולהבין אותו. בדרך כלל, הוא מוחל על עומסי עבודה שיש להם מאפיין של סוג פונקציונלי AGENT. הסכימה תואמת לכרטיס סוכן Agent2Agent‏ (A2A).

הגדרת סכימה

זוהי הסכימה של סוג המטא-נתונים הזה בפורמט 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"
            }
          }
        }
      }
    }
  }
}

תיאורי השדות

שדה סוג תיאור
displayName string השם המוצג של הסוכן.
description string תיאור הסוכן.
version string גרסת הסוכן.
framework string המסגרת ששימשה לפיתוח הסוכן.
agentCardUri string ה-URI של כרטיס הסוכן.
skills array רשימת המיומנויות של הסוכן.
skills.id string מזהה ייחודי של מיומנות הסוכן.
skills.name string שם של המיומנות של הסוכן שקריא לאנשים.
skills.description string תיאור של המיומנות של הסוכן.
skills.tags array מתוך string קבוצה של מילות מפתח שמתארות את היכולות של המיומנות.
skills.examples array מתוך string הנחיות או תרחישים לדוגמה שהמיומנות הזו יכולה לטפל בהם.