I have used it with Amazon S3 file uploads. It basically returns a Promise/A+ object to enable asynchronous workflows. More info here: https://docs.aws.amazon.com/aws-sdk-php/v3/guide/guide/promises.html
You can also use it to process a large list without having to actually load the entire "list" before processing. (eg have a for loop that calls the generator function to process a line read in from a large file that would normally exhaust free memory.)
I will admit it took a while for the concepts and usage/execution to sink in.