Upgrade cluster agent
upgrade_cluster_agentUpgrade the Ankra agent on a cluster now (the twin of ankra cluster agent upgrade), instead of waiting for the fleet rollout. Without a version it installs the newer of the release the agent runs and the latest stable release, so it never moves an agent backwards (an agent on a newer release candidate is re-rendered where it is). Pass version to install an exact published release; a version older than the running one is refused unless allow_downgrade is true, and a version that is neither published nor running is refused - relay those refusals as they are. Check get_cluster_agent_status first: the cluster must be online and have exactly one registered agent. The agent replaces itself and the cluster reads as offline for the seconds it restarts. Requires agents.manage.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "upgrade_cluster_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| version | No | Exact agent release to install, such as 2.1.1250. Optional: without it the platform installs the newer of the running release and the latest stable one. | |
| cluster_id | No | UUID of the target cluster. Optional when a cluster is selected. | |
| cluster_name | No | Exact name of the target cluster. Optional when a cluster is selected. | |
| allow_downgrade | No | true lets version be older than the release the agent runs (a deliberate rollback). Needs version; without it the upgrade never moves the agent backwards. Default false. |