Convex

Convex通过在Convex仪表盘中创建的团队访问令牌连接。一个团队访问令牌恰好限定于一个团队，所以一个令牌连接一个团队。令牌在存储前加密，智能体永远看不到它们。

1. 打开Convex dashboard，进入Team Settings → Access Tokens。
2. 点击Create access token并复制令牌值。
3. 把令牌粘贴到Polylane中。
4. Polylane验证令牌并开始同步。

Polylane发现你的项目，以及每个项目中的云部署：生产部署加上任何预览、开发和自定义部署，包括它们的区域、URL和部署类别。

团队访问令牌授予对团队的管理访问权限。同步用团队令牌读取你的项目和部署。当智能体或后台监控读取某个部署的函数日志或指标时，Polylane会铸造一个仅限定于那次读取（日志视图或指标视图）的短期部署密钥，用它完成那一次调用，然后立即删除它，所以每个密钥的存活时间只与它所服务的读取一样长。Polylane读取的一切都位于管理面上：项目和部署列表、函数日志和部署指标。

故障排除

“Not a team access token”错误

• 项目限定的令牌和部署密钥无法列出团队的项目；请在Team Settings → Access Tokens下创建令牌。
• 检查该令牌没有在Convex仪表盘中被删除。

缺少资源

• 本地部署运行在各开发者的机器上，有意不同步。
• 创建时没有部署的项目在首次部署之前不显示任何部署。
• 触发一次手动同步，以便比下一次计划同步更早刷新。

审计日志

• Convex把它的审计日志API限制在付费套餐之后。在免费团队上，审计日志读取会返回明确的错误，智能体会回退到函数日志和上下文图。

断开连接

在Polylane中断开该账户，然后从你的Convex团队设置中删除该访问令牌。

连接Convex不需要浏览器：控制台调用的同一个端点可以放进CI作业。一次经过身份验证的POST创建连接并启动第一次同步。

前提条件

• 一个具有cloud_accounts:write和cloud_accounts:read权限范围的Polylane API密钥。参见API密钥与OAuth。
• 你的工作区ID，以ws_开头。用同一个密钥从GET /v1/workspaces读取它。
• 一个来自Team Settings → Access Tokens的Convex团队访问令牌。

创建连接

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "convex",
    "workspaceId": "ws_0abc123",
    "token": "<team-access-token>"
  }'

团队访问令牌恰好限定于一个团队，所以一次调用连接一个团队。

响应列出已连接的内容，第一次同步已经在运行。精简为流程其余部分读取的两个字段：

{
  "success": true,
  "result": {
    "provider": "convex",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

已经连接的账户会落在failures而不是accounts中，所以重复调用永远不会产生重复的连接。

等待第一次同步

按id轮询每个返回的账户，直到status达到ready（注册时为new，资源流入时为syncing）：

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

给循环一个截止时间，让失败的连接使作业失败而不是挂起。账户变为ready后，它的资源已在拓扑中，Polylane已经开始它的第一次检查。

从API断开连接

删除连接会停止所有同步和检查，并删除Polylane持有的凭据。该调用需要cloud_accounts:delete权限范围：

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

然后按下方Disconnect所述在提供商侧撤销Convex凭据。