Skip to content

agent-revision

Generated reference page for spec/v1/schemas/resources/agent-revision.json.

Metadata

  • Type: JSON Schema
  • Source: spec/v1/schemas/resources/agent-revision.json
  • Raw: View Raw

Summary

Source

json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://agent-service.spec/v1/schemas/resources/agent-revision.json",
  "$defs": {
    "LocalCallableRef": {
      "type": "object",
      "additionalProperties": false,
      "required": ["alias", "resourceType", "bindingMode", "resourceId"],
      "properties": {
        "alias": {
          "type": "string",
          "minLength": 1
        },
        "resourceType": {
          "$ref": "../common/enums.json#/$defs/taskResourceType"
        },
        "bindingMode": {
          "$ref": "../common/enums.json#/$defs/callableBindingMode"
        },
        "resourceId": {
          "$ref": "../common/identity.json#/$defs/opaqueId"
        },
        "releaseChannelId": {
          "$ref": "../common/identity.json#/$defs/releaseChannelId"
        },
        "includeToolNames": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "metadata": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "allOf": [
        {
          "if": {
            "properties": {
              "resourceType": {
                "const": "mcp_server"
              }
            },
            "required": ["resourceType"]
          },
          "then": {
            "properties": {
              "bindingMode": {
                "const": "inject"
              }
            }
          },
          "else": {
            "properties": {
              "bindingMode": {
                "const": "invoke"
              }
            }
          }
        }
      ]
    },
    "GrantedCallableRef": {
      "type": "object",
      "additionalProperties": false,
      "required": ["alias", "resourceType", "bindingMode", "grantId"],
      "properties": {
        "alias": {
          "type": "string",
          "minLength": 1
        },
        "resourceType": {
          "$ref": "../common/enums.json#/$defs/taskResourceType"
        },
        "bindingMode": {
          "$ref": "../common/enums.json#/$defs/callableBindingMode"
        },
        "grantId": {
          "$ref": "../common/identity.json#/$defs/callableGrantId"
        },
        "includeToolNames": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "metadata": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "allOf": [
        {
          "if": {
            "properties": {
              "resourceType": {
                "const": "mcp_server"
              }
            },
            "required": ["resourceType"]
          },
          "then": {
            "properties": {
              "bindingMode": {
                "const": "inject"
              }
            }
          },
          "else": {
            "properties": {
              "bindingMode": {
                "const": "invoke"
              }
            }
          }
        }
      ]
    },
    "CallableRef": {
      "oneOf": [
        {
          "$ref": "#/$defs/LocalCallableRef"
        },
        {
          "$ref": "#/$defs/GrantedCallableRef"
        }
      ]
    }
  },
  "type": "object",
  "additionalProperties": false,
  "required": ["agentRevisionId", "agentId", "orgId", "executionProfile", "createdAt"],
  "properties": {
    "agentRevisionId": {
      "$ref": "../common/identity.json#/$defs/agentRevisionId"
    },
    "agentId": {
      "$ref": "../common/identity.json#/$defs/agentId"
    },
    "orgId": {
      "$ref": "../common/identity.json#/$defs/orgId"
    },
    "card": {
      "type": "object",
      "additionalProperties": true
    },
    "protocolProfiles": {
      "$ref": "../common/protocol-profile.json#/$defs/ProtocolProfiles"
    },
    "callableRefs": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CallableRef"
      }
    },
    "executionProfile": {
      "$ref": "../common/execution-profile.json#/$defs/ExecutionProfile"
    },
    "runPolicy": {
      "$ref": "../common/execution-profile.json#/$defs/RunPolicy"
    },
    "secretRefs": {
      "type": "array",
      "items": {
        "$ref": "../common/execution-profile.json#/$defs/SecretRef"
      }
    },
    "releaseNotes": {
      "type": "string"
    },
    "contentDigest": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true
    },
    "createdAt": {
      "$ref": "../common/identity.json#/$defs/timestamp"
    }
  }
}

白皮书与规范内容以仓库真源为准。