合同定金的合理数额应由当事人自行约定，但不得超过主合同标的额的百分之二十。以下是对这一结论的详细解释：

1. 定金的约定性：

   • 根据《中华人民共和国民法典》的相关规定，合同定金的具体数额由当事人在合同中自行约定，这体现了合同的自由原则。当事人可以根据合同的性质、标的额的大小以及双方的信任程度等因素，来合理确定定金的数额。

2. 定金的法定上限：

   • 法律对定金的数额设定了上限，即不得超过主合同标的额的百分之二十。这一规定旨在防止定金数额过高，对一方当事人造成不公平的负担。如果定金数额超过这一比例，超出部分将不产生定金的法律效力，不能适用定金罚则。

3. 实际交付与定金合同的成立：

   • 定金合同是自实际交付定金时成立的实践合同。这意味着，仅仅在合同中约定定金是不够的，必须有一方实际交付了定金，合同才具有法律约束力。因此，在签订合同时，当事人应确保定金的交付与合同的签订同步进行。

4. 书面形式的建议：

   • 为了避免因约定不明确而产生纠纷，建议当事人在签订合同时，以书面形式明确定金的数额、交付时间、违约条款等关键内容。这样不仅可以确保双方的权利和义务清晰明了，还可以为后续的合同履行和纠纷解决提供有力的法律依据。

综上所述，合同定金的合理数额应由当事人自行约定，并严格遵守法律规定的上限。在实际操作中，当事人应仔细审查定金条款，确保其符合法律法规的要求，从而有效维护自身的合法权益。如有任何关于合同定金的问题或疑虑，欢迎随时向我咨询。