PR #162 introduced new CopilotSession capabilities, but the site docs did not cover key runtime APIs for agent control and explicit compaction. This PR closes that gap by adding focused guidance where users already look for advanced session behavior.

• Documentation gap addressed

  • Added coverage for CopilotSession.compact() in Infinite Sessions as a new Manual Compaction subsection.
  • Added coverage for custom-agent runtime APIs in Custom Agents as a new Programmatic Agent Selection subsection.

• Navigation updates

  • Updated advanced.md table of contents with anchors for:
    • Manual Compaction
    • Programmatic Agent Selection

• What’s now documented (new methods)

  • session.compact()
  • session.listAgents()
  • session.getCurrentAgent()
  • session.selectAgent(String)
  • session.deselectAgent()

var available = session.listAgents().get();

var current = session.getCurrentAgent().get();
if (current != null) {
    System.out.println("Current agent: " + current.name());
}

var selected = session.selectAgent("reviewer").get();
System.out.println("Selected: " + selected.name());

session.deselectAgent().get(); // Return to the default agent
session.compact().get();       // Trigger immediate compaction

• Fixes PR #162 needs documentation #165

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.