Suggestion to improve the tutorial at this page. For someone who is tinkering with Prefect and Docker containers for the first time it might not be obvious that the agent cannot be running with the ephemeral API. Specifically, here, the documentation only says to start an agent polling from the “test” queue. This works if the PREFECT_API_URL has been set before hand. It would be nice for the tutorial to include a note about setting this environment variable using the CLI or starting the agent with the --api flag set to the API endpoint.

Thanks for the heads up. I’ll add a note as you suggest.