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：ブランドのコンテキストを確認する

ユーザーが使用するブランドをすでに指定しているか確認します。

ブランドが判明している（ユーザーがブランド名を指定した場合、またはブランドが 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. 応答を解析します — ブランドの結果は 9Ps で始まる ID を持ちます。次の情報を抽出します：
   • 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 に進みます。

ブランドが 1 つ見つかった場合、ユーザーに確認します。

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. 利用できない場合も適切に対処する — ツールを利用できない場合は、ブランディングなしで進めるのではなく、手動でのガイドライン共有を依頼してください