Hi Prefect team, I’ve been reading a bit more on agents and I think that having diagrams in the documentation for the interactions between different agent types, the Prefect API (is this GraphQL??), and the storage and executor chosen for a Flow, would really help making it crystal clear what happens where. For example, the docs on a local agent make it very clear that it is local because the Flows that the local agent polls the Prefect API for, will be run in the same machine as where Prefect has been installed. So the logal agent is both local in the sense that it is 1) a process local to the machine where Prefect is installed, and 2) runs Flows in the same machine as where Prefect is installed.
But when I read the Kubernetes agent docs, it is not clear to me whether the Kubernetes agent process runs in the same environment/machine as where Prefect is installed and pushes Flows to a Kubernetes cluster, or whether we install a Kubernetes agent in our Kubernetes cluster and it pulls Flows to the cluster. Or are both valid options?
prefect agent kubernetes start
would start a Kubernetes agent in the environment where Prefect is installed but
prefect agent install kubernetes
installs the agent in the Kubernetes cluster right?
Having diagrams for these interactions would make it more intuitive to read the docs.