agentmarkup.dev

{
  "type": "object",
  "additionalProperties": false,
  "minProperties": 1,
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "Whether to emit the Agent Card discovery file."
    },
    "version": {
      "type": "string",
      "description": "The Agent Card version.",
      "maxLength": 300
    },
    "description": {
      "type": "string",
      "description": "The Agent Card description.",
      "maxLength": 1000
    },
    "supportedInterfaces": {
      "type": "array",
      "description": "Transport interfaces exposed by the agent.",
      "maxItems": 5,
      "items": {
        "type": "object",
        "description": "One transport interface advertised by the Agent Card.",
        "additionalProperties": false,
        "required": [
          "url",
          "protocolBinding",
          "protocolVersion"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "An absolute HTTP, HTTPS, WS, or WSS interface URL.",
            "maxLength": 2000
          },
          "protocolBinding": {
            "type": "string",
            "description": "The interface protocol binding.",
            "maxLength": 300
          },
          "protocolVersion": {
            "type": "string",
            "description": "The interface protocol version.",
            "maxLength": 300
          },
          "tenant": {
            "type": "string",
            "description": "An optional tenant identifier.",
            "maxLength": 300
          }
        }
      }
    },
    "skills": {
      "type": "array",
      "description": "Skills advertised by the Agent Card.",
      "maxItems": 10,
      "items": {
        "type": "object",
        "description": "One skill advertised by the Agent Card.",
        "additionalProperties": false,
        "required": [
          "id",
          "name",
          "description",
          "tags"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The stable skill identifier.",
            "maxLength": 300
          },
          "name": {
            "type": "string",
            "description": "The human-readable skill name.",
            "maxLength": 300
          },
          "description": {
            "type": "string",
            "description": "A concise skill description.",
            "maxLength": 1000
          },
          "tags": {
            "type": "array",
            "description": "Searchable tags for this skill.",
            "maxItems": 10,
            "items": {
              "type": "string",
              "description": "A bounded list of text values.",
              "maxLength": 300
            }
          },
          "examples": {
            "type": "array",
            "description": "Example requests for this skill.",
            "maxItems": 5,
            "items": {
              "type": "string",
              "description": "A bounded list of text values.",
              "maxLength": 1000
            }
          },
          "inputModes": {
            "type": "array",
            "description": "Supported input media types.",
            "maxItems": 5,
            "items": {
              "type": "string",
              "description": "A bounded list of text values.",
              "maxLength": 300
            }
          },
          "outputModes": {
            "type": "array",
            "description": "Supported output media types.",
            "maxItems": 5,
            "items": {
              "type": "string",
              "description": "A bounded list of text values.",
              "maxLength": 300
            }
          },
          "security": {
            "type": "array",
            "description": "Optional security requirements for this skill.",
            "maxItems": 5,
            "items": {
              "type": "object",
              "description": "A security scheme name mapped to required scopes.",
              "maxProperties": 10,
              "propertyNames": {
                "maxLength": 300
              },
              "additionalProperties": {
                "type": "array",
                "maxItems": 5,
                "items": {
                  "type": "string",
                  "description": "One required security scope.",
                  "maxLength": 300
                }
              }
            }
          }
        }
      }
    },
    "providerOrganization": {
      "type": "string",
      "description": "The provider organization name.",
      "maxLength": 300
    },
    "providerUrl": {
      "type": "string",
      "description": "The provider organization HTTP or HTTPS URL.",
      "maxLength": 2000,
      "format": "uri"
    }
  }
}