Annotation Interface A2AAgentCardHeaders
Marks a static method returning the
Map<String, String> of request headers used to fetch an A2A agent card.
The method runs lazily, when the card is first needed, and again when a failed fetch is retried. A successful
card is cached, so the method is not invoked for every agent invocation. Returning null or an empty map
adds no headers. These headers authenticate card discovery only, not A2A messages.
The method can only declare parameters resolved through a SupplierParameterResolver. Those parameters
are resolved once, when the agent is built, while the method itself normally runs on a LangChain4j executor
thread within the card resolution timeout. Pass a token provider as a resolved parameter, rather than a token
captured at build time, when credentials need refreshing between fetch attempts.
Like other helper methods, it can be an instance method on a helper object instead of a static method on the
agent type: see the "Helper objects" section of the agentic tutorial and
AgenticServices.AgentConfigurator. Exactly one helper can supply the card headers of an agent.
- Since:
- 1.24.0