agent: updated function comments