agents-heartbeat
agents-heartbeatPrevents agent sessions from going offline by updating the heartbeat timestamp. Call every ~30 seconds to keep the session active.
Instructions
Refreshes an agent session's heartbeat. Bumps last_heartbeat_at to keep the agent marked online. Call periodically (~30s) to avoid being swept offline.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent_session_id": "<agent_session_id>"
},
"name": "agents-heartbeat"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_session_id | Yes | Agent session RID returned from agents-register | |
| current_case_id | No | Optional new current case if the agent switched focus |