doc: fix misleading documentation around agents

Author: fioan89

README.md

@@ -64,9 +64,9 @@ You can use specially crafted JetBrains Gateway URIs to automatically:
 ### Example URIs
 
 ```text
-jetbrains://gateway/com.coder.toolbox?url=https%3A%2F%2Fdev.coder.com&token=abaC5SbSpP-J2qGpajkdreR9jBdcekXS2&workspace=bobiverse-bob&ide_product_code=GO&ide_build_number=241.23774.119&folder=%2Fhome%2Fcoder%2Fworkspace%2Fhello-world-rs
+jetbrains://gateway/com.coder.toolbox?url=https%3A%2F%2Fdev.coder.com&token=zeoX4SbSpP-j2qGpajkdwxR9jBdcekXS2&workspace=bobiverse-bob&agent=dev&ide_product_code=GO&ide_build_number=241.23774.119&folder=%2Fhome%2Fcoder%2Fworkspace%2Fhello-world-rs
 
-jetbrains://gateway/com.coder.toolbox?url=https%3A%2F%2Fj5gj2r1so5nbi.pit-1.try.coder.app%2F&token=gqEirOoI1U-FfCQ6uj8iOLtybBIk99rr8&workspace=bobiverse-bill&ide_product_code=RR&ide_build_number=243.26053.17&folder=%2Fhome%2Fcoder%2Fworkspace%2Fhello-world-rs
+jetbrains://gateway/com.coder.toolbox?url=https%3A%2F%2Fj5gj2r1so5nbi.pit-1.try.coder.app%2F&token=gqEirOoI1U-FfCQ6uj8iOLtybBIk99rr8&workspace=bobiverse-riker&agent=dev&ide_product_code=RR&ide_build_number=243.26053.17&folder=%2Fhome%2Fcoder%2Fworkspace%2Fhello-world-rs
 ```
 
 ### URI Breakdown
@@ -76,32 +76,35 @@ jetbrains://gateway/com.coder.toolbox
   ?url=http(s)://<your-coder-deployment>
   &token=<auth-token>
   &workspace=<workspace-name>
+  &agent/agent_id=<agent-name-or-agent-id>
   &ide_product_code=<IDE-code>
   &ide_build_number=<IDE-build>
   &folder=<absolute-path-to-a-project-folder>
 ```
 
-| Query param      | 	Description                                                                   | Mandatory |
-|------------------|--------------------------------------------------------------------------------|-----------|
-| url              | 	Your Coder deployment URL (encoded)                                           | Yes       |
-| token            | 	Coder authentication token                                                    | Yes       |
-| workspace        | 	Name of the Coder workspace to connect to. Agent name should not be included. | Yes       |
-| ide_product_code | 	JetBrains IDE product code (e.g., GO for GoLand, RR for Rider)                | No        |
-| ide_build_number | 	Specific build number of the JetBrains IDE to install on the workspace        | No        |
-| folder           | 	Absolute path to the project folder to open in the remote IDE (URL-encoded)   | No        |
+| Query param      | 	Description                                                                 | Mandatory |
+|------------------|------------------------------------------------------------------------------|-----------|
+| url              | 	Your Coder deployment URL (encoded)                                         | Yes       |
+| token            | 	Coder authentication token                                                  | Yes       |
+| workspace        | 	Name of the Coder workspace to connect to.                                  | Yes       |
+| agent            | 	Name of the agent associated with the workspace                             | No        |
+| agent_id         | 	ID of the agent associated with the workspace                               | No        |
+| ide_product_code | 	JetBrains IDE product code (e.g., GO for GoLand, RR for Rider)              | No        |
+| ide_build_number | 	Specific build number of the JetBrains IDE to install on the workspace      | No        |
+| folder           | 	Absolute path to the project folder to open in the remote IDE (URL-encoded) | No        |
+
+If only a single agent is available, specifying an agent name or ID is optional. However, if multiple agents exist,
+you must provide either the name or ID to target a specific one. Note that this version of the Coder Toolbox plugin
+does not automatically start agents if they are offline, so please ensure the selected agent is running before
+proceeding.
 
 If `ide_product_code` and `ide_build_number` is missing, Toolbox will only open and highlight the workspace environment
-page.
-Coder Toolbox will attempt to start the workspace if it’s not already running; however, for the most reliable
+page. Coder Toolbox will attempt to start the workspace if it’s not already running; however, for the most reliable
 experience, it’s recommended to ensure the workspace is running prior to initiating the connection.
 
-If the agent is down, or we can't resolve an agent for the workspace.
-
 ## Releasing
 
 1. Check that the changelog lists all the important changes.
 2. Update the gradle.properties version.
 3. Publish the resulting draft release after validating it.
-4. Merge the resulting changelog PR.
-
-## `main` vs `eap` branch
+4. Merge the resulting changelog PR.