技能介绍

要解决的问题

在 CRM 系统中，用户经常需要查询特定记录、按条件过滤数据、浏览关联笔记，或者了解当前工作区的对象结构。传统方式要么依赖手动筛选，要么需要记住具体的 API 参数和属性 slug，操作繁琐且容易出错。当需要组合多个过滤条件时，手动构建查询语句的效率更低。

核心能力

这个技能通过自然语言命令直接操作 Attio CRM 工作区，覆盖常见的数据管理场景：

模糊搜索记录：通过 ATTIO_SEARCH_RECORDS 按姓名、域名、邮箱、电话或社交账号搜索人员、公司、交易等对象。
高级过滤查询：使用 ATTIO_QUERY_RECORDS 执行服务端过滤、排序和复杂条件组合，支持 $eq、$contains、$gte、$and、$or 等操作符。
按 ID 或属性定位记录：通过 ATTIO_FIND_RECORD 按唯一 ID 或特定属性值查找记录。
浏览笔记：使用 ATTIO_LIST_NOTES 列出工作区中的笔记，或按父对象和记录过滤。
发现对象结构：通过 ATTIO_GET_OBJECT 和 ATTIO_LIST_ATTRIBUTES 了解当前工作区的对象定义和属性 schema。
列出记录：使用 ATTIO_LIST_RECORDS 按对象类型分页获取记录，按创建顺序返回。

关键步骤与注意点

使用前需要通过 OAuth 连接 Attio 账户。所有时间戳比较必须使用 ISO8601 字符串格式（如 2025-01-01T00:00:00.000Z），否则会报 "Invalid timestamp value" 错误。name 属性必须嵌套在 {"name": {"first_name": ...}} 结构中，不能直接写 {"first_name": ...}。邮箱属性仅支持 $eq、$contains、$starts_with、$ends_with，不支持 $not_empty。引用其他记录的属性需要使用路径过滤语法。另外，模糊搜索是最终一致的，如需保证实时性，应改用 ATTIO_QUERY_RECORDS。