TraconA2AExtensions

Namespace Tracon · Assembly Tracon.AspNetCore.dll

Extensions that connect the HTTP endpoint that publishes Tracon agents over A2A.

public static class TraconA2AExtensions

Inheritance

object ← TraconA2AExtensions

Inherited Members

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Fields

DefaultPattern

Default path prefix.

public const string DefaultPattern = "/tracon/a2a"

Field Value

string

Methods

MapTraconA2A(IEndpointRouteBuilder, string)

Publishes the agents registered via UseA2A over A2A.

public static IEndpointConventionBuilder MapTraconA2A(this IEndpointRouteBuilder endpoints, string pattern = "/tracon/a2a")

Parameters

endpoints IEndpointRouteBuilder

The application’s routing builder.

pattern string

Path prefix. Default is /tracon/a2a.

Returns

IEndpointConventionBuilder

The endpoint’s convention builder.

Remarks

Each exposed agent is mapped to its own sub-path: {pattern}/{agent}. The A2A protocol models a single server as a single agent identity; multiple agents cannot share the SAME .well-known/agent-card.json path. Each agent’s card is published at its own sub-path ({pattern}/{agent}/.well-known/agent-card.json).

Applies the SAME three-layer protection as MapTracon — settings are inherited from there.

If an exposed agent carries a tool that requires approval the application STILL fails — but not synchronously from this method, rather through Tracon.A2AApprovalGuardFilter: the check waits in the background until the SQL schema is ready (so this method itself does not crash with “no such table” against an empty database, the same pattern), completes by the first request, and no request can get ahead of it.

app.MapTracon();
app.MapTraconA2A();

Exceptions

ArgumentNullException

endpoints is null.

ArgumentException

pattern is empty.

InvalidOperationException

UseA2A or MapTracon has not been called first, or this is called while remote access is enabled.