improved agent docs