A2A Binding¶

The A2A (Agent-to-Agent) binding enables USP interactions between autonomous agents using the A2A protocol.

Each USP operation is expressed as an A2A task. The full multi-step booking flow is supported through A2A task chaining.

Task-Type Mapping¶

End-to-End Booking Flow via A2A¶

The following shows a complete booking flow through A2A task chaining between a scheduling agent and a business agent:

sequenceDiagram
    participant PA as Platform Agent
    participant BA as Business Agent

    PA->>BA: Task: usp/services/list (with filters)
    BA-->>PA: Service catalog

    PA->>BA: Task: usp/availability/query<br/>(selected service + date range)
    BA-->>PA: Available slots

    opt Business supports holds
        PA->>BA: Task: usp/availability/hold<br/>(selected slot)
        BA-->>PA: Hold confirmation
    end

    PA->>BA: Task: usp/bookings/create<br/>(service, slot, buyer, hold_id)
    BA-->>PA: Booking (pending payment)

    opt Payment required
        PA->>PA: Process payment via<br/>configured checkout
    end

    PA->>BA: Task: usp/bookings/confirm-payment<br/>(payment result)
    BA-->>PA: Booking confirmed

Step-by-Step¶

1. Platform agent sends usp/services/list with filters. Business agent returns the service catalog.
2. Platform agent sends usp/availability/query with the selected service and date range. Business agent returns available slots.
3. (If business supports holds) Platform agent sends usp/availability/hold with the selected slot. Business agent returns the hold.
4. Platform agent sends usp/bookings/create with service, slot, buyer, optional recipient, and hold_id (if step 3 was performed). Business agent returns the booking.
5. (If payment required) Platform agent processes payment through the configured checkout system.
6. Platform agent sends usp/bookings/confirm-payment with the payment result.

Each task in the chain carries the A2A conversation context, enabling the business agent to maintain state across the multi-step flow.

Agent Card¶

A USP-enabled business agent MUST publish an Agent Card advertising its USP capabilities. The Agent Card SHOULD include the supported USP task types and authentication requirements.

Example Agent Card¶

{
  "name": "Glamour Salon Scheduling Agent",
  "description": "Handles appointment booking for Glamour Salon via USP.",
  "url": "https://salon.example.com/a2a",
  "capabilities": {
    "tasks": [
      "usp/services/list",
      "usp/availability/query",
      "usp/bookings/create",
      "usp/bookings/cancel",
      "usp/bookings/reschedule"
    ]
  },
  "authentication": {
    "schemes": ["bearer"]
  },
  "usp_profile": "https://salon.example.com/.well-known/usp"
}

DataPart Conventions¶

USP data maps to A2A DataPart objects as follows:

• Each USP response is carried as a DataPart with mimeType: "application/json" and data containing the USP response object.
• The USP metadata (usp envelope with version and capabilities) is carried in the DataPart's metadata field.
• Business outcome errors are carried in data.messages[], consistent with the REST and MCP bindings.

Example DataPart¶

Availability response as a DataPart:

{
  "mimeType": "application/json",
  "metadata": {
    "usp": {
      "version": "2026-02-09"
    }
  },
  "data": {
    "service_id": "svc_haircut_001",
    "slots": [
      {
        "id": "slot_20260315_0900",
        "start": "2026-03-15T09:00:00-04:00",
        "end": "2026-03-15T10:00:00-04:00",
        "state": "available"
      }
    ],
    "messages": []
  }
}

flowchart LR
    subgraph DataPart
        direction TB
        A["mimeType: application/json"]
        B["metadata.usp: {version, capabilities}"]
        C["data: {USP response object}"]
        D["data.messages[]: business outcome errors"]
    end

Session Management¶

A2A tasks within the same booking flow SHOULD share a session context (sessionId). The session enables the business agent to maintain state (e.g., held slots, partial booking data) across multi-step task chains.

Rules¶

sequenceDiagram
    participant PA as Platform Agent
    participant BA as Business Agent

    PA->>BA: Task: usp/services/list<br/>(no sessionId)
    BA-->>PA: Result + sessionId: "sess_abc123"

    PA->>BA: Task: usp/availability/query<br/>(sessionId: "sess_abc123")
    BA-->>PA: Slots (session state maintained)

    PA->>BA: Task: usp/bookings/create<br/>(sessionId: "sess_abc123")
    BA-->>PA: Booking confirmed

    Note over PA,BA: If 30+ min pass without activity...
    BA->>BA: Session expired:<br/>release holds, discard state

Conformance Requirements¶

MUST¶

A conforming A2A binding implementation MUST:

1. Publish an Agent Card advertising supported USP task types.
2. Use task types from the task-type mapping table above.
3. Carry USP data as DataParts with mimeType: "application/json".
4. Return business outcome errors in data.messages[], consistent with REST and MCP bindings.

SHOULD¶

A conforming A2A binding implementation SHOULD:

1. Maintain session context (sessionId) across multi-step booking flows.
2. Include the usp_profile field in the Agent Card pointing to /.well-known/usp.