用途：通过 Attio CRM 的 REST API v2 直接读取和写入数据，agent-swarm 不维护单独的 Attio 同步副本。
主要能力：发现对象与 slug；用过滤条件与分页查询记录；获取单条记录；对公司（matching_attribute 为 domains）和人员（matching_attribute 为 email_addresses）执行 upsert；用 PATCH 更新指定属性；写入笔记、创建关联任务、发布评论；查询列表或流水线视图；跨对象全局搜索。
必要用法：先解析密钥 ATTIO_API_KEY=$(get-config key="ATTIO_API_KEY" includeSecrets=true)，基础 URL 为 https://api.attio.com/v2/，请求头使用 Authorization: Bearer $ATTIO_API_KEY、Content-Type: application/json 与 Accept: application/json。优先使用 upsert：PUT /v2/objects/{slug}/records 配合 matching_attribute，可重复调用；POST /records 可能产生重复。属性值必须写成数组，即使是标量也要用 [{"value": 42}]。分页通过递增 offset 直到返回为空。
限制与注意事项：读限速 100 次/秒（建议约 80），写限速 25 次/秒（建议 15-20），循环写调用之间加 sleep 0.05，Attio 未提供原生批量端点。webhook 至少投递一次且仅含 ID，需重新 GET 完整记录；超时 5 秒，应立即返回 200 并异步处理。Attio 没有 API 级记录合并端点，去重需以评论或任务标记交由人工复核。密钥无效时重新从配置获取，仍失败需通知 Lead 轮换，不静默重试。错误码：401 密钥无效、403 权限不足、404 slug 或记录 ID 错误、400 body 格式错误、422 校验冲突、429 限速需退避重试。官方文档见 https://developers.attio.com/reference。