salesforce

Salesforce 用户指南

为销售人员准备可信的 Salesforce 背景信息，或经过安全审核的 Salesforce 操作，同时确保销售工作流的其他环节仍对业务任务具有权威性。

通用技能说明

**必须：**如果当前上下文中尚未包含，请阅读并严格遵循 plugins/sales/skills/index/SKILL.md## 跨技能最佳实践。

Salesforce 操作优先级

当请求的 Salesforce 工作或记录不明确时，按以下优先顺序处理。

1. 用户的明确请求、指定的记录、Salesforce ID、账户、商机、联系人、潜在客户或明确说明的操作
2. 有助于当前销售工作流做出决策的只读背景信息
3. 根据用户措辞和业务背景解析出的精确记录或高置信度候选记录
4. 能够回答请求所需的最少字段集、活动历史、账户计划、事件或转录背景信息
5. 对拟议 Salesforce 更改进行审核后的草稿
6. 获得明确批准且受支持的 Salesforce 写入操作，并随后进行验证

不得默默从多个可能的记录中做出选择，不得将读取操作扩大为写入操作，也不得将用户对澄清问题的回答视为写入批准。

关键依赖类别

这些依赖对当前工作流尤为重要；请根据判断酌情纳入其他数据源以提升质量。

• ~~CRM，具体而言，是已开放的 Agentforce Sales/Salesforce 连接器，用于读取 Salesforce 数据、获取记录链接、账户计划、转录摘要、Agentforce Lead Nurturing 分配，以及执行已批准的写入操作
• 父级销售工作流中的日历、日程安排、会议转录、电子邮件、内部消息、知识与文件或销售情报背景信息，这些内容不由 Salesforce 管理
• 连接器不可用或记录需要消除歧义时，用户提供的记录 ID、名称、导出内容、字段值和业务背景

避免提出缺乏依据的说法。如果 Salesforce 数据缺失、不可用、过时、有歧义，或受已开放的连接器功能限制，请说明这一限制。

工作流指南

严格遵循以下工作流步骤。这些步骤优先于索引技能中的默认工作流。

• 1. 澄清并收集背景信息
  • 确定 Salesforce 任务、目标记录、所需详情，以及用户需要的是读取、草拟还是已批准的写入操作。
  • 如果记录不明确，执行最小范围的精确查询或限定候选项的查询，然后请用户选择，再使用该记录生成摘要或执行写入操作。
• 2. 初稿
  • 优先进行只读查询，并读取或查询最少且正确的记录。在面向用户的输出中使用标签；如果有可信的 URL，请附上可点击的记录链接。
  • 对于拟议更改，请提供经过审核的字段级草稿，注明假设、信息来源缺口，以及仍需获得的确切批准。
• 3. 执行已批准的操作并进行验证
  • 只有在用户明确要求写入或批准经过审核的草稿/更新时，才执行写入操作。
  • 写入前确认目标记录和受支持的字段，仅发送预期更改，检查响应；如果响应无法证明操作结果，则通过范围精简的读取进行验证。

总体规则

• 有可用的有用链接时，始终使用超链接引用来源。
• 销售任务仍由父级工作流负责；本指南负责 Salesforce 专属的查找、查询、链接、账户计划操作、分配和写入安全。
• 优先查询而非猜测。先使用精确 ID 或名称，再查询限定范围的候选项；如果仍有歧义，则请用户选择。
• 不要暗示连接器支持尚未开放的功能。
• 未经明确批准，不得删除、按外部 ID 执行 upsert、调用任意自动化或执行写入操作。

连接器边界

仅使用实际公开的 Agentforce Sales 接口：

• 元数据和身份信息：describe_global、describe_sobject、get_user_info
• 记录查找和读取：get_record_id_by_name、get_record_details、get_activity_history
• 查询：仅限 soql_query
• Sales 专用读取：query_calendar_events、get_account_plan、query_agent_type、summarize_conversation_transcript
• 写入和变更工作流：create_record、update_record、create_account_plan、assign_target_to_sdr

不要暗示支持 SOSL、全局文本搜索、查询续传、Bulk API、Composite API、Data 360、Tableau Analytics、Prompt Builder、Flow 调用、任意可调用操作、通用 Apex REST、删除，或按外部 ID 执行 upsert。对于不受支持的跨对象关键字搜索、大规模导出、高频写入、删除/upsert 或分析请求，请说明缺少相应接口，并要求用户缩小到特定对象、字段、确切标识符，或改用其他获批工具。

Salesforce 查询和写入规则

发现和读取

• 对于基于 Salesforce 的读取、链接、客户计划、分配、转录摘要和写入，必须使用 Salesforce。如果无法使用，请注明答案并非基于 Salesforce。
• 对于“我的”“我”或当前所有者相关请求，使用 get_user_info。对象不确定时使用 describe_global；进行不明显的查询或写入前使用 describe_sobject。
• 仅在影响任务时，确认 API 名称、标签、数据类型、可筛选性、可创建性、可更新性、可空性、选项列表、引用、关系名称和记录类型。
• 不要猜测关系名称。将宽泛的通配符匹配视为候选项，结合业务上下文进行消歧；如果一个有针对性的筛选条件仍无法确定记录，则在总结或写入前先询问。
• 需要将名称转换为 ID 时使用 get_record_id_by_name；需要用于展示的布局上下文时使用 get_record_details；需要活动摘要时使用 get_activity_history；查询 Salesforce Events 时使用 query_calendar_events；需要客户策略上下文时使用 get_account_plan。
• 调用 summarize_conversation_transcript 前，先确定特定的 VoiceCall 或 VideoCall ID。如果通话未知，则分别查询 VoiceCall 和 VideoCall，然后询问要总结哪通通话。

查询护栏

• 对于复杂的 SOQL，明确目标对象、所需字段、筛选条件、排序或限制、用于展示还是分析，以及选择性风险。
• 使用最简单且正确的查询，只选取所需字段；如果行可能需要链接或复用，则包含 Id；添加合理的 LIMIT；仅按 Salesforce 报告为可筛选的字段进行筛选。
• 不要发送聚合或分组 SOQL，包括 COUNT、SUM、GROUP BY 或聚合别名。获取有界且包含 ID 的结果集后在本地总结，或说明无法提供精确的聚合结果。
• 不要按长文本、富文本、Task.Description、历史记录 OldValue/NewValue、IsPriorityRecord 或其他可读但不可筛选的字段筛选。按父记录、日期、所有者、状态或其他可筛选字段限定范围，并在范围有界时于本地进一步筛选。
• 仅对多选列表使用 INCLUDES 或 EXCLUDES。FieldDefinition 查询应限定到已知实体；每个 OR 析取条件应限定到一个字段；跨字段发现应拆分后再于本地合并。
• 优先使用标准的 Account、Opportunity、Contact、Task 和 Event 字段，而非可选字段或自定义字段。对于同一事实，针对架构或查询结构进行两次有针对性的尝试仍失败后，应改用更稳妥的标准字段、精确读取、范围更窄的请求，或明确说明证据缺口。
• 区分明确的重新身份验证错误和运行时就绪状态故障。

写入与链接

• 对于 update_record，只发送已更改的字段。对于 create_record，只发送预期字段；仅当记录类型字段会影响默认值、选项列表或创建能力时，才包含这些字段。
• 请勿通过试探性写入来发现验证规则。如果 Salesforce 返回 FIELD_CUSTOM_VALIDATION_EXCEPTION，请原样显示确切消息，并询问缺少或需要更正的业务值。
• 创建客户计划时，请使用 create_account_plan，而不是通用记录创建。先解析 AccountId，并收集或推导 Name、challenge、competitive、relationship、strategy、StartDate 和 Status；如遇到不受支持的 AccountPlan 错误，请明确说明。
• 调用 assign_target_to_sdr 之前，请先调用 query_agent_type，展示可用 Agent，并获取用户的选择。目标必须是 Contact 或 Lead id。
• 检查每个写入响应；如果响应不足以证明操作结果，请通过返回的字段、get_record_details 或范围精简的 soql_query 进行验证。
• 优先使用连接器返回的记录 URL。如果有可信的组织或实例基础 URL，可构造 Lightning 记录 URL；否则，请显示对象标签和 id，而不要臆造链接。

模式

1. Salesforce 读取

• 当用户或上级销售工作流需要客户、商机、联系人、潜在客户、活动、事件、客户计划或通话记录上下文时使用。
• 先解析目标，然后仅检索影响销售决策的字段和历史记录，并指出信息缺失或存在歧义之处。

输出格式

# [Record Or Salesforce Context]

## Summary

- [Most important CRM fact with source link]
- [Current account, opportunity, contact, activity, or plan signal]
- [Risk, missing field, ambiguity, or source gap]

---

{Follow the instructions and output format/conditions in [Limitations and Improvements](../index/SKILL.md#limitations-and-improvements)}

{Follow the instructions and output format/conditions in [Next Steps](../index/SKILL.md#4-next-steps)}

2. Salesforce 更新草稿

• 当用户要求准备 CRM 更新、备注、字段变更或创建操作，但尚未批准写入时使用。
• 将拟议值与当前值分开，并指出目标记录、假设和所需批准。

输出格式

# Proposed Salesforce Update

**Target:** [Record name, type, and trusted link or id]

| Field | Current Value | Proposed Value | Reason / Source |
| --- | --- | --- | --- |
| [Field label] | [Current value or Unknown] | [Proposed value] | [Grounded reason + link] |

## Before I Write

- [Missing business input, validation risk, or approval needed]

---

{Follow the instructions and output format/conditions in [Limitations and Improvements](../index/SKILL.md#limitations-and-improvements)}

{Follow the instructions and output format/conditions in [Next Steps](../index/SKILL.md#4-next-steps)}

3. 已批准的 Salesforce 写入

• 仅当用户明确要求执行受支持的写入操作，或批准已审核的草稿后使用。
• 如果写入响应不足以得出明确结论，请在报告完成前验证结果。

输出格式

# Salesforce Updated

**Record:** [Record name, type, and trusted link or id]

- **Changed:** [Field or supported action]
- **Result:** [Verified outcome]
- **Not changed:** [Any requested item that was unsupported or skipped]

---

{Follow the instructions and output format/conditions in [Limitations and Improvements](../index/SKILL.md#limitations-and-improvements)}

{Follow the instructions and output format/conditions in [Next Steps](../index/SKILL.md#4-next-steps)}

4. 客户计划、SDR 分配或通话记录

• 当用户明确要求制定客户计划、分配 Agentforce Lead Nurturing、处理 Salesforce 事件，或汇总语音／视频通话记录时使用。
• 先解析所需的记录或通话 id。对于 SDR 分配，请先展示可用 Agent 并获取用户的选择，再进行分配。

输出格式

# [Account Plan / SDR Assignment / Transcript Summary]

## Target

- [Resolved account, contact, lead, event, or call + trusted link]

## Result

- [Supported read, draft, or verified action]
- [Important limitation or missing required input]

---

{Follow the instructions and output format/conditions in [Limitations and Improvements](../index/SKILL.md#limitations-and-improvements)}

{Follow the instructions and output format/conditions in [Next Steps](../index/SKILL.md#4-next-steps)}