Package com.tnsai.annotations

Annotation Interface Coordination

@Documented @Retention(RUNTIME) @Target(TYPE) public @interface Coordination
Configures coordination behavior for multi-agent systems.

Defines how an agent coordinates with other agents including role (orchestrator/worker), consensus mechanisms, and team membership.

Usage - Orchestrator


 @Coordination(
     role = CoordinationRole.ORCHESTRATOR,
     workers = {"analyst-1", "analyst-2", "writer-1"},
     consensus = @Consensus(strategy = Strategy.MAJORITY, threshold = 0.6),
     taskDistribution = TaskDistribution.ROUND_ROBIN
 )
 public class ResearchTeamAgent extends Agent { ... }

Usage - Worker


 @Coordination(
     role = CoordinationRole.WORKER,
     orchestrator = "research-team",
     capabilities = {"analysis", "summarization"}
 )
 public class AnalystAgent extends Agent { ... }
Author:
TnsAI Team

  • Element Details

    • role

      Coordination.CoordinationRole role
      Coordination role of this agent.
      Returns:
      coordination role
      Default:
      PEER

    • workers

      String[] workers
      Worker agent IDs (for orchestrators).
      Returns:
      worker IDs
      Default:
      {}

    • orchestrator

      String orchestrator
      Orchestrator agent ID (for workers).
      Returns:
      orchestrator ID
      Default:
      ""

    • consensus

      Coordination.Consensus consensus
      Consensus configuration for group decisions.
      Returns:
      consensus settings
      Default:
      @com.tnsai.annotations.Coordination.Consensus

    • taskDistribution

      Coordination.TaskDistribution taskDistribution
      Task distribution strategy.
      Returns:
      distribution strategy
      Default:
      CAPABILITY_BASED

    • capabilities

      String[] capabilities
      Agent capabilities (for capability-based routing).
      Returns:
      capability names
      Default:
      {}

    • teams

      String[] teams
      Team/group memberships.
      Returns:
      team names
      Default:
      {}

    • maxConcurrentTasks

      int maxConcurrentTasks
      Maximum concurrent tasks this agent can handle.
      Returns:
      max concurrent tasks
      Default:
      1

    • canDelegate

      boolean canDelegate
      Whether agent can delegate tasks to others.
      Returns:
      true if can delegate
      Default:
      false

    • votingMember

      boolean votingMember
      Whether agent participates in voting.
      Returns:
      true if voting member
      Default:
      true

    • votingWeight

      int votingWeight
      Voting weight for consensus (1-10).
      Returns:
      voting weight
      Default:
      1

    • negotiation

      Coordination.Negotiation negotiation
      Negotiation configuration for this agent.
      Returns:
      negotiation settings
      Default:
      @com.tnsai.annotations.Coordination.Negotiation