Class AgentDiscoveryService

Service for discovering A2A protocol compatible agents. Implements the A2A discovery standards for finding and identifying compatible agents.

Index

Constructors

Methods

clearCache discoverAgents findAgentsByCapabilities findTopAgentsForTask

Constructors

constructor

new AgentDiscoveryService(
config?: Partial<AgentDiscoveryConfig>,
): AgentDiscoveryService
Creates an instance of AgentDiscoveryService.
Parameters
- Optionalconfig: Partial<AgentDiscoveryConfig>
  The configuration for the service.
Returns AgentDiscoveryService
See
A2AAgentCard
- Defined in src/systems/a2a/AgentDiscoveryService.ts:91

Methods

clearCache

clearCache(): void
Clears the agent cache.

Returns void
- Defined in src/systems/a2a/AgentDiscoveryService.ts:359

discoverAgents

discoverAgents(traceId?: string): Promise<A2AAgentInfo[]>
Discovers all available A2A agents from the discovery endpoint.
Parameters
- OptionaltraceId: string
  Optional trace ID for request tracking
Returns Promise<A2AAgentInfo[]>
Promise resolving to array of discovered A2A agents

Throws
If discovery fails or no agents are found
- Defined in src/systems/a2a/AgentDiscoveryService.ts:109

findAgentsByCapabilities

findAgentsByCapabilities(
capabilities: string[],
traceId?: string,
): Promise<A2AAgentInfo[]>
Finds agents by specific capabilities.
Parameters
- capabilities: string[]
  Array of required capabilities
- OptionaltraceId: string
  Optional trace ID for request tracking
Returns Promise<A2AAgentInfo[]>
Promise resolving to agents that have all specified capabilities
- Defined in src/systems/a2a/AgentDiscoveryService.ts:340

findTopAgentsForTask

findTopAgentsForTask(
    taskType: string,
    topK?: number,
    traceId?: string,
): Promise<A2AAgentInfo[]>
Finds the top K A2A agents for a specific task type, ranked by suitability. This method acts as a pre-filter, returning a list of the most promising candidates for an LLM to make the final selection from.
Parameters
- taskType: string
  The type of task (e.g., 'analysis', 'research', 'generation')
- topK: number = 3
  The maximum number of agents to return.
- OptionaltraceId: string
  Optional trace ID for request tracking.
Returns Promise<A2AAgentInfo[]>
Promise resolving to a ranked array of matching agents.

Remarks
TODO: Revisit and enhance the scoring algorithm.
- Defined in src/systems/a2a/AgentDiscoveryService.ts:199