同事推荐了这款，我拿自己手头的一个真实任务走了一遍完整流程，没有用示例数据。

`POST /v1/agents/run` 超时后我重试，同一个 `idempotency_key` 返回 409 `duplicate`，可第一次的请求其实没执行成功，任务永久卡在 running，只能人工介入。

Webhook 签名统一成文档里的 hex 编码，或在 header 里声明编码方式；校验失败率应该能从 100% 直接归零。

PATCH 实际是整对象覆盖，静默重置字段比直接报错还难查。

我当时的调用大概是这样：

func doWithRetry(ctx context.Context, c *beehub.Client, req beehub.ChatRequest) (*beehub.ChatResponse, error) {
    for i := 0; i < 4; i++ {
        res, err := c.Chat(ctx, req)
        if err == nil {
            return res, nil
        }
        var rl *beehub.RateLimitError
        if !errors.As(err, &rl) {
            return nil, err // 只重试限流，其余立即失败
        }
        time.Sleep(time.Duration(1<<i) * time.Second)
    }
    return nil, errors.New("rate limited after 4 attempts")
}