Mentoring

Mentoring pairs a high-performing agent (mentor) with a less experienced agent (mentee) for structured knowledge transfer. Sessions capture prompt patterns, tool strategies, and decision heuristics that can be applied to improve the mentee's performance.

Creating a pair

bash

# Create a mentor/mentee pair
curl -X POST http://localhost:3000/mentoring/pairs \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "mentorId": "senior-agent",
    "menteeId": "junior-agent",
    "focus": ["prompt-engineering", "tool-selection"]
  }'

Recording sessions

Each session captures three types of insights:

Insight type	Description
`promptPatterns`	Effective prompting strategies the mentee should adopt
`toolStrategies`	When and how to use specific tools
`heuristics`	Decision-making rules and guidelines

bash

# Record a mentoring session with insights
curl -X POST http://localhost:3000/mentoring/pairs/mp_abc123/sessions \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "insights": {
      "promptPatterns": ["Use chain-of-thought for complex reasoning tasks"],
      "toolStrategies": ["Prefer brave_search over web_scrape for factual queries"],
      "heuristics": ["When confidence < 0.7, request clarification before proceeding"]
    }
  }'

Endpoint reference

Method	Endpoint	Description
`POST`	`/mentoring/pairs`	Create pair
`GET`	`/mentoring/pairs`	List pairs
`GET`	`/mentoring/pairs/:id`	Get pair details
`DELETE`	`/mentoring/pairs/:id`	End mentorship
`POST`	`/mentoring/pairs/:id/sessions`	Record session
`GET`	`/mentoring/pairs/:id/sessions`	List sessions