Dynamics 365 CRM 自动化实战：用 Claude Skill 管理线索、商机与客户工单-平芜编程栈

AI 技能
AI 插件
人工智能
工作流自动化

【免费下载链接】awesome-claude-skills

A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows

项目地址：https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills

核心指南主体：composio-skills/dynamics365-automation/SKILL.md 提供了一套开箱即用的 Dynamics 365 自动化 Skill，让 Claude 通过 Rube MCP（Composio 托管）直连 Microsoft Dynamics 365 CRM，围绕线索（Lead）、客户（Account）、联系人（Contact）、商机（Opportunity）、销售订单（Sales Order）、发票（Invoice）与支持工单（Case）完成创建、更新、查询等日常操作。读完本文，你将掌握如何建立 dynamics365 连接、调用DYNAMICS365_DYNAMICSCRM_*系列工具、正确填写 CRM 实体字段（GUID、OData 过滤、实体引用格式），并避开最常见的报错陷阱，把整套 CRM 操作安全地编排进你的 Agent 工作流。

一、Skill 定位：把 Dynamics 365 变成 Agent 的可操作对象

在 awesome-claude-skills 仓库中，Dynamics 365 Automation 归属于「App Automation via Composio」分类——这是一批为 78 个 SaaS 应用预构建的自动化 Skill，每个 Skill 都包含工具调用序列、参数指引、已知陷阱与速查表，且全部基于 Composio API 发现的真实工具 slug。本 Skill 的 frontmatter 明确声明了它的技术底座：

name: Dynamics 365 Automation description: "Dynamics 365 Automation: manage CRM contacts, accounts, leads, opportunities, sales orders, invoices, and cases via the Dynamics CRM Web API" requires: mcp: [rube]

三个关键信息：

能力边界：覆盖 CRM 销售与客服主链路——线索、客户、联系人、商机、销售订单、发票、工单；
底层协议：所有操作最终经由Dynamics CRM Web API完成（工具名中的DYNAMICSCRM即来源于此）；
依赖声明：requires.mcp指明必须挂载Rube MCP 服务器，这决定了 Skill 的运行前提。

关于 Skill 的加载机制：Claude 在会话启动时只读取 name 与 description（约 100 token），当任务相关时才完整加载SKILL.md正文——这意味着本 Skill 可以常驻在你的 skill 目录而不会挤占上下文窗口，只有在涉及 Dynamics 365 任务时才会被激活。

二、环境准备：连接 Rube MCP 与 dynamics365 toolkit

2.1 前置条件

本 Skill 要求Rube MCP 服务器以https://rube.app/mcp为地址接入（Rube 是 Composio 托管的 MCP 网关，文档声明无需额外 API Key，添加端点即可使用）。在开始任何工具调用前，必须确认 dynamics365 toolkit 存在一条 ACTIVE（活跃）连接；如果没有，需要通过RUBE_MANAGE_CONNECTIONS发起并完成授权。

2.2 标准连接流程

从同仓库的 composio-skills/composio-automation/SKILL.md 可以看到这套 Rube 类 Skill 的统一接入范式，应用到本 Skill 即为：

验证 Rube MCP 可用：确认RUBE_SEARCH_TOOLS能正常响应；
发起连接：调用RUBE_MANAGE_CONNECTIONS，传入 toolkit 名dynamics365；
完成授权：若连接状态不是 ACTIVE，按返回的认证链接完成 OAuth/凭据配置；
确认状态：返回 ACTIVE 后再执行任何工作流。

2.3 工具发现优先

Rube 架构强调「先搜索、后执行」：工具 schema 会随 Composio 侧演进而变化，切勿硬编码工具 slug 或参数。标准做法是先用RUBE_SEARCH_TOOLS拉取当前可用工具、输入 schema 与推荐的执行计划：

RUBE_SEARCH_TOOLS queries: [{use_case: "Dynamics 365 CRM operations", known_fields: ""}] session: {generate_id: true}

搜索结果会返回本 Skill 速查表中的全部DYNAMICS365_DYNAMICSCRM_*工具 slug 及其字段定义。执行阶段则通过RUBE_MULTI_EXECUTE_TOOL完成（注意memory参数必须保留，即使为空也要传{}）。

延伸阅读：完整的 Rube 三步工作流（Discover → Check Connection → Execute）与分页、会话复用等注意事项，见 composio-skills/composio-automation/SKILL.md。

三、核心工作流 1：管理线索（Leads）

线索是销售漏斗的起点。本 Skill 提供 4 个线索工具，覆盖完整生命周期：

工具	作用
`DYNAMICS365_DYNAMICSCRM_CREATE_LEAD`	创建新线索
`DYNAMICS365_DYNAMICSCRM_UPDATE_LEAD`	更新既有线索
`DYNAMICS365_DYNAMICSCRM_GET_A_LEAD`	按 GUID 检索单条线索
`DYNAMICS365_DYNAMICSCRM_GET_ALL_LEADS`	列表/过滤查询全部线索

3.1 创建线索的关键参数

firstname— 线索名
lastname— 线索姓氏
emailaddress1— 主邮箱（Dynamics 使用address1/2/3后缀区分多个同名属性，1即主值）
telephone1— 主电话号码
companyname— 关联公司名
subject— 简短的标题/描述，常用于标记意向

示例调用：

Tool: DYNAMICS365_DYNAMICSCRM_CREATE_LEAD Arguments: firstname: "Jane" lastname: "Smith" emailaddress1: "jane.smith@example.com" companyname: "Acme Corp" subject: "Interested in Enterprise plan"

3.2 查询线索的关键参数

GET_ALL_LEADS是列表接口，查询能力由四个参数组合实现：

filter—OData 过滤表达式，如"contains(fullname,'John')"（按姓名模糊匹配）
select— 指定返回字段，如"fullname,emailaddress1"（减少响应体积）
orderby— 排序表达式，如"createdon desc"（按创建时间倒序）
top— 最大返回条数（分页场景下与 top/skip 语义一致）

OData 语法是 Dynamics Web API 的查询标准，支持contains、startswith、eq、and/or等运算符。语法错误不会抛出显式异常，而是返回空结果或错误响应——排查时优先怀疑 filter 写法。

四、核心工作流 2：管理客户（Accounts）

DYNAMICS365_DYNAMICSCRM_CREATE_ACCOUNT用于创建并维护客户（公司）档案。

关键参数：

name— 客户/公司名称
description— 客户描述
revenue— 营收金额（数值类型，如5000000表示 500 万）
accountcategorycode— 类别代码（整数，默认值 1）
creditonhold— 是否处于信用冻结状态（布尔值，true/false）

示例调用：

Tool: DYNAMICS365_DYNAMICSCRM_CREATE_ACCOUNT Arguments: name: "Contoso Ltd" description: "Strategic partner for cloud services" revenue: 5000000 creditonhold: false

说明：accountcategorycode属于选项集（OptionSet）字段，整数映射到组织内定义的选项。文档标注默认值 1，若你的环境自定义过选项集，应通过RUBE_SEARCH_TOOLS返回的 schema 确认当前合法取值。

五、核心工作流 3：管理联系人（Contacts）

DYNAMICS365_DYNAMICSCRM_CREATE_CONTACT创建包含地址与电话信息的完整联系人档案。

关键参数：

firstname、lastname— 联系人姓名
emailaddress1— 主邮箱
telephone1— 主电话
mobilephone— 手机号
jobtitle— 职位
address1_city、address1_stateorprovince、address1_postalcode、address1_country— 地址四要素（address1前缀代表主地址，与 CRM 的地址分区模型一致）

示例调用：

Tool: DYNAMICS365_DYNAMICSCRM_CREATE_CONTACT Arguments: firstname: "Bob" lastname: "Johnson" emailaddress1: "bob.johnson@example.com" jobtitle: "VP of Engineering" address1_city: "Seattle" address1_stateorprovince: "WA"

联系人常与客户、商机联动：一条商机（Opportunity）可以同时挂接customer_account_id（客户 GUID）与customer_contact_id（联系人 GUID），因此建议在自动化流程中先创建 Account，再创建挂靠其下的 Contact，最后引用二者 GUID 创建 Opportunity。

六、核心工作流 4：管理商机（Opportunities）

商机承载预估价值与预期成交日期，是销售预测的核心对象。

工具	作用
`DYNAMICS365_DYNAMICSCRM_CREATE_OPPORTUNITY`	创建商机
`DYNAMICS365_DYNAMICSCRM_UPDATE_OPPORTUNITY`	更新商机（评级、阶段）

6.1 创建商机的关键参数

name（必填）— 商机标题
description— 简要描述
estimatedvalue— 预期营收（数值）
estimatedclosedate— 预期成交日期，格式必须为YYYY-MM-DD
customer_account_id— 关联客户的 GUID（不要带花括号）
customer_contact_id— 关联联系人的 GUID（不要带花括号）

示例调用：

Tool: DYNAMICS365_DYNAMICSCRM_CREATE_OPPORTUNITY Arguments: name: "Enterprise Cloud Migration" estimatedvalue: 250000 estimatedclosedate: "2026-06-30" description: "Full cloud migration project for Contoso"

6.2 更新商机的关键参数

opportunity_id（必填）— 商机 GUID
opportunityratingcode— 商机评级：1（Cold/冷）、2（Warm/温）、3（Hot/热）
salesstagecode— 销售阶段：1（Qualify/资格确认）、2（Develop/开发）、3（Propose/提案）

这两个选项集字段是典型的销售推进信号：把salesstagecode与opportunityratingcode的联动更新（例如 Hot + Propose）作为 Agent 的「升级动作」，即可实现自动化的销售阶段流转。

七、核心工作流 5：销售订单与发票（Sales Orders & Invoices）

工具	作用
`DYNAMICS365_DYNAMICSCRM_CREATE_SALES_ORDER`	创建销售订单
`DYNAMICS365_DYNAMICSCRM_UPDATE_SALES_ORDER`	更新销售订单
`DYNAMICS365_DYNAMICSCRM_CREATE_INVOICE`	创建发票用于开票结算

7.1 创建销售订单的关键参数

name— 订单名称
description— 描述
account_id— 客户引用，格式"/accounts(GUID)"
currency_id— 币种引用，格式"/transactioncurrencies(GUID)"
price_level_id— 价格表引用，格式"/pricelevels(GUID)"

注意：这三个引用参数与商机的 GUID 传参方式不同——这里必须使用 Dynamics Web API 的导航引用格式/entityset(GUID)（含前导斜杠与括号）。

7.2 更新销售订单的关键参数

salesorder_id（必填）— 订单 GUID
name— 更新后的订单名
discountamount— 更新后的折扣金额
freightamount— 更新后的运费

7.3 创建发票的关键参数

name— 发票名称/编号，如"Invoice #12345"
description— 发票描述
account_id— 关联客户引用（/accounts(GUID)）
currency_id— 币种引用（/transactioncurrencies(GUID)）
price_level_id— 价格表引用（/pricelevels(GUID)）

实用组合：订单确认后由 Agent 基于同一组account_id/currency_id/price_level_id生成发票，即可把「订单 → 开票」衔接成一条自动化流水线；后续更新freightamount（运费）或discountamount（折扣）时，务必先按 GUID 检索订单再更新，避免覆盖其他字段。

八、核心工作流 6：创建支持工单（Support Cases）

DYNAMICS365_DYNAMICSCRM_CREATE_CASE用于创建 incident/case 记录，纳入客服跟踪体系。

关键参数：

title— 工单主题/标题
description— 详细描述
prioritycode— 优先级：1（Low/低）、2（Normal/普通）、3（High/高）
caseorigincode— 来源渠道：1（Phone/电话）、2（Email/邮件）、3（Web/网页）
account_id— 关联客户，格式"/accounts(GUID)"
contact_id— 关联联系人，格式"/contacts(GUID)"

示例调用：

Tool: DYNAMICS365_DYNAMICSCRM_CREATE_CASE Arguments: title: "Login issue reported by customer" description: "Customer unable to access portal since Feb 10" prioritycode: 3 caseorigincode: 2

结合 6.2 的商机评级字段可以看到本 Skill 的字段设计规律：选项集字段（category/priority/origin/rating/stage code）一律使用整数映射，且文档均已给出1/2/3的默认语义，直接按语义取值即可。

九、已知陷阱速查（Known Pitfalls）

这是本 Skill 最具实战价值的部分，直接决定调用成功率：

陷阱	细节
GUID 格式	所有实体 ID 均为 GUID（如`"00000000-0000-0000-0000-000000000000"`）。商机/联系人引用不得包含花括号。
引用格式	关联实体引用使用`"/entityset(GUID)"`格式（如`"/accounts(abc-123)"`）。缺少前导斜杠或括号会导致报错。
OData 过滤语法	`filter`必须使用 Dynamics 365 OData 语法（如`contains(fullname,'John')`）。语法错误会返回空结果或错误响应。
user_id 默认值	多数工具默认`user_id`为`"me"`（当前认证用户）。仅在代表他人操作时才覆盖此值。
必填字段	`CREATE_OPPORTUNITY`要求`name`。其余创建工具无严格必填项，但空参数会创建空记录，应尽量补齐业务字段。

几点补充解读（依据上述文档与源码结构推断）：

两种 ID 传参并存是本 Skill 最容易踩坑的点：商机类工具（customer_account_id等）传裸 GUID，订单/发票/工单类工具（account_id等）传/entityset(GUID)完整引用，二者不可混用；
创建类工具大多不校验必填，意味着「参数缺失」不会报错而是静默生成脏数据，因此在 Agent 侧建议对关键字段（如lastname、name、title）做前置断言；
涉及跨实体引用（Contact→Account、Opportunity→Account/Contact）时，建议先执行检索类工具（如GET_A_LEAD、GET_ALL_LEADS）拿到 GUID 再做引用，避免手写错误 ID。

十、工具速查表（Quick Reference）

工具 Slug	描述
`DYNAMICS365_DYNAMICSCRM_CREATE_LEAD`	创建新线索记录
`DYNAMICS365_DYNAMICSCRM_UPDATE_LEAD`	更新既有线索
`DYNAMICS365_DYNAMICSCRM_GET_A_LEAD`	按 GUID 检索线索
`DYNAMICS365_DYNAMICSCRM_GET_ALL_LEADS`	列表/过滤全部线索
`DYNAMICS365_DYNAMICSCRM_CREATE_ACCOUNT`	创建新客户
`DYNAMICS365_DYNAMICSCRM_CREATE_CONTACT`	创建新联系人
`DYNAMICS365_DYNAMICSCRM_CREATE_OPPORTUNITY`	创建新商机
`DYNAMICS365_DYNAMICSCRM_UPDATE_OPPORTUNITY`	更新既有商机
`DYNAMICS365_DYNAMICSCRM_CREATE_SALES_ORDER`	创建新销售订单
`DYNAMICS365_DYNAMICSCRM_UPDATE_SALES_ORDER`	更新既有销售订单
`DYNAMICS365_DYNAMICSCRM_CREATE_INVOICE`	创建新发票
`DYNAMICS365_DYNAMICSCRM_CREATE_CASE`	创建支持工单/事件

十一、把六个工作流串成一条销售自动化链路

六个工作流并非孤立功能，按 CRM 业务逻辑可编排为一条端到端链路：

线索培育：CREATE_LEAD录入外部渠道线索，用GET_ALL_LEADS（filter: contains(fullname,'...')）定期清洗重复线索；
客户化：线索确认意向后，CREATE_ACCOUNT建立公司档案，CREATE_CONTACT挂靠联系人；
商机推进：引用客户/联系人 GUID 创建 Opportunity，用UPDATE_OPPORTUNITY的salesstagecode/opportunityratingcode推进阶段；
成交开票：商机进入 Propose 阶段后，CREATE_SALES_ORDER（带/accounts(GUID)、/pricelevels(GUID)引用）生成订单，再由CREATE_INVOICE生成发票；
售后支撑：成交客户遇到问题，CREATE_CASE建立工单，prioritycode: 3标记高优。

每次执行前保留三步纪律：先RUBE_SEARCH_TOOLS确认 schema → 再RUBE_MANAGE_CONNECTIONS确认 ACTIVE → 最后RUBE_MULTI_EXECUTE_TOOL携带memory: {}执行；同一工作流内复用 session ID，新工作流生成新 session（详见 composio-skills/composio-automation/SKILL.md 的注意事项）。

十二、总结

Dynamics 365 Automation Skill 将 Microsoft CRM 的销售与客服核心对象全部抽象为 12 个DYNAMICS365_DYNAMICSCRM_*工具，配合 Rube MCP 的统一连接与工具发现机制，使 Claude 能够独立完成从线索录入到工单创建的完整业务闭环。使用时务必牢记三条主线：连接先行（dynamics365 toolkit 必须 ACTIVE）、schema 优先（每次执行前搜索确认）、格式精确（GUID 不带花括号、引用带/entityset()、日期用YYYY-MM-DD、过滤用 OData 语法）。原始 Skill 定义与全部参数细节可在 composio-skills/dynamics365-automation/SKILL.md 中随时查阅。