experience-cms-brand-apply

应用 CMS 品牌

用于搜索、提取和应用 CMS 品牌指南来生成内容的通用技能。

适用范围

此技能用于将 Salesforce CMS 中现有的品牌指南应用到你生成的内容中。

用户希望执行以下操作时，请使用此技能：

• 将品牌语气或风格应用到生成的内容中
• 查找并使用存储在 Salesforce CMS 中的品牌指南
• 在其组织中搜索现有品牌
• 获取用于生成内容的品牌指引
• 确保生成的内容符合其品牌标识
• 将品牌样式、语气或风格应用到页面、组件或应用中

用户希望执行以下操作时，请勿使用此技能：

• 搜索图像或媒体（请使用 experience-search-coordinate 技能）
• 从头创建新品牌（请使用 experience-cms-brand-create 技能）
• 在 CMS 中编辑品牌定义
• 生成徽标或视觉品牌素材

开始之前

重要：应用任何品牌之前，必须先获取品牌指引。

用户请求生成符合品牌风格的内容时：

1. 搜索可用品牌（如果尚未确定品牌）
2. 提取所选品牌的指引
3. 将品牌指南应用到生成的所有内容中

切勿先生成内容，再事后补上品牌风格。 从一开始就必须依据品牌指引生成内容。

工作流概览

复制此检查清单并跟踪进度：

CMS Branding Progress:
- [ ] Step 1: Determine if brand is already identified or needs search
- [ ] Step 2: Search for brands (if needed) and present options to user
- [ ] Step 3: Extract brand instructions for the selected brand

第 1 步：确定品牌背景

检查用户是否已指定要使用的品牌：

品牌已知（用户已命名，或仅有一个品牌）：

• 跳至第 3 步（提取品牌指引）

品牌未知（用户说“应用我的品牌”，但未指定具体品牌）：

• 继续执行第 2 步（搜索品牌）

第 2 步：搜索品牌

工具： search_media_cms_channels

品牌以类型为 sfdc_cms__brand 的 CMS 内容形式存储。通过查询 CMS 渠道并指定品牌内容类型来搜索品牌。

注意： 品牌内容搜索（contentTypeFqn=sfdc_cms__brand）明确不属于 experience-search-coordinate 技能的范围。在此处直接调用 search_media_cms_channels 是正确且有意为之的 — 请勿通过 experience-search-coordinate 搜索品牌。

流程：

1. 确定搜索查询 — 使用用户提供的关键词。品牌搜索会匹配品牌标题和描述。
2. 使用固定的品牌搜索输入约定构建请求：

{
  "inputs": [{
    "searchKeyword": "keyword",
    "searchLanguage": "<detected_language>",
    "channelType": "PublicUnauthenticated",
    "contentTypeFqn": "sfdc_cms__brand",
    "pageOffset": 0,
    "searchLimit": 25
  }]
}

字段规则：

• searchKeyword — 用户输入的关键词
• searchLanguage — 根据用户输入自动检测；如果无法确定，请使用 en_US
• channelType — 始终为 PublicUnauthenticated（品牌内容通过公共 CMS 渠道提供；此工具不支持在经过身份验证的渠道中搜索品牌）
• contentTypeFqn — 始终为 sfdc_cms__brand
• pageOffset — 0
• searchLimit — 25

3. 使用此请求调用 search_media_cms_channels
4. 解析响应 — 品牌结果的 ID 以 9Ps 开头。提取以下内容：
   • managedContentId — 唯一 ID（在第 3 步提取内容时使用）
   • managedContentKey — 内容键标识符
   • title — 品牌显示名称
   • contentUrl — 品牌内容的 URL，位于 managedContentChannelDeliveryDetails[0].contentUrl 下
   • pageNumber、pageSize、totalResults — 分页摘要

展示品牌结果

如果找到品牌，先显示摘要行，然后使用 ask_followup_question 提供选项：

Showing [N] of [totalResults] total results (page [pageNumber], page size [pageSize]).

Which brand should I apply?

1. [Brand Title 1]
2. [Brand Title 2]
3. [Brand Title 3]

Which brand would you like to use?

用户回复选择后，不要再次搜索 — 立即进入第 3 步。

如果找到一个品牌，请向用户确认：

I found the brand "[Brand Title]". Should I apply this brand's guidelines to the content?

如果未找到品牌：

No brands found in Salesforce CMS. To use branding:
1. Create a brand in Salesforce CMS (Content Type: sfdc_cms__brand)
2. Provide brand guidelines directly in this conversation

Would you like to proceed without CMS branding, or provide guidelines manually?

切勿自动选择品牌，必须先获得用户确认。 请始终等待用户选择。

第 3 步：提取品牌说明

工具： get_brand_instructions

流程：

1. 调用 get_brand_instructions — 这会获取品牌说明提取提示词模板

2. 解析响应：

   • promptBody — 包含完整的品牌说明提示词，其中包含提取和应用规则

3. 遵循 promptBody 中的说明 — 提示词模板包含以下具体指导：

   • 如何从品牌内容中提取品牌属性
   • 品牌声音与语调规则
   • 排版与颜色指南
   • 内容格式规则
   • 防护措施与限制

品牌说明包含的内容

提取的品牌说明通常包括：

属性	描述
品牌声音	品牌的表达方式（例如，专业、友好、权威）
品牌语调	沟通的情感特质（例如，自信、温暖、共情）
核心信息	核心信息支柱和价值主张
内容规则	内容生成的注意事项
风格指南	排版、颜色、间距偏好
防护措施	对语言、主题或声明的硬性限制

错误处理

错误	响应
search_media_cms_channels 不可用	“品牌搜索不可用。请直接提供品牌名称或指南。”
get_brand_instructions 不可用	“无法获取品牌说明。请在此对话中分享品牌指南，我会手动应用。”
组织未启用 Vibes 品牌功能	“此组织未启用 CMS 品牌功能。请联系管理员启用 Agentforce Vibes 品牌功能。”
权限被拒绝	“你没有访问 CMS 品牌的权限。请确保你拥有 Managed Content Authoring 权限。”
品牌提取结果为空	“该品牌存在，但尚未配置指南。请在 CMS 中添加品牌属性，或在此处提供指南。”

切勿静默失败。 始终告知用户，并提供替代方案。

核心原则

1. 品牌优先，内容其次 — 生成内容前，始终先提取品牌说明
2. 切勿臆测品牌指南 — 仅应用从 CMS 明确获取的内容
3. 绝对遵守防护措施 — 品牌内容规则是硬性约束，而非建议
4. 确认品牌选择 — 未经用户确认，切勿自动选择品牌
5. 展示工作过程 — 告知用户应用了哪些指南以及如何应用
6. 优雅降级 — 如果工具不可用，请向用户索取手动提供的指南，而不是在缺少品牌信息的情况下继续