Skip to content

Get Optimal Team

GET
/api/agents/optimal-team/{task_description}

Compose an optimal multi-agent team for a complex task.

Analyzes task requirements and assembles a team of complementary agents with defined roles for collaborative task execution.

Path Parameters: task_description: Natural language description of the complex task

Returns: TeamRoutingResponse with team composition and coordination strategy

Raises: HTTPException 503: If communication hub is not available HTTPException 500: For unexpected errors

task_description
required
Task Description
string

Successful Response

TeamRoutingResponse

Response model for team-based routing recommendations.

Returns optimal multi-agent team composition for complex tasks requiring collaboration between multiple specialized agents.

Fields: status: Operation status task_description: Original task description team: Recommended team composition team_size: Number of agents in team coordination_strategy: How team should coordinate reasoning: Explanation for team selection estimated_completion: Estimated task completion factor

Usage: GET /api/agents/routing/optimal-team/{task_description}

object
status
Status

Operation status

string
default: success
taskDescription
required
Taskdescription

Task description

string
team
required
Team

Team composition

Array<object>
TeamMemberInfo

Team member information for multi-agent routing.

Fields: agent_id: Agent identifier role: Role in the team (lead, specialist, support) contribution: Expected contribution to task confidence_score: Confidence for this role assignment

object
agentId
required
Agentid

Agent identifier

string
role
required
Role

Team role

string
contribution
required
Contribution

Expected contribution

string
confidenceScore
required
Confidencescore

Role confidence

number
teamSize
required
Teamsize

Team size

integer
coordinationStrategy
required
Coordinationstrategy

Coordination approach

string
reasoning
required
Reasoning

Team selection reasoning

string
estimatedCompletion
Any of:
number

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object