Move an agent to an inactive state. The agent's configuration is retained but it will not handle inference requests.

When demoting an agent that has other agents linked as tools, the linked agents are not automatically demoted — each must be demoted individually if needed.

An agent that is linked as a tool to another agent cannot be demoted while that relationship is active. Demote the parent agent first, or unlink the agent-as-tool.