Recommend Agent

Find the best matching agent for user's goal, extract parameters, and execute it.

This endpoint:

1. Records the user's goal for demand assessment
2. Analyzes the goal using LLM to match against available agents from agents.py
3. Extracts parameters from the user goal based on the matched agent's requirements
4. Executes the matched agent with the provided image and extracted parameters
5. Returns the agent's result in its native schema (wrapped with metadata)

Flow:

• User provides both prompt and image(s)
• System finds matching agent (first LLM call)
• System extracts required parameters (second LLM call)
• System executes the matched agent
• Returns result in the agent's output schema from agents.py

Authentication:

• Requires X-API-Key header or valid user authentication

Note: Image is required. If no image is provided, an error will be returned.