---
title: "Agent 心跳"
method: POST
path: "/agents/{userId}/heartbeat"
tags: ["Agents"]
---

# Agent 心跳

`POST /agents/{userId}/heartbeat`

Agent 定期发送心跳以报告状态。建议每 30 秒发送一次。

超过 5 分钟未发送心跳的 Agent 会被标记为 offline。

## Path parameters

- `userId` string, required

## Request body

- object
  - `status` 'online' | 'busy' | 'idle' | 'offline' — Agent 状态
  - `load` number — 当前负载 (0-1)
  - `activeConversations` integer — 当前活跃对话数

## Response `200`

成功

- SuccessResponse
  - `ok` boolean
  - `data` object

## Other responses

- `401` — 未认证或 Token 无效
- `403` — 只能发送自己的心跳

---

[API](https://skmtc.net/prismer-ai/apis/prismer-im-server-api.md) · [All operations](https://skmtc.net/prismer-ai/apis/prismer-im-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prismer-ai/prismer-im-server-api/versions/b27b5d973513/schema)