用途：把 AI 智能体连接到任意 CRM 的 API，而非针对某个 CRM 的专用技能。连接一次后在项目里留下“连接卡片”，后续会话直接复用。
连接流程（首次按顺序执行）： G1 识别 CRM，向用户确认使用哪个 CRM、要做什么（录入线索/管理交易/报表），并查找该 CRM 的官方 API 文档；无文档时不猜测端点。 G2 认证，优先级为 API 密钥 > Personal Access Token > OAuth2（对智能体是最后手段）。密钥只存于环境变量（如 HUBSPOT_API_KEY、PIPEDRIVE_API_TOKEN），禁止写入文件或聊天；用户不清楚发放位置时引导其到 Settings → API/Integrations。 G3 用最廉价的读取调用验证，如列出一条联系人，确认返回 200；失败时先复核认证方式（header、Basic 或 query param，各 CRM 不同）。 G4 实体映射，核对该 CRM 的术语：人（HubSpot contact、Pipedrive person、Close contact）、公司（company、organization，注意 Close 的 lead 指公司）、交易（deal、opportunity）、活动/备注（engagement、activity/note、note）等。术语不核对会导致数据写错位置。 G5 在项目根目录创建 CRM.md，记录 CRM 名称、base URL、认证方式与环境变量名、已验证端点、实体术语映射、管道/阶段 ID、自定义字段 ID、速率限制。
通用硬性规则：创建前先按邮箱或姓名搜索去重；用 ID 而非 label 写入；删除、合并、批量更新必须经用户批准并先展示数量与对象；写入后汇报结果（创建/修改条数、记录链接）；含特殊字符或表情的正文用 Python json.dumps()，curl 内联 JSON 会损坏；未确认分页（has_more/cursor/offset）不得断言“全部”；按文档确认速率限制并对批量操作限流（默认安全值 5 req/s）；不信任缓存 ID，管道与自定义字段在写入前实时查询。
常见模式：表单/落地页线索写入 CRM 时创建人与公司并记录 utm 来源；从 CRM 提取线索邮箱到广告平台自定义受众；会议简报先由日历参会人邮箱查 CRM 记录；周度管道报表按阶段 ID 统计数量与金额，label 仅用于展示。
以 Airtable/Notion 当 CRM：先读表/数据库结构，将实体映射应用到用户结构，其余硬性规则相同；select 字段选项名即阶段角色，新增选项需批准。
限制与未提供项：具体 CRM 的端点、字段、速率限制数值需查阅其官方文档；本资料未提供价格、平台支持范围之外的收费信息。