HubSpot Work 是 HubSpot 中的项目与工作管理产品,把团队的 Plans、跟踪器及其自动化放在 CRM 旁边。它目前处于公开测试阶段,因此某个账户可能尚未拥有该产品。
用途与结构
其组织层级为:工作区(一个团队的区域及其共享设置)下包含项目(一个具体倡议,含表、文档和智能体)。项目中的表是带类型的跟踪器,每行是一条记录;记录可带有子项,子项拥有独立于父项列的自己的列,且只属于一个父项、没有自己的分组。分组用于归类条目,例如阶段、周或看板列。文档保存项目的书面上下文,如简报、计划和笔记。智能体是项目的自动化,由目标加若干工作流组成,工作流由表事件触发,例如条目创建、列变更、条目移入分组、到达某个日期或按计划运行。
主要能力
通过 hubspot work 命令及其各子命令的帮助可了解参数、输入行和输出格式。可执行的操作包括:projects list、projects get PROJECT_ID 查看表的智能体与工作区;tables search --query 按词查找表,tables list --project 列出项目下的表;tables get TABLE_ID 查看列、选项与分组,tables options 分页查看长选项列表;records search --table 按过滤、分组或父级检索记录,records get 读取单条记录;comments list 查看记录上的对话;docs list、docs get 读取项目文档;agents list、agents get 查看自动化的触发与动作、是否启用及被 HubSpot 暂停的原因;users search 查找人员,hubspot whoami 确认当前身份。写入方面支持 records create、records update(JSONL)、records complete 标记完成,以及 comments create 发表评论。
值、标签与身份
每次读取会给出 values 和 labels 两种视图:values 是实际存储的值(选项值、用户 id、以毫秒计的时间戳),也是写入时接受的格式;labels 是人看到的显示文本。应以 values 推理和写入,用 labels 与人交流。列名、选项值、分组名都是内部标识,与显示标签不同;7-123 这类 id 是稳定句柄,名称可能不唯一且会变化。人员列及评论 @提及 使用 HubSpot 用户 id,且该人需能访问对应表,否则虽可保存但会有警告。
访问与缺失
每个 work 命令都以执行 hubspot auth login 的那个人的身份与其 Work 权限运行,看到和写入的都受该人权限限制,写入会记在其名下。服务密钥被有意拒绝。找不到某项不代表不存在:无权查看的表、项目和记录会被省略,表搜索是模糊匹配的,应表述为“在你可见范围内没找到名为 X 的表”。错误信息会说明原因,例如账户尚未开通 Work、登录缺少读写权限或该人无权访问某工作区、项目或表,应转达解决方式而非重试绕过。评论另有权限检查,新建表后可能需等待一两分钟。
写入的影响
Work 表是共享的实时团队数据,变更会立即对所有可见者生效并记入活动记录,还可能触发智能体的工作流,如通知、新建子项、更新其他记录或写入 CRM。批量更改前应查看项目智能体以了解会触发什么。@提及和指派会通知到人,不应提及或指派对方未要求的人。命令行中的评论和记录无法编辑或删除,如需删除应把记录链接发给对方在 HubSpot 中操作。records update 和 records complete 要求先预览:--dry-run 显示每条记录的当前值与新值并给出摘要,凭该摘要应用时会重新校验每条记录,若期间有人修改则拒绝并需重新预览。
查找与读取
从对方提到的内容入手:按名称搜索表,或列出项目逐层浏览。检索前先读表结构(tables get)以确定状态、截止日期或负责人所在的列、各选项值与分组,再按存储值过滤而非按标签。标记为 readOnly 的列不接受写入;当列的 optionsSource 为 PAGED 或 EXTERNAL 时,tables get 只列出部分选项,需用 tables options 分页搜索完整列表。列表、搜索和文档都分页返回,默认 jsonl 只打印行,若需完整结果(计数、是否全部逾期、计划摘要)应以 --format json 读取并沿 meta.next 用 --after 翻页至 null。总结时应区分数据事实与自己的推断,并提供记录、表、文档和智能体的 url 链接。
写入方式
只改对方要求的字段:每条更新行由记录 id、recordType 和要改的值组成,省略的字段保持原值,回传整行会重写未打算改动的字段。新建条目需要分组(按对方意图选择,未说明则用表的第一个分组),新建子项需要父条目。标记完成应使用 records complete,它按表自身定义的 done 状态写入,优于自行写状态值。单次调用最多处理 100 条记录,更大的更改应分批预览并用平实语言汇报进度。写入结果会返回记录现状,以及 skipped(已处于该状态)和 warnings(如被指派者看不到该表),两者都需告知对方。
范围区分
联系人、公司、交易、工单和 CRM 任务属于 CRM 记录,有各自的技能,即使 Work 表可通过关联列链接到它们;CRM 工作流与 Work 智能体是不同产品;HubSpot 开发者项目(hs project)与 Work 项目无关。
限制
资料未提供定价、具体平台客户端或独立安装方式,唯一调用入口为 HubSpot Agent CLI 的 hubspot work 命令;产品处于公开测试阶段,可用性取决于账户是否开通;所有操作受当前登录用户权限约束;评论在 CLI 中不可编辑或删除。