Agent Card Extensions

TACO extends the standard A2A Agent Card with construction-specific metadata using the x-construction extension field. These fields are optional — any A2A client that does not understand them will simply ignore them per the A2A specification.

Top-Level Extension: x-construction

Added to the root of the Agent Card.

{
  "x-construction": {
    "trade": "mechanical",
    "csiDivisions": ["22", "23"],
    "projectTypes": ["commercial", "healthcare", "education"],
    "certifications": ["SOC2"],
    "dataFormats": {
      "input": ["pdf", "dwg", "rvt", "ifc"],
      "output": ["bom-json", "csv", "pdf"]
    },
    "integrations": ["procore", "acc", "bluebeam"],
    "security": {
      "trustTier": 0,
      "scopesOffered": ["taco:trade:mechanical", "taco:task:takeoff"]
    }
  }
}

Fields

Field	Type	Required	Description
trade	string	Yes	Primary trade. Values: mechanical, electrical, plumbing, structural, civil, architectural, fire-protection, general, multi-trade
csiDivisions	string[]	Yes	CSI MasterFormat division numbers (e.g., ["22", "23"] for plumbing and HVAC)
projectTypes	string[]	No	Supported project types: commercial, residential, healthcare, education, industrial, infrastructure, mixed-use
certifications	string[]	No	Security/compliance certifications: SOC2, ISO27001, FedRAMP
dataFormats.input	string[]	Yes	File formats the agent can accept
dataFormats.output	string[]	Yes	File formats the agent can produce
integrations	string[]	No	Platform integrations: procore, acc, bluebeam, plangrid, p6, ms-project, sage, viewpoint
security	object	No	TACO security metadata. See Security for the full reference.

Skill-Level Extension: x-construction

Added to individual skill entries in the Agent Card's skills array.

{
  "skills": [
    {
      "id": "generate-bom",
      "name": "Generate Bill of Materials",
      "description": "Generates a detailed BOM from construction plan sheets",
      "x-construction": {
        "taskType": "takeoff",
        "inputSchema": "plan-sheets",
        "outputSchema": "bom-v1"
      }
    }
  ]
}

Fields

Field	Type	Required	Description
taskType	string	Yes	References a TACO task type
inputSchema	string	No	Expected input schema identifier
outputSchema	string	Yes	Output schema identifier (see Data Schemas)

Discovery Queries

The TACO Agent Registry supports querying agents using these extension fields:

GET /agents?trade=mechanical&taskType=schedule-coordination&projectType=healthcare&integration=procore

This returns all registered Agent Cards matching the filter criteria.

Full Agent Card Example

{
  "name": "BuildRight Mechanical Estimating Agent",
  "description": "AI-powered cost estimation for mechanical trades",
  "url": "https://api.buildright.io/a2a",
  "version": "1.0.0",
  "skills": [
    {
      "id": "generate-estimate",
      "name": "Generate Cost Estimate",
      "description": "Produces a detailed cost estimate from a BOM",
      "x-construction": {
        "taskType": "estimate",
        "inputSchema": "bom-v1",
        "outputSchema": "estimate-v1"
      }
    },
    {
      "id": "value-engineer",
      "name": "Value Engineering Analysis",
      "description": "Identifies cost reduction opportunities",
      "x-construction": {
        "taskType": "value-engineering",
        "inputSchema": "bom-v1",
        "outputSchema": "ve-suggestions-v1"
      }
    }
  ],
  "x-construction": {
    "trade": "mechanical",
    "csiDivisions": ["22", "23"],
    "projectTypes": ["commercial", "healthcare"],
    "certifications": ["SOC2"],
    "dataFormats": {
      "input": ["bom-json"],
      "output": ["estimate-json", "csv", "pdf"]
    },
    "integrations": ["procore", "acc"],
    "security": {
      "trustTier": 1,
      "scopesOffered": [
        "taco:trade:mechanical",
        "taco:task:estimate",
        "taco:task:value-engineering"
      ],
      "projectScoped": true,
      "delegationSupported": false
    }
  }
}