add the --values flag

Author: guowenatk

platform/_partials/cluster/connect-helm.mdx

@@ -88,5 +88,14 @@ import Expander from '@site/src/components/Expander'
 
     This command automatically installs the [vCluster Platform Agent](/docs/platform/administer/clusters/advanced/agent-config) in the cluster that is your current context.
     However, if you want to connect a cluster that is not your current context, you can append the `--kube-context` flag to specify the context of the cluster you want to connect.
+
+    You can also retrieve pre-configured agent values from your platform by appending the `--values` flag with the platform endpoint `--values "https://$HOST/clusters/agent-values/$CLUSTER_NAME?token=$TOKEN"`.
+    - `$HOST` — your vCluster Platform domain
+    - `$CLUSTER_NAME` — the name you're assigning to the cluster being connected (e.g., `cluster-name`)
+    - `$TOKEN` — the authentication token to access your vCluster Platform
+    The endpoint returns an intelligently merged content of
+    - Platform-level defaults configured in the `agentValues` field of your vCluster Platform Helm values
+    - Cluster-specific overrides from the `loft.sh/agent-values` annotation (when present)
+
   </Step>
 </Flow>

platform/_partials/cluster/upgrade-helm.mdx

@@ -44,6 +44,15 @@ import Expander from '@site/src/components/Expander'
         Ensure that the namespace specified with `--namespace` exists. This is the namespace where the platform agent is installed.
         If you deploy the platform agent’s resources into a different namespace, make sure to set `--namespace` accordingly.
 
+        You can also retrieve pre-configured agent values from your platform by appending the `--values` flag with platform endpoint
+        `--values "https://$HOST/clusters/agent-values/$CLUSTER_NAME?token=$TOKEN"`.
+        - `$HOST` — your platform domain.
+        - `$CLUSTER_NAME` — the name of the cluster you are connecting.
+        - `$TOKEN` — the authentication token.
+        In this example, `$HOST=loftg2fei.loft.host`, `$CLUSTER_NAME=cluster-name` and `$TOKEN=xxxxxxxx`.
+        The endpoint returns a YAML file with agent values that are configured in the `agentValues` field of your vCluster 
+        Platform Helm values, merged with any cluster-specific overrides from the `loft.sh/agent-values` annotation (when present).
+
         If the platform agent is not yet installed, you can include the `--install` and `--create-namespace` flags. The combination 
         of `--create-namespace` and `--namespace vcluster-platform` will create the `vcluster-platform` namespace in the host cluster
         if it does not already exist. All platform agent resources will then be deployed and run within that namespace.