Add Agent class architecture documentation (#26320)

* Add Agent class internals documentation

* PCX review

---------

Co-authored-by: katereznykova <[email protected]>
Co-authored-by: Jun Lee <[email protected]>

Author: 3 people