{
  "type": "record",
  "Aspect": {
    "name": "aiAgentInfo",
    "schemaVersion": 8
  },
  "name": "AIAgentInfo",
  "namespace": "com.linkedin.pegasus2avro.agent",
  "fields": [
    {
      "Searchable": {
        "boostScore": 10.0,
        "enableAutocomplete": true,
        "fieldNameAliases": [
          "_entityName"
        ],
        "fieldType": "WORD_GRAM"
      },
      "type": "string",
      "name": "name",
      "doc": "Display name of the agent"
    },
    {
      "Searchable": {
        "fieldType": "TEXT",
        "hasValuesFieldName": "hasTagline",
        "queryByDefault": false
      },
      "type": [
        "null",
        "string"
      ],
      "name": "tagline",
      "default": null,
      "doc": "Short, user-facing tagline shown on agent cards, hero subtitles, and\npicker dropdowns. Should be a one-line summary (~120 chars). When\nabsent, surfaces fall back to truncating `description`."
    },
    {
      "Searchable": {
        "fieldType": "TEXT",
        "hasValuesFieldName": "hasDescription"
      },
      "type": [
        "null",
        "string"
      ],
      "name": "description",
      "default": null,
      "doc": "Description of what this agent does AND when Ask DataHub should\nroute to it. Style: \"X does Y. Use when Z.\" The router reads this\nverbatim when deciding whether to delegate to this agent, so the\n\"Use when...\" tail is load-bearing \u2014 not optional prose. Roughly\n300-1000 chars is the right length."
    },
    {
      "type": [
        "null",
        "string"
      ],
      "name": "instructions",
      "default": null,
      "doc": "Custom base instructions for the agent, beyond the standard DataHub boilerplate.\nInjected into the agent's system prompt."
    },
    {
      "type": [
        "null",
        {
          "type": "record",
          "name": "AIAgentSource",
          "namespace": "com.linkedin.pegasus2avro.agent",
          "fields": [
            {
              "Searchable": {
                "addToFilters": true,
                "fieldName": "sourceType",
                "fieldType": "KEYWORD"
              },
              "type": {
                "type": "enum",
                "symbolDocs": {
                  "EXTERNAL": "An agent defined and managed externally, cataloged on DataHub.",
                  "NATIVE": "An agent defined and managed natively on DataHub by end users.",
                  "SYSTEM": "A system-internal agent, bootstrapped at deployment time.\nSystem agents are not editable by end users."
                },
                "name": "AIAgentSourceType",
                "namespace": "com.linkedin.pegasus2avro.agent",
                "symbols": [
                  "SYSTEM",
                  "NATIVE",
                  "EXTERNAL"
                ],
                "doc": "The source type of an AI agent definition.\n\nFollows the same pattern as AssertionSourceType: NATIVE agents are\ndefined and managed on DataHub, while EXTERNAL agents are cataloged\nbut managed outside DataHub."
              },
              "name": "type",
              "doc": "The source type of the agent"
            },
            {
              "Relationship": {
                "entityTypes": [
                  "aiAgent"
                ],
                "name": "ClonedFromAgent"
              },
              "Searchable": {
                "addToFilters": true,
                "fieldName": "clonedFrom",
                "fieldType": "URN",
                "filterNameOverride": "Cloned From",
                "queryByDefault": false
              },
              "java": {
                "class": "com.linkedin.pegasus2avro.common.urn.Urn"
              },
              "type": [
                "null",
                "string"
              ],
              "name": "clonedFrom",
              "default": null,
              "doc": "If this agent was cloned from another agent, the URN of the source agent.\nNull on SYSTEM agents and original NATIVE/EXTERNAL agents.\n\nUsed to group clones into an Agent Family \u2014 the base + all its clones share\none frontend module, one tool palette, and one set of instructions. Clones\ninherit configuration verbatim from the base; what differs is their\nstewardship set (the artifacts they manage).",
              "Urn": "Urn",
              "entityTypes": [
                "aiAgent"
              ]
            }
          ],
          "doc": "The source or origin of an AI agent definition.\nFollows the same pattern as AssertionSource."
        }
      ],
      "name": "source",
      "default": null,
      "doc": "The source or origin of the agent definition.\nSystem agents (source.type = SYSTEM) are bootstrapped at deployment time\nand are not editable by end users."
    },
    {
      "Searchable": {
        "/time": {
          "fieldName": "createdAt",
          "fieldType": "DATETIME",
          "queryByDefault": false
        }
      },
      "type": {
        "type": "record",
        "name": "AuditStamp",
        "namespace": "com.linkedin.pegasus2avro.common",
        "fields": [
          {
            "type": "long",
            "name": "time",
            "doc": "When did the resource/association/sub-resource move into the specific lifecycle stage represented by this AuditEvent."
          },
          {
            "java": {
              "class": "com.linkedin.pegasus2avro.common.urn.Urn"
            },
            "type": "string",
            "name": "actor",
            "doc": "The entity (e.g. a member URN) which will be credited for moving the resource/association/sub-resource into the specific lifecycle stage. It is also the one used to authorize the change.",
            "Urn": "Urn"
          },
          {
            "java": {
              "class": "com.linkedin.pegasus2avro.common.urn.Urn"
            },
            "type": [
              "null",
              "string"
            ],
            "name": "impersonator",
            "default": null,
            "doc": "The entity (e.g. a service URN) which performs the change on behalf of the Actor and must be authorized to act as the Actor.",
            "Urn": "Urn"
          },
          {
            "type": [
              "null",
              "string"
            ],
            "name": "message",
            "default": null,
            "doc": "Additional context around how DataHub was informed of the particular change. For example: was the change created by an automated process, or manually."
          }
        ],
        "doc": "Data captured on a resource/association/sub-resource level giving insight into when that resource/association/sub-resource moved into a particular lifecycle stage, and who acted to move it into that specific lifecycle stage."
      },
      "name": "created",
      "doc": "When this agent was created"
    },
    {
      "Searchable": {
        "/time": {
          "fieldName": "lastModifiedAt",
          "fieldType": "DATETIME",
          "queryByDefault": false
        }
      },
      "type": "com.linkedin.pegasus2avro.common.AuditStamp",
      "name": "lastModified",
      "doc": "When this agent was last modified"
    }
  ],
  "doc": "Configuration and metadata for an AI agent.\n\nAgents can be:\n1. System (SYSTEM): bootstrapped at deployment time via YAML, not editable\n2. Native (NATIVE): created by end users through the UI or API\n3. External (EXTERNAL): cataloged on DataHub but managed externally"
}