Skip to content

Get Specialist Agent

GET
/api/agents/specialist/{specialization}

Find the best agent for a specific specialization area.

Routes to the most qualified specialist for domains like lore, writing, code analysis, etc.

Path Parameters: specialization: The specialization area (e.g., “lore”, “writing”, “code”)

Returns: SpecialistRoutingResponse with best specialist and alternatives

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

specialization
required
Specialization
string

Successful Response

SpecialistRoutingResponse

Response model for specialist agent routing.

Returns the best agent for a specific specialization area.

Fields: status: Operation status specialization: Requested specialization specialist_agent: Best agent for this specialization confidence_score: Confidence in selection alternatives: Alternative specialists reasoning: Selection reasoning

Usage: GET /api/agents/routing/specialist/{specialization}

object
status
Status

Operation status

string
default: success
specialization
required
Specialization

Requested specialization

string
specialistAgent
required
Any of:
string
confidenceScore
required
Confidencescore

Selection confidence

number
alternatives
Any of:
Array<string>
reasoning
required
Reasoning

Selection reasoning

string

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