技能介绍

要解决什么问题

销售与运营团队把客户、公司、商机放在 Attio 里，但日常查人、按条件拉列表、翻备注往往要在 Web 里点筛选器，复杂条件还要对照 API 文档写 filter JSON。若你已经在对话式环境里接好了 Composio MCP，更希望用一句话完成「按域名找公司」「列出某客户最近备注」这类操作，而不是反复切换界面。

技能如何工作

本技能把 Attio 工作区能力封装成一组自然语言可触发的工具，核心路径包括：

模糊搜索（ATTIO_SEARCH_RECORDS）：按姓名、域名、邮箱、电话等在指定对象（如 people、companies、deals）里检索；需明确 query、objects 与 request_as（通常用 workspace 上下文）。
服务端筛选查询（ATTIO_QUERY_RECORDS）：用 Attio 的 $eq、$contains、$gte、$and 等算子做排序与分页，适合「2025 年后创建的公司按名称排序」这类确定性结果；比纯搜索更适合要保证数据新鲜度的场景。
按 ID 或属性定位（ATTIO_FIND_RECORD）：例如用 attributes 匹配 example.com 对应的公司记录。
备注与结构：ATTIO_LIST_NOTES 可按父记录拉备注；ATTIO_GET_OBJECT / ATTIO_LIST_ATTRIBUTES 用于弄清自定义字段 slug，避免 filter 写错。
简单分页列表（ATTIO_LIST_RECORDS）：按对象类型按创建顺序批量拉记录。

使用前需在客户端配置 Composio MCP，并按提示完成 Attio OAuth 绑定。工具文档见 composio.dev 上的 Attio toolkit。

适用边界与注意点

时间比较一律用 ISO8601 字符串（如 2025-01-01T00:00:00.000Z），不要用 Unix 时间戳。
人员 name 必须嵌套在 name 下（如 name.first_name），顶层 first_name 会报未知属性。
email_addresses 不支持 $not_empty；记录引用类字段要用 path 约束，不能把 lists 当成普通 object_id。
ATTIO_SEARCH_RECORDS 结果是最终一致的；要最新数据请用 ATTIO_QUERY_RECORDS。各工作区自定义属性 slug 不同，动手写 filter 前先 LIST_ATTRIBUTES 核对。