Skip to content

Get Enhanced Agent Details

GET
/api/agents/enhanced/{agent_id}

Retrieve detailed information about a specific agent.

Returns comprehensive information about a single agent including capabilities, specializations, current workload, performance metrics, and availability status. Used for deep-dive agent analysis and task routing decisions.

Args: agent_id: Unique identifier of the agent to retrieve details for request: FastAPI Request object for backend service access background_tasks: FastAPI BackgroundTasks for async analytics logging

Returns: AgentDetails: Comprehensive agent information containing: - agent_id: Unique agent identifier - name: Human-readable agent name - description: Agent’s purpose and specialization - capabilities: List of agent capabilities - specializations: Specialized skills - status: Current availability status - current_load: Current workload level (0.0-1.0) - confidence_score: Task handling confidence - task_match_score: Task matching score

Raises: HTTPException 404: If agent not found HTTPException 500: For unexpected errors during data retrieval HTTPException 503: If backend service is unavailable

agent_id
required
Agent Id
string

Successful Response

AgentDetails

Detailed agent information model for capabilities and availability.

Provides comprehensive information about a divine agent’s capabilities, specializations, current workload, and availability status. Used by boot coordinator orchestrator for optimal agent selection and task routing.

Fields: agent_id: Unique agent identifier name: Human-readable agent name description: Agent’s purpose, role, and specialization capabilities: General capabilities (e.g., “code_analysis”, “testing”) specializations: Specialized skills (e.g., “python”, “react”, “performance”) status: Current availability (available, busy, offline) confidence_score: Confidence in handling current task (0.0-1.0) task_match_score: How well agent matches task requirements (0.0-1.0) current_load: Current workload level (0.0 = idle, 1.0 = max capacity) availability: Detailed availability description estimated_completion_time: Estimated task completion time in seconds

Used By: - boot coordinator orchestrator for agent selection - GET /api/agents/capabilities endpoint - Agent routing and load balancing - Task-agent matching algorithms - Multi-agent workflow planning

object
agentId
Agentid

Unique agent identifier

string
""
name
Name

Human-readable agent name

string
""
description
Description

Agent’s purpose and role

string
""
capabilities
Capabilities

List of general capabilities

Array<string>
specializations
Specializations

Specialized skills and domains

Array<string>
status
Status

Liveness status from the activity service (available, busy, offline)

string
default: offline
Allowed values: available busy offline
confidenceScore
Any of:
number
<= 1
taskMatchScore
Any of:
number
<= 1
currentLoad
Any of:
number
<= 1
availability
Any of:
string
Allowed values: Busy Available
estimatedCompletionTime
Any of:
integer

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