Request Agent Consultation
POST /api/agents/consultation
Request consultation between agents with comprehensive workflow coordination.
Args: request_data: Consultation request containing agent IDs, type, and context request: FastAPI Request object for backend service access background_tasks: FastAPI BackgroundTasks for async analytics logging
Returns: Dict[str, object]: Consultation request status and tracking information
Note: Creates formal consultation requests between agents with priority handling, timeout management, and result tracking for collaborative agent workflows and knowledge sharing across the divine agent ecosystem. Analytics are logged asynchronously via BackgroundTasks.
Request Body required
Section titled “Request Body required ”API model for agent consultation requests.
Simplified consultation request model used by API endpoints. Uses string-based priority for easier API integration, converted to enum internally for processing.
Fields:
requesting_agent: Agent requesting consultation
target_agent: Agent being consulted for expertise
consultation_type: Type of consultation (category, e.g. “code_review”)
question: The actual question to ask the consulted agent. Optional
for backwards compatibility — when omitted the route falls back
to using consultation_type so older callers keep working.
context: Consultation context and parameters
priority: Consultation priority as string (default: “medium”)
Used By: - POST /api/agents/consultation endpoint - Agent collaboration API routes - Frontend agent consultation UI
object
Responses
Section titled “ Responses ”Successful Response
Consultation request response model.
Returns consultation request status, tracking ID, and result information for agent-to-agent consultation coordination workflows through the communication hub.
Fields: status: Operation status indicator consultation_id: Unique consultation tracking identifier result: Consultation request result from hub message: Status message describing consultation request
Used By: - POST /api/agents/management/consultation endpoint - Agent-to-agent consultation requests - Collaborative agent workflows
Validation Error