Agent to agent

Discover the AI Shopping Agent

Retrieve the A2A 1.0 agent card for a configured AI Shopping Agent domain using the protocol media type application/a2a+json. The card describes the product-discovery skill, supported input and output modes, bearer authentication, and the tenant-specific JSON-RPC interface URL. Discovery is public, but the card and authenticated SendMessage calls are both available only when A2A is enabled for the domain.

get/v1/a2a/{key}/{domain}/.well-known/agent-card.json

Request

Base URL
https://agent.cnstrc.com
URL
https://agent.cnstrc.com/v1/a2a/{key}/{domain}/.well-known/agent-card.json
Auth
none required

Path parameters

keystring required

The key of the index to use.

domainstring required

The domain specifying a set of specific instructions for processing the intent, e.g., 'recipes', 'sportsgear'.

Response

A2A agent discovery document.

namestring required

Human-readable name of the agent.

descriptionstring required

Human-readable description of the agent.

versionstring required

Version of the agent implementation described by this card.

documentationUrlstring uri

Public documentation for integrating with the agent.

securitySchemesobject

Security scheme definitions supported by the agent, keyed by scheme name.

securityRequirementsobject[]

Security requirements callers must satisfy to invoke the agent.

defaultInputModesstring[] required

Media types accepted by default for message parts.

defaultOutputModesstring[] required

Media types produced by default for response parts.

Example response

{
  "name": "Constructor AI Shopping Agent",
  "version": "1.0.0",
  "provider": {
    "organization": "Constructor"
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "product-discovery",
      "name": "Product discovery"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.